鸿蒙5.0开发进阶：UI框架-ArkTS组件（Search）

最新推荐文章于 2025-05-27 09:50:26 发布
原创 最新推荐文章于 2025-05-27 09:50:26 发布 · 1k 阅读 · 12 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#harmonyos #华为 #前端 #android #鸿蒙系统 #ArkUI #UI框架

往期鸿蒙5.0全套实战文章必看：（文中附带全栈鸿蒙5.0学习资料）

Search

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

说明

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

子组件

无

接口

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

元服务API： 从API version 11开始，该接口支持在元服务中使用。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数:

参数名类型必填说明
valuestring否

设置当前显示的搜索文本内容。

从API version 10开始，该参数支持$$双向绑定变量。

placeholderResourceStr10+否设置无输入时的提示文本。
iconstring否

设置搜索图标路径，默认使用系统搜索图标。

说明：

icon的数据源支持本地图片和网络图片。

- 支持的图片格式包括png、jpg、bmp、svg、gif、pixelmap和heif。

- 支持Base64字符串。格式data:image/[png|jpeg|bmp|webp|heif];base64,[base64 data], 其中[base64 data]为Base64字符串数据。

如果与属性searchIcon同时设置，则searchIcon优先。

controllerSearchController否设置Search组件控制器。

属性

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

searchButton

searchButton(value: string, option?: SearchButtonOptions)

设置搜索框末尾搜索按钮。

点击搜索按钮，同时触发onSubmit与onClick回调。

元服务API： 从API version 11开始，该接口支持在元服务中使用。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

参数名类型必填说明
valuestring是搜索框末尾搜索按钮文本内容。
optionSearchButtonOptions否

配置搜索框文本样式。

默认值：

{

fontSize: '16fp',

fontColor: '#ff3f97e9'

}

placeholderColor

placeholderColor(value: ResourceColor)

设置placeholder文本颜色。

元服务API： 从API version 11开始，该接口支持在元服务中使用。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

参数名类型必填说明
valueResourceColor是

placeholder文本颜色。

默认值：'#99182431'。

placeholderFont

placeholderFont(value?: Font)

设置placeholder文本样式，包括字体大小，字体粗细，字体族，字体风格。当前支持'HarmonyOS Sans'字体和注册自定义字体。

元服务API： 从API version 11开始，该接口支持在元服务中使用。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

参数名类型必填说明
valueFont否placeholder文本样式。

textFont

textFont(value?: Font)

设置搜索框内输入文本样式，包括字体大小，字体粗细，字体族，字体风格。目前仅支持默认字体族。

元服务API： 从API version 11开始，该接口支持在元服务中使用。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

参数名类型必填说明
valueFont否搜索框内输入文本样式。

textAlign9+

textAlign(value: TextAlign)

设置文本在搜索框中的对齐方式。目前支持的对齐方式有：Start、Center、End。

元服务API： 从API version 11开始，该接口支持在元服务中使用。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

参数名类型必填说明
valueTextAlign是

文本在搜索框中的对齐方式。

默认值：TextAlign.Start

copyOption9+

copyOption(value: CopyOptions)

设置输入的文本是否可复制。设置CopyOptions.None时，当前Search中的文字无法被复制或剪切，仅支持粘贴。

设置CopyOptions.None时，不允许拖拽。

元服务API： 从API version 11开始，该接口支持在元服务中使用。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

参数名类型必填说明
valueCopyOptions是

输入的文本是否可复制。

默认值：CopyOptions.LocalDevice，支持设备内复制。

searchIcon10+

searchIcon(value: IconOptions | SymbolGlyphModifier)

设置左侧搜索图标样式。

元服务API： 从API version 11开始，该接口支持在元服务中使用。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

参数名类型必填说明
valueIconOptions | SymbolGlyphModifier是

左侧搜索图标样式。

浅色模式默认值：

{

size: '16vp',

color: '#99000000',

src: ' '

}

深色模式默认值：

{

size: '16vp',

color: '#99ffffff',

src: ' '

}

cancelButton10+

cancelButton(value: CancelButtonOptions | CancelButtonSymbolOptions)

设置右侧清除按钮样式。

元服务API： 从API version 11开始，该接口支持在元服务中使用。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

参数名类型必填说明
valueCancelButtonOptions | CancelButtonSymbolOptions是

右侧清除按钮样式。

默认值：

{

style: CancelButtonStyle.INPUT,

icon: {

size: '16vp',

color: '#99ffffff',

src: ' '

}

}

当style为CancelButtonStyle.CONSTANT时，默认显示清除样式。

fontColor10+

fontColor(value: ResourceColor)

设置输入文本的字体颜色。文本通用属性fontSize、fontStyle、fontWeight和fontFamily在textFont属性中设置。

元服务API： 从API version 11开始，该接口支持在元服务中使用。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

参数名类型必填说明
valueResourceColor是

输入文本的字体颜色。

默认值：'#FF182431'。

caretStyle10+

caretStyle(value: CaretStyle)

设置光标样式。

元服务API： 从API version 11开始，该接口支持在元服务中使用。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

参数名类型必填说明
valueCaretStyle是

光标样式。

默认值：

{

width: '1.5vp',

color: '#007DFF'

}

说明

从API version 12开始，此接口支持设置文本手柄颜色，光标和文本手柄颜色保持一致。

enableKeyboardOnFocus10+

enableKeyboardOnFocus(value: boolean)

设置Search通过点击以外的方式获焦时，是否主动拉起软键盘。

从API version 10开始，获焦默认绑定输入法。

元服务API： 从API version 11开始，该接口支持在元服务中使用。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

参数名类型必填说明
valueboolean是

Search获焦时，是否主动拉起软键盘。

默认值：true。

selectionMenuHidden10+

selectionMenuHidden(value: boolean)

设置是否不弹出系统文本选择菜单。

元服务API： 从API version 11开始，该接口支持在元服务中使用。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

参数名类型必填说明
valueboolean是

是否不弹出系统文本选择菜单。

设置为true时，单击输入框光标、长按输入框、双击输入框、三击输入框或者右键输入框，不弹出系统文本选择菜单。

设置为false时，弹出系统文本选择菜单。

默认值：false

customKeyboard10+

customKeyboard(value: CustomBuilder, options?: KeyboardOptions)

