添加 Grid 表单筛选功能

Author: SmallRuralDog

docs/components.md

@@ -227,6 +227,11 @@ Cascader::make()->panel(true)
 ### Slider 滑块
 ### TimePicker 时间选择器
 ### DatePicker 日期选择器
+
+```php
+DatePicker::make()
+```
+
 ### DateTimePicker 日期时间选择器
 ### Upload 上传
 通过以下的调用来生成上传组件

docs/grid.assets/image-20200313093443485.png

@@ -203,7 +203,214 @@ $model->where('title', 'like', "%{$input}%")
 ```php
 $grid->quickSearchPlaceholder("占位符文字");
 ```
-### 表单搜索
+### 表单模式搜索
+
+提供了一系列的方法实现表格数据的查询过滤：
+
+```php
+$grid->filter(function($filter){
+    // 在这里添加字段过滤器
+    $filter->like('name', 'name');
+    
+});
+```
+
+####  查询类型
+
+目前支持的过滤类型有下面这些:
+
+### equal
+
+`sql: ... WHERE`column`= "$input"`：
+
+```php
+$filter->equal('column', $label);
+```
+
+### not equal
+
+`sql: ... WHERE`column`!= "$input"`：
+
+```php
+$filter->notEqual('column', $label);
+```
+
+### like
+
+`sql: ... WHERE`column`LIKE "%$input%"`：
+
+```php
+$filter->like('column', $label);
+```
+
+### ilike
+
+`sql: ... WHERE`column`ILIKE "%$input%"`：
+
+```php
+$filter->ilike('column', $label);
+```
+
+### contains
+
+> since v1.6.12
+
+等于like查询
+
+```php
+$filter->contains('title');
+```
+
+### starts with
+
+> since v1.6.12
+
+查询以输入内容开头的title字段数据
+
+```php
+$filter->startsWith('title');
+```
+
+### starts with
+
+> since v1.6.12
+
+查询以输入内容结尾的title字段数据
+
+```php
+$filter->endsWith('title');
+```
+
+### 大于
+
+`sql: ... WHERE`column`> "$input"`：
+
+```php
+$filter->gt('column', $label);
+```
+
+### 小于
+
+`sql: ... WHERE`column`< "$input"`：
+
+```php
+$filter->lt('column', $label);
+```
+
+### between
+
+`sql: ... WHERE`column`BETWEEN "$start" AND "$end"`：
+
+```php
+$filter->between('column', $label);
+
+// 设置datetime类型
+$filter->between('column', $label)->datetime();
+
+// 设置time类型
+$filter->between('column', $label)->time();
+```
+
+### in
+
+`sql: ... WHERE`column`in (...$inputs)`：
+
+```php
+$filter->in('column', $label)->multipleSelect(['key' => 'value']);
+```
+
+### notIn
+
+`sql: ... WHERE`column`not in (...$inputs)`：
+
+```php
+$filter->notIn('column', $label)->multipleSelect(['key' => 'value']);
+```
+
+### date
+
+`sql: ... WHERE DATE(`column`) = "$input"`：
+
+```php
+$filter->date('column', $label);
+```
+
+### day
+
+`sql: ... WHERE DAY(`column`) = "$input"`：
+
+```php
+$filter->day('column', $label);
+```
+
+### month
+
+`sql: ... WHERE MONTH(`column`) = "$input"`：
+
+```php
+$filter->month('column', $label);
+```
+
+### year
+
+`sql: ... WHERE YEAR(`column`) = "$input"`：
+
+```php
+$filter->year('column', $label);
+```
+
+### where
+
+可以用where来构建比较复杂的查询过滤
+
+`sql: ... WHERE`title`LIKE "%$input" OR`content`LIKE "%$input"`：
+
+```php
+$filter->where(function ($query) {
+
+    $query->where('title', 'like', "%{$this->input}%")
+        ->orWhere('content', 'like', "%{$this->input}%");
+
+}, 'Text');
+```
+
+`sql: ... WHERE`rate`>= 6 AND`created_at`= {$input}`:
+
+```php
+$filter->where(function ($query) {
+
+    $query->whereRaw("`rate` >= 6 AND `created_at` = {$this->input}");
+
+}, 'Text');
+```
+
+关系查询，查询对应关系`profile`的字段：
+
+```php
+$filter->where(function ($query) {
+
+    $query->whereHas('profile', function ($query) {
+        $query->where('address', 'like', "%{$this->input}%")->orWhere('email', 'like', "%{$this->input}%");
+    });
+
+}, '地址或手机号');
+```
+
+#### 表单类型
+
+请查看表单可用组件
+
+```php
+$filter->between("created_at", "名称")->component(DatePicker::make()->type("daterange"));
+```
+
+使用`component`方法设置表单类型
+
+### 标签页模式搜索
+
+例如：产品订单列表的 `全部 代付款 代发货` 等状态的快捷筛选
+
+![image-20200313093513048](grid.assets/image-20200313093513048.png)
 
 ## 字段使用