add autocomplete

[edwinhuish]

本地模式

option为字符串：

$form->autocomplete($column[, $label])->options(['foo', 'bar', 'Option name']);

option 为数组：（value键为必须，data可省略)

$form->autocomplete($column[, $label])->options([
    ['value' => 'foo', 'data'=>['group'=>'group a']],
    ['value' => 'bar', 'data'=>['group'=>'group a']],
    ['value' => 'option name', 'data'=>['group'=>'other group name']],
    ....
]);

设定group有更简便的方式，使用方式和select类似：

$form->autocomplete($column[, $label])->groups([
    [
        'label'=>'xxx',
        'options'=>['foo', 'bar', 'other option', ...],
    ],
    ....
]);

以上两种方法都支持闭包，闭包需要返回以上对应的array格式：

$form->autocomplete($column[, $label])->options(function($model, $value){
    return $model->all()->pluck('name');
});

远程API模式

  /**
    * ajax 函数的第一个参数为 ajax url, 第二个参数为 valueField（可选）, 第三个参数为 groupField（可选）
    */
  $form->autocomplete($column[, $label])->ajax('/countries', 'name', 'region');

远程API 服务端的请求参数为query，示例代码如下：

class CountryController extends AdminController
{
    public function search()
    {
        $countries = Country::when(request('query'), function ($query, $value) {
            $query->where('name', 'like', "%{$value}%");
        })->get();

        return Admin::json($countries->toArray());
    }
}

自定义 autocomplete 的设置：

详细设置请参考： devbridge/jQuery-Autocomplete

$js = <<<JS
    function (suggestion) {
        alert('You selected: ' + suggestion.value + ', ' + suggestion.data);
    }
JS;

$form->autocomplete($column[, $label])->configs([
    'minChars' => 5,
    'noCache' => true,
    'onSelect' => JavaScript::make($js),
]);

configs 同样也支持闭包：

$form->autocomplete($column[, $label])->configs(function($model, $value){
    return [
        ....
    ];
});

联动：

autocomplete 的联动逻辑和select的刚好相反。
depends 需要写在受影响的字段，不限上级字段类型，上级字段的值将同时上传到API。

$form->select('region')->options([
    'asia',
    'Africa',
    'America',
    'Europe',
]);

$form->autocomplete('country')->ajax('/countries', 'name', 'region');

// 将会发出 /states?query={query}&region={region}&country={country}  的请求
$form->autocomplete('addr')->ajax('/states', 'name')->depends(['region', 'country']);

[jqhph]

感谢