鸿蒙5.0开发进阶:ArkTS组件-基础类型定义

鸿蒙OpenHarmony【ChipGroup】信息展示 ChipGroup高级组件,提供操作块群组,用于对文件或者资源内容进行分类等场景。 阅读详情

往期鸿蒙5.0全套实战文章必看:(文中附带全栈鸿蒙5.0学习资料)


基础类型定义

说明

本模块首批接口从API version 7开始支持,后续版本的新增接口,采用上角标单独标记接口的起始版本。

Resource

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

资源引用类型,用于设置组件属性的值。

可以通过$r或者$rawfile创建Resource类型对象,不可以修改Resource中的各属性的值。

  • $r('belonging.type.name')

    belonging:系统资源或者应用资源,相应的取值为'sys'和'app';

    type:资源类型,支持'boolean'、'color'、'float'、'intarray'、'integer'、'pattern'、'plural'、'strarray'、'string'、'media';

    name:资源名称,在资源定义时确定。

  • $rawfile('filename')

    filename:工程中resources/rawfile目录下的文件名称。

    说明: 在引用资源类型时,注意其数据类型要与属性方法本身的类型一致,例如某个属性方法支持设置string | Resource,那么在使用Resource引用类型时,其数据类型也应当为string。

Length

长度类型,用于描述尺寸单位。

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

类型说明
string

需要显式指定像素单位,如'10px',也可设置百分比字符串,如'100%'。

说明:

不指定像素单位时,默认单位vp,如'10',等同于10。

number默认单位vp。
Resource资源引用类型,引入系统资源或者应用资源中的尺寸。

ResourceStr

字符串类型,用于描述字符串入参可以使用的类型。

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

类型说明
string字符串类型。
Resource资源引用类型,引入系统资源或者应用资源中的字符串。

Padding

内边距类型,用于描述组件不同方向的内边距。

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

名称类型必填说明
topLength否上内边距,组件内元素距组件顶部的尺寸。
rightLength否右内边距,组件内元素距组件右边界的尺寸。
bottomLength否下内边距,组件内元素距组件底部的尺寸。
leftLength否左内边距,组件内元素距组件左边界的尺寸。

LocalizedPadding12+

内边距类型,用于描述组件不同方向的内边距。

名称类型必填说明
topLengthMetrics12+否上内边距,组件内元素距组件顶部的尺寸。
endLengthMetrics12+否

右内边距,组件内元素距组件右边界的尺寸。

从右至左显示语言模式下为

左内边距,组件内元素距组件左边界的尺寸。

bottomLengthMetrics12+否下内边距,组件内元素距组件底部的尺寸。
startLengthMetrics12+否

左内边距,组件内元素距组件左边界的尺寸。

从右至左显示语言模式下为

右内边距,组件内元素距组件右边界的尺寸。

Margin

外边距类型,用于描述组件不同方向的外边距。

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

名称类型必填说明
topLength否上外边距,组件顶部距组件外元素的尺寸。
rightLength否右外边距,组件右边界距组件外元素的尺寸。
bottomLength否下外边距,组件底部距组件外元素的尺寸。
leftLength否左外边距,组件左边界距组件外元素的尺寸。

LocalizedMargin12+

外边距类型,用于描述组件不同方向的外边距。

名称类型必填说明
topLengthMetrics12+否上外边距,组件顶部距组件外元素的尺寸。
endLengthMetrics12+否

右外边距,组件右边界距组件外元素的尺寸。

从右至左显示语言模式下为

左外边距,组件左边界距组件外元素的尺寸。

bottomLengthMetrics12+否下外边距,组件底部距组件外元素的尺寸。
startLengthMetrics12+否

左外边距,组件左边界距组件外元素的尺寸。

从右至左显示语言模式下为

右外边距,组件右边界距组件外元素的尺寸。

EdgeWidths9+

边框宽度类型,用于描述组件边框不同方向的宽度。

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

名称类型必填说明
topLength否组件上边框宽度。
rightLength否组件右边框宽度。
bottomLength否组件下边框宽度。
leftLength否组件左边框宽度。

LocalizedEdgeWidths12+

边框宽度类型,用于描述组件边框不同方向的宽度。

名称类型必填说明
topLengthMetrics12+否组件上边框宽度。
endLengthMetrics12+否

组件右边框宽度。

从右至左显示语言模式下为组件左边框宽度。

bottomLengthMetrics12+否组件下边框宽度。
startLengthMetrics12+否

