README

简介

我们都曾使用过 WordPress，本项目受到 Advanced Custom Fields 的启发。

本包为 Orchid RAD 平台 添加重复字段支持。

先决条件

您必须已安装并配置 Orchid 平台

版本支持：.*

对于 ^13.0.1 版本，请使用 ^13.0.0 标签 及更高版本。

旧版本不支持当前大部分功能。

对于 6.* 版本，请使用 2.0.5 标签。

对于 5 版本，请使用 1.0.0 标签。

对于 4.7.1 版本，请使用 0.0.8 标签。

使用方法

1. 使用 composer 安装包： composer require nakukryskin/orchid-repeater-field

   最新版本的 Laravel 会自动发现并使用该包。

2. 在您的 Orchid 布局目录中创建 RepeaterFields.php 文件。示例

 <?php
 
 namespace App\Http\Orchid\Layouts\Repeaters;
 
 use Orchid\Screen\Layouts\Rows;
 use Orchid\Screen\Fields\Input;
 use Orchid\Screen\Fields\Select;
 
 class RepeaterFields extends Rows
 {
     function fields(): array
     {
         return [
             Input::make('repeater_name')
                 ->type('text')
                 ->max(255)
                 ->required()
                 ->title('Nested Field'),
             
             Select::make('select.')
                 ->multiple()
                 ->options([
                     'test' => 'Test',
                     'test2' => 'Test2'
                 ])
                 ->required()
         ];
     }
 }

1. 简单地在您的屏幕中添加 RepeaterField::make('repeater')：示例

public function layout(): array
{
   return [
       Layout::rows([
           RepeaterField::make('repeater')
               ->title('Repeater')
               ->layout(App\Http\Orchid\Layouts\Repeaters\RepeaterFields::class),
       ])
   ];
}

1. 打开您的屏幕并检查这里的重复字段

高级用法

重复字段也支持必需、最大和最小参数。您可以通过调用 RepeaterField 添加这些参数。

RepeaterField::make('repeater')
    ->title('Repeater')
    ->layout(App\Http\Orchid\Layouts\Repeaters\RepeaterFields::class)
    ->required()
    ->min(10)
    ->max(20)

如果将 ->required() 传递给构造函数，则会自动将 min 设置为 1。如果用户尝试删除此字段，将会阻止并显示消息。

您还可以使用 ->confirmText('Are you sure that you want to delete the block?') 方法更改删除块时的文本。

要显示保存时的必需消息，您必须在屏幕规则中添加此规则，例如 'content.*.repeater' => 'required'

您还可以使用 buttonLabel() 方法重命名按钮标签。例如。

RepeaterField::make('repeater')
    ->title('Repeater')
    ->layout(App\Http\Orchid\Layouts\Repeaters\RepeaterFields::class)
    ->buttonLabel('Add new repeater field')

在极端情况下，如果您使用某种动态数据加载并且需要将额外的数据传递给您的布局，请使用 ->ajaxData() 方法。此方法既可以与可调用函数一起使用，也可以与数据数组一起使用。这可以在您需要为每个字段过滤数据时很有用。

要使用 ajaxData，首先将 trait AjaxDataAccess 连接到您的布局

<?php

namespace App\Orchid\Layouts;

use Nakukryskin\OrchidRepeaterField\Traits\AjaxDataAccess;
use Orchid\Screen\Layouts\Rows;
use Orchid\Screen\Fields\Input;
use Orchid\Screen\Fields\Select;

class RepeaterFields extends Rows
{
    use AjaxDataAccess;

    public function fields(): array
    {
        return [
            Select::make('select.')
                ->title('Select')
                ->multiple()
                ->options($this->getSelectOptions())
                ->required(),
        ];
    }
    
    protected function getSelectOptions() {
        return $this->getAjaxData()->get('select_options');
    }
}

之后，在主屏幕上，确定您想要传输的内容。在示例中，我们根据当前用户角色生成列表

Repeater::make('repeater')
      ->title('Repeater')
      ->layout(\App\Orchid\Layouts\RepeaterFields::class)
      ->ajaxData(function () {
          $data = [
              'select_options' => [
                  'default' => 'Default option',
              ],
          ];
   
          if (request()->user()->id === 1) {
              $data['select_options']['only_first'] = 'Option only for user with id #1';
          }
   
          return $data;
      }),

您可以在重复字段中结合输出选项、输出内容和条件来向用户展示。请注意，您的布局不知道当前屏幕上其他字段的状况，如果您想要传输当前字段的有关数据，您必须首先保存记录并使用主屏幕的数据和查询。

Repeater::make('repeater')
         ->title('Repeater')
         ->layout(\App\Orchid\Layouts\RepeaterFields::class)
         ->ajaxData([
             'select_options' => [
                 'default' => $this->query()['name'] ?? 'Default Name',
             ],
         ]),