category: Components type: UI Views component: Form chinese: 搜索框 english: SearchField source: next-search
搜索框, FormItem + Search【 @alicd/next 】 的功能融合,同时支持了 x-bind 双向绑定, rules 规则配置,name 表单 name 属性
API
参数 | 说明 | 类型 | 默认值 |
---|---|---|---|
prefix | 样式前缀 | String | 'next-' |
className | 样式名称 | String | - |
style | 自定义样式 | Object | - |
size | 大小,可选 primary/secondary 可选择 medium/large ; normal 可选择 small/medium
|
String | 'medium' |
type | 类型可选值:'primary', 'secondary', 'normal' | Enum | 'primary' |
value | 数值 | String/Number | - |
defaultValue | 搜索框默认值 (不适用于Combox) | String | - |
onChange | 输入关键字时的回掉签名:Function() => void | Function | function() { } |
filter | 前置下拉框,default为默认选中项 [{text:'Products', value:'Products',default: true},{text:'Suppliers',valuse:'Suppliers'}]
|
Array | [] |
searchIcon | 搜索按钮图标 | Boolean | - |
searchText | 搜索按钮文案 | String | 'Search' |
combox | 定制下拉框,适合业务特殊定制 | ReactNode | false |
inputWidth | 搜索框宽度 | String/Number | 'auto' |
showSearchBtn | 控制搜索按钮的展现 | Boolean | true |
overlayVisible | 与combox配合使用,控制定制下拉框的展现 | Boolean | - |
canCloseByOutSideClick | 与combox配合使用,控制是否可以通过点击文档其他区域收起下拉框 | Boolean | false |
onRequestClose | 定制下拉框收起的时候出发的回调签名:Function() => void | Function | function() { } |
dataSource | 下拉提示框:历史搜索/搜索建议 [{label:'',value:'',disabled:true}]
|
Array | [] |
placeholder | 默认提示 | String | - |
onInputFocus | input获取焦点的时候触发的回调签名:Function() => void | Function | function() { } |
onInputBlur | input失去焦点的时候触发的回调签名:Function() => void | Function | function() { } |
onSearch | 点击搜索按钮触发的回调签名:Function(object: Object) => void参数:object: {Object} {filter:'',key:''} | Function | function() { } |
onFilterChange | Filter改变时的回掉(filterValue)签名:Function() => void | Function | function() { } |
autoWidth | 搜索框100%自适应父容器 | Boolean | false |
filterAutoWidth | filter的下拉菜单是否与选择器对齐 | Boolean | true |
container | 指定渲染combox的容器 | ReactNode | - |
prefix | 样式前缀 | String | 'next-' |
className | 扩展class | String | - |
style | 自定义内联样式 | Object | - |
size | 单个FormItem的size自定义,优先级高于Form的size, 并且当组件与 FormItem 一起使用时,组件自身设置 size 属性无效。可选值:'', 'large', 'small', 'medium' | Enum | - |
label | label 标签的文本 | ReactNode | - |
labelCol | label 标签布局,通 <Col> 组件,设置 span offset 值,如 {span: 8, offset: 16},该项仅在垂直表单有效 |
Object | - |
help | 提示信息,如不设置,则会根据校验规则自动生成. 如果设置会受控(ps: 可以利用这点自定义错误位置,详细看demo自定义错误) | ReactNode | - |
validateStatus | 校验状态,如不设置,则会根据校验规则自动生成可选值:'''success'(成功)'error'(失败)'loading'(校验中) | Enum | - |
hasFeedback | 配合 validateStatus 属性使用,是否展示校验状态图标, 目前只有Input支持 | Boolean | false |
wrapperCol | 需要为输入控件设置布局样式时,使用该属性,用法同 labelCol | Object | - |
extra | 额外的提示信息,和 help 类似,当需要错误信息和提示文案同时出现时,可以使用这个。 位于错误信息后面 | ReactNode | - |
inputStyle | 表单输入框自定义内联样式 | Object/String | null |
showValidateType | 应用于Field 类元素后,指定其展示错误的方式,可选值有 help 、tooltip 两种 |
String | help |
name |
walle 模式下才支持 可以配合表单Form 收集表单元素的数据,要求表单必须指定 field 属性 |
String | '' |
rules |
walle 模式下才支持 配置表单规则,可以配置多个规则,可参考:async-validator,注意Form 表单必须配置field 属性才会生效 |
Array | null |
x-bind |
walle 模式下才支持 双向绑定某一个变量 |
state | null |