组件左边框宽度。

从右至左显示语言模式下为组件右边框宽度。

BorderRadiuses9+

圆角类型,用于描述组件边框圆角半径。

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

名称类型必填说明
topLeftLength否组件左上角圆角半径。
topRightLength否组件右上角圆角半径。
bottomLeftLength否组件左下角圆角半径。
bottomRightLength否组件右下角圆角半径。

LocalizedBorderRadiuses12+

圆角类型,用于描述组件边框圆角半径。

名称类型必填说明
topStartLengthMetrics12+否

组件左上角圆角半径。

从右至左显示语言模式下为组件右上角圆角半径。

topEndLengthMetrics12+否

组件右上角圆角半径。

从右至左显示语言模式下为组件左上角圆角半径。

bottomStartLengthMetrics12+否

组件左下角圆角半径。

从右至左显示语言模式下为组件右下角圆角半径。

bottomEndLengthMetrics12+否

组件右下角圆角半径。

从右至左显示语言模式下为组件左下角圆角半径。

EdgeColors9+

边框颜色,用于描述组件边框四条边的颜色。

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

名称类型必填说明
topResourceColor否组件上边框颜色。
rightResourceColor否组件右边框颜色。
bottomResourceColor否组件下边框颜色。
leftResourceColor否组件左边框颜色。

LocalizedEdgeColors12+

边框颜色,用于描述组件边框四条边的颜色。

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

名称类型必填说明
topResourceColor否组件上边框颜色。
endResourceColor否

组件右边框颜色。

从左至右显示语言模式下为组件左边框颜色。

bottomResourceColor否组件下边框颜色。
startResourceColor否

组件左边框颜色。

从左至右显示语言模式下为组件右边框颜色。

EdgeStyles9+

边框样式,用于描述组件边框四条边的样式。

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

名称类型必填说明
topBorderStyle否组件上边框样式。
rightBorderStyle否组件右边框样式。
bottomBorderStyle否组件下边框样式。
leftBorderStyle否组件左边框样式。

Offset

相对布局完成位置坐标偏移量。

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

名称类型必填说明
dxLength是水平方向偏移量。
dyLength是竖直方向偏移量。

RectResult10+

位置和尺寸类型,用于描述组件的位置和宽高。

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

参数类型描述
xnumber水平方向横坐标。
ynumber竖直方向纵坐标。
widthnumber内容宽度大小。
heightnumber内容高度大小。

ResourceColor

颜色类型,用于描述资源颜色类型。

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

类型说明
Color颜色枚举值。
numberHEX格式颜色,支持rgb或者argb。示例:0xffffff,0xffff0000。number无法识别传入位数,格式选择依据值的大小,例如0x00ffffff作rgb格式解析
stringrgb或者argb格式颜色。示例:'#ffffff', '#ff000000', 'rgb(255, 100, 255)', 'rgba(255, 100, 255, 0.5)'。
Resource使用引入资源的方式,引入系统资源或者应用资源中的颜色。

ColoringStrategy10+

智能取色枚举类型。

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

名称描述
INVERT

设置前景色为控件背景色的反色。仅支持在foregroundColor中设置该枚举。

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

AVERAGE11+

设置控件背景阴影色为控件背景阴影区域的平均色。仅支持在入参类型为ShadowOptions的shadow中设置该枚举。

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

PRIMARY11+

设置控件背景阴影色为控件背景阴影区域的主色。仅支持在入参类型为ShadowOptions的shadow中设置该枚举。

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

LengthConstrain

长度约束,用于对组件最大、最小长度做限制。

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

名称类型必填说明
minLengthLength是组件最小长度。
maxLengthLength是组件最大长度。

Font

设置文本样式。

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

名称类型必填说明
sizeLength否

设置文本尺寸,Length为number类型时,使用fp单位。不支持设置百分比字符串。

默认值:16.0

weightFontWeight | number | string否

设置文本的字体粗细,number类型取值[100, 900],取值间隔为100,取值越大,字体越粗。

默认值:400 | FontWeight.Normal

familystring | Resource否设置文本的字体列表。使用多个字体,使用','进行分割,优先级按顺序生效。例如:'Arial, HarmonyOS Sans'。当前支持'HarmonyOS Sans'字体和注册自定义字体。
styleFontStyle否

设置文本的字体样式。

默认值:FontStyle.Normal

Area8+

区域类型,用于存储元素所占区域信息。

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

