openharmony 鸿蒙 capi-native-node-h-nodeattributetype-textinputcategory

2026-08-25 浏览 (1)

ArkUI_NodeAttributeType(文本输入类组件相关属性)

enum ArkUI_NodeAttributeType

概述

定义ArkUI在Native侧可以设置的文本输入类组件相关属性样式集合,包含TextInput、TextArea组件属性设置。

起始版本: 12

相关模块: ArkUI_NativeModule

所在头文件: native_node.h

NODE_TEXT_INPUT_PLACEHOLDER

NODE_TEXT_INPUT_PLACEHOLDER = MAX_NODE_SCOPE_NUM * ARKUI_NODE_TEXT_INPUT = 7000

单行文本输入框的默认提示文本内容属性,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.string默认提示文本的内容。

返回:

类型说明
.string默认提示文本的内容。

NODE_TEXT_INPUT_TEXT

NODE_TEXT_INPUT_TEXT = 7001

单行文本输入框的默认文本内容属性,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.string默认文本的内容。

返回:

类型说明
.string默认文本的内容。

NODE_TEXT_INPUT_CARET_COLOR

NODE_TEXT_INPUT_CARET_COLOR = 7002

光标颜色属性,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].u32光标颜色数值,0xargb格式,形如 0xFFFF0000 表示红色。

返回:

类型说明
.value[0].u32光标颜色数值,0xargb格式。

NODE_TEXT_INPUT_CARET_STYLE

NODE_TEXT_INPUT_CARET_STYLE = 7003

光标风格属性,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].f32光标宽度数值,单位为vp。

返回:

类型说明
.value[0].f32光标宽度数值,单位为vp。

NODE_TEXT_INPUT_SHOW_UNDERLINE

NODE_TEXT_INPUT_SHOW_UNDERLINE = 7004

单行文本输入框下划线属性,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].i32false表示不展示下划线,true表示展示下划线。

返回:

类型说明
.value[0].i320表示不展示下划线,1表示展示下划线。

NODE_TEXT_INPUT_MAX_LENGTH

NODE_TEXT_INPUT_MAX_LENGTH = 7005

输入框支持的最大文本数属性,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].i32最大文本数的数字,无单位。

返回:

类型说明
.value[0].i32最大文本数的数字。

NODE_TEXT_INPUT_ENTER_KEY_TYPE

NODE_TEXT_INPUT_ENTER_KEY_TYPE = 7006

回车键类型属性,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].i32回车键类型枚举ArkUI_EnterKeyType,默认值为ARKUI_ENTER_KEY_TYPE_DONE。

返回:

类型说明
.value[0].i32回车键类型枚举ArkUI_EnterKeyType

NODE_TEXT_INPUT_PLACEHOLDER_COLOR

NODE_TEXT_INPUT_PLACEHOLDER_COLOR = 7007

无输入时默认提示文本的颜色属性,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].u32颜色数值,0xargb格式,形如 0xFFFF0000 表示红色。

返回:

类型说明
.value[0].u32颜色数值,0xargb格式。

NODE_TEXT_INPUT_PLACEHOLDER_FONT

NODE_TEXT_INPUT_PLACEHOLDER_FONT = 7008

无输入时默认提示文本的字体配置(包括大小、字重、样式、字体列表)属性,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0]?.f32可选字体大小数值,默认值16.0,单位为fp。
.value[1]?.i32可选字体样式ArkUI_FontStyle,默认值为ARKUI_FONT_STYLE_NORMAL。
.value[2]?.i32可选字体粗细样式ArkUI_FontWeight,默认值为ARKUI_FONT_WEIGHT_NORMAL。
?.string字体族内容,多个字体族之间使用逗号分隔,形如“字重;字体族1,字体族2”。

返回:

类型说明
.value[0].f32字体大小数值,单位为fp。
.value[1].i32字体样式ArkUI_FontStyle
.value[2].i32字体粗细样式ArkUI_FontWeight
.string字体族内容,多个字体族之间使用逗号分隔。

NODE_TEXT_INPUT_ENABLE_KEYBOARD_ON_FOCUS

NODE_TEXT_INPUT_ENABLE_KEYBOARD_ON_FOCUS = 7009

聚焦时是否绑定输入法属性,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].i32false表示聚焦不拉起输入法,true表示拉起。

返回:

类型说明
.value[0].i320表示聚焦不拉起输入法,1表示拉起。

NODE_TEXT_INPUT_TYPE

NODE_TEXT_INPUT_TYPE = 7010

输入框的类型属性,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].i32输入框类型枚举ArkUI_TextInputType,默认值为ARKUI_TEXTINPUT_TYPE_NORMAL。

返回:

类型说明
.value[0].i32输入框类型枚举ArkUI_TextInputType

NODE_TEXT_INPUT_SELECTED_BACKGROUND_COLOR

NODE_TEXT_INPUT_SELECTED_BACKGROUND_COLOR = 7011

输入框文本选中时的背景色属性,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].u32颜色数值,0xargb格式,形如 0xFFFF0000 表示红色。

返回:

类型说明
.value[0].u32颜色数值,0xargb格式。

NODE_TEXT_INPUT_SHOW_PASSWORD_ICON

NODE_TEXT_INPUT_SHOW_PASSWORD_ICON = 7012

密码输入模式时是否显示末尾图标属性,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].i32false表示不显示图标,true表示显示图标,默认值为false。

返回:

类型说明
.value[0].i320表示不显示图标,1表示显示图标。

NODE_TEXT_INPUT_EDITING

NODE_TEXT_INPUT_EDITING = 7013

控制单行文本输入框编辑态属性,支持属性设置。
作为属性设置方法参数ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].i32false表示退出编辑态,true表示维持现状。
属性获取方法参数ArkUI_AttributeItem格式:
.value[0].i32false表示退出编辑态,true表示维持现状。

