本模块首批接口从API version 7开始支持,后续版本的新增接口,采用上角标单独标记接口的起始版本。
本模块首批接口从API version 7开始支持,后续版本的新增接口,采用上角标单独标记接口的起始版本。
type Resource = import('../api/global/resource').Resource
资源引用类型,用于设置组件属性的值。各类资源文件,需要放入特定子目录中存储管理,资源目录的示例请参考资源分类。
| 类型 | 说明 |
|---|---|
| import('../api/global/resource').Resource | 资源引用类型。 |
卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
可以通过$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。
引用资源类型时,需确保资源类型对象用法为当前支持的用法,否则当前以资源类型作为参数的属性效果将和不设置该属性相同。
$rawfile不支持通过预览器预览。
type Length = string | number | Resource
长度类型,用于描述尺寸单位。
卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
type LengthMetricsUnit = import('../api/arkui/Graphics').LengthMetricsUnit
定义长度属性单位。
卡片能力: 从API version 12开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 12开始,该接口支持在元服务中使用。
模型约束: 此接口仅可在Stage模型下使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
| 类型 | 说明 |
|---|---|
| import('../api/arkui/Graphics').LengthMetricsUnit | 长度属性单位。 |
type LengthMetrics = import('../api/arkui/Graphics').LengthMetrics
定义长度属性。
卡片能力: 从API version 12开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 12开始,该接口支持在元服务中使用。
模型约束: 此接口仅可在Stage模型下使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
| 类型 | 说明 |
|---|---|
| import('../api/arkui/Graphics').LengthMetrics | 长度属性。 |
declare type ColorMetrics = import('../api/arkui/Graphics').ColorMetrics
定义混合颜色。
卡片能力: 从API version 12开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 12开始,该接口支持在元服务中使用。
模型约束: 此接口仅可在Stage模型下使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
| 类型 | 说明 |
|---|---|
| import('../api/arkui/Graphics').ColorMetrics | 混合颜色。 |
type ResourceStr = string | Resource
字符串类型,用于描述字符串入参可以使用的类型。
卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
| 类型 | 说明 |
|---|---|
| string | 字符串类型。 |
| Resource | 资源引用类型,引入系统资源或者应用资源中的字符串。 |
type Padding = { top?: Length; right?: Length; bottom?: Length; left?: Length; }
内边距类型,用于描述组件不同方向的内边距。
引入该对象时,至少传入一个参数。
卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
内边距类型,用于描述组件不同方向的内边距。
卡片能力: 从API version 12开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 12开始,该接口支持在元服务中使用。
模型约束: 此接口仅可在Stage模型下使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
| 名称 | 类型 | 只读 | 可选 | 说明 |
|---|---|---|---|---|
| top | LengthMetrics12+ | 否 | 是 | 上内边距,组件内元素距组件顶部的尺寸。 |
| end | LengthMetrics12+ | 否 | 是 | 右内边距,组件内元素距组件右边界的尺寸。 从右至左显示语言模式下为 左内边距,组件内元素距组件左边界的尺寸。 |
| bottom | LengthMetrics12+ | 否 | 是 | 下内边距,组件内元素距组件底部的尺寸。 |
| start | LengthMetrics12+ | 否 | 是 | 左内边距,组件内元素距组件左边界的尺寸。 从右至左显示语言模式下为 右内边距,组件内元素距组件右边界的尺寸。 |
type Margin = Padding
外边距类型,用于描述组件不同方向的外边距。
引入该对象时,至少传入一个参数。
卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
| 类型 | 说明 |
|---|---|
| Padding | 外边距类型,用于描述组件不同方向的外边距,其类型与内边距类型一致。 |
type LocalizedMargin = LocalizedPadding
外边距类型,用于描述组件不同方向的外边距。
引入该对象时,至少传入一个参数。
卡片能力: 从API version 12开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 12开始,该接口支持在元服务中使用。
模型约束: 此接口仅可在Stage模型下使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
| 类型 | 说明 |
|---|---|
| LocalizedPadding | 外边距类型,用于描述组件不同方向的外边距,其类型与内边距类型一致。 |
type EdgeWidths = { top?: Length; right?: Length; bottom?: Length; left?: Length; }
边框宽度类型,用于描述组件边框不同方向的宽度。
引入该对象时,至少传入一个参数。
卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
type EdgeWidth = EdgeWidths
边框宽度类型,用于描述组件边框不同方向的宽度。
引入该对象时,至少传入一个参数。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
模型约束: 此接口仅可在Stage模型下使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
| 类型 | 说明 |
|---|---|
| EdgeWidths | 组件边框不同方向的宽度。 |
边框宽度类型,用于描述组件边框不同方向的宽度。
引入该对象时,至少传入一个参数。
卡片能力: 从API version 12开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 12开始,该接口支持在元服务中使用。
模型约束: 此接口仅可在Stage模型下使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
| 名称 | 类型 | 只读 | 可选 | 说明 |
|---|---|---|---|---|
| top | LengthMetrics12+ | 否 | 是 | 组件上边框宽度。 |
| end | LengthMetrics12+ | 否 | 是 | 组件右边框宽度。 从右至左显示语言模式下为组件左边框宽度。 |
| bottom | LengthMetrics12+ | 否 | 是 | 组件下边框宽度。 |
| start | LengthMetrics12+ | 否 | 是 | 组件左边框宽度。 从右至左显示语言模式下为组件右边框宽度。 |
type BorderRadiuses = { topLeft?: Length; topRight?: Length; bottomLeft?: Length; bottomRight?: Length; }
圆角类型,用于描述组件边框圆角半径。
引用该对象时,至少传入一个参数。
卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
圆角类型,用于描述组件边框圆角半径。
引用该对象时,至少传入一个参数。
卡片能力: 从API version 12开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 12开始,该接口支持在元服务中使用。
模型约束: 此接口仅可在Stage模型下使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
| 名称 | 类型 | 只读 | 可选 | 说明 |
|---|---|---|---|---|
| topStart | LengthMetrics12+ | 否 | 是 | 组件左上角圆角半径。 从右至左显示语言模式下为组件右上角圆角半径。 |
| topEnd | LengthMetrics12+ | 否 | 是 | 组件右上角圆角半径。 从右至左显示语言模式下为组件左上角圆角半径。 |
| bottomStart | LengthMetrics12+ | 否 | 是 | 组件左下角圆角半径。 从右至左显示语言模式下为组件右下角圆角半径。 |
| bottomEnd | LengthMetrics12+ | 否 | 是 | 组件右下角圆角半径。 从右至左显示语言模式下为组件左下角圆角半径。 |
type EdgeColors = { top?: ResourceColor; right?: ResourceColor; bottom?: ResourceColor; left?: ResourceColor; }
边框颜色,用于描述组件边框四条边的颜色。
引入该对象时,至少传入一个参数。
卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| top | ResourceColor | 否 | 组件上边框颜色。 |
| right | ResourceColor | 否 | 组件右边框颜色。 |
| bottom | ResourceColor | 否 | 组件下边框颜色。 |
| left | ResourceColor | 否 | 组件左边框颜色。 |
边框颜色,用于描述组件边框四条边的颜色。
引入该对象时,至少传入一个参数。
卡片能力: 从API version 12开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 12开始,该接口支持在元服务中使用。
模型约束: 此接口仅可在Stage模型下使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
| 名称 | 类型 | 只读 | 可选 | 说明 |
|---|---|---|---|---|
| top | ResourceColor | 否 | 是 | 组件上边框颜色。 |
| end | ResourceColor | 否 | 是 | 组件右边框颜色。 从右至左显示语言模式下为组件左边框颜色。 |
| bottom | ResourceColor | 否 | 是 | 组件下边框颜色。 |
| start | ResourceColor | 否 | 是 | 组件左边框颜色。 从右至左显示语言模式下为组件右边框颜色。 |
type EdgeStyles = { top?: BorderStyle; right?: BorderStyle; bottom?: BorderStyle; left?: BorderStyle; }
边框样式,用于描述组件边框四条边的样式。
引入该对象时,至少传入一个参数。
卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| top | BorderStyle | 否 | 组件上边框样式。 |
| right | BorderStyle | 否 | 组件右边框样式。 |
| bottom | BorderStyle | 否 | 组件下边框样式。 |
| left | BorderStyle | 否 | 组件左边框样式。 |
type Offset = { dx: Length; dy: Length; }
相对布局完成位置坐标偏移量。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
type ResourceColor = Color | number | string | Resource
颜色类型,用于描述资源颜色类型。
卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
type LengthConstrain = { minLength: Length; maxLength: Length; }
长度约束,用于对组件最大、最小长度做限制。
卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
设置文本样式。
可以使用loadFontSync注册自定义字体。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
| 名称 | 类型 | 只读 | 可选 | 说明 |
|---|---|---|---|---|
| size | Length | 否 | 是 | 设置文本尺寸,Length为number类型时,使用fp单位。不支持设置百分比字符串。 默认值:16.0 |
| weight | FontWeight | number | string | 否 | 是 | 设置文本的字体粗细,number类型取值[100, 900],取值间隔为100,取值越大,字体越粗。 默认值:400 | FontWeight.Normal |
| family | string | Resource | 否 | 是 | 字体列表。默认字体'HarmonyOS Sans'。 使用多个字体时,请用逗号','分隔,字体的优先级按顺序生效。例如:'Arial,HarmonyOS Sans'。 |
| style | FontStyle | 否 | 是 | 设置文本的字体样式。 默认值:FontStyle.Normal |
区域类型,用于存储元素所占的区域信息。
卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
位置类型,用于表示一个坐标点。
卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
位置类型,用于表示一个坐标点。
元服务API: 从API version 12开始,该接口支持在元服务中使用。
模型约束: 此接口仅可在Stage模型下使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
| 名称 | 类型 | 只读 | 可选 | 说明 |
|---|---|---|---|---|
| start | LengthMetrics | 否 | 是 | LTR模式时x轴相对左边坐标,RTL模式x轴相对右边坐标。 |
| top | LengthMetrics | 否 | 是 | y轴坐标。 |
位置类型,表示相对四边的偏移量。同时设置top和bottom,仅top生效;同时设置left和right,仅left生效。
卡片能力: 从API version 12开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 12开始,该接口支持在元服务中使用。
模型约束: 此接口仅可在Stage模型下使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
位置类型,表示相对四边的偏移量。同时设置top和bottom,仅top生效;同时设置start和end,仅start生效。
元服务API: 从API version 12开始,该接口支持在元服务中使用。
模型约束: 此接口仅可在Stage模型下使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
| 名称 | 类型 | 只读 | 可选 | 说明 |
|---|---|---|---|---|
| top | LengthMetrics | 否 | 是 | 相对顶边的偏移量。 |
| bottom | LengthMetrics | 否 | 是 | 相对底边的偏移量。 |
| start | LengthMetrics | 否 | 是 | LTR模式时相对左边的偏移量,RTL模式时相对右边的偏移量。 |
| end | LengthMetrics | 否 | 是 | LTR模式时相对右边的偏移量,RTL模式时相对左边的偏移量。 |
约束尺寸类型,用于描述组件布局时对尺寸大小的范围限制。
卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
在Row、Column、RelativeContainer组件中,width、height设置auto表示自适应子组件。在TextInput组件中,width设置auto表示自适应文本宽度。
宽高尺寸类型,用于描述组件布局时的宽高尺寸大小。
卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
边框属性集合,用于描述边框相关信息。
系统能力: SystemCapability.ArkUI.ArkUI.Full
| 名称 | 类型 | 只读 | 可选 | 说明 |
|---|---|---|---|---|
| width | EdgeWidths9+ | Length | LocalizedEdgeWidths12+ | 否 | 是 | 设置边框宽度。 元服务API: 从API version 11开始,该接口支持在元服务中使用。 卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。 |
| color | EdgeColors9+ | ResourceColor | LocalizedEdgeColors12+ | 否 | 是 | 设置边框颜色。 元服务API: 从API version 11开始,该接口支持在元服务中使用。 卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。 |
| radius | BorderRadiuses9+ | Length | LocalizedBorderRadiuses12+ | 否 | 是 | 设置边框圆角半径。 元服务API: 从API version 11开始,该接口支持在元服务中使用。 卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。 |
| style | EdgeStyles9+ | BorderStyle | 否 | 是 | 设置边框样式。 元服务API: 从API version 11开始,该接口支持在元服务中使用。 卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。 |
| dashGap12+ | EdgeWidths | LengthMetrics | LocalizedEdgeWidths | 否 | 是 | 设置虚线的线段间距,仅在边框样式为虚线时生效。 不支持设置百分比。 元服务API: 从API version 12开始,该接口支持在元服务中使用。 模型约束: 此接口仅可在Stage模型下使用。 卡片能力: 该接口不支持在ArkTS卡片中使用。 |
| dashWidth12+ | EdgeWidths | LengthMetrics | LocalizedEdgeWidths | 否 | 是 | 设置虚线的线段长度,仅在边框样式为虚线时生效。 不支持设置百分比。 元服务API: 从API version 12开始,该接口支持在元服务中使用。 模型约束: 此接口仅可在Stage模型下使用。 卡片能力: 该接口不支持在ArkTS卡片中使用。 |
创建具有4*5矩阵的颜色过滤器。
卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
constructor(value: number[])
ColorFilter的构造函数,创建具有4*5矩阵的颜色过滤器。
卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
参数:
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| value | number[] | 是 | 4*5颜色矩阵的值,[m*n]位于m行和n列中矩阵值,矩阵是行优先的。 |
组件属性方法参数可使用CustomBuilder类型来自定义UI描述。
| 名称 | 类型定义 | 描述 |
|---|---|---|
| CustomBuilder | (() => any) | void | 生成用户自定义组件,在使用时结合@Builder使用。 |
type CustomBuilderT<T> = (t: T) => void
自定义UI描述,相比于CustomBuilder,本接口支持传入一个参数。
卡片能力: 从API version 23开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 23开始,该接口支持在元服务中使用。
模型约束: 此接口仅可在Stage模型下使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
参数:
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| t | T | 是 | 生成用户自定义组件,在使用时结合@Builder使用,并允许传入一个参数。 |
元服务API: 从API version 11开始,该接口支持在元服务中使用。
模型约束: 此接口仅可在Stage模型下使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
| 名称 | 类型 | 只读 | 可选 | 说明 |
|---|---|---|---|---|
| strokeColor | ResourceColor | 否 | 是 | 内部图标颜色。默认值:Color.White |
| size | Length | 否 | 是 | 内部图标大小,单位vp。默认大小与多选框组件宽度相同。 不支持百分比形式设置。设置为非法值时,按照默认值处理。 |
| strokeWidth | Length | 否 | 是 | 内部图标粗细,单位vp。不支持设置百分比。设置为非法值时,按照默认值处理。默认值:2 |
全屏模态转场方式枚举类型,用于设置全屏模态转场类型。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
模型约束: 此接口仅可在Stage模型下使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
| 名称 | 描述 |
|---|---|
| NONE | 全屏模态无转场动画。 |
| DEFAULT | 全屏模态上下切换动画。 |
| ALPHA | 全屏模态透明度渐变动画。 |
外描边选项设置。
模型约束: 此接口仅可在Stage模型下使用。
元服务API: 从API version 12开始,该接口支持在元服务中使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
卡片能力: 从API version 11开始,该接口支持在ArkTS卡片中使用。
| 名称 | 类型 | 只读 | 可选 | 说明 |
|---|---|---|---|---|
| width | EdgeOutlineWidths | Dimension | 否 | 是 | 设置外描边宽度,不支持百分比。 默认值:0,外描边效果中width为必设项,否则不显示外描边。 |
| color | EdgeColors | ResourceColor | LocalizedEdgeColors12+ | 否 | 是 | 设置外描边颜色。 默认值:Color.Black |
| radius | OutlineRadiuses | Dimension | 否 | 是 | 设置外描边圆角半径,不支持百分比。 默认值:0 最大生效值:组件width/2 + outlineWidth或组件height/2 + outlineWidth。 |
| style | EdgeOutlineStyles | OutlineStyle | 否 | 是 | 设置外描边样式。 默认值:OutlineStyle.SOLID |
引入该对象时,至少传入一个参数。
元服务API: 从API version 12开始,该接口支持在元服务中使用。
卡片能力: 从API version 11开始,该接口支持在ArkTS卡片中使用。
模型约束: 此接口仅可在Stage模型下使用。
引用该对象时,至少传入一个参数。
元服务API: 从API version 12开始,该接口支持在元服务中使用。
卡片能力: 从API version 11开始,该接口支持在ArkTS卡片中使用。
模型约束: 此接口仅可在Stage模型下使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
引入该对象时,至少传入一个参数。
元服务API: 从API version 12开始,该接口支持在元服务中使用。
卡片能力: 从API version 11开始,该接口支持在ArkTS卡片中使用。
模型约束: 此接口仅可在Stage模型下使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
| 名称 | 类型 | 只读 | 可选 | 说明 |
|---|---|---|---|---|
| left | OutlineStyle | 否 | 是 | 左侧外描边样式。 |
| right | OutlineStyle | 否 | 是 | 右侧外描边样式。 |
| top | OutlineStyle | 否 | 是 | 上侧外描边样式。 |
| bottom | OutlineStyle | 否 | 是 | 下侧外描边样式。 |
type Dimension = PX | VP | FP | LPX | Percentage | Resource
长度类型,用于描述尺寸单位。
卡片能力: 从API version 23开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
模型约束: 此接口仅可在Stage模型下使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
type PX = { number }px
长度类型,用于描述以px像素单位为单位的长度。
卡片能力: 从API version 23开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
模型约束: 此接口仅可在Stage模型下使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
| 类型 | 说明 |
|---|---|
| { number }px | 需要指定以px像素单位,如'10px'。 |
type VP = { number }vp | number
长度类型,用于描述以vp为单位的长度。
卡片能力: 从API version 23开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
模型约束: 此接口仅可在Stage模型下使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
| 类型 | 说明 |
|---|---|
| { number }vp | number | 需要指定数字或vp像素单位,如10或'10vp'。 |
type FP = { number }fp
长度类型,用于描述以fp像素单位为单位的长度。
卡片能力: 从API version 23开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
模型约束: 此接口仅可在Stage模型下使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
| 类型 | 说明 |
|---|---|
| { number }fp | 需要指定以fp像素单位,如'10fp'。 |
type LPX = { number }lpx
长度类型,用于描述以lpx像素单位为单位的长度。
卡片能力: 从API version 23开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
模型约束: 此接口仅可在Stage模型下使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
| 类型 | 说明 |
|---|---|
| { number }lpx | 需要指定以lpx像素单位,如'10lpx'。 |
type Percentage = { number }%
长度类型,用于描述以百分比单位为单位的长度。
卡片能力: 从API version 23开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
模型约束: 此接口仅可在Stage模型下使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
| 类型 | 说明 |
|---|---|
| { number }% | 需要指定以百分比单位,如'10%'。 |
type Degree = ${number}deg
角度类型,用于描述以deg为单位的角度。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
模型约束: 此接口仅可在Stage模型下使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
| 类型 | 说明 |
|---|---|
| { number }deg | 需要指定以deg为单位,如'10deg'。 |
配置跟手点坐标,不配置时,默认居中。
元服务API: 从API version 12开始,该接口支持在元服务中使用。
模型约束: 此接口仅可在Stage模型下使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
type VoidCallback = () => void
无参数、无返回值的函数回调类型,用于定义不需要传递数据且不返回结果的回调场景。
元服务API: 从API version 12开始,该接口支持在元服务中使用。
模型约束: 此接口仅可在Stage模型下使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
type Callback<T, V = void> = (data: T) => V;
带参数的函数回调。
元服务API: 从API version 12开始,该接口支持在元服务中使用。
模型约束: 此接口仅可在Stage模型下使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
分割线样式属性集合, 用于描述分割线相关信息。
元服务API: 从API version 12开始,该接口支持在元服务中使用。
模型约束: 此接口仅可在Stage模型下使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
| 名称 | 类型 | 只读 | 可选 | 说明 |
|---|---|---|---|---|
| strokeWidth | LengthMetrics | 否 | 是 | 分割线的线宽。 |
| color | ResourceColor | 否 | 是 | 分割线的颜色。 |
| startMargin | LengthMetrics | 否 | 是 | 分割线与菜单侧边起始端的距离。 |
| endMargin | LengthMetrics | 否 | 是 | 分割线与菜单侧边结束端的距离。 |
| mode19+ | DividerMode | 否 | 是 | 设置分割线模式。 |
链中组件的布局权重。
元服务API: 从API version 14开始,该接口支持在元服务中使用。
模型约束: 此接口仅可在Stage模型下使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
| 名称 | 类型 | 只读 | 可选 | 说明 |
|---|---|---|---|---|
| horizontal | number | 否 | 是 | 组件在水平方向的布局权重,设置大于0的数字时生效。 默认值:0 异常值:0 |
| vertical | number | 否 | 是 | 组件在竖直方向的布局权重,设置大于0的数字时生效。 默认值:0 异常值:0 |
数据类型。用于设置颜色模式和字体缩放倍数。
卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
| 名称 | 类型 | 只读 | 可选 | 说明 |
|---|---|---|---|---|
| colorMode | string | 是 | 否 | 颜色模式。 |
| fontScale | number | 是 | 否 | 字体缩放。 |
模型约束: 此接口仅可在Stage模型下使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
| 名称 | 类型 | 只读 | 可选 | 说明 |
|---|---|---|---|---|
| accessibilityPreferred | boolean | 否 | 是 | 若accessibilityPreferred设置为true,则深度遍历每个子节点时优先选择该子节点的无障碍文本accessibilityText。 若无障碍文本为空则选择本身Text文本,最终将拼接完成的文本设置给accessibilityText与Text都为空的父节点。 若accessibilityPreferred设置为false,表示不启用此功能。 默认值:false 元服务API: 从API version 14开始,该接口支持在元服务中使用。 |
| stateControllerRoleType23+ | AccessibilityRoleType | 否 | 是 | 指定特定类型的子组件。配置accessibilityGroup的容器组件进行无障碍聚合后,会将该特定类型的子组件的选中状态和状态播报文本作为聚合组件的状态和播报文本。从而聚合屏幕朗读下的状态播报,避免需要对子组件单独进行聚焦。 说明: 如果聚合组件内有多个相同类型的子组件,则以组件树上该聚合组件下的第一个查找到的子组件为控制组件。 不支持跨进程嵌入式组件内的特定类型,例如:卡片、EmbeddedUIExtension。 默认值:无指定组件 元服务API: 从API version 23开始,该接口支持在元服务中使用。 |
| stateControllerId23+ | string | 否 | 是 | 指定特定唯一标识ID的子组件。配置accessibilityGroup的容器组件进行无障碍聚合后,会将该特定标识的子组件的选中状态和状态播报文本作为聚合组件的状态和播报文本。从而聚合屏幕朗读下的状态播报,避免需要对子组件单独进行聚焦。 说明: 如果聚合组件内有多个相同类型的子组件,则以组件树上该聚合组件下的第一个查找到的子组件为控制组件。 如果与stateControllerRoleType同时配置,则优先匹配ID一致的组件。 不支持跨进程嵌入式组件内的特定类型,例如:卡片、EmbeddedUIExtension。 默认值:无指定组件 元服务API: 从API version 23开始,该接口支持在元服务中使用。 |
| actionControllerRoleType23+ | AccessibilityRoleType | 否 | 是 | 指定特定类型的子组件。配置accessibilityGroup的容器组件进行无障碍聚合后,如果触发无障碍的控制操作时,会将操作转发给该特定类型的子组件。从而聚合屏幕朗读下的点击事件,避免需要对子组件单独进行聚焦。 说明: 如果聚合组件内有多个相同类型的子组件,则以组件树上该聚合组件下的第一个查找到的子组件为控制组件。 当前只支持无障碍点击操作。 不支持跨进程嵌入式组件内的特定类型,例如:卡片、EmbeddedUIExtension。 默认值:无指定组件 元服务API: 从API version 23开始,该接口支持在元服务中使用。 |
| actionControllerId23+ | string | 否 | 是 | 指定特定唯一标识ID的子组件。配置accessibilityGroup的容器组件进行无障碍聚合后,如果触发无障碍的控制操作时,会将操作转发给该特定标识的子组件。从而聚合屏幕朗读下的点击事件,避免需要对子组件单独进行聚焦。 说明: 如果聚合组件内有多个相同类型的子组件,则以组件树上该聚合组件下的第一个查找到的子组件为控制组件。 当前只支持无障碍点击操作。 如果与actionControllerRoleType同时配置,则优先匹配ID一致的组件。 不支持跨进程嵌入式组件内的特定类型,例如:卡片、EmbeddedUIExtension。 默认值:无指定组件 元服务API: 从API version 23开始,该接口支持在元服务中使用。 |
滚动条边距。
元服务API: 从API version 20开始,该接口支持在元服务中使用。
模型约束: 此接口仅可在Stage模型下使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
| 名称 | 类型 | 只读 | 可选 | 说明 |
|---|---|---|---|---|
| start | LengthMetrics | 否 | 是 | 滚动条起始边距。 默认值:0,单位:vp |
| end | LengthMetrics | 否 | 是 | 滚动条末尾边距。 默认值:0,单位:vp |
type ResponsiveFillType = PresetFillType
响应式布局填充模式,用于WaterFlow、Grid、List、Swiper和LazyVWaterFlowLayout组件。LazyVWaterFlowLayout组件从API版本26.0.0开始支持。
元服务API: 从API version 22开始,该接口支持在元服务中使用。
模型约束: 此接口仅可在Stage模型下使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
| 类型 | 说明 |
|---|---|
| PresetFillType | 为不同响应式断点规格指定列数。 |
定义一个适用于WaterFlow、Grid、List、Swiper和LazyVWaterFlowLayout组件的响应式布局策略。LazyVWaterFlowLayout组件从API版本26.0.0开始支持。
元服务API: 从API version 22开始,该接口支持在元服务中使用。
模型约束: 此接口仅可在Stage模型下使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
| 名称 | 类型 | 只读 | 可选 | 说明 |
|---|---|---|---|---|
| fillType | ResponsiveFillType | 否 | 是 | 为不同的响应式断点指定列数。默认值为BREAKPOINT_DEFAULT。 |
边缘宽度类型,用于描述组件边缘不同方向的宽度。支持全球化。
卡片能力: 从API version 12开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 12开始,该接口支持在元服务中使用。
模型约束: 此接口仅可在Stage模型下使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
| 名称 | 类型 | 只读 | 可选 | 说明 |
|---|---|---|---|---|
| start | T | 否 | 否 | 起始边缘的属性。在LTR的方向下,为左边缘,在RTL的方向下,为右边缘。 |
| end | T | 否 | 否 | 终止边缘的属性。在LTR的方向下,为右边缘,在RTL的方向下,为左边缘。 |
| top | T | 否 | 否 | 顶部边缘的属性。 |
| bottom | T | 否 | 否 | 底部边缘的属性。 |
设置组件在锚点约束下的偏移参数。
以水平方向Bias为例,其值为组件到左锚点的距离 Dstart与组件到水平方向锚点间总距离 Dstart + Dend的比值。镜像语言下,Dstart为组件到右锚点的距离。下图中Dwidth表示组件宽度。