名称类型说明
widthLength目标元素的宽度,作为返回值时,类型为number,单位vp。
heightLength目标元素的高度,作为返回值时,类型为number,单位vp。
positionPosition目标元素左上角相对父元素左上角的位置。
globalPositionPosition目标元素左上角相对页面左上角的位置。

Position

位置类型,用于表示一个坐标点。

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

名称类型必填说明
xLength否x轴坐标,作为返回值时,类型为number,单位vp。
yLength否y轴坐标,作为返回值时,类型为number,单位vp。

LocalizedPosition12+

位置类型,用于表示一个坐标点。

名称类型必填说明
startLengthMetrics否LTR模式时x轴相对左边坐标,RTL模式x轴相对右边坐标。
topLengthMetrics否y轴坐标。

Edges12+

位置类型,表示相对四边的偏移量。同时设置top和bottom,仅top生效;同时设置left和right,仅left生效。

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

名称类型必填说明
topDimension否相对顶边的偏移量
bottomDimension否相对底边的偏移量
leftDimension否相对左边的偏移量
rightDimension否相对右边的偏移量

LocalizedEdges12+

位置类型,表示相对四边的偏移量。同时设置top和bottom,仅top生效;同时设置start和end,仅start生效。

名称类型必填说明
topLengthMetrics否相对顶边的偏移量。
bottomLengthMetrics否相对底边的偏移量。
startLengthMetrics否LTR模式时相对左边的偏移量,RTL模式时相对右边的偏移量。
endLengthMetrics否LTR模式时相对右边的偏移量,RTL模式时相对左边的偏移量。

ConstraintSizeOptions

设置约束尺寸,组件布局时,进行尺寸范围限制。

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

名称类型必填说明
minWidthLength否元素最小宽度。
maxWidthLength否元素最大宽度。
minHeightLength否元素最小高度。
maxHeightLength否元素最大高度。

SizeOptions

设置宽高尺寸。

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

名称类型必填说明
widthLength否元素宽度。
heightLength否元素高度。

BorderOptions

边框属性集合,用于描述边框相关信息。

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

名称类型必填说明
widthLength | EdgeWidths9+ | LocalizedEdgeWidths12+否边框宽度。
colorResourceColor | EdgeColors9+否边框颜色。
radiusLength | BorderRadiuses9+否边框圆角半径。
styleBorderStyle | EdgeStyles9+否边框样式。

ColorFilter9+

创建具有4*5矩阵的颜色过滤器。

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

名称类型必填描述
constructornumber[]是创建具有4*5矩阵的颜色过滤器, 入参为[m*n]位于m行和n列中矩阵值, 矩阵是行优先的。

CustomBuilder8+

组件属性方法参数可使用CustomBuilder类型来自定义UI描述。

名称类型定义描述
CustomBuilder() => any | void生成用户自定义组件,在使用时结合@Builder使用。具体用法见@Builder。

MarkStyle10+对象说明

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

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

名称类型必填默认值描述
strokeColorResourceColor否Color.White内部图标颜色。
sizeLength否-

内部图标大小,单位vp。默认大小与多选框组件宽度设置值一致。

不支持百分比形式设置。当设置为非法值时,按照默认值处理。

strokeWidthLength否2内部图标粗细,单位vp。不支持百分比形式设置。当设置为非法值时,按照默认值处理。

ModalTransition10+

全屏模态转场方式枚举类型,用于设置全屏模态转场类型。

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

名称描述
NONE全屏模态无转场动画。
DEFAULT全屏模态上下切换动画。
ALPHA全屏模态透明度渐变动画。

Dimension10+

长度类型,用于描述尺寸单位。

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

类型说明
PX需要指定以px像素单位,如'10px'。
VP需要指定数字或vp像素单位,如10或'10vp'。
FP需要指定以fp像素单位,如'10fp'。
LPX需要指定以lpx像素单位,如'10lpx'。
Percentage需要指定以%像素单位,如'10%'。
Resource资源引用类型,引入系统资源或者应用资源中的尺寸。

PX10+

长度类型,用于描述以px像素单位为单位的长度。

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

类型说明
{number}px需要指定以px像素单位,如'10px'。

VP10+

长度类型,用于描述以vp像素单位为单位的长度。

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

类型说明
{number}vp|number需要指定数字或vp像素单位,如10或'10vp'。

FP10+

长度类型,用于描述以fp像素单位为单位的长度。

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

类型说明
{number}fp需要指定以fp像素单位,如'10fp'。

LPX10+