NODE_TEXT_INPUT_CANCEL_BUTTON

NODE_TEXT_INPUT_CANCEL_BUTTON = 7014

单行文本右侧清除按钮样式属性,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].i32按钮样式ArkUI_CancelButtonStyle,默认值为ARKUI_CANCELBUTTON_STYLE_INPUT。
.value[1]?.f32图标大小数值,单位为vp。
.value[2]?.u32按钮图标颜色数值,0xargb格式,形如 0xFFFF0000 表示红色。
?.string按钮图标地址,入参内容为图片本地地址,例如 /pages/icon.png。

返回:

类型说明
.value[0].i32按钮样式ArkUI_CancelButtonStyle
.value[1].f32图标大小数值,单位为vp。
.value[2].u32按钮图标颜色数值,0xargb格式。
.string按钮图标地址。

NODE_TEXT_INPUT_TEXT_SELECTION

NODE_TEXT_INPUT_TEXT_SELECTION = 7015

单行文本设置文本选中并高亮的区域,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].i32选中文本的起始位置。
.value[1].i32选中文本的终止位置。

返回:

类型说明
.value[0].i32选中文本的起始位置。
.value[1].i32选中文本的终止位置。

NODE_TEXT_INPUT_UNDERLINE_COLOR

NODE_TEXT_INPUT_UNDERLINE_COLOR = 7016

开启下划线时,支持配置下划线颜色。主题配置的默认下划线颜色为'0x33182431'。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].u32typing,必填,键入时下划线颜色,0xargb类型。
.value[1].u32normal,必填,非特殊状态时下划线颜色,0xargb类型。
.value[2].u32error,必填,错误时下划线颜色,0xargb类型。
.value[3].u32disable,必填,禁用时下划线颜色,0xargb类型。

返回:

类型说明
.value[0].u32typing,键入时下划线颜色,0xargb类型。
.value[1].u32normal,非特殊状态时下划线颜色,0xargb类型。
.value[2].u32error,错误时下划线颜色,0xargb类型。
.value[3].u32disable,禁用时下划线颜色,0xargb类型。

NODE_TEXT_INPUT_ENABLE_AUTO_FILL

NODE_TEXT_INPUT_ENABLE_AUTO_FILL = 7017

设置是否启用自动填充。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].i32是否启用自动填充,默认值true。
true表示启用,false表示不启用。

返回:

类型说明
.value[0].i32是否启用自动填充。

NODE_TEXT_INPUT_CONTENT_TYPE

NODE_TEXT_INPUT_CONTENT_TYPE = 7018

自动填充类型。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].i32参数类型ArkUI_TextInputContentType

返回:

类型说明
.value[0].i32参数类型ArkUI_TextInputContentType

NODE_TEXT_INPUT_PASSWORD_RULES

NODE_TEXT_INPUT_PASSWORD_RULES = 7019

定义生成密码的规则。在触发自动填充时,所设置的密码规则会透传给密码保险箱,用于新密码的生成。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.string定义生成密码的规则。

返回:

类型说明
.string定义生成密码的规则。

NODE_TEXT_INPUT_SELECT_ALL

NODE_TEXT_INPUT_SELECT_ALL = 7020

设置当初始状态,是否全选文本。不支持内联模式。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].i32是否全选文本,默认值:false。
true表示会全选文本,false表示不会全选文本。

返回:

类型说明
.value[0].i32是否全选文本。

NODE_TEXT_INPUT_INPUT_FILTER

NODE_TEXT_INPUT_INPUT_FILTER = 7021

通过正则表达式设置输入过滤器。匹配表达式的输入允许显示,不匹配的输入将被过滤。单字符输入场景仅支持单字符匹配,多字符输入场景支持字符串匹配,例如粘贴。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.string正则表达式。

返回:

类型说明
.string正则表达式。

NODE_TEXT_INPUT_STYLE

NODE_TEXT_INPUT_STYLE = 7022

设置输入框为默认风格或内联输入风格。内联输入风格只支持输入框类型的枚举ArkUI_TextInputType设置为ARKUI_TEXTINPUT_TYPE_NORMAL。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].i32参数类型ArkUI_TextInputStyle。默认值为ARKUI_TEXTINPUT_STYLE_DEFAULT。

返回:

类型说明
.value[0].i32参数类型ArkUI_TextInputStyle

NODE_TEXT_INPUT_CARET_OFFSET

NODE_TEXT_INPUT_CARET_OFFSET = 7023

设置或获取光标所在位置信息。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。
设置输入光标的位置。
返回当前光标所在位置信息。在当前帧更新光标位置同时调用该接口,该接口不生效。

起始版本: 12

参数:

参数项描述
.value[0].i32从字符串开始到光标所在位置的字符长度。

返回:

类型说明
.value[0].i32光标所在位置的索引值。
.value[1].f32光标相对输入框的x坐标位值。
.value[2].f32光标相对输入框的y坐标位值。

NODE_TEXT_INPUT_CONTENT_RECT

NODE_TEXT_INPUT_CONTENT_RECT = 7024

获取已编辑文本内容区域相对组件的位置和大小。
作为属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

返回:

类型说明
.value[0].f32水平方向横坐标。
.value[1].f32竖直方向纵坐标。
.value[2].f32内容宽度大小。
.value[3].f32内容高度大小。

NODE_TEXT_INPUT_CONTENT_LINE_COUNT

NODE_TEXT_INPUT_CONTENT_LINE_COUNT = 7025

获取已编辑文本内容的行数。
作为属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

返回:

类型说明
.value[0].i32已编辑文本内容行数。

NODE_TEXT_INPUT_SELECTION_MENU_HIDDEN

NODE_TEXT_INPUT_SELECTION_MENU_HIDDEN = 7026