设置自定义键盘。

当设置自定义键盘时，输入框激活后不会打开系统输入法，而是加载指定的自定义组件。

自定义键盘的高度可以通过自定义组件根节点的height属性设置，宽度不可设置，使用系统默认值。

自定义键盘采用覆盖原始界面的方式呈现，当没有开启避让模式或者输入框不需要避让的场景不会对应用原始界面产生压缩或者上提。

自定义键盘无法获取焦点，但是会拦截手势事件。

默认在输入控件失去焦点时，关闭自定义键盘，开发者也可以通过stopEditing方法控制键盘关闭。

如果设备支持拍摄输入，设置自定义键盘后，该输入框会不支持拍摄输入。

当设置自定义键盘时，可以通过绑定onKeyPrelme事件规避物理键盘的输入。

元服务API： 从API version 11开始，该接口支持在元服务中使用。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

参数名类型必填说明
valueCustomBuilder是自定义键盘。
options12+KeyboardOptions否设置自定义键盘是否支持避让功能。

type11+

type(value: SearchType)

设置输入框类型。

元服务API： 从API version 12开始，该接口支持在元服务中使用。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

参数名类型必填说明
valueSearchType是

输入框类型。

默认值：SearchType.Normal

maxLength11+

maxLength(value: number)

设置文本的最大输入字符数。默认不设置最大输入字符数限制。到达文本最大字符限制，将无法继续输入字符。

元服务API： 从API version 12开始，该接口支持在元服务中使用。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

参数名类型必填说明
valuenumber是文本的最大输入字符数。

enterKeyType12+

enterKeyType(value: EnterKeyType)

设置输入法回车键类型。

元服务API： 从API version 12开始，该接口支持在元服务中使用。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

参数名类型必填说明
valueEnterKeyType是

输入法回车键类型。

默认值：EnterKeyType.Search

lineHeight12+

lineHeight(value: number | string | Resource)

设置文本的文本行高，设置值不大于0时，不限制文本行高，自适应字体大小，number类型时单位为fp。

元服务API： 从API version 12开始，该接口支持在元服务中使用。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

参数名类型必填说明
valuenumber | string | Resource是文本的文本行高。

decoration12+

decoration(value: TextDecorationOptions)

设置文本装饰线类型样式及其颜色。

元服务API： 从API version 12开始，该接口支持在元服务中使用。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

参数名类型必填说明
valueTextDecorationOptions是

文本装饰线对象。

默认值：{

type: TextDecorationType.None,

color: Color.Black,

style: TextDecorationStyle.SOLID

}

letterSpacing12+

letterSpacing(value: number | string | Resource)

设置文本字符间距。设置该值为百分比时，按默认值显示。设置该值为0时，按默认值显示。

当取值为负值时，文字会发生压缩，负值过小时会将组件内容区大小压缩为0，导致无内容显示。

元服务API： 从API version 12开始，该接口支持在元服务中使用。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

参数名类型必填说明
valuenumber | string | Resource是文本字符间距。

fontFeature12+

fontFeature(value: string)

设置文字特性效果，比如数字等宽的特性。

格式为：normal | <feature-tag-value>

<feature-tag-value>的格式为：<string> [ <integer> | on | off ]

<feature-tag-value>的个数可以有多个，中间用','隔开。

例如，使用等宽数字的输入格式为："ss01" on。

元服务API： 从API version 12开始，该接口支持在元服务中使用。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

参数名类型必填说明
valuestring是文字特性效果。

Font Feature当前支持的属性见 fontFeature属性列表。

设置 Font Feature 属性，Font Feature 是 OpenType 字体的高级排版能力，如支持连字、数字等宽等特性，一般用在自定义字体中，其能力需要字体本身支持。

 

selectedBackgroundColor12+

selectedBackgroundColor(value: ResourceColor)

设置文本选中底板颜色。如果未设置不透明度，默认为20%不透明度。

元服务API： 从API version 12开始，该接口支持在元服务中使用。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

参数名类型必填说明
valueResourceColor是

文本选中底板颜色。

默认为20%不透明度。

inputFilter12+

inputFilter(value: ResourceStr, error?: Callback< string >)

通过正则表达式设置输入过滤器。匹配表达式的输入允许显示，不匹配的输入将被过滤。仅支持单个字符匹配，不支持字符串匹配。

设置inputFilter且输入的字符不为空字符，会导致设置输入框类型(即type接口)附带的文本过滤效果失效。

元服务API： 从API version 12开始，该接口支持在元服务中使用。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

参数名类型必填说明
valueResourceStr是正则表达式。
errorCallback< string >否正则匹配失败时，返回被过滤的内容。

textIndent12+

textIndent(value: Dimension)

设置首行文本缩进。

元服务API： 从API version 12开始，该接口支持在元服务中使用。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

参数名类型必填说明
valueDimension是

首行文本缩进。

默认值：0

minFontSize12+

minFontSize(value: number | string | Resource)

设置文本最小显示字号。

需配合maxFontSize以及布局大小限制使用，单独设置不生效。

自适应字号生效时，fontSize设置不生效。

元服务API： 从API version 12开始，该接口支持在元服务中使用。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

参数名类型必填说明
valuenumber | string | Resource是文本最小显示字号。

maxFontSize12+

maxFontSize(value: number | string | Resource)

设置文本最大显示字号。

需配合minFontSize以及布局大小限制使用，单独设置不生效。

自适应字号生效时，fontSize设置不生效。

元服务API： 从API version 12开始，该接口支持在元服务中使用。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

参数名类型必填说明
valuenumber | string | Resource是文本最大显示字号。

editMenuOptions12+

editMenuOptions(editMenu: EditMenuOptions)

设置自定义菜单扩展项，允许用户设置扩展项的文本内容、图标、回调方法。

元服务API： 从API version 12开始，该接口支持在元服务中使用。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

参数名类型必填说明
editMenuEditMenuOptions是扩展菜单选项。

enablePreviewText12+

enablePreviewText(enable: boolean)

设置是否开启输入预上屏。

预上屏内容定义为文字暂存态，目前不支持文字拦截功能，因此不触发onWillInsert、onDidInsert、onWillDelete、onDidDelete回调。

元服务API： 从API version 12开始，该接口支持在元服务中使用。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

参数名类型必填说明
enableboolean是