长度类型,用于描述以lpx像素单位为单位的长度。

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

类型说明
{number}lpx需要指定以lpx像素单位,如'10lpx'。

Percentage10+

长度类型,用于描述以%像素单位为单位的长度。

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

类型说明
{number}%需要指定以%像素单位,如'10%'。

Degree10+

角度类型,用于描述以deg像素单位为单位的长度。

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

类型说明
{number}deg需要指定以deg像素单位,如'10deg'。

MultiShadowOptions10+

投影样式。

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

名称参数类型必填描述
radiusnumber | Resource否

投影模糊半径。

API version 10及以前,默认值:5

API version 11及以后,默认值:20

单位:vp

说明:

设置小于等于0的值时,按默认值显示。

offsetXnumber | Resource否

X轴的偏移量。

默认值:5

单位:vp

offsetYnumber | Resource否

Y轴的偏移量。

默认值:5

单位:vp

SafeAreaType10+

扩展安全区域的枚举类型。

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

名称描述
SYSTEM系统默认非安全区域,包括状态栏、导航栏。
CUTOUT设备的非安全区域,例如刘海屏或挖孔屏区域。
KEYBOARD软键盘区域。

SafeAreaEdge10+

扩展安全区域的方向。

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

名称描述
TOP上方区域。
BOTTOM下方区域。
START前部区域。
END尾部区域。

KeyboardAvoidMode12+枚举说明

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

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

名称值说明
DEFAULT0默认避让软键盘并在到达极限高度之后进行高度压缩。
NONE1不避让软键盘。

LayoutSafeAreaType12+

扩展布局安全区域的枚举类型。

名称描述
SYSTEM系统默认非安全区域,包括状态栏、导航栏。

LayoutSafeAreaEdge12+

扩展安全区域的方向。

名称描述
TOP上方区域。
BOTTOM下方区域。

TouchPoint11+

配置跟手点坐标,不配置时,默认居中。

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

名称类型定义描述
XDimension跟手点X轴坐标。
YDimension跟手点Y轴坐标。

PixelRoundPolicy11+

指定组件级像素取整的方向。

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

名称类型必填说明
startPixelRoundCalcPolicy否组件前部边界取整对齐方式。
topPixelRoundCalcPolicy否组件上部边界取整对齐方式。
endPixelRoundCalcPolicy否组件尾部边界取整对齐方式。
bottomPixelRoundCalcPolicy否组件底部边界取整对齐方式。

VoidCallback12+

type VoidCallback:() => void;

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

Callback12+

Callback<T,V = void> = (data: T) => V;

带参数的函数回调。

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

HoverCallback12+

hover事件的回调类型。

type HoverCallback = (isHover: boolean, event: HoverEvent) => void;

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

名称类型描述
HoverCallback(isHover: boolean, event: HoverEvent) => voidhover事件的回调。

VisibleAreaEventOptions12+

关于区域变化相关的参数。

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

参数名类型必填说明
ratiosArray<number>是阈值数组。其中,每个阈值代表组件可见面积(即组件在屏幕显示区的面积,只计算父组件内的面积,超出父组件部分不会计算)与组件自身面积的比值。每个阈值的取值范围为[0.0, 1.0],如果开发者设置的阈值超出该范围,则会实际取值0.0或1.0。
expectedUpdateIntervalnumber否预期更新间隔,单位为ms。定义了开发者期望的更新间隔。默认值:1000。

VisibleAreaChangeCallback12+

组件可见区域变化事件的回调类型。

type VisibleAreaChangeCallback = (isVisible: boolean, currentRatio: number) => void;

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

名称类型描述
VisibleAreaChangeCallback(isVisible: boolean, currentRatio: number) => void

组件可见区域变化事件的回调。

-isVisible:表示组件的可见面积与自身面积的比值与上一次变化相比的情况,比值变大为true,比值变小为false。

-currentRatio:触发回调时,组件可见面积与自身面积的比值。

StyledStringValue12+

样式对象类型,用于设置属性字符串的样式。

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

名称描述
TextStyle文本字体样式。
DecorationStyle文本装饰线样式。
BaselineOffsetStyle文本基线偏移量样式。
LetterSpacingStyle文本字符间距样式。
LineHeightStyle文本行高样式。
TextShadowStyle文本阴影样式。
GestureStyle事件手势样式。
ParagraphStyle文本段落样式。
ImageAttachment图片样式。
CustomSpan自定义绘制Span样式。
UserDataSpanUserDataSpan样式。

