HarmonyOS:枚举说明

一、TitleHeight

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

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

名称 描述
MainOnly 只有主标题时标题栏的推荐高度(56vp)。
MainWithSub 同时有主标题和副标题时标题栏的推荐高度(82vp)。

二、EdgeEffect

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

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

名称 描述
Spring 弹性物理动效,滑动到边缘后可以根据初始速度或通过触摸事件继续滑动一段距离,松手后回弹。
Fade 阴影效果,滑动到边缘后会有圆弧状的阴影。
None 滑动到边缘后无效果。

示例

复制代码
 Scroll(){

    }
    .align(Alignment.TopStart)
    .edgeEffect(EdgeEffect.Spring)//设置边缘滑动效果。

三、Alignment

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

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

名称 描述
TopStart 顶部起始端。
Top 顶部横向居中。
TopEnd 顶部尾端。
Start 起始端纵向居中。
Center 横向和纵向居中。
End 尾端纵向居中。
BottomStart 底部起始端。
Bottom 底部横向居中。
BottomEnd 底部尾端。

示例

复制代码
 Scroll(){

    }
    .align(Alignment.TopStart)// 顶部起始端
    .edgeEffect(EdgeEffect.Spring)//设置边缘滑动效果。

四、BarState

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

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

名称 描述
Off 不显示。
On 常驻显示。
Auto 按需显示(触摸时显示,2s后消失)。

示例

复制代码
 Scroll() {
      Column() {
       
      }
    }
    .scrollable(ScrollDirection.Vertical)
    .scrollBar(BarState.Auto)
    .scrollBarColor(Color.Gray)
    .align(Alignment.TopStart)
  }

五、BorderStyle

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

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

名称 描述
Dotted 显示为一系列圆点,圆点半径为borderWidth的一半。
Dashed 显示为一系列短的方形虚线。
Solid 显示为一条实线。

六、Direction

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

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

名称 描述
Ltr 元素从左到右布局。
Rtl 元素从右到左布局。
Auto 使用系统默认布局方向。

七、Visibility

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

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

名称 描述
Hidden 隐藏,但参与布局进行占位。
Visible 显示。
None 隐藏,但不参与布局,不进行占位。

八、LineCapStyle

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

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

名称 描述
Butt 线条两端为平行线,不额外扩展。
Round 在线条两端延伸半个圆,直径等于线宽。
Square 在线条两端延伸一个矩形,宽度等于线宽的一半,高度等于线宽。

九、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开始,该接口支持在元服务中使用。

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

名称 描述
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开始,该接口支持在元服务中使用。

十七、FontWeight

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

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

名称 描述
Lighter 100 字体较细。
Normal 400 字体粗细正常。
Regular 400 字体粗细正常。
Medium 500 字体粗细适中。
Bold 700 字体较粗。
Bolder 900 字体非常粗。

十八、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 文本采用全大写。
相关推荐
陈奕昆37 分钟前
3.2 HarmonyOS NEXT跨设备任务调度与协同实战:算力分配、音视频协同与智能家居联动
音视频·智能家居·harmonyos
WLY2905 小时前
HarmonyOS 5 ------访问权限控制
harmonyos
fei_sun5 小时前
【Harmony OS】数据存储
harmonyos
鸿蒙自习室5 小时前
鸿蒙UI开发——组件的自适应拉伸
ui·华为·harmonyos·鸿蒙
WLY2905 小时前
HarmonyOS5---封装 日志 工具
harmonyos
lucky志6 小时前
探秘鸿蒙 HarmonyOS NEXT:一起了解鸿蒙的 AI 编程助手——CodeGenie!
harmonyos·arkts
塞尔维亚大汉6 小时前
OpenHarmony OpenCV应用样例开发
opencv·harmonyos
万少6 小时前
HarmonyOS Next 弹窗系列教程(2)
前端·华为·harmonyos
行十万里人生6 小时前
仓颉项目调试配置与多文件场景下的问题解析
开发语言·人工智能·机器学习·华为od·华为·华为云·harmonyos
程序员小刘16 小时前
【HarmonyOS 5】鸿蒙Taro跨端框架
华为·harmonyos·taro