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 |