是否开启输入预上屏。

默认值：true

说明

该接口在CAPI场景使用时下，默认关闭。可以在工程的module.json5中配置metadata字段控制是否启用预上屏，配置如下：

 
 
"metadata": [
 {
    "name": "can_preview_text",
    "value": "true",
 }
]
 

 

IconOptions10+对象说明
 

元服务API： 从API version 11开始，该接口支持在元服务中使用。
 

系统能力： SystemCapability.ArkUI.ArkUI.Full
 

名称类型必填说明
sizeLength否图标尺寸，不支持百分比。
colorResourceColor否图标颜色。
srcResourceStr否图标/图片源。


SearchButtonOptions10+对象说明
 

元服务API： 从API version 11开始，该接口支持在元服务中使用。
 

系统能力： SystemCapability.ArkUI.ArkUI.Full
 

名称类型必填说明
fontSizeLength否文本按钮字体大小，不支持百分比。
fontColorResourceColor否文本按钮字体颜色。


CancelButtonStyle10+枚举说明
 

元服务API： 从API version 11开始，该接口支持在元服务中使用。
 

系统能力： SystemCapability.ArkUI.ArkUI.Full
 

名称描述
CONSTANT清除按钮常显样式。
INVISIBLE清除按钮常隐样式。
INPUT清除按钮输入样式。


SearchType11+枚举说明
 

元服务API： 从API version 12开始，该接口支持在元服务中使用。
 

系统能力： SystemCapability.ArkUI.ArkUI.Full
 

名称值描述
NORMAL0 
基本输入模式。
 
支持输入数字、字母、下划线、空格、特殊字符。
 
元服务API： 从API version 12开始，该接口支持在元服务中使用。
 
NUMBER2 
纯数字输入模式。
 
元服务API： 从API version 12开始，该接口支持在元服务中使用。
 
PHONE_NUMBER3 
电话号码输入模式。
 
支持输入数字、空格、+ 、-、*、#、(、)，长度不限。
 
元服务API： 从API version 12开始，该接口支持在元服务中使用。
 
EMAIL5 
邮箱地址输入模式。
 
支持数字，字母，下划线、小数点、!、#、$、%、&、'、*、+、-、/、=、?、^、`、{、|、}、~，以及@字符（只能存在一个@字符）。
 
元服务API： 从API version 12开始，该接口支持在元服务中使用。
 
NUMBER_DECIMAL12+12 
带小数点的数字输入模式。
 
支持数字，小数点（只能存在一个小数点）。
 
元服务API： 从API version 12开始，该接口支持在元服务中使用。
 
URL12+13 
带URL的输入模式。
 
元服务API： 从API version 12开始，该接口支持在元服务中使用。
 


CancelButtonOptions12+对象说明
 

元服务API： 从API version 12开始，该接口支持在元服务中使用。
 

系统能力： SystemCapability.ArkUI.ArkUI.Full
 

名称类型必填说明
styleCancelButtonStyle否右侧清除按钮显示状态。
iconIconOptions否右侧清除按钮图标。


CancelButtonSymbolOptions12+对象说明
 

元服务API： 从API version 12开始，该接口支持在元服务中使用。
 

系统能力： SystemCapability.ArkUI.ArkUI.Full
 

名称类型必填说明
styleCancelButtonStyle否右侧清除按钮显示状态。
iconSymbolGlyphModifier否右侧清除按钮Symbol图标。


事件
 

除支持通用事件外，还支持以下事件：
 

onSubmit
 

onSubmit(callback: (value: string) => void)
 

点击搜索图标、搜索按钮或者按下软键盘搜索按钮时触发该回调。
 

元服务API： 从API version 11开始，该接口支持在元服务中使用。
 

系统能力： SystemCapability.ArkUI.ArkUI.Full
 

参数：
 

参数名类型必填说明
valuestring是当前搜索框中输入的文本内容。


onChange
 

onChange(callback: EditableTextOnChangeCallback)
 

输入内容发生变化时，触发该回调。
 

在本回调中，若执行了光标操作，需要开发者在预上屏场景下依据previewText参数调整光标逻辑，以适应预上屏场景。
 

元服务API： 从API version 11开始，该接口支持在元服务中使用。
 

系统能力： SystemCapability.ArkUI.ArkUI.Full
 

参数：
 

参数名类型必填说明
callbackEditableTextOnChangeCallback是当前输入文本内容变化时的回调。


onCopy
 

onCopy(callback: (value: string) => void)
 

进行复制操作时，触发该回调。
 

元服务API： 从API version 11开始，该接口支持在元服务中使用。
 

系统能力： SystemCapability.ArkUI.ArkUI.Full
 

参数：
 

参数名类型必填说明
valuestring是复制的文本内容。


onCut
 

onCut(callback: (value: string) => void)
 

进行剪切操作时，触发该回调。
 

元服务API： 从API version 11开始，该接口支持在元服务中使用。
 

系统能力： SystemCapability.ArkUI.ArkUI.Full
 

参数：
 

参数名类型必填说明
valuestring是剪切的文本内容。


onPaste
 

onPaste(callback: (value: string, event: PasteEvent) => void)
 

进行粘贴操作时，触发该回调。
 

元服务API： 从API version 11开始，该接口支持在元服务中使用。
 

系统能力： SystemCapability.ArkUI.ArkUI.Full
 

参数：
 

参数名类型必填说明
valuestring是粘贴的文本内容。
event11+PasteEvent是用户自定义的粘贴事件。


onTextSelectionChange10+
 

onTextSelectionChange(callback: (selectionStart: number, selectionEnd: number) => void)
 

文本选择的位置发生变化或编辑状态下光标位置发生变化时，触发该回调。
 

元服务API： 从API version 11开始，该接口支持在元服务中使用。
 

系统能力： SystemCapability.ArkUI.ArkUI.Full
 

参数：
 

参数名类型必填说明
selectionStartnumber是文本选择区域起始位置，文本框中文字的起始位置为0。
selectionEndnumber是文本选择区域结束位置。


onContentScroll10+
 

onContentScroll(callback: (totalOffsetX: number, totalOffsetY: number) => void)
 

文本内容滚动时，触发该回调。
 

元服务API： 从API version 11开始，该接口支持在元服务中使用。
 

系统能力： SystemCapability.ArkUI.ArkUI.Full
 