设置长按、双击输入框或者右键输入框时,是否不弹出文本选择菜单,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].i32长按、双击输入框或者右键输入框时,是否不弹出文本选择菜单。默认值false。
设置为true时,单击输入框光标、长按输入框、双击输入框、三击输入框或者右键输入框,隐藏系统文本选择菜单。
设置为false时,显示系统文本选择菜单。

返回:

类型说明
.value[0].i32长按、双击输入框或者右键输入框时,是否不弹出文本选择菜单。

NODE_TEXT_INPUT_BLUR_ON_SUBMIT

NODE_TEXT_INPUT_BLUR_ON_SUBMIT = 7027

设置输入框在submit状态下,触发回车键是否失焦。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].i32是否失焦。默认值true。
false表示触发回车键后不失焦,true表示触发回车键后失焦。

返回:

类型说明
.value[0].i32是否失焦。

NODE_TEXT_INPUT_CUSTOM_KEYBOARD

NODE_TEXT_INPUT_CUSTOM_KEYBOARD = 7028

设置自定义键盘。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.object自定义键盘,参数类型ArkUI_NodeHandle
.value[0]?.i32设置自定义键盘是否支持避让功能,默认值false。
true表示支持避让,false表示不支持避让。

返回:

类型说明
.object自定义键盘,参数类型ArkUI_NodeHandle
.value[0].i32设置自定义键盘是否支持避让功能。

NODE_TEXT_INPUT_WORD_BREAK

NODE_TEXT_INPUT_WORD_BREAK = 7029

文本断行规则属性,仅在内联输入风格编辑态生效,支持属性设置,属性重置,属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].i32参数类型ArkUI_WordBreak。默认值ARKUI_WORD_BREAK_BREAK_WORD。

返回:

类型说明
.value[0].i32参数类型ArkUI_WordBreak

NODE_TEXT_INPUT_SHOW_KEYBOARD_ON_FOCUS

NODE_TEXT_INPUT_SHOW_KEYBOARD_ON_FOCUS = 7030

设置输入框获取焦点时是否弹出键盘,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].i32是否弹出键盘。false表示获取焦点时不弹出键盘,true表示获取焦点时弹出键盘。

返回:

类型说明
.value[0].i32是否弹出键盘。

NODE_TEXT_INPUT_NUMBER_OF_LINES

NODE_TEXT_INPUT_NUMBER_OF_LINES = 7031

设置该属性后,通过该属性计算TextInput组件的高度。 例如:设置numberOfLines为3时,组件将默认显示足够容纳3行文本内容的高度。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].i32设置numberOfLines的值。

返回:

类型说明
.value[0].i32设置numberOfLines的值。

NODE_TEXT_INPUT_LETTER_SPACING

NODE_TEXT_INPUT_LETTER_SPACING = 7032

设置该属性后,通过该属性调整TextInput组件的字符间距。接口支持设置,重置以及获取该属性。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 15

参数:

参数项描述
.value[0].f32设置letterSpacing的值,默认单位fp。

返回:

类型说明
.value[0].f32获取letterSpacing的值,默认单位fp。

NODE_TEXT_INPUT_ENABLE_PREVIEW_TEXT

NODE_TEXT_INPUT_ENABLE_PREVIEW_TEXT = 7033

设置TextInput组件是否开启输入预上屏。接口支持设置,重置以及获取该属性。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 15

参数:

参数项描述
.value[0].i32设置是否开启输入预上屏。默认值true。
false表示不开启输入预上屏,true表示开启输入预上屏。

返回:

类型说明
.value[0].i32获取是否开启输入预上屏。

NODE_TEXT_INPUT_HALF_LEADING

NODE_TEXT_INPUT_HALF_LEADING = 7034

设置文本将行间距平分至行的顶部与底部。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 18

参数:

参数项描述
.value[0].i32设置文本是否将行间距平分至行的顶部与底部。默认值false。
true表示将行间距平分至行的顶部与底部,false表示不平分。

返回:

类型说明
.value[0].i32设置文本是否将行间距平分至行的顶部与底部。

NODE_TEXT_INPUT_KEYBOARD_APPEARANCE

NODE_TEXT_INPUT_KEYBOARD_APPEARANCE = 7035

设置输入框拉起的键盘样式。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 15

参数:

参数项描述
.value[0].i32键盘样式,参数类型ArkUI_KeyboardAppearance

返回:

类型说明
.value[0].i32键盘样式,参数类型ArkUI_KeyboardAppearance。默认值ARKUI_KEYBOARD_APPEARANCE_NONE_IMMERSIVE。

NODE_TEXT_INPUT_ENABLE_FILL_ANIMATION

NODE_TEXT_INPUT_ENABLE_FILL_ANIMATION = 7036

设置是否启用自动填充动效。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 20

参数:

参数项描述
.value[0].i32是否启用自动填充动效。
true表示启用,false表示不启用。
默认值true。

返回:

类型说明
.value[0].i32是否启用自动填充动效。启用之后,仅输入框类型的枚举ArkUI_TextInputType设置为ARKUI_TEXTINPUT_TYPE_PASSWORD、ARKUI_TEXTINPUT_TYPE_NUMBER_PASSWORD或ARKUI_TEXTINPUT_TYPE_NEW_PASSWORD的输入框在进行自动填充时动效可生效。

NODE_TEXT_INPUT_LINE_HEIGHT

NODE_TEXT_INPUT_LINE_HEIGHT = 7037

设置输入框文本的高度,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 20

参数:

参数项描述
.value[0].i32文本的高度的数字。默认值是自适应字体大小。设置为undefined时,文本的高度设置为5。

返回:

类型说明
.value[0].i32文本的高度的数字。

NODE_TEXT_INPUT_ENABLE_SELECTED_DATA_DETECTOR

NODE_TEXT_INPUT_ENABLE_SELECTED_DATA_DETECTOR = 7038

开启选中词文本识别。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 22

参数:

参数项描述
.value[0].i32开启选中词文本识别,true表示开启识别,false表示关闭识别。默认值:true。

返回:

类型说明
.value[0].i32是否开启选中词文本识别。

NODE_TEXT_INPUT_SHOW_COUNTER

NODE_TEXT_INPUT_SHOW_COUNTER = 7040

设置输入的字符数超过阈值时是否显示计数器并设置计数器样式,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 22

参数:

参数项描述
.value[0].i32是否开启计数器。值为true表示开启计数器,值为false表示不开启计数器。
.value[1]?.f32可输入字符数占最大字符限制的百分比值,超过此值时显示计数器,取值范围[1, 100],小数时向下取整,若超出取值范围,则接口属性设置不生效。
.value[2]?.i32输入字符超出限制时高亮边框,true表示高亮边框,false表示为不高亮边框。
.object计数器配置,配置属性为文本输入框未达到最大字符数时计数器的颜色以及超出最大字符数时计数器的颜色。参数类型为 ArkUI_ShowCounterConfig

返回:

类型说明
.value[0].i32是否开启计数器。
.value[1].f32可输入字符数占最大字符限制的百分比值,超过此值时显示计数器,取值范围[1, 100]。
.value[2].i32输入字符超出限制时高亮边框,true表示高亮边框,false表示为不高亮边框,默认高亮。
.object计数器配置,配置属性为文本输入框未达到最大字符数时计数器的颜色以及超出最大字符数时计数器的颜色。参数类型为ArkUI_ShowCounterConfig

NODE_TEXT_INPUT_TEXT_CONTENT_CONTROLLER_BASE

NODE_TEXT_INPUT_TEXT_CONTENT_CONTROLLER_BASE = 7041

用于设置或获取文本输入控制器。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 23

参数:

参数项描述
.object文本内容基础控制器。参数类型为ArkUI_TextContentBaseController

返回:

类型说明
.object文本内容基础控制器。参数类型为ArkUI_TextContentBaseController

NODE_TEXT_INPUT_ELLIPSIS_MODE

NODE_TEXT_INPUT_ELLIPSIS_MODE = 7042

设置单行文本输入框中文本省略位置,支持属性设置,属性重置,属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 24

参数:

参数项描述
.value[0].i32参数类型ArkUI_EllipsisMode。默认值为ARKUI_ELLIPSIS_MODE_END。

返回:

类型说明
.value[0].i32参数类型ArkUI_EllipsisMode

NODE_TEXT_INPUT_ORPHAN_CHAR_OPTIMIZATION

NODE_TEXT_INPUT_ORPHAN_CHAR_OPTIMIZATION = 7043

设置TextInput文本排版时是否使能孤字优化,设置后通过更高效地处理孤立字符(段落尾行首字符)来改善文本布局。使能后,它会调整换行点以尽可能避免孤立字符。孤字优化特性需在ArkUI_WordBreak属性为非ARKUI_WORD_BREAK_BREAK_ALL时生效。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 26.0.0

参数:

参数项描述
.value[0].i32是否使能,true表示使能,false表示不使能。默认值false。

返回:

类型说明
.value[0].i32是否使能孤字优化。

NODE_TEXT_INPUT_COMPRESS_LEADING_PUNCTUATION

NODE_TEXT_INPUT_COMPRESS_LEADING_PUNCTUATION = 7044

设置输入字符行首标点压缩开关,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 23

参数:

参数项描述
.value[0].i32是否打开行首标点压缩开关。
true表示开启行首标点压缩,false表示关闭行首标点压缩。默认值false。

返回:

类型说明
.value[0].i32是否打开行首标点压缩开关。

NODE_TEXT_INPUT_INCLUDE_FONT_PADDING

NODE_TEXT_INPUT_INCLUDE_FONT_PADDING = 7045

设置单行输入框内文字是否在首行顶部和尾行底部增加间距以避免文字截断。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 23

参数:

参数项描述
.value[0].i32设置输入框内文字是否在首行顶部和尾行底部增加间距以避免文字截断。true表示开启增加间距,false表示关闭增加间距。默认值:false。

返回:

类型说明
.value[0].i32是否在首行顶部和尾行底部增加间距。true表示增加间距,false表示不增加间距。

NODE_TEXT_INPUT_FALLBACK_LINE_SPACING

NODE_TEXT_INPUT_FALLBACK_LINE_SPACING = 7046

针对多行文字叠加,支持行高基于文字实际高度自适应。此接口仅当行高小于文字实际高度时生效。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 23

参数:

参数项描述
.value[0].i32支持行高基于文字实际高度自适应。true表示开启自适应,false表示关闭自适应。默认值:false。

返回:

类型说明
.value[0].i32是否开启行高基于文字实际高度自适应。true表示开启自适应,false表示关闭自适应。

NODE_TEXT_INPUT_DIRECTION

NODE_TEXT_INPUT_DIRECTION = 7047

单行输入框的文本排版方向。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 23

参数:

参数项描述
.value[0].i32表示文本的排版方向,取ArkUI_TextDirection枚举值。默认值为ARKUI_TEXT_DIRECTION_DEFAULT。

返回:

类型说明
.value[0].i32表示文本的排版方向,对应取值及含义请参考ArkUI_TextDirection枚举值。

NODE_TEXT_INPUT_SELECTED_DRAG_PREVIEW_STYLE

NODE_TEXT_INPUT_SELECTED_DRAG_PREVIEW_STYLE = 7048

用于设置文本输入框内文本选中状态下的拖拽预览样式。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 23

参数:

参数项描述
.object文本选中状态下的拖拽预览样式。参数类型为ArkUI_SelectedDragPreviewStyle

返回:

类型说明
.object文本选中状态下的拖拽预览样式。参数类型为ArkUI_SelectedDragPreviewStyle

NODE_TEXT_INPUT_TEXT_OVERFLOW

