搜索框

用于搜索场景的输入框组件。

概念说明

属性

组件通用属性请参见组件通用说明。

搜索框

• 值：当前选择的值。
• 占位提示文字：占位提示文字。
• 搜索框形状：搜索框形状，可选：方形、圆形，默认选择方形。
• 输入的最大字符数：输入的最大字符数。
• 是否启用清除图标：是否启用清除图标，点击清除图标后会清空输入框
• 显示清除图标：显示清除图标，可选择：一直显示、输入框获取焦点时且不为空时提示，默认选择一直显示。
• 只读：正常显示，但禁止选择或输入。
• 禁用：置灰显示，且禁止任何交互（焦点、点击、选择、输入等）。
• 内容对齐方式：支持左对齐、居中对齐和右对齐。
• 搜索图标位置：支持左和右。

事件

• 搜索框组件支持手势事件和组件事件。
  • 组件事件：确定搜索时触发、点击右侧按钮时触发、点击搜索图标时触发、输入框内容变化时触发、输入框获得焦点时触发、输入框失去焦点时触发、点击输入区域时触发、点击清除图标时触发。
  • 手势事件：输入框获取焦点时触发 输入框失去焦点时触发

样式

样式说明请参见组件通用说明。

示例

一个简单的搜索框