## 自定义字段 我们在模型、自定义表单、单页、专题中可以使用自定义字段。 ## 字段类型 | 类型 | 说明 | | :-- | :-- | | 字符 | 常用于普通文本内容 | | 文本 | 常用于多行富文本内容 | | 编辑器 | 常用于富文本内容，将自动渲染编辑器 | | 数字 | 录入时仅支持录入数字 | | 日期 | 前台将自动渲染日期选择 | | 时间 | 前台将自动渲染时间选择 | | 日期时间 | 前台将自动渲染日期时间选择 | | 日期时间区间 | 前台将自动渲染日期时间区间选择 | | 列表 | 前台将渲染固定的列表项，单选 | | 列表(多选) | 前台将渲染固定的列表项，多选 | | 图片 | 前台将渲染图片选择组件，单选 | | 图片(多选) | 前台将渲染图片选择组件，多选 | | 文件 | 前台将渲染文件选择组件，单选 | | 文件(多选) | 前台将渲染文件选择组件，多选 | | 开关 | 前台将渲染成开关组件 | | 单选 | 前台将渲染成单选框按钮 | | 复选 | 前台将渲染成复选框按钮 | | 城市地区 | 前台将渲染成城市地区选择组件 | | 关联字段 | 用于关联其它表时使用，单选 | | 关联字段(多选) | 用于关联其它表时使用，多选 | | 数组 | 将自动渲染成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} ~~~ > 目前暂时只支持自定义表单详情页