NODE_TEXT_INPUT_TEXT_OVERFLOW = 7049

单行文本输入框中文本超长时的显示方式属性,支持属性设置,属性重置,属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 24

参数:

参数项描述
.value[0].i32表示文本超长时的显示方式ArkUI_TextOverflow。内联模式非编辑态下默认值为ARKUI_TEXT_OVERFLOW_ELLIPSIS,内联模式编辑态下默认值为ARKUI_TEXT_OVERFLOW_CLIP。

返回:

类型说明
.value[0].i32表示文本超长时的显示方式ArkUI_TextOverflow

NODE_TEXT_INPUT_DECORATION

NODE_TEXT_INPUT_DECORATION = 7050

定义单行输入框的文本装饰线样式与颜色,支持属性设置、属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 24

参数:

参数项描述
.object装饰样式配置项,为可选参数。参数类型为OH_ArkUI_DecorationStyleOptions

返回:

类型说明
.object装饰样式配置项。参数类型为OH_ArkUI_DecorationStyleOptions

NODE_TEXT_AREA_PLACEHOLDER

NODE_TEXT_AREA_PLACEHOLDER = MAX_NODE_SCOPE_NUM * ARKUI_NODE_TEXT_AREA = 8000

多行文本输入框的默认提示文本内容属性,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.string默认提示文本的内容。

返回:

类型说明
.string默认提示文本的内容。

NODE_TEXT_AREA_TEXT

NODE_TEXT_AREA_TEXT = 8001

多行文本输入框的默认文本内容属性,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.string默认文本的内容。

返回:

类型说明
.string默认文本的内容。

NODE_TEXT_AREA_MAX_LENGTH

NODE_TEXT_AREA_MAX_LENGTH = 8002

输入框支持的最大文本数属性,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].i32最大文本数的数字。

返回:

类型说明
.value[0].i32最大文本数的数字。

NODE_TEXT_AREA_PLACEHOLDER_COLOR

NODE_TEXT_AREA_PLACEHOLDER_COLOR = 8003

无输入时默认提示文本的颜色属性,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].u32颜色数值,0xargb格式,形如 0xFFFF0000 表示红色。

返回:

类型说明
.value[0].u32颜色数值,0xargb格式。

NODE_TEXT_AREA_PLACEHOLDER_FONT

NODE_TEXT_AREA_PLACEHOLDER_FONT = 8004

无输入时默认提示文本的字体配置(包括大小、字重、样式、字体列表)属性,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0]?.f32可选字体大小数值,默认值16.0,单位为fp。
.value[1]?.i32可选字体样式ArkUI_FontStyle,默认值为ARKUI_FONT_STYLE_NORMAL。
.value[2]?.i32可选字体粗细样式ArkUI_FontWeight,默认值为ARKUI_FONT_WEIGHT_NORMAL。
?.string字体族内容,多个字体族之间使用逗号分隔,形如“字重;字体族1,字体族2”。

返回:

类型说明
.value[0].f32字体大小数值,单位为fp。
.value[1].i32字体样式ArkUI_FontStyle
.value[2].i32字体粗细样式ArkUI_FontWeight
.string字体族内容,多个字体族之间使用逗号分隔。

NODE_TEXT_AREA_CARET_COLOR

NODE_TEXT_AREA_CARET_COLOR = 8005

光标颜色属性,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].u32背景色数值,0xargb格式,形如 0xFFFF0000 表示红色。

返回:

类型说明
.value[0].u32背景色数值,0xargb格式。

NODE_TEXT_AREA_EDITING

NODE_TEXT_AREA_EDITING = 8006

控制多行文本输入框编辑态属性,支持属性设置,属性获取接口。
作为属性设置方法参数ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].i32false表示退出编辑态,true表示维持现状。
属性获取方法参数ArkUI_AttributeItem格式:
.value[0].i32false表示退出编辑态,true表示维持现状。

NODE_TEXT_AREA_TYPE

NODE_TEXT_AREA_TYPE = 8007

输入框的类型属性,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].i32输入框类型枚举ArkUI_TextAreaType,默认值为ARKUI_TEXTAREA_TYPE_NORMAL。

返回:

类型说明
.value[0].i32输入框类型枚举ArkUI_TextAreaType

NODE_TEXT_AREA_SHOW_COUNTER

NODE_TEXT_AREA_SHOW_COUNTER = 8008

设置输入的字符数超过阈值时是否显示计数器并设置计数器样式,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].i32是否开启计数器,值为true时为开启。默认值false。
.value[1]?.f32可输入字符数占最大字符限制的百分比值,超过此值时显示计数器,取值范围[1, 100],小数时向下取整,若超出取值范围,则接口属性设置不生效。
.value[2]?.i32输入字符超出限制时是否高亮边框。true表示高亮边框,false表示不高亮边框。默认值true。
.object计数器配置,配置属性为文本输入框未达到最大字符数时计数器的颜色以及超出最大字符数时计数器的颜色。参数类型为ArkUI_ShowCounterConfig

返回:

类型说明
.value[0].i32是否开启计数器,值为true时开启。
.value[1].f32可输入字符数占最大字符限制的百分比值,超过此值时显示计数器,取值范围[1, 100]。
.value[2].i32输入字符超出限制时是否高亮边框,值为true时高亮边框。
.object计数器配置,配置属性为文本输入框未达到最大字符数时计数器的颜色以及超出最大字符数时计数器的颜色。参数类型为ArkUI_ShowCounterConfig

NODE_TEXT_AREA_SELECTION_MENU_HIDDEN

NODE_TEXT_AREA_SELECTION_MENU_HIDDEN = 8009

设置长按、双击输入框或者右键输入框时,是否不弹出文本选择菜单,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].i32长按、双击输入框或者右键输入框时,是否不弹出文本选择菜单。默认值false。
设置为true时,单击输入框光标、长按输入框、双击输入框、三击输入框或者右键输入框,隐藏系统文本选择菜单。
设置为false时,显示系统文本选择菜单。

