## addFilterMap('字段名' [, '查詢條件']) 點擊篩選圖標時，系統會去獲取該字段的所有數據，默認是沒有添加任何篩選條件的，如果想在獲取字段數據的時加上查詢條件，可以這樣做。 ~~~ // 使用ZBuilder構建數據表格 return ZBuilder::make('table') ->addFilter('id,username') // 添加篩選 ->addFilterMap('id', ['group' => 'cms']) // 只獲取group等于cms的id字段信息 ->fetch(); ~~~ 也可以使用>、<、eq、gt、egt等關鍵字，和ThinkPHP的用法一致 ~~~ // 使用ZBuilder構建數據表格 return ZBuilder::make('table') ->addFilter('id,username') // 添加篩選 ->addFilterMap('id', ['status' => ['>=', 10]]) // 只獲取status大于等于10的id字段 ->fetch(); ~~~ 如果多個字段的限定條件是相同的，也可以寫在一起，字段之間用逗號隔開 ~~~ // 使用ZBuilder構建數據表格 return ZBuilder::make('table') ->addFilter('id,username') // 添加篩選 ->addFilterMap('id,username', ['status' => ['>=', 10]]) // 只獲取status大于等于10的id字段 ->fetch(); ~~~ 如果所有字段都需要用到相同的限定條件，那么可以干脆把條件寫到`addFilter`方法的第二個參數，不用添加`addFilterMap`方法。 ~~~ // 使用ZBuilder構建數據表格 return ZBuilder::make('table') ->addFilter('id,username', ['status' => ['>=', 10]]) // 添加篩選并限定條件 ->fetch(); ~~~ 如果某字段的限定條件已經定義過，想對該字段額外增加條件也可以，比如上面的例子，我希望獲取username字段信息的時候，不僅要group等于cms，還要求status大于0，只需接著對該字段添加限定條件。 ~~~ // 使用ZBuilder構建數據表格 return ZBuilder::make('table') ->addFilter('id,username') // 添加篩選 ->addFilterMap('id,username', ['group' => 'cms']) ->addFilterMap('username', ['status' => ['>', 0]]) ->fetch(); ~~~ 除此之外，也可以把條件都定義好，直接以數組形式傳入，以上的代碼和下面的效果是相同的。 ~~~ $filter_map = [ 'id,username' => ['group' => 'cms'], 'username' => ['status' => ['>', 0]] ]; // 使用ZBuilder構建數據表格 return ZBuilder::make('table') ->addFilter('id,username') // 添加篩選 ->addFilterMap($filter_map) ->fetch(); ~~~ 或者這樣 ~~~ $filter_map = [ 'id' => ['group' => 'cms'], 'username' => ['group' => 'cms', 'status' => ['>', 0]] ]; // 使用ZBuilder構建數據表格 return ZBuilder::make('table') ->addFilter('id,username') // 添加篩選 ->addFilterMap($filter_map) ->fetch(); ~~~ ###與其他篩選字段聯動 >[info]從1.0.3版本開始，當addFilterMap的第二個參數是字符串時，表示與其他字段篩選進行聯動 比如，我們添加了省份篩選和城市篩選，一般是這樣寫的 ~~~ // 使用ZBuilder構建數據表格 return ZBuilder::make('table') ->addFilter('province', $list_province) // $list_province 是用于將省份id轉為省份名稱 ->addFilter('city', $list_city) // $list_city 是用于將城市id轉為城市名稱 ->fetch(); ~~~ 但是我們假如想實現當用戶篩選“廣東”省時，點擊城市篩選只會出現屬于廣東省的城市列表，那么我們可以這么寫 ~~~ // 使用ZBuilder構建數據表格 return ZBuilder::make('table') ->addFilter('province', $list_province) // $list_province 是用于將省份id轉為省份名稱 ->addFilter('city', $list_city) // $list_city 是用于將城市id轉為城市名稱 ->addFilterMap('city', 'province') ->fetch(); ~~~ 當用戶點擊篩選城市時，框架會把當前選擇的省份一起傳到服務器進行查詢。