参数：
 

参数名类型必填说明
totalOffsetXnumber是文本在内容区的横坐标偏移，单位px。
totalOffsetYnumber是文本在内容区的纵坐标偏移，单位px。


onEditChange12+
 

onEditChange(callback: Callback< boolean >)
 

输入状态变化时，触发该回调。有光标时为编辑态，无光标时为非编辑态。isEditing为true表示正在输入。
 

元服务API： 从API version 12开始，该接口支持在元服务中使用。
 

系统能力： SystemCapability.ArkUI.ArkUI.Full
 

参数：
 

参数名类型必填说明
isEditingCallback< boolean >是为true表示正在输入。


onWillInsert12+
 

onWillInsert(callback: Callback<InsertValue, boolean>)
 

在将要输入时，触发该回调。
 

元服务API： 从API version 12开始，该接口支持在元服务中使用。
 

系统能力： SystemCapability.ArkUI.ArkUI.Full
 

参数：
 

参数名类型必填说明
callbackCallback<InsertValue, boolean>是 
在将要输入时调用的回调。
 
在返回true时，表示正常插入，返回false时，表示不插入。
 
在预上屏操作时，该回调不触发。
 
仅支持系统输入法输入的场景。
 


onDidInsert12+
 

onDidInsert(callback: Callback<InsertValue>)
 

在输入完成时，触发该回调。
 

元服务API： 从API version 12开始，该接口支持在元服务中使用。
 

系统能力： SystemCapability.ArkUI.ArkUI.Full
 

参数：
 

参数名类型必填说明
callbackCallback<InsertValue>是 
在输入完成时调用的回调。
 
仅支持系统输入法输入的场景。
 


onWillDelete12+
 

onWillDelete(callback: Callback<DeleteValue, boolean>)
 

在将要删除时，触发该回调。
 

元服务API： 从API version 12开始，该接口支持在元服务中使用。
 

系统能力： SystemCapability.ArkUI.ArkUI.Full
 

参数：
 

参数名类型必填说明
callbackCallback<DeleteValue, boolean>是 
在将要删除时调用的回调。
 
在返回true时，表示正常删除，返回false时，表示不删除。
 
在预上屏删除操作时，该回调不触发。
 
仅支持系统输入法输入的场景。
 


onDidDelete12+
 

onDidDelete(callback: Callback<DeleteValue>)
 

在删除完成时，触发该回调。
 

元服务API： 从API version 12开始，该接口支持在元服务中使用。
 

系统能力： SystemCapability.ArkUI.ArkUI.Full
 

参数：
 

参数名类型必填说明
callbackCallback<DeleteValue>是 
在删除完成时调用的回调。
 
仅支持系统输入法输入的场景。
 


SearchController
 

Search组件的控制器继承自TextContentControllerBase。
 

导入对象
 

controller: SearchController = new SearchController()
 

constructor8+
 

constructor()
 

SearchController的构造函数。
 

元服务API： 从API version 11开始，该接口支持在元服务中使用。
 

系统能力： SystemCapability.ArkUI.ArkUI.Full
 

caretPosition8+
 

caretPosition(value: number): void
 

设置输入光标的位置。
 

元服务API： 从API version 11开始，该接口支持在元服务中使用。
 

系统能力： SystemCapability.ArkUI.ArkUI.Full
 

参数:
 

参数名类型必填说明
valuenumber是从字符串开始到光标所在位置的长度。


stopEditing10+
 

stopEditing(): void
 

退出编辑态。
 

元服务API： 从API version 11开始，该接口支持在元服务中使用。
 

系统能力： SystemCapability.ArkUI.ArkUI.Full
 

setTextSelection12+
 

setTextSelection(selectionStart: number, selectionEnd: number, options?: SelectionOptions): void;
 

组件在获焦状态下，调用该接口设置文本选择区域并高亮显示，且只有在selectionStart小于selectionEnd时，文字才会被选取、高亮显示。
 

元服务API： 从API version 12开始，该接口支持在元服务中使用。
 

系统能力： SystemCapability.ArkUI.ArkUI.Full
 

参数：
 

参数名类型必填说明
selectionStartnumber是 
文本选择区域起始位置，文本框中文字的起始位置为0。
 
当selectionStart小于0时、按照0处理；当selectionStart大于文字最大长度时、按照文字最大长度处理。
 
selectionEndnumber是 
文本选择区域结束位置。
 
当selectionEnd小于0时、按照0处理；当selectionEnd大于文字最大长度时、按照文字最大长度处理。
 
optionsSelectionOptions否 
选中文字时的配置。
 
默认值：MenuPolicy.DEFAULT。
 


 
 
说明
 
 
如果selectionStart或selectionEnd被赋值为undefined时，当作0处理。
 
 
如果selectionMenuHidden被赋值为true或设备为2in1时，即使options被赋值为MenuPolicy.SHOW，调用setTextSelection也不弹出菜单。
 
 
如果选中的文本含有emoji表情时，表情的起始位置包含在设置的文本选中区域内就会被选中。
 

 

示例
 

示例1（设置与获取光标位置）
 

该示例通过controller实现了光标位置的设置与获取的功能。
 

// xxx.ets
@Entry
@Component
struct SearchExample {
  @State changeValue: string = ''
  @State submitValue: string = ''
  @State positionInfo: CaretOffset = { index: 0, x: 0, y: 0 }
  controller: SearchController = new SearchController()

  build() {
    Column({space: 10}) {
      Text('onSubmit:' + this.submitValue).fontSize(18).margin(15)
      Text('onChange:' + this.changeValue).fontSize(18).margin(15)
      Search({ value: this.changeValue, placeholder: 'Type to search...', controller: this.controller })
        .searchButton('SEARCH')
        .width('95%')
        .height(40)
        .backgroundColor('#F5F5F5')
        .placeholderColor(Color.Grey)
        .placeholderFont({ size: 14, weight: 400 })
        .textFont({ size: 14, weight: 400 })
        .onSubmit((value: string) => {
          this.submitValue = value
        })
        .onChange((value: string) => {
          this.changeValue = value
        })
        .margin(20)
      Button('Set caretPosition 1')
        .onClick(() => {
          // 设置光标位置到输入的第一个字符后
          this.controller.caretPosition(1)
        })
      Button('Get CaretOffset')
        .onClick(() => {
          this.positionInfo = this.controller.getCaretOffset()
        })
    }.width('100%')
  }
}
 

 

 