返回:

类型说明
.value[0].i32长按、双击输入框或者右键输入框时,是否不弹出文本选择菜单。

NODE_TEXT_AREA_BLUR_ON_SUBMIT

NODE_TEXT_AREA_BLUR_ON_SUBMIT = 8010

设置多行输入框在submit状态下,触发回车键是否失焦。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].i32是否失焦。false表示触发回车键后不失焦,true表示触发回车键后失焦。

返回:

类型说明
.value[0].i32是否失焦。

NODE_TEXT_AREA_INPUT_FILTER

NODE_TEXT_AREA_INPUT_FILTER = 8011

通过正则表达式设置输入过滤器。匹配表达式的输入允许显示,不匹配的输入将被过滤。单字符输入场景仅支持单字符匹配,多字符输入场景支持字符串匹配,例如粘贴。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.string正则表达式。

返回:

类型说明
.string正则表达式。

NODE_TEXT_AREA_SELECTED_BACKGROUND_COLOR

NODE_TEXT_AREA_SELECTED_BACKGROUND_COLOR = 8012

设置文本选中底板颜色,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].u32颜色数值,0xargb格式,形如 0xFFFF0000 表示红色。

返回:

类型说明
.value[0].u32颜色数值,0xargb格式。

NODE_TEXT_AREA_ENTER_KEY_TYPE

NODE_TEXT_AREA_ENTER_KEY_TYPE = 8013

设置输入法回车键类型,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].i32回车键类型枚举ArkUI_EnterKeyType,默认值为ARKUI_ENTER_KEY_TYPE_DONE。

返回:

类型说明
.value[0].i32回车键类型枚举ArkUI_EnterKeyType

NODE_TEXT_AREA_ENABLE_KEYBOARD_ON_FOCUS

NODE_TEXT_AREA_ENABLE_KEYBOARD_ON_FOCUS = 8014

设置TextArea通过点击以外的方式获焦时,是否绑定输入法,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].i32false表示聚焦不拉起输入法,true表示拉起,默认值为true。

返回:

类型说明
.value[0].i320表示聚焦不拉起输入法,1表示拉起。

NODE_TEXT_AREA_CARET_OFFSET

NODE_TEXT_AREA_CARET_OFFSET = 8015

设置或获取光标所在位置信息。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。
设置输入光标的位置。
返回当前光标所在位置信息。在当前帧更新光标位置同时调用该接口,该接口不生效。

起始版本: 12

参数:

参数项描述
.value[0].i32从字符串开始到光标所在位置的字符长度。

返回:

类型说明
.value[0].i32光标所在位置的索引值。
.value[1].f32光标相对输入框的x坐标位值。
.value[2].f32光标相对输入框的y坐标位值。

NODE_TEXT_AREA_CONTENT_RECT

NODE_TEXT_AREA_CONTENT_RECT = 8016

获取已编辑文本内容区域相对组件的位置和大小。
作为属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

返回:

类型说明
.value[0].f32水平方向横坐标。
.value[1].f32竖直方向纵坐标。
.value[2].f32内容宽度大小。
.value[3].f32内容高度大小。

NODE_TEXT_AREA_CONTENT_LINE_COUNT

NODE_TEXT_AREA_CONTENT_LINE_COUNT = 8017

获取已编辑文本内容的行数。
作为属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

返回:

类型说明
.value[0].i32已编辑文本内容行数。

NODE_TEXT_AREA_TEXT_SELECTION

NODE_TEXT_AREA_TEXT_SELECTION = 8018

组件在获焦状态下,调用该接口设置文本选择区域并高亮显示,且只有在selectionStart小于selectionEnd时,文字才会被选取、高亮显示。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].i32选中文本的起始位置。
.value[1].i32选中文本的终止位置。

返回:

类型说明
.value[0].i32选中文本的起始位置。
.value[1].i32选中文本的终止位置。

NODE_TEXT_AREA_ENABLE_AUTO_FILL

NODE_TEXT_AREA_ENABLE_AUTO_FILL = 8019

设置是否启用自动填充。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].i32是否启用自动填充,默认值true。
true表示启用,false表示不启用。

返回:

类型说明
.value[0].i32是否启用自动填充。

NODE_TEXT_AREA_CONTENT_TYPE

NODE_TEXT_AREA_CONTENT_TYPE = 8020

自动填充类型。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].i32参数类型ArkUI_TextInputContentType

返回:

类型说明
.value[0].i32参数类型ArkUI_TextInputContentType

NODE_TEXT_AREA_SHOW_KEYBOARD_ON_FOCUS

NODE_TEXT_AREA_SHOW_KEYBOARD_ON_FOCUS = 8021

设置输入框获取焦点时是否弹出键盘,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].i32是否弹出键盘。默认值true。
false表示获取焦点时不弹出键盘,true表示获取焦点时弹出键盘。

返回:

类型说明
.value[0].i32是否弹出键盘。

NODE_TEXT_AREA_NUMBER_OF_LINES

NODE_TEXT_AREA_NUMBER_OF_LINES = 8022

设置该属性后,通过该属性计算TextArea组件的高度。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].i32设置numberOfLines的值。

返回:

类型说明
.value[0].i32设置numberOfLines的值。

NODE_TEXT_AREA_LETTER_SPACING

NODE_TEXT_AREA_LETTER_SPACING = 8023

设置该属性后,通过该属性调整TextArea组件的字符间距。接口支持设置,重置以及获取该属性。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 15

参数:

参数项描述
.value[0].f32设置letterSpacing的值,默认单位fp。

返回:

类型说明
.value[0].f32获取letterSpacing的值,默认单位fp。

NODE_TEXT_AREA_ENABLE_PREVIEW_TEXT