EnterKeyType枚举说明

名称描述
Go

显示为开始样式。

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

Search

显示为搜索样式。

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

Send

显示为发送样式。

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

Next

显示为下一步样式。

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

Done

显示为完成样式。

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

PREVIOUS11+

显示为上一步样式。

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

NEW_LINE11+

显示为换行样式。

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

DividerStyleOptions12+

分割线样式属性集合, 用于描述分割线相关信息。

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

名称类型必填说明
strokeWidthLengthMetrics12+否分割线的线宽。
colorResourceColor否分割线的颜色。
startMarginLengthMetrics12+否分割线与菜单侧边起始端的距离。
endMarginLengthMetrics12+否分割线与菜单侧边结束端的距离。

TextContentControllerBase10+

TextInput、TextArea、Search的基础控制器。

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

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

getTextContentRect10+

getTextContentRect(): RectResult

获取已编辑文本内容区域相对组件的位置和大小,返回值单位为像素。

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

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

返回值:

类型说明
RectResult获取已编辑文本内容区域相对组件的位置和大小。

说明

  • 初始不输入文本时,返回值中有相对组件的位置信息,大小为0。
  • 返回值中的位置信息是第一个字符相对于可编辑组件的位置。
  • 在Search组件中,返回的位置信息是相对Search组件中搜索图标的偏移值。
  • 有输入时返回信息中的宽度是组件编辑的固定宽度。

getTextContentLineCount10+

getTextContentLineCount(): number

获取已编辑文本内容的行数。

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

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

返回值:

类型说明
number已编辑文本内容行数。

getCaretOffset11+

getCaretOffset(): CaretOffset

返回当前光标所在位置信息。

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

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

返回值:

类型说明
CaretOffset光标相对输入框的位置。

说明

  • 在当前帧更新光标位置同时调用该接口,该接口不生效。
  • 在Search组件中,返回的位置信息是相对Search组件中搜索图标的偏移值。
  • 在Search组件中,不输入文本时,返回值中有相对Search组件的位置信息。
  • 返回值中的位置信息是光标相对于可编辑组件的位置。

TextDecorationOptions12+对象说明

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

名称参数类型必填描述
typeTextDecorationType是

设置文本装饰线样式。

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

colorResourceColor否

设置文本装饰线颜色。

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

styleTextDecorationStyle否

设置文本装饰线样式。

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

SelectionOptions12+对象说明

setTextSelection选中文字时的配置。

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

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

名称类型必填说明
menuPolicyMenuPolicy否菜单弹出的策略。

CaretOffset11+对象说明

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

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

参数名类型描述
indexnumber光标所在位置的索引值。
xnumber光标相对输入框的x坐标位值,单位px。
ynumber光标相对输入框的y坐标位值,单位px。

InputCounterOptions11+对象说明

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

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

参数名类型描述
thresholdPercentagenumberthresholdPercentage是可输入字符数占最大字符限制的百分比值。字符计数器显示的样式为当前输入字符数/最大字符数。当输入字符数大于最大字符数乘百分比值时,显示字符计数器。thresholdPercentage值的有效值区间为[1,100],数值为小数时,向下取整,如果设置的number超出有效值区间内,不显示字符计数器。thresholdPercentage设置为undefined,显示字符计数器,但此参数不生效。
highlightBorderboolean如果用户设置计数器时不设置InputCounterOptions,那么当前输入字符数达到最大字符数时,边框和计数器下标将变为红色。如果用户设置显示字符计数器同时thresholdPercentage参数数值在有效区间内,那么当输入字符数超过最大字符数时,边框和计数器下标将变成红色。如果此参数为true,则显示红色边框。计数器默认显示红色边框。

Configuration

数据类型。用于设置颜色模式和字体缩放倍数。

卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。

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

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

名称类型只读可选说明
colorModestring是否颜色模式。
fontScalenumber是否字体缩放。

鸿蒙5.0版开发:ArkTS基础组件(Stepper) 步骤导航器组件,适用于引导用户按照步骤完成任务的导航场景。 阅读详情

相关推荐

鸿蒙Harmony应用开发—ArkTS声明式开发(基础手势:LoadingProgress)

ArkTS声明式开发(基础手势:LoadingProgress)

m0_64420071的博客 1644

最新HarmonyOS基础-提前入门

连培训机构都在宣传的鸿蒙还不得值得入手学习吗

欢迎来到我的博客 875

