在 FastAdmin 中,selectpage 是一个基于 Select2 实现的弹出窗口选择器,用于选择相关的数据,其中 data-primary-key
是指定数据表主键字段名的属性,以便在列表选择后自动赋值到相应主键表单域。
除了 data-primary-key
属性外,常用的参数包括:
data-url
:指定数据来源的 URL。data-text-field
:设定下拉列表显示文本的字段。data-value-field
:设定下拉列表实际值的字段。data-multiple
:设定是否支持多选,取值为true
或false
。data-width
:设定下拉列表宽度,例如"150px"
或"100%"
。data-height
:设定下拉列表高度,例如"200px"
或"auto"
。data-select-width
:设定弹出的窗口宽度,例如"800px"
或"100%"
。data-select-height
:设定弹出的窗口高度,例如"600px"
或"auto"
。data-replace-name
:设定选择器替换表单域的名称,用于在修改表单中表示外键关联字段。data-allow-clear
:设定是否允许清空已选中的选项,取值为true
或false
。data-fields
:设定额外的查询参数,格式为 JSON 对象,例如data-fields="{type:'1', status:'2'}"
。
除了以上列出的常用参数之外,还有其他参数可以根据具体需求进行配置,例如:
data-template-result
:指定一个自定义函数来格式化下拉列表中的选项,以便插入 HTML 代码等特殊格式。data-template-selection
:指定一个自定义函数来格式化选择项在输入框中的显示内容,以便显示更多信息或不同的样式。
综上所述,可以根据需要自行选择适用的参数进行配置。
在 FastAdmin 中,selectpage 是一个基于 Select2 实现的弹出窗口选择器,用于选择相关的数据,其参数可以根据具体需求进行配置,以下是常用的参数列表:
参数名 | 类型 | 默认值 | 描述 |
---|---|---|---|
url | string | 无 | 必须,选择器的数据来源,支持远程 URL 和本地数组 |
text | string | ‘name’ | 显示文本字段名,如果返回的数据中没有该字段,则无法显示明细 |
value | string | ‘id’ | 实际值字段名,如果返回的数据中没有该字段,则 val() 返回空 |
placeholder | string | ‘请选择’ | 未选择时的占位文字 |
multiple | boolean | false | 是否多选 |
width | string | ‘100%’ | 弹窗的宽度 |
height | string | ‘100%’ | 弹窗的高度 |
dataType | string | ‘json’ | 远程数据格式 |
fields | object | {} | 额外参数数组(会作为 GET 参数一起提交) |
allowClear | boolean | true | 是否允许清空 |
showSearchBox | boolean | true | 是否显示搜索框 |
async | boolean | false | 是否异步请求数据 |
delay | integer | 250 | 输入框输入多少毫秒之后触发请求 |
minimumInputLength | integer | 1 | 输入框必须输入多少个字符才会触发查询 |
maximumSelectionLength | integer | 0 | 多选时,限制最多可以选择多少个项目,为 0 则不限制 |
templateResult | function | 无 | 用于格式化下拉列表的每个选项 |
templateSelection | function | 无 | 用于格式化当前选择项的输入框显示 |
除以上列出的常用参数外,还有一些其他的参数,如语言、匹配器、数据去重等,可根据具体需求进行配置。