说明
本模块首批接口从API version 7开始支持,后续版本的新增接口,采用上角标单独标记接口的起始版本。
Color
卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
颜色名称 | 颜色值 | 颜色示意 |
---|---|---|
Black | 0x000000 | |
Blue | 0x0000ff | |
Brown | 0xa52a2a | |
Gray | 0x808080 | |
Grey | 0x808080 | |
Green | 0x008000 | |
Orange | 0xffa500 | |
Pink | 0xffc0cb | |
Red | 0xff0000 | |
White | 0xffffff | |
Yellow | 0xffff00 | |
Transparent9+ | rgba(0,0,0,0) | 透明色 |
ImageFit
卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
名称 | 描述 |
---|---|
Contain | 保持宽高比进行缩小或者放大,使得图片完全显示在显示边界内。 |
Cover | 保持宽高比进行缩小或者放大,使得图片两边都大于或等于显示边界。 |
Auto | 图像会根据其自身尺寸和组件的尺寸进行适当缩放,以在保持比例的同时填充视图。 |
Fill | 不保持宽高比进行放大缩小,使得图片充满显示边界。 |
ScaleDown | 保持宽高比显示,图片缩小或者保持不变。 |
None | 保持原有尺寸显示。 |
TOP_START12+ | 图像显示在Image组件的顶部起始端,保持原有尺寸显示。 |
TOP12+ | 图像显示在Image组件的顶部横向居中,保持原有尺寸显示。 |
TOP_END12+ | 图像显示在Image组件的顶部尾端,保持原有尺寸显示。 |
START12+ | 图像显示在Image组件的起始端纵向居中,保持原有尺寸显示。 |
CENTER12+ | 图像显示在Image组件的横向和纵向居中,保持原有尺寸显示。 |
END12+ | 图像显示在Image组件的尾端纵向居中,保持原有尺寸显示。 |
BOTTOM_START12+ | 图像显示在Image组件的底部起始端,保持原有尺寸显示。 |
BOTTOM12+ | 图像显示在Image组件的底部横向居中,保持原有尺寸显示。 |
BOTTOM_END12+ | 图像显示在Image组件的底部尾端,保持原有尺寸显示。 |
BorderStyle
卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
名称 | 描述 |
---|---|
Dotted | 显示为一系列圆点,圆点半径为borderWidth的一半。 |
Dashed | 显示为一系列短的方形虚线。 |
Solid | 显示为一条实线。 |
LineJoinStyle
卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
名称 | 描述 |
---|---|
Bevel | 使用斜角连接路径段。 |
Miter | 使用尖角连接路径段。 |
Round | 使用圆角连接路径段。 |
TouchType
元服务API: 从API version 11开始,该接口支持在元服务中使用。
名称 | 描述 |
---|---|
Down | 手指按下时触发。 |
Up | 手指抬起时触发。 |
Move | 手指按压态在屏幕上移动时触发。 |
Cancel | 触摸事件取消时触发。 |
MouseButton
元服务API: 从API version 11开始,该接口支持在元服务中使用。
名称 | 描述 |
---|---|
Left | 鼠标左键。 |
Right | 鼠标右键。 |
Middle | 鼠标中键。 |
Back | 鼠标左侧后退键。 |
Forward | 鼠标左侧前进键。 |
None | 无按键。 |
MouseAction
元服务API: 从API version 11开始,该接口支持在元服务中使用。
名称 | 描述 |
---|---|
Press | 鼠标按键按下。 |
Release | 鼠标按键松开。 |
Move | 鼠标移动。 |
Hover | 鼠标悬浮。 说明: 该枚举值无效。 |
Curve
卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
名称 | 描述 |
---|---|
Linear | 表示动画从头到尾的速度都是相同的。 |
Ease | 表示动画以低速开始,然后加快,在结束前变慢,CubicBezier(0.25, 0.1, 0.25, 1.0)。 |
EaseIn | 表示动画以低速开始,CubicBezier(0.42, 0.0, 1.0, 1.0)。 |
EaseOut | 表示动画以低速结束,CubicBezier(0.0, 0.0, 0.58, 1.0)。 |
EaseInOut | 表示动画以低速开始和结束,CubicBezier(0.42, 0.0, 0.58, 1.0)。 |
FastOutSlowIn | 标准曲线,CubicBezier(0.4, 0.0, 0.2, 1.0)。 |
LinearOutSlowIn | 减速曲线,CubicBezier(0.0, 0.0, 0.2, 1.0)。 |
FastOutLinearIn | 加速曲线,CubicBezier(0.4, 0.0, 1.0, 1.0)。 |
ExtremeDeceleration | 急缓曲线,CubicBezier(0.0, 0.0, 0.0, 1.0)。 |
Sharp | 锐利曲线,CubicBezier(0.33, 0.0, 0.67, 1.0)。 |
Rhythm | 节奏曲线,CubicBezier(0.7, 0.0, 0.2, 1.0)。 |
Smooth | 平滑曲线,CubicBezier(0.4, 0.0, 0.4, 1.0)。 |
Friction | 阻尼曲线,CubicBezier(0.2, 0.0, 0.2, 1.0)。 |
AnimationStatus
卡片能力: 从API version 10开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
名称 | 描述 |
---|---|
Initial | 动画初始状态。 |
Running | 动画处于播放状态。 |
Paused | 动画处于暂停状态。 |
Stopped | 动画处于停止状态。 |
FillMode
卡片能力: 从API version 10开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
名称 | 描述 |
---|---|
None | 动画未执行时不会将任何样式应用于目标,动画播放完成之后恢复初始默认状态。 |
Forwards | 目标将保留动画执行期间最后一个关键帧的状态。 |
Backwards | 动画将在应用于目标时立即应用第一个关键帧中定义的值,并在delay期间保留此值。第一个关键帧取决于playMode,playMode为Normal或Alternate时为from的状态,playMode为Reverse或AlternateReverse时为to的状态。 |
Both | 动画将遵循Forwards和Backwards的规则,从而在两个方向上扩展动画属性。 |
PlayMode
卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
名称 | 描述 |
---|---|
Normal | 动画正向播放。 |
Reverse | 动画反向播放。 |
Alternate | 动画在奇数次(1、3、5...)正向播放,在偶数次(2、4、6...)反向播放。 |
AlternateReverse | 动画在奇数次(1、3、5...)反向播放,在偶数次(2、4、6...)正向播放。 |
KeyType
元服务API: 从API version 11开始,该接口支持在元服务中使用。
名称 | 描述 |
---|---|
Down | 按键按下。 |
Up | 按键松开。 |
KeySource
元服务API: 从API version 11开始,该接口支持在元服务中使用。
名称 | 描述 |
---|---|
Unknown | 输入设备类型未知。 |
Keyboard | 输入设备类型为键盘。 |
Edge
元服务API: 从API version 11开始,该接口支持在元服务中使用。
名称 | 描述 |
---|---|
Top | 竖直方向上边缘。 卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。 |
Center(deprecated) | 竖直方向居中位置。 从API version 9开始废弃。 |
Bottom | 竖直方向下边缘。 卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。 |
Baseline(deprecated) | 交叉轴方向文本基线位置。 从API version 9开始废弃。 |
Start | 水平方向起始位置。 卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。 |
Middle(deprecated) | 水平方向居中位置。 从API version 9开始废弃。 |
End | 水平方向末尾位置。 卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。 |
Week
元服务API: 从API version 11开始,该接口支持在元服务中使用。
名称 | 描述 |
---|---|
Mon | 星期一 |
Tue | 星期二 |
Wed | 星期三 |
Thur | 星期四 |
Fri | 星期五 |
Sat | 星期六 |
Sun | 星期日 |
Direction
卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
名称 | 描述 |
---|---|
Ltr | 元素从左到右布局。 |
Rtl | 元素从右到左布局。 |
Auto | 使用系统默认布局方向。 |
BarState
卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
名称 | 描述 |
---|---|
Off | 不显示。 |
On | 常驻显示。 |
Auto | 按需显示(触摸时显示,2s后消失)。 |
EdgeEffect
卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
名称 | 描述 |
---|---|
Spring | 弹性物理动效,滑动到边缘后可以根据初始速度或通过触摸事件继续滑动一段距离,松手后回弹。 |
Fade | 阴影效果,滑动到边缘后会有圆弧状的阴影。 |
None | 滑动到边缘后无效果。 |
Alignment
卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
名称 | 描述 |
---|---|
TopStart | 顶部起始端。 |
Top | 顶部横向居中。 |
TopEnd | 顶部尾端。 |
Start | 起始端纵向居中。 |
Center | 横向和纵向居中。 |
End | 尾端纵向居中。 |
BottomStart | 底部起始端。 |
Bottom | 底部横向居中。 |
BottomEnd | 底部尾端。 |
TransitionType
卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
名称 | 描述 |
---|---|
All | 指定当前的Transition动效生效在组件的所有变化场景。 |
Insert | 指定当前的Transition动效生效在组件的插入显示场景。 |
Delete | 指定当前的Transition动效生效在组件的删除隐藏场景。 |
RelateType
元服务API: 从API version 11开始,该接口支持在元服务中使用。
名称 | 描述 |
---|---|
FILL | 缩放当前子组件以填充满父组件 |
FIT | 缩放当前子组件以自适应父组件 |
Visibility
卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
名称 | 描述 |
---|---|
Hidden | 隐藏,但参与布局进行占位。 |
Visible | 显示。 |
None | 隐藏,但不参与布局,不进行占位。 |
LineCapStyle
卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
名称 | 描述 |
---|---|
Butt | 线条两端为平行线,不额外扩展。 |
Round | 在线条两端延伸半个圆,直径等于线宽。 |
Square | 在线条两端延伸一个矩形,宽度等于线宽的一半,高度等于线宽。 |
Axis
卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
名称 | 描述 |
---|---|
Vertical | 方向为纵向。 |
Horizontal | 方向为横向。 |
HorizontalAlign
卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
名称 | 描述 |
---|---|
Start | 按照语言方向起始端对齐。 |
Center | 居中对齐,默认对齐方式。 |
End | 按照语言方向末端对齐。 |
FlexAlign
卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
名称 | 描述 |
---|---|
Start | 元素在主轴方向首端对齐,第一个元素与行首对齐,同时后续的元素与前一个对齐。 |
Center | 元素在主轴方向中心对齐,第一个元素与行首的距离与最后一个元素与行尾距离相同。 |
End | 元素在主轴方向尾部对齐,最后一个元素与行尾对齐,其他元素与后一个对齐。 |
SpaceBetween | Flex主轴方向均匀分配弹性元素,相邻元素之间距离相同。第一个元素与行首对齐,最后一个元素与行尾对齐。 |
SpaceAround | Flex主轴方向均匀分配弹性元素,相邻元素之间距离相同。第一个元素到行首的距离和最后一个元素到行尾的距离是相邻元素之间距离的一半。 |
SpaceEvenly | Flex主轴方向均匀分配弹性元素,相邻元素之间的距离、第一个元素与行首的间距、最后一个元素到行尾的间距都完全一样。 |
ItemAlign
卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
名称 | 描述 |
---|---|
Auto | 使用Flex容器中默认配置。 |
Start | 元素在Flex容器中,交叉轴方向首部对齐。 |
Center | 元素在Flex容器中,交叉轴方向居中对齐。 |
End | 元素在Flex容器中,交叉轴方向底部对齐。 |
Stretch | 元素在Flex容器中,交叉轴方向拉伸填充。容器为Flex且设置Wrap为FlexWrap.Wrap或FlexWrap.WrapReverse时,元素拉伸到与当前行/列交叉轴长度最长的元素尺寸。其余情况下,无论元素尺寸是否设置,均拉伸到容器尺寸。 |
Baseline | 元素在Flex容器中,交叉轴方向文本基线对齐。 |
FlexDirection
卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
名称 | 描述 |
---|---|
Row | 主轴与行方向一致作为布局模式。 |
RowReverse | 与Row方向相反方向进行布局。 |
Column | 主轴与列方向一致作为布局模式。 |
ColumnReverse | 与Column相反方向进行布局。 |
FlexWrap
卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
名称 | 描述 |
---|---|
NoWrap | Flex容器的元素单行/列布局,子元素尽可能约束在容器内。当子元素有最小尺寸约束等设置时,Flex容器不会对其强制弹性压缩。 |
Wrap | Flex容器的元素多行/列排布,子项允许超出容器。 |
WrapReverse | Flex容器的元素反向多行/列排布,子项允许超出容器。 |
VerticalAlign
卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
名称 | 描述 |
---|---|
Top | 顶部对齐。 |
Center | 居中对齐,默认对齐方式。 |
Bottom | 底部对齐。 |
ImageRepeat
卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
名称 | 描述 |
---|---|
X | 只在水平轴上重复绘制图片。 |
Y | 只在竖直轴上重复绘制图片。 |
XY | 在两个轴上重复绘制图片。 |
NoRepeat | 不重复绘制图片。 |
ImageSize
卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。
类型 | 描述 |
---|---|
Cover | 默认值,保持宽高比进行缩小或者放大,使得图片两边都大于或等于显示边界。 元服务API: 从API version 11开始,该接口支持在元服务中使用。 |
Contain | 保持宽高比进行缩小或者放大,使得图片完全显示在显示边界内。 元服务API: 从API version 11开始,该接口支持在元服务中使用。 |
Auto | 保持原图的比例不变。 元服务API: 从API version 11开始,该接口支持在元服务中使用。 |
FILL12+ | 不保持宽高比进行放大缩小,使得图片充满显示边界。 元服务API: 从API version 12开始,该接口支持在元服务中使用。 |
GradientDirection
卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
名称 | 描述 |
---|---|
Left | 从右向左。 |
Top | 从下向上。 |
Right | 从左向右。 |
Bottom | 从上向下。 |
LeftTop | 左上。 |
LeftBottom | 左下。 |
RightTop | 右上。 |
RightBottom | 右下。 |
None | 无。 |
SharedTransitionEffectType
元服务API: 从API version 11开始,该接口支持在元服务中使用。
名称 | 描述 |
---|---|
Static | 目标页面元素的位置保持不变,可以配置透明度动画。目前,只有为重定向到目标页面而配置的静态效果才会生效。 |
Exchange | 将源页面元素移动到目标页面元素位置并适当缩放。 |
FontStyle
卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
名称 | 描述 |
---|---|
Normal | 标准的字体样式。 |
Italic | 斜体的字体样式。 |
FontWeight
卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
名称 | 描述 |
---|---|
Lighter | 字体较细。 |
Normal | 字体粗细正常。 |
Regular | 字体粗细正常。 |
Medium | 字体粗细适中。 |
Bold | 字体较粗。 |
Bolder | 字体非常粗。 |
TextAlign
卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
名称 | 描述 |
---|---|
Start | 水平对齐首部。 |
Center | 水平居中对齐。 |
End | 水平对齐尾部。 |
JUSTIFY10+ | 双端对齐。 |
TextOverflow
卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
名称 | 描述 |
---|---|
None | 文本超长时按最大行截断显示。 |
Clip | 文本超长时按最大行截断显示。 |
Ellipsis | 文本超长时显示不下的文本用省略号代替。 |
MARQUEE10+ | 文本超长时以跑马灯的方式展示。 |
TextDecorationType
卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
名称 | 描述 |
---|---|
Underline | 文字下划线修饰。 |
LineThrough | 穿过文本的修饰线。 |
Overline | 文字上划线修饰。 |
None | 不使用文本装饰线。 |
TextCase
卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
名称 | 描述 |
---|---|
Normal | 保持文本原有大小写。 |
LowerCase | 文本采用全小写。 |
UpperCase | 文本采用全大写。 |
ResponseType8+
元服务API: 从API version 11开始,该接口支持在元服务中使用。
名称 | 描述 |
---|---|
LongPress | 通过长按触发菜单弹出。 |
RightClick | 通过鼠标右键触发菜单弹出。 |
RichEditorResponseType11+
元服务API: 从API version 12开始,该接口支持在元服务中使用。
名称 | 描述 |
---|---|
LONG_PRESS | 通过长按触发菜单弹出。 |
RIGHT_CLICK | 通过鼠标右键触发菜单弹出。 |
SELECT | 通过鼠标选中触发菜单弹出。 |
HoverEffect8+
元服务API: 从API version 11开始,该接口支持在元服务中使用。
名称 | 描述 |
---|---|
Auto | 使用组件的系统默认悬浮效果。 |
Scale | 放大缩小效果。 |
Highlight | 背景淡入淡出的强调效果。 |
None | 不设置效果。 |
Placement8+
元服务API: 从API version 11开始,该接口支持在元服务中使用。
名称 | 描述 |
---|---|
Left | 气泡提示位于组件左侧,与组件左侧中心对齐。 |
Right | 气泡提示位于组件右侧,与组件右侧中心对齐。 |
Top | 气泡提示位于组件上侧,与组件上侧中心对齐。 |
Bottom | 气泡提示位于组件下侧,与组件下侧中心对齐。 |
TopLeft | 气泡提示位于组件上侧,从API Version 9开始,与组件左侧边缘对齐。 |
TopRight | 气泡提示位于组件上侧,从API Version 9开始,与组件右侧边缘对齐。 |
BottomLeft | 气泡提示位于组件下侧,从API Version 9开始,与组件左侧边缘对齐。 |
BottomRight | 气泡提示位于组件下侧,从API Version 9开始,与组件右侧边缘对齐。 |
LeftTop9+ | 气泡提示位于组件左侧,与组件上侧边缘对齐。 |
LeftBottom9+ | 气泡提示位于组件左侧,与组件下侧边缘对齐。 |
RightTop9+ | 气泡提示位于组件右侧,与组件上侧边缘对齐。 |
RightBottom9+ | 气泡提示位于组件右侧,与组件下侧边缘对齐。 |
CopyOptions9+
卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。
名称 | 描述 |
---|---|
None | 不支持复制。 元服务API: 从API version 11开始,该接口支持在元服务中使用。 |
InApp | 支持应用内复制。 元服务API: 从API version 11开始,该接口支持在元服务中使用。 |
LocalDevice | 支持设备内复制。 元服务API: 从API version 11开始,该接口支持在元服务中使用。 |
CROSS_DEVICE(deprecated) | 支持跨设备复制。 说明: 从API version 11开始支持,从API version 12开始废弃。 |
HitTestMode9+
元服务API: 从API version 11开始,该接口支持在元服务中使用。
名称 | 描述 |
---|---|
Default | 自身节点和子节点都响应触摸事件的命中测试,但会阻止被该节点屏蔽的其他节点的命中测试。 |
Block | 自身节点响应触摸事件的命中测试,但阻止被该节点屏蔽的子节点和其他节点的命中测试。 |
Transparent | 自身节点和子节点响应触摸事件的命中测试,并允许对被该节点屏蔽的其他节点进行命中测试。 |
None | 自身节点不会响应触摸事件的命中测试,但子节点会对触摸事件进行命中测试。 |
DialogButtonStyle10+枚举说明
系统能力: SystemCapability.ArkUI.ArkUI.Full
元服务API: 从API version 11开始,该接口支持在元服务中使用。
名称 | 描述 |
---|---|
DEFAULT | 白底蓝字(深色主题:白底=黑底)。 |
HIGHLIGHT | 蓝底白字。 |
ThemeColorMode10+
元服务API: 从API version 11开始,该接口支持在元服务中使用。
名称 | 描述 |
---|---|
SYSTEM | 跟随系统深浅色模式。 |
LIGHT | 固定使用浅色模式。 |
DARK | 固定使用深色模式。 |
TextHeightAdaptivePolicy10+
元服务API: 从API version 11开始,该接口支持在元服务中使用。
名称 | 描述 |
---|---|
MAX_LINES_FIRST | 设置文本高度自适应方式为以MaxLines优先。 |
MIN_FONT_SIZE_FIRST | 设置文本高度自适应方式为以缩小字体优先。 |
LAYOUT_CONSTRAINT_FIRST | 设置文本高度自适应方式为以布局约束(高度)优先。 |
NestedScrollMode10+枚举说明
元服务API: 从API version 11开始,该接口支持在元服务中使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
名称 | 描述 |
---|---|
SELF_ONLY | 只自身滚动,不与父组件联动。 |
SELF_FIRST | 自身先滚动,自身滚动到边缘以后父组件滚动。父组件滚动到边缘以后,如果父组件有边缘效果,则父组件触发边缘效果,否则子组件触发边缘效果。 |
PARENT_FIRST | 父组件先滚动,父组件滚动到边缘以后自身滚动。自身滚动到边缘后,如果有边缘效果,会触发自身的边缘效果,否则触发父组件的边缘效果。 |
PARALLEL | 自身和父组件同时滚动,自身和父组件都到达边缘以后,如果自身有边缘效果,则自身触发边缘效果,否则父组件触发边缘效果。 |
ObscuredReasons10+
该接口支持在ArkTS卡片中使用。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
名称 | 描述 |
---|---|
PLACEHOLDER | 显示的数据为通用占位符。 |
ClickEffectLevel10+
元服务API: 从API version 11开始,该接口支持在元服务中使用。
名称 | 描述 | 动效参数 | 默认缩放比 |
---|---|---|---|
LIGHT | 小面积(轻盈) | 弹簧动效, 刚性:410,阻尼:38,初始速度:1 | 90% |
MIDDLE | 中面积(稳定) | 弹簧动效, 刚性:350,阻尼:35,初始速度:0.5 | 95% |
HEAVY | 大面积(厚重) | 弹簧动效, 刚性:240,阻尼:28,初始速度:0 | 95% |
FoldStatus11+
元服务API: 从API version 12开始,该接口支持在元服务中使用。
名称 | 描述 |
---|---|
FOLD_STATUS_UNKNOWN | 表示设备当前折叠状态未知。 |
FOLD_STATUS_EXPANDED | 表示设备当前折叠状态为完全展开。 |
FOLD_STATUS_FOLDED | 表示设备当前折叠状态为折叠。 |
FOLD_STATUS_HALF_FOLDED | 表示设备当前折叠状态为半折叠。半折叠指完全展开和折叠之间的状态。 |
TextContentStyle10+
元服务API: 从API version 11开始,该接口支持在元服务中使用。
名称 | 描述 |
---|---|
DEFAULT | 默认风格,光标宽1.5vp,光标高度与文本选中底板高度和字体大小相关。 |
INLINE | 内联输入风格。文本选中底板高度与输入框高度相同。 内联输入是在有明显的编辑态/非编辑态的区分场景下使用,例如:文件列表视图中的重命名。 不支持showError属性。 |
Nullable 11+
Nullable<T> {
(data: T);
}
开发者在使用该类型时候,该类型的对象可以是自定义类型,也可以是undefined。
元服务API: 从API version 12开始,该接口支持在元服务中使用。
系统能力:SystemCapability.ArkUI.ArkUI.Full
名称 | 类型 | 必填 | 说明 |
---|---|---|---|
data | T | 是 | 该类型申明的对象可以是自定义类型,也可以是undefined。 |
WordBreak11+
元服务API: 从API version 11开始,该接口支持在元服务中使用。
名称 | 描述 |
---|---|
NORMAL | CJK(中文、日文、韩文)文本可以在任意2个字符间断行,而Non-CJK文本(如英文等)只能在空白符处断行。 |
BREAK_ALL | 对于Non-CJK的文本,可在任意2个字符间断行。对于CJK与NORMAL效果一致。 |
BREAK_WORD | 与BREAK_ALL相同,对于Non-CJK的文本可在任意2个字符间断行,一行文本中有断行破发点(如空白符)时,优先按破发点换行,保障单词优先完整显示。若整一行文本均无断行破发点时,则在任意2个字符间断行。对于CJK与NORMAL效果一致。 |
LineBreakStrategy12+
元服务API: 从API version 12开始,该接口支持在元服务中使用。
名称 | 描述 |
---|---|
GREEDY | 使每一行尽量显示多的字符,直到这一行不能显示更多字符再进行折行。 |
HIGH_QUALITY | 在BALANCED的基础上,尽可能填满行,在最后一行的权重上比较低,可能会出现最后一行留白比较多。 |
BALANCED | 尽可能保证在不拆词的情况下,使一个段落中每一行的宽度相同。 |
TextSelectableMode12+
名称 | 描述 |
---|---|
SELECTABLE_UNFOCUSABLE | 文本可选择,但不可获焦,设置属性selection、bindSelectionMenu、copyOption不影响当前行为。 |
SELECTABLE_FOCUSABLE | 文本可选择,可获焦并Touch后获得焦点。 |
UNSELECTABLE | 文本不可选择,不可获焦,设置属性selection、bindSelectionMenu、copyOption都不生效。 |
EllipsisMode11+
卡片能力: 从API version 11开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 12开始,该接口支持在元服务中使用。
名称 | 描述 |
---|---|
START | 省略行首内容。 |
CENTER | 省略行中内容。 |
END | 省略行末内容。 |
ArrowPointPosition11+
元服务API: 从API version 12开始,该接口支持在元服务中使用。
名称 | 描述 |
---|---|
START | 水平方向:位于父组件最左侧,垂直方向:位于父组件最上侧。 |
CENTER | 位于父组件居中位置。 |
END | 水平方向:位于父组件最右侧,垂直方向:位于父组件最下侧。 |
OptionWidthMode11+枚举说明
系统能力: SystemCapability.ArkUI.ArkUI.Full
元服务API: 从API version 12开始,该接口支持在元服务中使用。
名称 | 描述 |
---|---|
FIT_CONTENT | 设置该值时,下拉菜单宽度按默认2栅格显示。 |
FIT_TRIGGER | 设置下拉菜单继承下拉按钮宽度。 |
SelectionMenuOptions11+
范围信息。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
名称 | 类型 | 只读 | 必填 | 描述 |
---|---|---|---|---|
onAppear | MenuOnAppearCallback | 否 | 否 | 自定义选择菜单弹出时回调。 |
onDisappear | () => void | 否 | 否 | 自定义选择菜单关闭时回调。 |
DismissReason12+
元服务API: 从API version 12开始,该接口支持在元服务中使用。
名称 | 值 | 描述 |
---|---|---|
PRESS_BACK | 0 | 点击三键back、左滑/右滑、键盘ESC。 |
TOUCH_OUTSIDE | 1 | 点击遮障层时。 |
CLOSE_BUTTON | 2 | 点击关闭按钮。 |
SLIDE_DOWN | 3 | 下拉关闭。 说明: 该接口仅支持在半模态转场中使用。 |
ChainStyle12+
元服务API: 从API version 12开始,该接口支持在元服务中使用。
定义链的风格。
名称 | 描述 |
---|---|
SPREAD | 组件在约束锚点间均匀分布。 |
SPREAD_INSIDE | 除首尾2个子组件的其他组件在约束锚点间均匀分布。 |
PACKED | 链内子组件无间隙。 |
BarrierDirection12+
定义屏障线的方向。
元服务API: 从API version 12开始,该接口支持在元服务中使用。
名称 | 描述 |
---|---|
LEFT | 屏障在其所有referencedId的最左侧。 |
RIGHT | 屏障在其所有referencedId的最右侧。 |
TOP | 屏障在其所有referencedId的最上方。 |
BOTTOM | 屏障在其所有referencedId的最下方。 |
PixelRoundCalcPolicy11+
组件边界像素级取整计算策略。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
名称 | 描述 |
---|---|
NO_FORCE_ROUND | 不取整计算。 |
FORCE_CEIL | 取上整计算。 |
FORCE_FLOOR | 取下整计算。 |
TextDecorationStyle12+
元服务API: 从API version 12开始,该接口支持在元服务中使用。
名称 | 描述 |
---|---|
SOLID | 单实线(默认值)。 |
DOUBLE | 双实线。 |
DOTTED | 点线。 |
DASHED | 虚线。 |
WAVY | 波浪线。 |
FlexSpaceOptions12+
名称 | 类型 | 只读 | 必填 | 说明 |
---|---|---|---|---|
main | LengthMetrics | 否 | 否 | Flex容器主轴上的space。 space: {main: LengthMetrics.unit(value)} |
cross | LengthMetrics | 否 | 否 | Flex容器交叉轴上的space。 space: {cross: LengthMetrics.unit(value)} |
MenuPolicy12+
菜单弹出的策略。
元服务API: 从API version 12开始,该接口支持在元服务中使用。
名称 | 值 | 描述 |
---|---|---|
DEFAULT | 0 | 按照底层默认逻辑决定是否弹出菜单。 |
HIDE | 1 | 始终不弹出菜单。 |
SHOW | 2 | 始终弹出菜单。 |
EmbeddedType12+
枚举类型,用于指定EmbeddedComponent可拉起的提供方类型。
元服务API: 从API version 12开始,该接口支持在元服务中使用。
名称 | 值 | 说明 |
---|---|---|
EMBEDDED_UI_EXTENSION | 0 | 表示当前拉起的提供方类型为EmbeddedUIExtensionAbility。 |
MarqueeUpdateStrategy12+枚举说明
元服务API: 从API version 12开始,该接口支持在元服务中使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
名称 | 值 | 描述 |
---|---|---|
DEFAULT | 0 | 跑马灯组件属性更新后, 从开始位置, 运行跑马灯效果。 |
PRESERVE_POSITION | 1 | 跑马灯组件属性更新后, 保持当前位置, 运行跑马灯效果。 |
AppRotation12+
元服务API: 从API version 12开始,该接口支持在元服务中使用。
名称 | 描述 |
---|---|
ROTATION_0 | 应用方向为0度。 |
ROTATION_90 | 应用方向为90度。 |
ROTATION_180 | 应用方向为180度。 |
ROTATION_270 | 应用方向为270度。 |
ScrollSource12+枚举说明
滑动操作的来源。
元服务API: 从API version 12开始,该接口支持在元服务中使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
名称 | 枚举值 | 描述 |
---|---|---|
DRAG | 0 | 拖拽事件。 |
FLING | 1 | 拖拽结束之后的惯性滑动。 |
EDGE_EFFECT | 2 | EdgeEffect.Spring的边缘滚动效果。 |
OTHER_USER_INPUT | 3 | 除拖拽外的其他用户输入,如鼠标滚轮、键盘事件等。 |
SCROLL_BAR | 4 | 滚动条的拖拽事件。 |
SCROLL_BAR_FLING | 5 | 滚动条拖拽结束后的带速度的惯性滑动。 |
SCROLLER | 6 | Scroller的不带动效方法。 |
SCROLLER_ANIMATION | 7 | Scroller的带动效方法。 |
ImageSpanAlignment10+枚举说明
元服务API: 从API version 11开始,该接口支持在元服务中使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
名称 | 描述 |
---|---|
TOP | 图片上边沿与行上边沿对齐。 |
CENTER | 图片中间与行中间对齐。 |
BOTTOM | 图片下边沿与行下边沿对齐。 |
BASELINE | 图片下边沿与文本BaseLine对齐。 |
最后
小编在之前的鸿蒙系统扫盲中,有很多朋友给我留言,不同的角度的问了一些问题,我明显感觉到一点,那就是许多人参与鸿蒙开发,但是又不知道从哪里下手,因为资料太多,太杂,教授的人也多,无从选择。有很多小伙伴不知道学习哪些鸿蒙开发技术?不知道需要重点掌握哪些鸿蒙应用开发知识点?而且学习时频繁踩坑,最终浪费大量时间。所以有一份实用的鸿蒙(HarmonyOS NEXT)资料用来跟着学习是非常有必要的。
为了确保高效学习,建议规划清晰的学习路线,涵盖以下关键阶段:
→【纯血版鸿蒙全套最新学习资料】希望这一份鸿蒙学习资料能够给大家带来帮助~
鸿蒙(HarmonyOS NEXT)最新学习路线
该路线图包含基础技能、就业必备技能、多媒体技术、六大电商APP、进阶高级技能、实战就业级设备开发,不仅补充了华为官网未涉及的解决方案
路线图适合人群:
IT开发人员:想要拓展职业边界
零基础小白:鸿蒙爱好者,希望从0到1学习,增加一项技能。
技术提升/进阶跳槽:发展瓶颈期,提升职场竞争力,快速掌握鸿蒙技术
2.视频学习资料+学习PDF文档
HarmonyOS Next 最新全套视频教程 (鸿蒙语法ArkTS、TypeScript、ArkUI教程……)
纯血版鸿蒙全套学习资料(面试、文档、全套视频等)
鸿蒙APP开发必备
总结
总的来说,华为鸿蒙不再兼容安卓,对程序员来说是一个挑战,也是一个机会。只有积极应对变化,不断学习和提升自己,才能在这个变革的时代中立于不败之地。