## 篩選表單字段驗證器 > 說明： 設置篩選表單字段驗證器。在點擊搜索按鈕進行列表的搜索時，對預設驗證規則的篩選表單字段數據進行驗證。在設定的驗證器中可以寫字段自定義的驗證方法，也可對篩選表單字段數據進行進一步處理（handleData操作）。默認篩選表單字段驗證器為 `\yunj\Validate` 方法：`filterValidate($callable)` * 參數 **callable** （必須），例： ```php filterValidate(function(){ return TestValidate(); }); ``` * 返回值：需為 `\yunj\Validate`或其子類的實例對象 * 驗證環境scene： * `count`：列表搜索時獲取搜索數據總數的驗證環境 在`count`環境的驗證數據中存在固定參數，`$data["state"]`當前驗證數據行所在狀態欄，`$data["ids"]`當前選中數據行的id集合。 * `items`：列表搜索時獲取搜索數據的驗證環境 在`items`環境的驗證數據中存在固定參數 `$data["state"]` 當前驗證數據行所在狀態欄，`$data["ids"]`當前選中數據行的id集合。 * `export`：列表搜索時導出數據的驗證環境 在`items`環境的驗證數據中存在固定參數 `$data["state"]` 當前驗證數據行所在狀態欄，`$data["ids"]`當前選中數據行的id集合。 > 示例： 搜索產品數據：`序列號(sn)`、`名稱(name)`、`商戶(mid)`... * 驗證器 ```php namespace app\demo\validate\product; final class Lists extends \yunj\Validate { // 自定義驗證方法，校驗序列號格式（這里序列號定義為10位字母組合） protected function checkSn($value,$rule = "",$data){ if(!$value) return true; if(!preg_match("/^[a-zA-Z]{10}$/",$value)) return "序列號僅支持10位字母組合"; return true; } protected function handleData(array $raw_data, $scene): array { $data = $raw_data; switch ($scene) { case "count": // 固定參數：狀態 $state = $data["state"]; // 固定參數：選中數據行id集合 $ids = $data["ids"]; // 校驗商戶有效性，并獲取商戶數據添加到驗證數據里 $merchant = Db::name("merchant")->where("id","=",$data["mid"])->select(); if(!$merchant ) throw_error_json("商戶數據錯誤"); $data["merchant_data"] = $merchant; break; case "items": ... break; case "export": ... break; } return $data; } } ``` * 表格構建器： ```php $builder=YT('general_example')->filter(function($state){ $filter=[ 'sn'=>['title'=>'序列號','verify'=>'checkSn'], 'name'=>['title'=>'名稱','verify'=>'checkSn','desc'=>'只能輸入漢字'], 'mid'=>[ 'title'=>'商戶', 'type'=>'dropdown_search', 'verify'=>'positiveInteger', "multi"=>false, 'url'=>url('merchantOptions') ] ]; return $filter; })->filterValidate(function(){ return new \app\demo\validate\product\Lists(); })->count(function($filter){ // 獲取展商數據 $merchant = $filter["merchant_data"]; // 業務處理... })->items(function($limit_start,$limit_length,$filter,$sort){ ... }); ```