## setTrigger('觸發表單項名', '觸發的值', '觸發后顯示的表單項名' [, '是否清除原有值']) | 版本 | 新增功能 | | --- | --- | | 1.0.6 | 支持設置是否清除原有值 | 有時候，選擇某些表單項或者填寫某個值后，希望顯示某些表單項，那么就可以用到觸發器了，它可以讓你很輕松就實現動態顯示和隱藏某些表單項。 比如，我們希望用戶選擇“廣州”之后，顯示“郵編”和“電話”兩個表單項，選擇其他則隱藏這兩項。 ~~~ $list_province = ['gz' => '廣州', 'sz' => '深圳', 'sh' => '上海']; return ZBuilder::make('form') ->addSelect('city', '城市', '', $list_province) ->addText('zipcode', '郵編') ->addText('mobile', '電話') ->setTrigger('city', 'gz', 'zipcode,mobile') ->fetch(); ~~~ 這樣設置之后，表單默認不會顯示“郵編”和“電話”這兩項內容，只有用戶選擇了“廣州”之后，這兩項才會顯示，選擇其他選項，則“郵編”和“電話”會隱藏起來，并清空內容。 也可以設置成，選擇“廣州”顯示“郵編”，選擇“深圳”顯示“電話”。 ~~~ $list_province = ['gz' => '廣州', 'sz' => '深圳', 'sh' => '上海']; return ZBuilder::make('form') ->addSelect('city', '城市', '', $list_province) ->addText('zipcode', '郵編') ->addText('mobile', '電話') ->setTrigger('city', 'gz', 'zipcode') ->setTrigger('city', 'sz', 'mobile') ->fetch(); ~~~ 上面的寫法也可以用數組來設置 ~~~ $list_province = ['gz' => '廣州', 'sz' => '深圳', 'sh' => '上海']; $trigger = [ ['city', 'gz', 'zipcode'], ['city', 'sz', 'mobile'], ]; return ZBuilder::make('form') ->addSelect('city', '城市', '', $list_province) ->addText('zipcode', '郵編') ->addText('mobile', '電話') ->setTrigger($trigger) ->fetch(); ~~~ 或者我們希望無論選擇“廣州”還是“深圳”，都顯示“郵編”和“電話”。 ~~~ $list_province = ['gz' => '廣州', 'sz' => '深圳', 'sh' => '上海']; return ZBuilder::make('form') ->addSelect('city', '城市', '', $list_province) ->addText('zipcode', '郵編') ->addText('mobile', '電話') ->setTrigger('city', 'gz,sz', 'zipcode,mobile') ->fetch(); ~~~ 也可以設置連續觸發，比如，選擇“廣州”則顯示“郵編”，“郵編”填寫“123”則顯示“電話”。 ~~~ $list_province = ['gz' => '廣州', 'sz' => '深圳', 'sh' => '上海']; return ZBuilder::make('form') ->addSelect('city', '城市', '', $list_province) ->addText('zipcode', '郵編') ->addText('mobile', '電話') ->setTrigger('city', 'gz', 'zipcode') ->setTrigger('zipcode', '123', 'mobile') ->fetch(); ~~~ ### 觸發表單項名 目前，觸發表單項名僅支持下拉菜單（非多選）、單選、單行文本框這三種表單項類型。 ### 觸發的值 觸發的值可以寫一個，也可以寫多個，多個值用逗號隔開。 ### 觸發后顯示的表單項名 目前不支持普通聯動、范圍、拖動排序、靜態文本這四種表單項類型。 >[danger] 注意，觸發后顯示的表單項名不能重復，比如下面的例子 ~~~ ->setTrigger('model', '2', 'content,detail_template') ->setTrigger('model', '3', 'list_template,detail_template') ~~~ 原本我們的預期是，當model的值為2時顯示content和detail_template，當model的值為3時顯示list_template和detail_template。 但事實上當model的值為2時，detail_template會被隱藏，這是因為此時model不是3，所以list_template和detail_template會被隱藏。如果要達到預期的效果，需要改寫下規則，將相同的表單項名寫在同一個觸發內。 ~~~ ->setTrigger('model', '2,3', 'detail_template') ->setTrigger('model', '2', 'content') ->setTrigger('model', '3', 'list_template') ~~~ 這樣就可以達到我們預期的效果了。 ### 是否清除原有值(1.0.6+) 從1.0.6版本開始，支持設置是否清除原有值。在默認的情況下，會清除原有值。比如： ~~~ $list_province = ['gz' => '廣州', 'sz' => '深圳', 'sh' => '上海']; return ZBuilder::make('form') ->addSelect('city', '城市', '', $list_province) ->addText('zipcode', '郵編') ->addText('mobile', '電話') ->setTrigger('city', 'gz', 'zipcode') ->setTrigger('zipcode', '123', 'mobile') ->fetch(); ~~~ 當城市的值發生改變時，它所關聯的郵編(zipcode)會自動清除掉原有值，如果不希望被清除掉，可以添加第四個參數為false。 ~~~ $list_province = ['gz' => '廣州', 'sz' => '深圳', 'sh' => '上海']; return ZBuilder::make('form') ->addSelect('city', '城市', '', $list_province) ->addText('zipcode', '郵編') ->addText('mobile', '電話') ->setTrigger('city', 'gz', 'zipcode', false) ->setTrigger('zipcode', '123', 'mobile') ->fetch(); ~~~ 這樣，不管城市的值如何變，郵編原有的值不會被清除。