鸿蒙5.0版开发:ArkTS基础组件(TextInput)

单行文本输入框组件。

m0_69424697的博客 2318

构建第一个ArkTS用的资源分类与访问

应用开发过程中,经常需要用到颜色、字体、间距、图片等资源,在不同的设备或配置中,这些资源的值可能不同。应用资源:借助资源文件能力,开发者在应用中自定义资源,自行管理这些资源在不同的设备或配置中的表现。系统资源:开发者直接使用系统预置的资源定义(即,同一资源ID在设备类型、深浅色等不同配置下有不同的取值)。

二当家的 2128

鸿蒙Harmony应用开发—ArkTS声明式开发(容器组件:RowSplit)

ArkTS声明式开发(容器组件:RowSplit)

m0_64420071的博客 1642

鸿蒙5.0版开发:ArkTS基础组件(Slider)

滑动条组件,通常用于快速调节设置值,如音量调节、亮度调节等应用场景。

m0_69424697的博客 1597

ArkTS基本语法基础篇

如果switch表达式的值等于某个label的值,则执行相应的语句。SDK对同一个Kit下的接口模块进行了封装,开发者在示例代码中可通过导入Kit的方式来使用Kit所包含的接口能力。数组可由数组复合字面量(即用方括号括起来的零个或多个表达式的列表,其中每个表达式为数组中的一个元素)来赋值。默认情况下,ArkTS中的所有类型都是不可为空的,因此类型的值不能为空。在以下示例中,如果一个Person的实例有不为空的spouse属性,且spouse有不为空的nick属性,则输出spouse.nick。

weixin_44252504的博客 1252

鸿蒙5.0版开发:ArkTS基础组件(Select)

提供下拉选择菜单,可以让用户在多个选项之间选择。

m0_69424697的博客 2274

鸿蒙开发:ArkTs字符串string

字符串类型是开发中非常重要的一个数据类型,除了上述的方法概述之外,还有String对象,正则等其他的用处,我们放到以后得篇章中讲述。

知足常乐 1845

华为鸿蒙HarmonyOS Next基础开发教程

《HarmonyOSNext开发指南》摘要: HarmonyOSNext是华为2025年推出的纯自研分布式操作系统,完全脱离安卓生态,采用ArkTS语言和微内核架构,具备原生精致、流畅、安全等六大特性。本文系统介绍了开发环境搭建(DevEcoStudio+SDK)、ArkTS语言基础(静态类型检查/声明式UI)、UI开发框架(声明式布局/组件化)、状态管理机制(@State/@Link等装饰器)、本地存储(Preferences)和网络请求(http模块)等核心内容,并包含调试技巧与发布流程。通过60天学习

abcdlwt的博客 1973

鸿蒙5.0版开发:ArkTS基础组件(TextArea)

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

m0_69424697的博客 2028

(HarmonyOS5.0) 华为鸿蒙开发学习实战教程

《HarmonyOS5.0实战学习指南》摘要 本文介绍了基于HarmonyOS5.0开发"个人健康助手"应用的完整教程。首先详细讲解了开发环境搭建和SDK配置,强调版本兼容性。核心内容包括:基础功能开发(数据展示、目标管理)、HarmonyOS5.0新特性集成(状态管理增强、分布式能力、元服务卡片)以及项目优化测试(性能、兼容性、自动化测试)。教程采用项目驱动方式,通过健康数据同步、多设备协同等场景展示5.0特性应用,并提供了性能优化方案和测试策略。最后总结了开发经验,提出了功能扩展建议

2501_93207838的博客 1580

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

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

m0_69424697的博客 1026

鸿蒙5.0版开发:ArkTS组件-GridItem

网格容器中单项内容容器。

m0_69424697的博客 1079

鸿蒙5.0版开发:ArkTS组件-LoadingProgress

用于显示加载动效的组件。

m0_69424697的博客 1099

鸿蒙5.0版开发:ArkTS基础组件(进展)

进度条组件,用于显示内容加载或操作处理等进度。

m0_69424697的博客 1277

鸿蒙5.0版开发:ArkTS基础组件(RichText)

富文本组件,解析并显示HTML格式文本。

m0_69424697的博客 1523

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

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

m0_69424697的博客 1222
上一篇: 鸿蒙5.0开发进阶:ArkTS组件-Repeat
下一篇: 鸿蒙5.0开发进阶:ArkTS组件-像素单位
懂你的大海
博客等级 码龄6年 9049粉丝 1381原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

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

余额充值