示例2（设置搜索和删除图标）
 

该示例通过searchButton、searchIcon、cancelButton属性展示了设置搜索和删除图标的效果。
 

// xxx.ets
@Entry
@Component
struct SearchExample {
  @State changeValue: string = ''
  @State submitValue: string = ''

  build() {
    Column() {
      Text('onSubmit:' + this.submitValue).fontSize(18).margin(15)
      Search({ value: this.changeValue, placeholder: 'Type to search...' })
        .searchButton('SEARCH')
        .searchIcon({
          src: $r('app.media.search')
        })
        .cancelButton({
          style: CancelButtonStyle.CONSTANT,
          icon: {
            src: $r('app.media.cancel')
          }
        })
        .width('90%')
        .height(40)
        .maxLength(20)
        .backgroundColor('#F5F5F5')
        .placeholderColor(Color.Grey)
        .placeholderFont({ size: 14, weight: 400 })
        .textFont({ size: 14, weight: 400 })
        .onSubmit((value: string) => {
          this.submitValue = value
        })
        .onChange((value: string) => {
          this.changeValue = value
        })
        .margin(20)
    }.width('100%')
  }
}
 

 

 

示例3（设置自定义键盘）
 

该示例通过customKeyboard属性实现了自定义键盘的功能。
 

// xxx.ets
@Entry
@Component
struct SearchExample {
  controller: SearchController = new SearchController()
  @State inputValue: string = ""

  // 自定义键盘组件
  @Builder CustomKeyboardBuilder() {
    Column() {
      Button('x').onClick(() => {
        // 关闭自定义键盘
        this.controller.stopEditing()
      })
      Grid() {
        ForEach([1, 2, 3, 4, 5, 6, 7, 8, 9, '*', 0, '#'], (item: number | string) => {
          GridItem() {
            Button(item + "")
              .width(110).onClick(() => {
              this.inputValue += item
            })
          }
        })
      }.maxCount(3).columnsGap(10).rowsGap(10).padding(5)
    }.backgroundColor(Color.Gray)
  }

  build() {
    Column() {
      Search({ controller: this.controller, value: this.inputValue})
        // 绑定自定义键盘
        .customKeyboard(this.CustomKeyboardBuilder()).margin(10).border({ width: 1 })
    }
  }
}
 

 

 

示例4（设置输入法回车键类型）
 

该示例通过enterKeyType属性实现了动态切换输入法回车键的效果。
 

// xxx.ets
@Entry
@Component
struct SearchExample {
  @State text: string = ''
  @State enterTypes: Array<EnterKeyType> = [EnterKeyType.Go, EnterKeyType.Search, EnterKeyType.Send, EnterKeyType.Done, EnterKeyType.Next, EnterKeyType.PREVIOUS, EnterKeyType.NEW_LINE]
  @State index: number = 0
  build() {
    Column({ space: 20 }) {
      Search({ placeholder: '请输入文本', value: this.text })
        .width(380)
        .enterKeyType(this.enterTypes[this.index])
        .onChange((value: string) => {
          this.text = value
        })
        .onSubmit((value: String) => {
          console.log("trigger search onsubmit" + value);
        })

      Button('改变EnterKeyType').onClick(() => {
        this.index = (this.index + 1) % this.enterTypes.length;
      })
    }.width('100%')
  }
}
 

 

 

示例5（设置文本样式）
 

该示例通过lineHeight、letterSpacing、decoration属性展示了不同样式的文本效果。
 

// xxx.ets
@Entry
@Component
struct SearchExample {
  build() {
    Row() {
      Column() {
        Text('lineHeight').fontSize(9).fontColor(0xCCCCCC)
        Search({value: 'lineHeight unset'})
          .border({ width: 1 }).padding(10)
        Search({value: 'lineHeight 15'})
          .border({ width: 1 }).padding(10).lineHeight(15)
        Search({value: 'lineHeight 30'})
          .border({ width: 1 }).padding(10).lineHeight(30)

        Text('letterSpacing').fontSize(9).fontColor(0xCCCCCC)
        Search({value: 'letterSpacing 0'})
          .border({ width: 1 }).padding(5).letterSpacing(0)
        Search({value: 'letterSpacing 3'})
          .border({ width: 1 }).padding(5).letterSpacing(3)
        Search({value: 'letterSpacing -1'})
          .border({ width: 1 }).padding(5).letterSpacing(-1)

        Text('decoration').fontSize(9).fontColor(0xCCCCCC)
        Search({value: 'LineThrough, Red'})
          .border({ width: 1 }).padding(5)
          .decoration({type: TextDecorationType.LineThrough, color: Color.Red})
        Search({value: 'Overline, Red, DOTTED'})
          .border({ width: 1 }).padding(5)
          .decoration({type: TextDecorationType.Overline, color: Color.Red, style: TextDecorationStyle.DOTTED})
        Search({value: 'Underline, Red, WAVY'})
          .border({ width: 1 }).padding(5)
          .decoration({type: TextDecorationType.Underline, color: Color.Red, style: TextDecorationStyle.WAVY})
      }.height('90%')
    }
    .width('90%')
    .margin(10)
  }
}
 

 

 

示例6（设置文字特性效果）
 

该示例通过fontFeature属性实现了文本在不同文字特性下的展示效果。
 

// xxx.ets
@Entry
@Component
struct SearchExample {
  @State text1: string = 'This is ss01 on : 0123456789'
  @State text2: string = 'This is ss01 off: 0123456789'

  build() {
    Column(){
      Search({value: this.text1})
        .margin({top:200})
        .fontFeature("\"ss01\" on")
      Search({value: this.text2})
        .margin({top:10})
        .fontFeature("\"ss01\" off")
    }
    .width("90%")
    .margin("5%")
  }
}
 

 

 

示例7（自定义键盘避让）
 

该示例通过自定义键盘实现了键盘避让的功能。
 

// xxx.ets
@Entry
@Component
struct SearchExample {
  controller: SearchController = new SearchController()
  @State inputValue: string = ""
  @State height1: string | number = '80%'
  @State supportAvoidance: boolean = true