NODE_TEXT_AREA_ENABLE_PREVIEW_TEXT = 8024

设置TextArea组件是否开启输入预上屏。接口支持设置,重置以及获取该属性。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 15

参数:

参数项描述
.value[0].i32设置是否开启输入预上屏。false表示不开启输入预上屏,true表示开启输入预上屏。

返回:

类型说明
.value[0].i32获取是否开启输入预上屏。

NODE_TEXT_AREA_HALF_LEADING

NODE_TEXT_AREA_HALF_LEADING = 8025

设置文本将行间距平分至行的顶部与底部。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 18

参数:

参数项描述
.value[0].i32设置文本是否将行间距平分至行的顶部与底部。默认值false。
true表示将行间距平分至行的顶部与底部,false表示不平分。

返回:

类型说明
.value[0].i32设置文本是否将行间距平分至行的顶部与底部。

NODE_TEXT_AREA_KEYBOARD_APPEARANCE

NODE_TEXT_AREA_KEYBOARD_APPEARANCE = 8026

设置输入框拉起的键盘样式。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 15

参数:

参数项描述
.value[0].i32键盘样式,参数类型ArkUI_KeyboardAppearance

返回:

类型说明
.value[0].i32键盘样式,参数类型ArkUI_KeyboardAppearance

NODE_TEXT_AREA_MAX_LINES

NODE_TEXT_AREA_MAX_LINES = 8027

设置输入框内联模式编辑态时文本可显示的最大行数,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 20

参数:

参数项描述
.value[0].i32内联输入风格编辑态时文本可显示的最大行数。内联模式下,默认值是3,
非内联模式下,默认值是+∞,不限制最大行数。设置为undefined时,最大行数设置为5。

返回:

类型说明
.value[0].i32最大行数的数字。

NODE_TEXT_AREA_LINE_SPACING

NODE_TEXT_AREA_LINE_SPACING = 8028

设置输入框文本的行间距,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 20

参数:

参数项描述
.value[0].i32文本的行间距的数字。默认值是0,单位fp。设置为undefined时,行间距设置为5。

返回:

类型说明
.value[0].i32文本的行间距的数字,单位fp。

NODE_TEXT_AREA_MIN_LINES

NODE_TEXT_AREA_MIN_LINES = 8029

设置节点的最小行数。支持属性设置、属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 20

参数:

参数项描述
.value[0].f32最小行数的数字。

返回:

类型说明
.value[0].f32最小行数的数字。

NODE_TEXT_AREA_MAX_LINES_WITH_SCROLL

NODE_TEXT_AREA_MAX_LINES_WITH_SCROLL = 8030

设置支持滚动时节点的最大行数。支持属性设置、属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 20

参数:

参数项描述
.value[0].f32支持滚动时的最大行数的数字。

返回:

类型说明
.value[0].f32支持滚动时的最大行数的数字。

NODE_TEXT_AREA_LINE_HEIGHT

NODE_TEXT_AREA_LINE_HEIGHT = 8031

设置输入框文本的高度,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 20

参数:

参数项描述
.value[0].i32文本的高度的数字。默认值是自适应字体大小,单位fp。设置为undefined时,文本的高度设置为5。

返回:

类型说明
.value[0].i32文本的高度的数字,单位fp。

NODE_TEXT_AREA_BAR_STATE

NODE_TEXT_AREA_BAR_STATE = 8032

定义文本输入框滚动条状态。支持属性设置、属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 22

参数:

参数项描述
.value[0].i32文本控制滚动条状态。参数类型为ArkUI_BarState。默认值为ARKUI_BAR_STATE_AUTO。

返回:

类型说明
.value[0].i32文本控制滚动条状态。参数类型为ArkUI_BarState

NODE_TEXT_AREA_ENABLE_SELECTED_DATA_DETECTOR

NODE_TEXT_AREA_ENABLE_SELECTED_DATA_DETECTOR = 8033

开启选中词文本识别。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 22

参数:

参数项描述
.value[0].i32开启选中词文本识别,true表示开启识别,false表示关闭识别。默认值:true。

返回:

类型说明
.value[0].i32是否开启选中词文本识别。

NODE_TEXT_AREA_SCROLL_BAR_COLOR

NODE_TEXT_AREA_SCROLL_BAR_COLOR = 8035

设置输入框滚动条颜色,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 22

参数:

参数项描述
.value[0].u32滚动条颜色数值。0xargb类型。默认值:0x66182431,显示为灰色。

返回:

类型说明
.value[0].u32滚动条颜色数值。

NODE_TEXT_AREA_CUSTOM_KEYBOARD

NODE_TEXT_AREA_CUSTOM_KEYBOARD = 8036

设置文本输入框的自定义键盘。支持属性设置、属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 22

参数:

参数项描述
.object自定义键盘,参数类型ArkUI_NodeHandle
.value[0]?.i32设置自定义键盘是否支持避让功能。
true表示支持避让,false表示不支持避让。
默认值:false。

返回:

类型说明
.object自定义键盘,参数类型ArkUI_NodeHandle
.value[0].i32设置自定义键盘是否支持避让功能。

NODE_TEXT_AREA_TEXT_CONTENT_CONTROLLER_BASE

NODE_TEXT_AREA_TEXT_CONTENT_CONTROLLER_BASE = 8037

用于设置或获取文本区域控制器。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 23

参数:

参数项描述
.object文本内容基础控制器,参数类型为ArkUI_TextContentBaseController

返回:

类型说明
.object文本内容基础控制器,参数类型为ArkUI_TextContentBaseController

NODE_TEXT_AREA_ELLIPSIS_MODE

NODE_TEXT_AREA_ELLIPSIS_MODE = 8038

设置多行文本输入框中文本省略位置,支持属性设置,属性重置,属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 24

参数:

参数项描述
.value[0].i32参数类型ArkUI_EllipsisMode。默认值为ARKUI_ELLIPSIS_MODE_END。

