# text Text欄是最常用的列, 用于顯示列數據 ## 方法原型: ``` /** * @param string $name 字段名, 支持復雜結構的多級操作, 以英文句號分隔, 如: 'city.name' * @param string $title 標題 * @param string $type 類型, 為空時默認為text類型 * @param array $option 顯示的值映射, 用于將值轉換為對應要顯示的值, 如 [1 => '啟用', 2=>'禁用'] * @param string $default 默認值 * @param array $attr 觸發器等其他屬性: { * trigger: {key: value}, // 用于控制當前列是否顯示, value可以是一個數組, 若傳了trigger參數, 只有當前行數據中出現在value中時才顯示 * fixed: 是否固定列, * show_tooltip: 是否在長度超出后顯示tooltip * } */ addColumn($name, $title, $type = 'text', $option = '', $default = '', $attr = []) ``` ## 調用方式: ``` return SBuilder::make('table') ->addColumn('name', '姓名') ->fetch(); ``` 或 ``` return SBuilder::make('table') ->addColumns([ ['name', '姓名'], ... // 其他列 ]) ->fetch(); ``` > 頁面效果: >  - 復雜結構支持 如用戶行數據結構為: ```json { id: 1, name: 'Finay', sex: 1, city: { id: 1001, name: '深圳', } } ``` 要直接在列表中展示用戶城市, 可用如下用法: ``` return SBuilder::make('table') ->addColumn('city.name', '城市名') ->fetch(); ``` - 數據展示轉換 如上面的數據中, 要把性別展示為1對應男, 2對應女,需要使用option參數: ``` return SBuilder::make('table') ->addColumn('sex', '性別', '', ['1' => '男', '2' => '女']) ->fetch(); ``` - 觸發器 可使用觸發器控制行數據是否在當前列顯示, 如上main的數據中, 若要id為1,2,3才顯示`name`: ``` return SBuilder::make('table') ->addColumn('name', '姓名', '', '', '', [ 'trigger' => ['id' => [1,2,3]] ]) ->fetch(); ``` > 注意: 當trigger中存在多個字段的條件時, 判斷關系為或的關系，若需要其他復雜關系處理, 請在獲取列表邏輯中直接處理。