# search 提供搜索框组件，用于提供用户搜索内容的输入区域。 ## 子组件 不支持。 ## 属性 除支持[通用属性](js-components-common-attributes.md)外，还支持如下属性：

名称

类型

默认值

必填

描述

icon

string

-

否

搜索图标，默认使用系统搜索图标，图标格式为svg，jpg和png。

hint

string

-

否

搜索提示文字。

value

string

-

否

搜索框搜索文本值。

searchbutton5+

string

-

否

搜索框末尾搜索按钮文本值。

menuoptions5+

Array<MenuOption>

-

否

设置文本选择弹框点击更多按钮之后显示的菜单项。
**表 1** MenuOption5+

名称

类型

描述

icon

string

菜单选项中的图标路径。

content

string

菜单选项中的文本内容。
## 样式 除支持[通用样式](js-components-common-styles.md)外，还支持如下样式：

名称

类型

默认值

必填

描述

color

<color>

#e6000000

否

搜索框的文本颜色。

font-size

<length>

16px

否

搜索框的文本尺寸。

allow-scale

boolean

true

否

搜索框的文本尺寸是否跟随系统设置字体缩放尺寸进行放大缩小。

说明：

如果在config描述文件中针对ability配置了fontSize的config-changes标签，则应用不会重启而直接生效。

placeholder-color

<color>

#99000000

否

搜索框的提示文本颜色。

font-weight

number | string

normal

否

搜索框的字体粗细，见text组件font-weight的样式属性。

font-family

string

sans-serif

否

搜索框的字体列表，用逗号分隔，每个字体用字体名或者字体族名设置。列表中第一个系统中存在的或者通过自定义字体指定的字体，会被选中作为文本的字体。

caret-color6+

<color>

-

否

设置输入光标的颜色。
## 事件 除支持[通用事件](js-components-common-events.md)外，还支持如下事件：

名称

参数

描述

change

{ text:newText }

输入内容发生变化时触发。

说明：

改变value属性值不会触发该回调。

submit

{ text:submitText }

点击搜索图标、搜索按钮5+或者按下软键盘搜索按钮时触发。

translate5+

{ value: selectedText }

设置此事件后，进行文本选择操作后文本选择弹窗会出现翻译按钮，点击翻译按钮之后，触发该回调，返回选中的文本内容。

share5+

{ value: selectedText }

设置此事件后，进行文本选择操作后文本选择弹窗会出现分享按钮，点击分享按钮之后，触发该回调，返回选中的文本内容。

search5+

{ value: selectedText }

设置此事件后，进行文本选择操作后文本选择弹窗会出现搜索按钮，点击搜索按钮之后，触发该回调，返回选中的文本内容。

optionselect5+

{ index:optionIndex, value: selectedText }

文本选择弹窗中设置menuoptions属性后，用户在文本选择操作后，点击菜单项后触发该回调，返回点击的菜单项序号和选中的文本内容。
## 方法 支持[通用方法](js-components-common-methods.md)。 ## 示例 ```
``` ``` /* xxx.css */ .container { display: flex; justify-content: center; align-items: center; } ``` ![](figures/zh-cn_image_0000001166601624.png)