返回:

类型说明
.value[0].i32参数类型ArkUI_EllipsisMode

NODE_TEXT_AREA_ORPHAN_CHAR_OPTIMIZATION

NODE_TEXT_AREA_ORPHAN_CHAR_OPTIMIZATION = 8039

设置TextArea文本排版时是否使能孤字优化,设置后通过更高效地处理孤立字符(段落尾行首字符)来改善文本布局。使能后,它会调整换行点以尽可能避免孤立字符。孤字优化特性需在ArkUI_WordBreak属性为非ARKUI_WORD_BREAK_BREAK_ALL时生效。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 26.0.0

参数:

参数项描述
.value[0].i32是否使能,true表示使能,false表示不使能。默认值false。

返回:

类型说明
.value[0].i32是否使能孤字优化。

NODE_TEXT_AREA_COMPRESS_LEADING_PUNCTUATION

NODE_TEXT_AREA_COMPRESS_LEADING_PUNCTUATION = 8040

设置输入字符行首标点压缩开关,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 23

参数:

参数项描述
.value[0].i32是否打开行首标点压缩开关。
true表示开启行首标点压缩,false表示关闭行首标点压缩。默认值false。

返回:

类型说明
.value[0].i32是否打开行首标点压缩开关。

NODE_TEXT_AREA_INCLUDE_FONT_PADDING

NODE_TEXT_AREA_INCLUDE_FONT_PADDING = 8041

设置多行输入框内文字是否在首行和尾行增加间距以避免文字截断。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 23

参数:

参数项描述
.value[0].i32设置输入框内文字是否在首行和尾行增加间距以避免文字截断。true表示开启增加间距,false表示关闭增加间距。默认值:false。

返回:

类型说明
.value[0].i32输入框内文字是否在首行和尾行增加间距。true表示增加间距,false表示不增加间距。

NODE_TEXT_AREA_FALLBACK_LINE_SPACING

NODE_TEXT_AREA_FALLBACK_LINE_SPACING = 8042

针对多行文字叠加,支持行高基于文字实际高度自适应。此接口仅当行高小于文字实际高度时生效。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 23

参数:

参数项描述
.value[0].i32支持行高基于文字实际高度自适应。true表示开启自适应,false表示关闭自适应。默认值:false。

返回:

类型说明
.value[0].i32是否开启行高基于文字实际高度自适应。true表示开启自适应,false表示关闭自适应。

NODE_TEXT_AREA_HORIZONTAL_SCROLLING

NODE_TEXT_AREA_HORIZONTAL_SCROLLING = 8043

设置多行输入框在文本宽度超过输入框内容区宽度时是否启用水平滚动。默认值为false,文本会被输入框自动换行。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 24

参数:

参数项描述
.value[0].i32是否启用水平滚动。true表示启用水平滚动,false表示不启用水平滚动。

返回:

类型说明
.value[0].i32是否启用水平滚动。

NODE_TEXT_AREA_DIRECTION

NODE_TEXT_AREA_DIRECTION = 8044

多行输入框的文本排版方向。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 23

参数:

参数项描述
.value[0].i32表示文本的排版方向,取ArkUI_TextDirection枚举值。默认值为ARKUI_TEXT_DIRECTION_DEFAULT。

返回:

类型说明
.value[0].i32表示文本的排版方向,对应取值及含义请参考ArkUI_TextDirection枚举值。

NODE_TEXT_AREA_SELECTED_DRAG_PREVIEW_STYLE

NODE_TEXT_AREA_SELECTED_DRAG_PREVIEW_STYLE = 8045

用于设置多行文本输入框内文本选中状态下的拖拽预览样式。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 23

参数:

参数项描述
.object文本选中状态下的拖拽预览样式。参数类型为ArkUI_SelectedDragPreviewStyle

返回:

类型说明
.object文本选中状态下的拖拽预览样式。参数类型为ArkUI_SelectedDragPreviewStyle

NODE_TEXT_AREA_TEXT_OVERFLOW

NODE_TEXT_AREA_TEXT_OVERFLOW = 8046

多行文本输入框中文本超长时的显示方式属性,支持属性设置,属性重置,属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 24

参数:

参数项描述
.value[0].i32表示文本超长时的显示方式ArkUI_TextOverflow。默认值为ARKUI_TEXT_OVERFLOW_CLIP。

返回:

类型说明
.value[0].i32表示文本超长时的显示方式ArkUI_TextOverflow

NODE_TEXT_AREA_DECORATION

NODE_TEXT_AREA_DECORATION = 8047

定义多行输入框的文本装饰线样式与颜色,支持属性设置、属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 24

参数:

参数项描述
.object装饰样式配置项,为可选参数。参数类型为OH_ArkUI_DecorationStyleOptions

返回:

类型说明
.object装饰样式配置项。参数类型为OH_ArkUI_DecorationStyleOptions

你可能感兴趣的鸿蒙文章

openharmony 鸿蒙 arkts-apis-uicontext-contextmenucontroller

openharmony 鸿蒙 errorcode-canvas

openharmony 鸿蒙 capi-oh-nativexcomponent-native-xcomponent-oh-nativexcomponent

openharmony 鸿蒙 errorcode-bindSheet

openharmony 鸿蒙 js-apis-arkui-uiExtension-sys

openharmony 鸿蒙 capi-arkui-accessibility-arkui-accessibilityeventinfo

openharmony 鸿蒙 capi-arkui-rendernodeutils

openharmony 鸿蒙 capi-native-node-h-nodeattributetype-layoutcomponent

openharmony 鸿蒙 js-apis-arkui-node

openharmony 鸿蒙 capi-native-node-h

  • 所属分类: 后端技术
  • 本文标签: 鸿蒙 软件
  • 版权声明: 本文链接 https://seaxiang.com/blog/qHXLh5R4