鸿蒙ArkTS声明式组件：【Search】

最新推荐文章于 2025-02-08 22:05:15 发布

鸿蒙系统小能手Mr.Li

最新推荐文章于 2025-02-08 22:05:15 发布

阅读量1.5k

点赞数 29

分类专栏：鸿蒙开发文章标签： harmonyos 鸿蒙开发鸿蒙 OpenHarmony 声明式 arkts 程序员

本文链接：https://blog.csdn.net/2401_82772199/article/details/140070089

版权

Search

搜索框组件，适用于浏览器的搜索内容输入框等应用场景。

说明：

该组件从API Version 8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。

无

Search(options?: { value?: string, placeholder?: ResourceStr, icon?: string, controller?: SearchController })

参数:

参数名	参数类型	必填	参数描述
value	string	否	设置当前显示的搜索文本内容。从API version 10开始，该参数支持[$$]双向绑定变量。
placeholder	[ResourceStr]10+	否	设置无输入时的提示文本。
icon	string	否	设置搜索图标路径，默认使用系统搜索图标。说明： icon的数据源支持本地图片和网络图片。 - 支持的图片格式包括png、jpg、bmp、svg、gif和pixelmap。 - 支持Base64字符串。格式data:image/[png
controller	SearchController	否	设置Search组件控制器。

除支持[通用属性]外，还支持以下属性：

名称	参数类型	描述
searchButton10+	value: string, option?: [SearchButtonOptions]	搜索框末尾搜索按钮文本内容，默认无搜索按钮。
placeholderColor	[ResourceColor]	设置placeholder文本颜色。默认值：‘#99182431’。
placeholderFont	[Font]	设置placeholder文本样式，包括字体大小，字体粗细，字体族，字体风格。目前仅支持默认字体族。
textFont	[Font]	设置搜索框内输入文本样式，包括字体大小，字体粗细，字体族，字体风格。目前仅支持默认字体族。
textAlign	[TextAlign]	设置文本在搜索框中的对齐方式。目前支持的对齐方式有：Start、Center、End。默认值：TextAlign.Start
copyOption9+	[CopyOptions]	设置输入的文本是否可复制。默认值：CopyOptions.LocalDevice，支持设备内复制。设置CopyOptions.None时，当前Search中的文字无法被复制或剪切，仅支持粘贴。
searchIcon10+	[IconOptions]	设置左侧搜索图标样式。
cancelButton10+	{ style? : [CancelButtonStyle]icon?: [IconOptions] }	设置右侧清除按钮样式。默认值： { style：CancelButtonStyle.INPUT }
fontColor10+	[ResourceColor