  // 自定义键盘组件
  @Builder
  CustomKeyboardBuilder() {
    Column() {
      Row() {
        Button('x').onClick(() => {
          // 关闭自定义键盘
          this.controller.stopEditing()
        }).margin(10)
      }

      Grid() {
        ForEach([1, 2, 3, 4, 5, 6, 7, 8, 9, '*', 0, '#'], (item: number | string) => {
          GridItem() {
            Button(item + "")
              .width(110).onClick(() => {
              this.inputValue += item
            })
          }
        })
      }.maxCount(3).columnsGap(10).rowsGap(10).padding(5)
    }
    .backgroundColor(Color.Gray)
  }

  build() {
    Column() {
      Row() {
        Button("20%")
          .fontSize(24)
          .onClick(() => {
            this.height1 = "20%"
          })
        Button("80%")
          .fontSize(24)
          .margin({ left: 20 })
          .onClick(() => {
            this.height1 = "80%"
          })
      }
      .justifyContent(FlexAlign.Center)
      .alignItems(VerticalAlign.Bottom)
      .height(this.height1)
      .width("100%")
      .padding({ bottom: 50 })

      Search({ controller: this.controller, value: this.inputValue })// 绑定自定义键盘
        .customKeyboard(this.CustomKeyboardBuilder(), { supportAvoidance: this.supportAvoidance })
        .margin(10)
        .border({ width: 1 })
        .onChange((value: string) => {
          this.inputValue = value
        })
    }
  }
}
 

 

 

示例8（设置文本自适应）
 

该示例通过minFontSize、maxFontSize属性展示了文本自适应字号的效果。
 

// xxx.ets
@Entry
@Component
struct SearchExample {
  build() {
    Row() {
      Column() {
        Text('adaptive font').fontSize(9).fontColor(0xCCCCCC)

        Search({value: 'This is the text without the adaptive font'})
          .width('80%').height(90).borderWidth(1)
        Search({value: 'This is the text without the adaptive font'})
          .width('80%').height(90).borderWidth(1)
          .minFontSize(4)
          .maxFontSize(40)
      }.height('90%')
    }
    .width('90%')
    .margin(10)
  }
}
 

 

 

示例9（支持插入和删除回调）
 

该示例通过onWillInsert、onDidInsert、onWillDelete、onDidDelete接口实现了插入和删除的功能。
 

// xxx.ets
@Entry
@Component
struct SearchExample {
  @State insertValue: string = ""
  @State deleteValue: string = ""
  @State insertOffset: number = 0
  @State deleteOffset: number = 0
  @State deleteDirection: number = 0

  build() {
    Row() {
      Column() {
        Search({ value: "Search支持插入回调文本" })
          .height(60)
          .onWillInsert((info: InsertValue) => {
            this.insertValue = info.insertValue
            return true;
          })
          .onDidInsert((info: InsertValue) => {
            this.insertOffset = info.insertOffset
          })

        Text("insertValue:" + this.insertValue + "  insertOffset:" + this.insertOffset).height(30)

        Search({ value: "Search支持删除回调文本b" })
          .height(60)
          .onWillDelete((info: DeleteValue) => {
            this.deleteValue = info.deleteValue
            info.direction
            return true;
          })
          .onDidDelete((info: DeleteValue) => {
            this.deleteOffset = info.deleteOffset
            this.deleteDirection = info.direction
          })

        Text("deleteValue:" + this.deleteValue + "  deleteOffset:" + this.deleteOffset).height(30)
        Text("deleteDirection:" + (this.deleteDirection == 0 ? "BACKWARD" : "FORWARD")).height(30)

      }.width('100%')
    }
    .height('100%')
  }
}
 

 

 

示例10（文本扩展自定义菜单）
 

该示例通过editMenuOptions接口实现了文本设置自定义菜单扩展项的文本内容、图标以及回调的功能。
 

// xxx.ets
@Entry
@Component
struct SearchExample {
  @State text: string = 'Search editMenuOptions'
  onCreateMenu = (menuItems: Array<TextMenuItem>) => {
    let item1: TextMenuItem = {
      content: 'custom1',
      icon: $r('app.media.startIcon'),
      id: TextMenuItemId.of('custom1'),
    }
    let item2: TextMenuItem = {
      content: 'custom2',
      id: TextMenuItemId.of('custom2'),
      icon: $r('app.media.startIcon'),
    }
    menuItems.push(item1)
    menuItems.unshift(item2)
    return menuItems
  }
  onMenuItemClick = (menuItem: TextMenuItem, textRange: TextRange) => {
    if (menuItem.id.equals(TextMenuItemId.of("custom2"))) {
      console.log("拦截 id: custom2 start:" + textRange.start + "; end:" + textRange.end)
      return true
    }
    if (menuItem.id.equals(TextMenuItemId.COPY)) {
      console.log("拦截 COPY start:" + textRange.start + "; end:" + textRange.end)
      return true
    }
    if (menuItem.id.equals(TextMenuItemId.SELECT_ALL)) {
      console.log("不拦截 SELECT_ALL start:" + textRange.start + "; end:" + textRange.end)
      return false
    }
    return false
  }
  @State editMenuOptions: EditMenuOptions = {
    onCreateMenu: this.onCreateMenu, onMenuItemClick: this.onMenuItemClick
  }

  build() {
    Column() {
      Search({ value: this.text })
        .width('95%')
        .editMenuOptions(this.editMenuOptions)
        .margin({ top: 100 })
    }
    .width("90%")
    .margin("5%")
  }
}
 

 

 

示例11（设置symbol类型清除按钮）
 

该示例通过searchIcon、cancelButton属性展示了自定义右侧symbol类型清除按钮样式的效果。
 

// xxx.ets
import { SymbolGlyphModifier } from '@kit.ArkUI'

@Entry
@Component
struct SearchExample {
  controller: SearchController = new SearchController()
  @State changeValue: string = ''
  @State submitValue: string = ''

