## 自定義字段 我們在模型、自定義表單、單頁、專題中可以使用自定義字段。 ## 字段類型 | 類型 | 說明 | | :-- | :-- | | 字符 | 常用于普通文本內容 | | 文本 | 常用于多行富文本內容 | | 編輯器 | 常用于富文本內容，將自動渲染編輯器 | | 數字 | 錄入時僅支持錄入數字 | | 日期 | 前臺將自動渲染日期選擇 | | 時間 | 前臺將自動渲染時間選擇 | | 日期時間 | 前臺將自動渲染日期時間選擇 | | 日期時間區間 | 前臺將自動渲染日期時間區間選擇 | | 列表 | 前臺將渲染固定的列表項，單選 | | 列表(多選) | 前臺將渲染固定的列表項，多選 | | 圖片 | 前臺將渲染圖片選擇組件，單選 | | 圖片(多選) | 前臺將渲染圖片選擇組件，多選 | | 文件 | 前臺將渲染文件選擇組件，單選 | | 文件(多選) | 前臺將渲染文件選擇組件，多選 | | 開關 | 前臺將渲染成開關組件 | | 單選 | 前臺將渲染成單選框按鈕 | | 復選 | 前臺將渲染成復選框按鈕 | | 城市地區 | 前臺將渲染成城市地區選擇組件 | | 關聯字段 | 用于關聯其它表時使用，單選 | | 關聯字段(多選) | 用于關聯其它表時使用，多選 | | 數組 | 將自動渲染成Fieldlist組件 | | 自定義 | 用于自定義HTML代碼 | ## 數據調用 我們在前臺模板列表頁或詳情頁時可以調用自定義字段的數據，詳情頁和欄目列表頁可以直接調用自定義字段數據。`arclist`調用自定義字段，請參考文檔：https://doc.fastadmin.net/cms/26.html 調用副表數據章節 ### 單選/復選 如果我們在后臺創建自定義字段時選擇的類型是`單選/復選`，則我們可以在模板中直接使用`字段名稱`來獲取數據外，還可以使用`字段名稱_text`來獲取對應的顯示文本，如在文章詳情頁使用： ~~~php //對應表中的值 {$__ARCHIVES__.字段名稱} //對應的數據列表的值 {$__ARCHIVES__.字段名稱_text} ~~~ 如果我們需要對`復選`數據進行循環，可以使用`字段名稱_list`來獲取對應的數組數據，如在文章詳情頁使用： ~~~bash {foreach name="__ARCHIVES__.字段名稱_list" id="item"} 值：{$key}，標題：{$item} {/foreach} ~~~ ### 列表/列表(多選) 如果我們在后臺創建自定義字段時選擇的類型是`列表/列表(多選)`，則我們可以在模板中直接使用`字段名稱`來獲取數據外，還可以使用`字段名稱_text`來獲取對應的顯示文本，如在文章詳情頁使用： ~~~php //對應表中的值 {$__ARCHIVES__.字段名稱} //對應的數據列表的值 {$__ARCHIVES__.字段名稱_text} ~~~ 如果我們需要對`列表(多選)`數據進行循環，可以使用`字段名稱_list`來獲取對應的數組數據，如在文章詳情頁使用： ~~~bash {foreach name="__ARCHIVES__.字段名稱_list" id="item"} 值：{$key}，標題：{$item} {/foreach} ~~~ ### 數組 如果我們在后臺創建自定義字段時選擇的類型是`數組`，則我們可以在模板中使用`字段名稱_list`來獲取對應的數組數據，如在文章詳情頁使用： ~~~bash {foreach name="__ARCHIVES__.字段名稱_list" id="item"} 鍵名：{$key}，鍵值：{$item} {/foreach} ~~~ ### 關聯字段/關聯字段(多選) 如果我們在后臺創建自定義字段時選擇的類型是`關聯字段/關聯字段(多選)`，則我們可以在模板中直接使用`字段名稱`來獲取數據外，還可以使用`字段名稱_value`來獲取對應關聯表的顯示文本，如在文章詳情頁使用： ~~~php //對應表中的值 {$__ARCHIVES__.字段名稱} //對應的關聯表的顯示文本 {$__ARCHIVES__.字段名稱_value} ~~~ > 溫馨提示：此功能僅在CMS1.4.4+版本可使用 ### 數據列表 如果需要獲取`列表/多選`選中的數據，可以參考上方使用`字段名稱_text`和`字段名稱_list`來獲取相應的數據，如果需要獲取后臺自定義字段配置時`數據列表`配置的字典數據信息，可以使用在自定義表單詳情頁使用`{$fieldList['字段名稱']['content_list']}`來獲取原始字典數據，如在詳情頁使用： ~~~bash {foreach name="fieldList.字段名稱.content_list" id="item"} 值：{$key}，標題：{$item} {/foreach} ~~~ > 目前暫時只支持自定義表單詳情頁