HarmonyOS:枚举说明

66 阅读8分钟

一、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元素在主轴方向尾部对齐,最后一个元素与行尾对齐,其他元素与后一个对齐。
SpaceBetweenFlex主轴方向均匀分配弹性元素,相邻元素之间距离相同。第一个元素与行首对齐,最后一个元素与行尾对齐。
SpaceAroundFlex主轴方向均匀分配弹性元素,相邻元素之间距离相同。第一个元素到行首的距离和最后一个元素到行尾的距离是相邻元素之间距离的一半。
SpaceEvenlyFlex主轴方向均匀分配弹性元素,相邻元素之间的距离、第一个元素与行首的间距、最后一个元素到行尾的间距都完全一样。

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

名称描述
NoWrapFlex容器的元素单行/列布局,子元素尽可能约束在容器内。当子元素有最小尺寸约束等设置时,Flex容器不会对其强制弹性压缩。
WrapFlex容器的元素多行/列排布,子项允许超出容器。
WrapReverseFlex容器的元素反向多行/列排布,子项允许超出容器。

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

名称描述
Lighter100字体较细。
Normal400字体粗细正常。
Regular400字体粗细正常。
Medium500字体粗细适中。
Bold700字体较粗。
Bolder900字体非常粗。

十八、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文本采用全大写。