  build() {
    Column() {
      Search({ value: this.changeValue, placeholder: 'Type to search...', controller: this.controller })
        .searchIcon(new SymbolGlyphModifier($r('sys.symbol.magnifyingglass')).fontColor([Color.Red]))
        .cancelButton({
          style: CancelButtonStyle.CONSTANT,
          icon: new SymbolGlyphModifier($r('sys.symbol.xmark')).fontColor([Color.Green])
        })
        .searchButton('SEARCH')
        .width('95%')
        .height(40)
        .backgroundColor('#F5F5F5')
        .placeholderColor(Color.Grey)
        .placeholderFont({ size: 14, weight: 400 })
        .textFont({ size: 14, weight: 400 })
        .margin(10)
    }
    .width('100%')
    .height('100%')
  }
}
 

 

 


                

        

         

    


  



    



                



	

		

			

				
					
鸿蒙5.0版开发：ArkTS基础组件（Search）

				
			

			

				

					m0_69424697的博客
				

				

					09-19
					
					1863
					
				

			

		

		

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

			
		

	



                

            
              



	

		

			

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

				
			

			

				

					2401_82772199的博客
				

				

					06-29
					
					1690
					
				

			

		

		

			
				
搜索框组件，适用于浏览器的搜索内容输入框等应用场景。该组件从API Version 8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。

			
		

	



              


  
              

                


	

		

			

				
					
鸿蒙Harmony应用开发—ArkTS声明式开发（基础手势：Search）

				
			

			

				

					m0_64420071的博客
				

				

					03-12
					
					2008
					
				

			

		

		

			
				
ArkTS声明式开发（基础手势：Search）

			
		

	





	

		

			

				
					
鸿蒙5.0版开发：ArkTS组件-Search

				
			

			

				

					m0_69424697的博客
				

				

					11-12
					
					1111
					
				

			

		

		

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

			
		

	



		

			
		



	

		

			

				
					
OpenHarmony 3.1 Beta版本关键特性解析——探秘隐式查询

				
			

			

				

					OpenHarmony_dev的博客
				

				

					03-22
					
					876
					
				

			

		

		

			
				
（以下内容来自开发者分享，不代表 OpenHarmony 项目群工作委员会观点）





徐浩



隐式查询是 OpenAtom OpenHarmony（以下简称“OpenHarmony”）的一个基础能力，被广泛应用于各种应用中（如视频播放、阅读器播放等）。应用通过隐式查询可以借助其他应用提供的能力，从而减少开发者工作量，同时给用户带来更好的体验。



那么隐式查询是什么？隐式查询是如何实现的？等等一连串疑问想必是开发者们最关心的问题，本期将对这些问题进行详细的解答。



一、什么是隐式查询？

.

			
		

	





	

		

			

				
					
鸿蒙5.0版开发：ArkTS组件-基础组件（NavRouter）

				
			

			

				

					m0_69424697的博客
				

				

					09-14
					
					1038
					
				

			

		

		

			
				
导航组件，默认提供点击响应处理，不需要开发者自定义点击事件逻辑。

			
		

	





	

		

			

				
					
鸿蒙5.0进阶开发：UI开发-构建自定义组件

				
			

			

				

					AyomQAQ的博客
				

				

					12-30
					
					1021
					
				

			

		

		

			
				
ArkUI开发框架在NDK接口提供了自定义UI组件的能力，这些能力包括自定义测算，自定义布局和自定义绘制。

			
		

	





	

		

			

				
					
鸿蒙5.0版开发：ArkTS组件-Marquee

				
			

			

				

					m0_69424697的博客
				

				

					11-17
					
					978
					
				

			

		

		

			
				
跑马灯组件，用于滚动展示一段单行文本。

			
		

	





	

		

			

				
					
鸿蒙5.0进阶开发：UI开发-容器组件（toolbar开发）

				
			

			

				

					AyomQAQ的博客
				

				

					01-07
					
					349
					
				

			

		

		

			
				
toolbar为页面工具栏组件，用于展示针对当前界面的操作选项，可作为页面的一级导航。

			
		

	





	

		

			

				
					
鸿蒙5.0进阶开发：ArkWeb框架-解决Web组件本地资源跨域问题

				
			

			

				

					AyomQAQ的博客
				

				

					01-15
					
					930
					
				

			

		

		

			
				
为了提高安全性，ArkWeb内核不允许file协议或者resource协议访问URL上下文中来自跨域的请求。

			
		

	





	

		

			

				
					
rk3568 OpenHarmony4.0如何使用中文输入法

				
			

			

				

					Devlin_的博客
				

				

					04-30
					
					2468
					
				

			

		

		

			
				
问题：rk3568开发板 OpenHarmony4.0release系统自带输入法kikaInput软件只有英文输入，不含中文输入，不方便。本文基于rk3568开发板 OpenHarmony4.0release移植了laval社区发布的开发者手机中的搜狗输入法（测试版），实现了中文输入，为OpenHarmony4.0release的其他开发板中文输入提供参考。

			
		

	





	

		

			

				
					
rk3568 OpenHarmony4.0中文输入法使用教程

				
			

			

				

					gitblog_06725的博客
				

				

					05-02
					
					390
					
				

			

		

		

			
				
rk3568 OpenHarmony4.0中文输入法使用教程

    
        
            【下载地址】rk3568OpenHarmony4.0中文输入法使用教程
            探索rk3568 OpenHarmony4.0中文输入法的便捷使用教程，助您轻松掌握汉字输入技巧。本教程详细介绍了输入法的启用、设置及高效使用方法，同时提供常见问题的解决方案，全面提升您在...

			
		

	





	

		

			

				
					
rk3568 OpenHarmony4.0中文输入法使用教程：轻松输入汉字，提升办公效率

				
			

			

				

					gitblog_06733的博客
				

				

					05-27
					
					336
					
				

			

		

		

			
				
rk3568 OpenHarmony4.0中文输入法使用教程：轻松输入汉字，提升办公效率

    
        
            【下载地址】rk3568OpenHarmony4.0中文输入法使用教程
            探索rk3568 OpenHarmony4.0中文输入法的便捷使用教程，助您轻松掌握汉字输入技巧。本教程详细介绍了输入法的启用、设置及高效使用方法，同时提供常见...

			
		

	





	

		

			

				
					
OpenHarmony实战开发-如何实现文本输入 (TextInput/TextArea)

				
			

			

				

					m0_70749039的博客
				

				

					04-27
					
					1460
					
				

			

		

		

			
				
TextInput、TextArea是输入框组件，通常用于响应用户的输入操作，比如评论区的输入、聊天框的输入、表格的输入等，也可以结合其它组件构建功能页面，例如登录注册页面。

			
		

	





	

		

			

				
					