竖直方向同理,其值为组件到上锚点的距离Dtop与组件到竖直方向锚点间总距离Dtop + Dbottom的比值。下图中Dheight表示组件高度。

卡片能力: 从API version 11开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 12开始,该接口支持在元服务中使用。
模型约束: 此接口仅可在Stage模型下使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
| 名称 | 类型 | 只读 | 可选 | 说明 |
|---|---|---|---|---|
| horizontal | number | 否 | 是 | 水平方向上的bias值。 当子组件的width属性有正确值并且有2个水平方向的锚点时生效,设置的值必须大于等于0。 默认值: 0.5 |
| vertical | number | 否 | 是 | 垂直方向上的bias值。 当子组件的height属性有正确值并且有2个垂直方向的锚点时生效,设置的值必须大于等于0。 默认值: 0.5 |
缓存数量信息。
元服务API: 从API version 22开始,该接口支持在元服务中使用。
模型约束: 此接口仅可在Stage模型下使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
| 名称 | 类型 | 只读 | 可选 | 说明 |
|---|---|---|---|---|
| minCount | number | 否 | 否 | 最小缓存数,当实际缓存数小于最小缓存数时,在滚动动画帧间空闲时隙加载缓存。 取值范围:[0, +∞),小于0时按1处理。 |
| maxCount | number | 否 | 否 | 最大缓存数,当实际缓存数大于最大缓存数时,缓存内容会回收或释放,当UI空闲时(无动画或用户操作),会加载缓存到最大缓存数。 取值范围:[minCount, +∞),小于minCount时按minCount处理。 |
描述一个二维坐标系。
起始版本: 26.0.0
模型约束: 此接口仅可在Stage模型下使用。
元服务API: 从API版本26.0.0开始,该接口支持在元服务中使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
| 名称 | 类型 | 只读 | 可选 | 说明 |
|---|---|---|---|---|
| x | number | 否 | 否 | x轴坐标,单位vp。 |
| y | number | 否 | 否 | y轴坐标,单位vp。 |
设置组件的无障碍操作的可选参数,用于限制或修改屏幕朗读等辅助应用发起的操作行为。仅Slider组件支持使用。在其他组件使用该接口时,编译环节可正常通过,但接口功能不生效。
元服务API: 从API version 23开始,该接口支持在元服务中使用。
卡片能力: 从API version 23开始,该接口支持在ArkTS卡片中使用。
模型约束: 此接口仅可在Stage模型下使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
定义无障碍自定义下一个焦点处理过程中可使用的详细参数对象。
起始版本: 26.0.0
卡片能力: 从API版本26.0.0开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API版本26.0.0开始,该接口支持在元服务中使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
模型约束: 此接口仅可在Stage模型下使用。
| 名称 | 类型 | 只读 | 可选 | 说明 |
|---|---|---|---|---|
| isConsiderDescendants | boolean | 否 | 是 | 是否在无障碍自定义下一个焦点处理过程中查找后代节点中的焦点。 true表示在无障碍自定义下一个焦点处理过程中查找后代节点中的焦点;false表示在无障碍自定义下一个焦点处理过程中不查找后代节点中的焦点。 默认值:false |
自定义无障碍操作接口。
起始版本: 26.0.0
卡片能力: 从API版本26.0.0开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API版本26.0.0开始,该接口支持在元服务中使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
模型约束: 此接口仅可在Stage模型下使用。
| 名称 | 类型 | 只读 | 可选 | 说明 |
|---|---|---|---|---|
| name | ResourceStr | 否 | 否 | 自定义操作的名称,用于标识和绑定操作回调。 说明: 名称的文本长度需在128字节以内,超出部分将被截断。 |
| onAction | VoidCallback | 否 | 否 | 处理自定义操作的回调。 |