开源中文输入法

				
			

			

				

					weixin_30410999的博客
				

				

					12-27
					
					1549
					
				

			

		

		

			
				
github上的本文地址
开源中文输入法
在Windows上面中文拼音输入法数不胜数。简单数了一下自己用过，就有六种以上：

智能ABC
微软拼音
紫光拼音
搜狗输入法
谷歌输入法
QQ输入法
......

可参考wikipedia 中文输入法列表，以及小众软件 我最喜欢的《拼音输入法》。在手机端各种拼音输入法种类更多。
而在Unix和Linux平台上也存在不少中文输入...

			
		

	





	

		

			

				
					
鸿蒙OpenHarmony【@ohos.inputMethod.Panel (输入法面板)】ArkTS API

				
			

			

				

					hhhhhh2323的博客
				

				

					12-23
					
					246
					
				

			

		

		

			
				
本模块提供对输入法面板的属性管理。

			
		

	





	

		

			

				
					
鸿蒙 harmonyos arkts 的Search组件如何默认获取焦点弹出键盘

				
			

			

				

					yuanlaile的博客
				

				

					03-27
					
					1162
					
				

			

		

		

			
				
鸿蒙 harmonyos arkts 的Search组件如何默认获取焦点弹出键盘呢？思路很简单，刚进来的时候模拟点击弹出键盘。

			
		

	





	

		

			

				
					
鸿蒙5.0版开发：ArkTS基础组件（TextArea）

				
			

			

				

					m0_69424697的博客
				

				

					09-21
					
					1819
					
				

			

		

		

			
				
多行文本输入框组件，当输入的文本内容超过组件宽度时会自动换行显示。

			
		

	





	

		

			

				
					
OpenHarmony实战开发-如何实现一个输入法应用

				
			

			

				

					m0_70749039的博客
				

				

					05-15
					
					1182
					
				

			

		

		

			
				
InputMethodExtensionAbility提供了onCreate()和onDestroy()生命周期回调，根据需要重写对应的回调方法。InputMethodExtensionAbility的生命周期如下：

			
		

	





	

		

			

				
					
鸿蒙5.0版开发：ArkTS组件通用属性（触摸热区设置）

					
最新发布

				
			

			

				

					08-21
				

			

		

		

			
				
在 HarmonyOS 5.0 的 ArkTS 组件中，设置触摸热区（Touch Area）属性可以通过组件的 `touchable` 和 `hitTestBehavior` 等属性来实现。这些属性允许开发者定义组件响应触摸事件的区域和行为。

### 配置触摸热区属性

#### 1. `touchable` 属性
`touchable` 属性用于控制组件是否可以响应触摸事件。设置为 `true` 时，组件将可以响应触摸事件；设置为 `false` 时，组件将忽略所有触摸事件。

```ts
@Component
struct MyComponent {
  build() {
    Column() {
      Text('Click Me')
        .fontSize(30)
        .touchable(true)
    }
    .width('100%')
    .height(100)
  }
}
```

#### 2. `hitTestBehavior` 属性
`hitTestBehavior` 属性用于定义组件在命中测试（Hit Test）中的行为。它有以下几种取值：
- `HitTestBehavior.self`: 组件仅在其自身的区域内响应触摸事件。
- `HitTestBehavior.none`: 组件不响应任何触摸事件。
- `HitTestBehavior.default`: 组件按照默认行为响应触摸事件。

```ts
@Component
struct MyComponent {
  build() {
    Column() {
      Text('Click Me')
        .fontSize(30)
        .hitTestBehavior(HitTestBehavior.self)
    }
    .width('100%')
    .height(100)
  }
}
```

#### 3. 自定义触摸热区
如果需要更复杂的触摸热区配置，可以通过自定义组件的 `onTouch` 事件来实现。通过监听触摸事件，开发者可以自定义组件的响应逻辑。

```ts
@Component
struct MyComponent {
  @State message: string = 'Touch Me'

  build() {
    Column() {
      Text(this.message)
        .fontSize(30)
        .onTouch((event: TouchEvent) => {
          if (event.type === TouchType.Down) {
            this.message = 'Touched Down'
          } else if (event.type === TouchType.Up) {
            this.message = 'Touched Up'
          }
        })
    }
    .width('100%')
    .height(100)
  }
}
```

### 注意事项
- **性能优化**：在设置触摸热区时，应避免不必要的复杂逻辑，以确保应用的响应速度和性能。
- **交互设计**：触摸热区的设计应符合用户习惯，避免过于敏感或响应区域过小的问题。

通过以上方法，开发者可以灵活地配置 ArkTS 组件的触摸热区属性，以满足不同的交互需求。



			
		

	



              




          




        



    





    



      

      

        
      

      





	

		评论	
	

  

	
    

      

      

      

        
        

          
          

            

              成就一亿技术人!
            

            

              拼手气红包6.0元
            

          

        

        

          

            还能输入1000个字符
          

          

             
          

          

            

              红包
              添加红包
            

            

              表情包
              插入表情
              

                

              

            

            

              表情包
              代码片
              

                
              

            

            

              
              
              
              
              
              
              
            

          

        

      

    

		

			

			

			

					 条评论被折叠 查看
			

			

				
			

		

	

	




  

    

      添加红包
      
    

    

      

        
        

          
          
        

        
请填写红包祝福语或标题

      

      

        
        

          
          个
        

        
红包个数最小为10个

      

      

        
        

          
          元
        

        
红包金额最低5元

      

      

        
        

          当前余额3.43元
          前往充值 >
        

      

      

        

          需支付：10.00元
        

        
        
      

    

  





  

    
    
  

  

    
    
  








  

    

      

        

          

            
            
成就一亿技术人!

          

          

        

        

          

          

            领取后你会自动成为博主和红包主的粉丝
            规则
          

        

      

      

        

          

            
              
            
            

              
hope_wisdom
 发出的红包
            

          

        

        

          

          

          

        

      

    

    

  



      
      

      
实付元

      
使用余额支付

      

        

          

            
            点击重新获取
          

        

        
扫码支付

      

      

        
          
            
          
          
        
      

      

        
        钱包余额
          0
          

            
            

              

                
抵扣说明：

                
 1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
 2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

              

            

          

      

      余额充值