1# 枚举说明 2 3>**说明:** 4> 5>本模块首批接口从API version 7开始支持,后续版本的新增接口,采用上角标单独标记接口的起始版本。 6 7## Color 8 9**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。 10 11**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 12 13**系统能力:** SystemCapability.ArkUI.ArkUI.Full 14 15| 名称 | 值 | 说明 | 16| ------------------------ | ------------- | ------------------------------------------------------------ | 17| Black | 0x000000 |  | 18| Blue | 0x0000ff |  | 19| Brown | 0xa52a2a |  | 20| Gray | 0x808080 |  | 21| Grey | 0x808080 |  | 22| Green | 0x008000 |  | 23| Orange | 0xffa500 |  | 24| Pink | 0xffc0cb |  | 25| Red | 0xff0000 |  | 26| White | 0xffffff |  | 27| Yellow | 0xffff00 |  | 28| Transparent<sup>9+</sup> | rgba(0,0,0,0) | 透明色 | 29 30## ImageFit 31 32**系统能力:** SystemCapability.ArkUI.ArkUI.Full 33 34| 名称 | 值 | 说明 | 35| --------- | ----- | ------------------------------- | 36| Contain | 0 | 保持宽高比进行缩小或者放大,使得图片完全显示在显示边界内,对齐方式为水平居中。<br/>**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。<br>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。<br/> | 37| Cover | 1 | 保持宽高比进行缩小或者放大,使得图片两边都大于或等于显示边界,对齐方式为水平居中。<br/>**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。<br/> | 38| Auto | 2 | 图像会根据其自身尺寸和组件的尺寸进行适当缩放,以在保持比例的同时填充视图,对齐方式为水平居中。<br/>**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。<br/> | 39| Fill | 3 | 不保持宽高比进行放大缩小,使得图片充满显示边界,对齐方式为水平居中。<br/>**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。<br/> | 40| ScaleDown | 4 | 保持宽高比显示,图片缩小或者保持不变,对齐方式为水平居中。<br/>**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。<br/> | 41| None | 5 | 保持原有尺寸显示,对齐方式为水平居中。<br/>**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。<br/> | 42| TOP_START<sup>12+</sup> | 7 | 图像显示在Image组件的顶部起始端,保持原有尺寸显示。<br/>**卡片能力:** 从API version 12开始,该接口支持在ArkTS卡片中使用。<br/>**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。<br/> | 43| TOP<sup>12+</sup> | 8 | 图像显示在Image组件的顶部横向居中,保持原有尺寸显示。<br/>**卡片能力:** 从API version 12开始,该接口支持在ArkTS卡片中使用。<br/>**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。<br/> | 44| TOP_END<sup>12+</sup> | 9 | 图像显示在Image组件的顶部尾端,保持原有尺寸显示。<br/>**卡片能力:** 从API version 12开始,该接口支持在ArkTS卡片中使用。<br/>**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。<br/> | 45| START<sup>12+</sup> | 10 | 图像显示在Image组件的起始端纵向居中,保持原有尺寸显示。<br/>**卡片能力:** 从API version 12开始,该接口支持在ArkTS卡片中使用。<br/>**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。<br/> | 46| CENTER<sup>12+</sup> | 11 | 图像显示在Image组件的横向和纵向居中,保持原有尺寸显示。<br/>**卡片能力:** 从API version 12开始,该接口支持在ArkTS卡片中使用。<br/>**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。<br/> | 47| END<sup>12+</sup> | 12 | 图像显示在Image组件的尾端纵向居中,保持原有尺寸显示。<br/>**卡片能力:** 从API version 12开始,该接口支持在ArkTS卡片中使用。<br/>**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。<br/> | 48| BOTTOM_START<sup>12+</sup> | 13 | 图像显示在Image组件的底部起始端,保持原有尺寸显示。<br/>**卡片能力:** 从API version 12开始,该接口支持在ArkTS卡片中使用。<br/>**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。<br/> | 49| BOTTOM<sup>12+</sup> | 14 | 图像显示在Image组件的底部横向居中,保持原有尺寸显示。<br/>**卡片能力:** 从API version 12开始,该接口支持在ArkTS卡片中使用。<br/>**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。<br/> | 50| BOTTOM_END<sup>12+</sup>| 15 | 图像显示在Image组件的底部尾端,保持原有尺寸显示。<br/>**卡片能力:** 从API version 12开始,该接口支持在ArkTS卡片中使用。<br/>**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。<br/> | 51| MATRIX<sup>15+</sup>| 16 | 配合[imageMatrix](ts-basic-components-image.md#imagematrix15)使用,使图像在Image组件自定义位置显示,保持原有尺寸显示。不支持svg图源。<br/>**原子化服务API:** 从API version 15开始,该接口支持在原子化服务中使用。 | 52 53## BorderStyle 54 55**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。 56 57**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 58 59**系统能力:** SystemCapability.ArkUI.ArkUI.Full 60 61| 名称 | 说明 | 62| ------ | ----------------------------- | 63| Dotted | 显示为一系列圆点,圆点半径为borderWidth的一半。 | 64| Dashed | 显示为一系列短的方形虚线。 | 65| Solid | 显示为一条实线。 | 66 67## LineJoinStyle 68 69**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。 70 71**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 72 73**系统能力:** SystemCapability.ArkUI.ArkUI.Full 74 75| 名称 | 说明 | 76| ----- | ---------- | 77| Bevel | 使用斜角连接路径段。 | 78| Miter | 使用尖角连接路径段。 | 79| Round | 使用圆角连接路径段。 | 80 81## TouchType 82 83**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 84 85**系统能力:** SystemCapability.ArkUI.ArkUI.Full 86 87| 名称 | 说明 | 88| ------ | --------------- | 89| Down | 手指按下时触发。 | 90| Up | 手指抬起时触发。 | 91| Move | 手指按压态在屏幕上移动时触发。 | 92| Cancel | 触摸事件取消时触发。 | 93 94## MouseButton<sup>8+</sup> 95 96**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 97 98**系统能力:** SystemCapability.ArkUI.ArkUI.Full 99 100| 名称 | 说明 | 101| ------- | -------- | 102| Left | 鼠标左键。 | 103| Right | 鼠标右键。 | 104| Middle | 鼠标中键。 | 105| Back | 鼠标左侧后退键。 | 106| Forward | 鼠标左侧前进键。 | 107| None | 无按键。 | 108 109## MouseAction<sup>8+</sup> 110 111**系统能力:** SystemCapability.ArkUI.ArkUI.Full 112 113| 名称 | 说明 | 114| ------- | ------- | 115| Press | 鼠标按键按下。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | 116| Release | 鼠标按键松开。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | 117| Move | 鼠标移动。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | 118| Hover | 鼠标悬浮。<br/>**说明:** 该枚举值无效。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | 119| CANCEL<sup>18+</sup> | 鼠标按键被取消。<br/>**原子化服务API:** 从API version 18开始,该接口支持在原子化服务中使用。 | 120 121## ModifierKey<sup>10+</sup> 122 123输入法修饰键类型。 124 125**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 126 127**系统能力:** SystemCapability.ArkUI.ArkUI.Full 128 129| 名称 | 说明 | 130| ----- | ------------ | 131| CTRL | 表示键盘上Ctrl键。 | 132| SHIFT | 表示键盘上Shift键。 | 133| ALT | 表示键盘上Alt键。 | 134 135## FunctionKey<sup>10+</sup> 136 137输入法功能键类型。 138 139**系统能力:** SystemCapability.ArkUI.ArkUI.Full 140 141| 名称 | 说明 | 142| ---- | ------------ | 143| ESC | 表示键盘上ESC功能键。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | 144| F1 | 表示键盘上F1功能键。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | 145| F2 | 表示键盘上F2功能键。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | 146| F3 | 表示键盘上F3功能键。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | 147| F4 | 表示键盘上F4功能键。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | 148| F5 | 表示键盘上F5功能键。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | 149| F6 | 表示键盘上F6功能键。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | 150| F7 | 表示键盘上F7功能键。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | 151| F8 | 表示键盘上F8功能键。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | 152| F9 | 表示键盘上F9功能键。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | 153| F10 | 表示键盘上F10功能键。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | 154| F11 | 表示键盘上F11功能键。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | 155| F12 | 表示键盘上F12功能键。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | 156| TAB<sup>12+</sup> | 表示键盘上TAB功能键。 <br/>**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。| 157| DPAD_UP<sup>12+</sup> | 表示键盘上UP方向键。 <br/>**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。| 158| DPAD_DOWN<sup>12+</sup> | 表示键盘上DOWN方向键。 <br/>**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。| 159| DPAD_LEFT<sup>12+</sup> | 表示键盘上LEFT方向键。 <br/>**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。| 160| DPAD_RIGHT<sup>12+</sup> | 表示键盘上RIGHT方向键。 <br/>**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。| 161 162## Curve 163 164插值曲线,动效请参考<!--RP1-->[贝塞尔曲线](../../../../design/ux-design/animation-attributes.md)<!--RP1End-->。 165 166**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。 167 168**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 169 170**系统能力:** SystemCapability.ArkUI.ArkUI.Full 171 172| 名称 | 说明 | 173| ------------------- | ---------------------------------------- | 174| Linear | 表示动画从头到尾的速度都是相同的。 | 175| Ease | 表示动画以低速开始,然后加快,在结束前变慢,CubicBezier(0.25, 0.1, 0.25, 1.0)。 | 176| EaseIn | 表示动画以低速开始,CubicBezier(0.42, 0.0, 1.0, 1.0)。 | 177| EaseOut | 表示动画以低速结束,CubicBezier(0.0, 0.0, 0.58, 1.0)。 | 178| EaseInOut | 表示动画以低速开始和结束,CubicBezier(0.42, 0.0, 0.58, 1.0)。 | 179| FastOutSlowIn | 标准曲线,CubicBezier(0.4, 0.0, 0.2, 1.0)。 | 180| LinearOutSlowIn | 减速曲线,CubicBezier(0.0, 0.0, 0.2, 1.0)。 | 181| FastOutLinearIn | 加速曲线,CubicBezier(0.4, 0.0, 1.0, 1.0)。 | 182| ExtremeDeceleration | 急缓曲线,CubicBezier(0.0, 0.0, 0.0, 1.0)。 | 183| Sharp | 锐利曲线,CubicBezier(0.33, 0.0, 0.67, 1.0)。 | 184| Rhythm | 节奏曲线,CubicBezier(0.7, 0.0, 0.2, 1.0)。 | 185| Smooth | 平滑曲线,CubicBezier(0.4, 0.0, 0.4, 1.0)。 | 186| Friction | 阻尼曲线,CubicBezier(0.2, 0.0, 0.2, 1.0)。 | 187 188## AnimationStatus 189 190**卡片能力:** 从API version 10开始,该接口支持在ArkTS卡片中使用。 191 192**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 193 194**系统能力:** SystemCapability.ArkUI.ArkUI.Full 195 196| 名称 | 说明 | 197| ------- | --------- | 198| Initial | 动画初始状态。 | 199| Running | 动画处于播放状态。 | 200| Paused | 动画处于暂停状态。 | 201| Stopped | 动画处于停止状态。 | 202 203## FillMode 204 205**卡片能力:** 从API version 10开始,该接口支持在ArkTS卡片中使用。 206 207**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 208 209**系统能力:** SystemCapability.ArkUI.ArkUI.Full 210 211| 名称 | 说明 | 212| --------- | ---------------------------------------- | 213| None | 动画未执行时不会将任何样式应用于目标,动画播放完成之后恢复初始默认状态。 | 214| Forwards | 目标将保留动画执行期间最后一个关键帧的状态。 | 215| Backwards | 动画将在应用于目标时立即应用第一个关键帧中定义的值,并在delay期间保留此值。第一个关键帧取决于playMode,playMode为Normal或Alternate时为from的状态,playMode为Reverse或AlternateReverse时为to的状态。 | 216| Both | 动画将遵循Forwards和Backwards的规则,从而在两个方向上扩展动画属性。 | 217 218## PlayMode 219 220**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。 221 222**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 223 224**系统能力:** SystemCapability.ArkUI.ArkUI.Full 225 226| 名称 | 说明 | 227| ---------------- | ---------------------------------------- | 228| Normal | 动画正向播放。 | 229| Reverse | 动画反向播放。 | 230| Alternate | 动画在奇数次(1、3、5...)正向播放,在偶数次(2、4、6...)反向播放。 | 231| AlternateReverse | 动画在奇数次(1、3、5...)反向播放,在偶数次(2、4、6...)正向播放。 | 232 233## KeyType 234 235**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 236 237**系统能力:** SystemCapability.ArkUI.ArkUI.Full 238 239| 名称 | 说明 | 240| ---- | ----- | 241| Down | 按键按下。 | 242| Up | 按键松开。 | 243 244## KeySource 245 246**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 247 248**系统能力:** SystemCapability.ArkUI.ArkUI.Full 249 250| 名称 | 说明 | 251| -------- | ---------- | 252| Unknown | 输入设备类型未知。 | 253| Keyboard | 输入设备类型为键盘。 | 254| JOYSTICK<sup>15+</sup> | 输入设备类型为游戏手柄。<br/>**原子化服务API:** 从API version 15开始,该接口支持在原子化服务中使用。| 255 256## Edge 257 258**系统能力:** SystemCapability.ArkUI.ArkUI.Full 259 260| 名称 | 说明 | 261| -------------------------------- | ------------------------------------------------------------ | 262| Top | 竖直方向上边缘。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | 263| Center<sup>(deprecated) </sup> | 竖直方向居中位置。<br/> 从API version 9开始废弃。 | 264| Bottom | 竖直方向下边缘。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | 265| Baseline<sup>(deprecated) </sup> | 交叉轴方向文本基线位置。<br/> 从API version 9开始废弃。 | 266| Start | 水平方向起始位置。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | 267| Middle<sup>(deprecated) </sup> | 水平方向居中位置。<br/> 从API version 9开始废弃。 | 268| End | 水平方向末尾位置。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | 269 270## Week 271 272**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 273 274**系统能力:** SystemCapability.ArkUI.ArkUI.Full 275 276| 名称 | 说明 | 277| ---- | ---- | 278| Mon | 星期一。 | 279| Tue | 星期二。 | 280| Wed | 星期三。 | 281| Thur | 星期四。 | 282| Fri | 星期五。 | 283| Sat | 星期六。 | 284| Sun | 星期日。 | 285 286## Direction 287 288**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。 289 290**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 291 292**系统能力:** SystemCapability.ArkUI.ArkUI.Full 293 294| 名称 | 说明 | 295| ---- | ----------- | 296| Ltr | 元素从左到右布局。 | 297| Rtl | 元素从右到左布局。 | 298| Auto | 使用系统默认布局方向。 | 299 300## BarState 301 302**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。 303 304**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 305 306**系统能力:** SystemCapability.ArkUI.ArkUI.Full 307 308| 名称 | 说明 | 309| ---- | ------------------ | 310| Off | 不显示。 | 311| On | 常驻显示。 | 312| Auto | 按需显示(触摸时显示,2s后消失)。 | 313 314## TitleHeight<sup>9+</sup> 315 316**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 317 318**系统能力:** SystemCapability.ArkUI.ArkUI.Full 319 320| 名称 | 说明 | 321| ----------- | -------------------------- | 322| MainOnly | 只有主标题时标题栏的推荐高度(56vp)。 | 323| MainWithSub | 同时有主标题和副标题时标题栏的推荐高度(82vp)。 | 324 325## EdgeEffect 326 327**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。 328 329**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 330 331**系统能力:** SystemCapability.ArkUI.ArkUI.Full 332 333| 名称 | 说明 | 334| ------ | ---------------------------------------- | 335| Spring | 弹性物理动效,滑动到边缘后可以根据初始速度或通过触摸事件继续滑动一段距离,松手后回弹。 | 336| Fade | 阴影效果,滑动到边缘后会有圆弧状的阴影。 | 337| None | 滑动到边缘后无效果。 | 338 339## Alignment 340 341**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。 342 343**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 344 345**系统能力:** SystemCapability.ArkUI.ArkUI.Full 346 347| 名称 | 说明 | 348| ----------- | -------- | 349| TopStart | 顶部起始端。 | 350| Top | 顶部横向居中。 | 351| TopEnd | 顶部尾端。 | 352| Start | 起始端纵向居中。 | 353| Center | 横向和纵向居中。 | 354| End | 尾端纵向居中。 | 355| BottomStart | 底部起始端。 | 356| Bottom | 底部横向居中。 | 357| BottomEnd | 底部尾端。 | 358 359## TransitionType 360 361**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。 362 363**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 364 365**系统能力:** SystemCapability.ArkUI.ArkUI.Full 366 367| 名称 | 说明 | 368| ------ | ------------------------------ | 369| All | 指定当前的Transition动效生效在组件的所有变化场景。 | 370| Insert | 指定当前的Transition动效生效在组件的插入显示场景。 | 371| Delete | 指定当前的Transition动效生效在组件的删除隐藏场景。 | 372 373## RelateType 374 375**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 376 377**系统能力:** SystemCapability.ArkUI.ArkUI.Full 378 379| 名称 | 说明 | 380| ---- | -------------- | 381| FILL | 缩放当前子组件以填充满父组件。 | 382| FIT | 缩放当前子组件以自适应父组件。 | 383 384## Visibility 385 386**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。 387 388**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 389 390**系统能力:** SystemCapability.ArkUI.ArkUI.Full 391 392| 名称 | 说明 | 393| ------- | ---------------- | 394| Hidden | 隐藏,但参与布局进行占位。 | 395| Visible | 显示。 | 396| None | 隐藏,但不参与布局,不进行占位。 | 397 398## LineCapStyle 399 400**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。 401 402**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 403 404**系统能力:** SystemCapability.ArkUI.ArkUI.Full 405 406| 名称 | 说明 | 407| ------ | ----------------------------- | 408| Butt | 线条两端为平行线,不额外扩展。 | 409| Round | 在线条两端延伸半个圆,直径等于线宽。 | 410| Square | 在线条两端延伸一个矩形,宽度等于线宽的一半,高度等于线宽。 | 411 412## Axis 413 414**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。 415 416**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 417 418**系统能力:** SystemCapability.ArkUI.ArkUI.Full 419 420| 名称 | 说明 | 421| ---------- | ------ | 422| Vertical | 方向为纵向。 | 423| Horizontal | 方向为横向。 | 424 425## HorizontalAlign 426 427**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。 428 429**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 430 431**系统能力:** SystemCapability.ArkUI.ArkUI.Full 432 433| 名称 | 说明 | 434| ------ | ------------ | 435| Start | 按照语言方向起始端对齐。 | 436| Center | 居中对齐,默认对齐方式。 | 437| End | 按照语言方向末端对齐。 | 438 439## FlexAlign 440 441**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。 442 443**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 444 445**系统能力:** SystemCapability.ArkUI.ArkUI.Full 446 447| 名称 | 说明 | 448| ------------ | ---------------------------------------- | 449| Start | 元素在主轴方向首端对齐,第一个元素与行首对齐,同时后续的元素与前一个对齐。 | 450| Center | 元素在主轴方向中心对齐,第一个元素与行首的距离与最后一个元素与行尾距离相同。 | 451| End | 元素在主轴方向尾部对齐,最后一个元素与行尾对齐,其他元素与后一个对齐。 | 452| SpaceBetween | Flex主轴方向均匀分配弹性元素,相邻元素之间距离相同。第一个元素与行首对齐,最后一个元素与行尾对齐。 | 453| SpaceAround | Flex主轴方向均匀分配弹性元素,相邻元素之间距离相同。第一个元素到行首的距离和最后一个元素到行尾的距离是相邻元素之间距离的一半。 | 454| SpaceEvenly | Flex主轴方向均匀分配弹性元素,相邻元素之间的距离、第一个元素与行首的间距、最后一个元素到行尾的间距都完全一样。 | 455 456## ItemAlign 457 458**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。 459 460**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 461 462**系统能力:** SystemCapability.ArkUI.ArkUI.Full 463 464| 名称 | 说明 | 465| -------- | ---------------------------------------- | 466| Auto | 使用Flex容器中默认配置。 | 467| Start | 元素在Flex容器中,交叉轴方向首部对齐。 | 468| Center | 元素在Flex容器中,交叉轴方向居中对齐。 | 469| End | 元素在Flex容器中,交叉轴方向底部对齐。 | 470| Stretch | 元素在Flex容器中,交叉轴方向拉伸填充。容器为Flex且设置Wrap为FlexWrap.Wrap或FlexWrap.WrapReverse时,元素拉伸到与当前行/列交叉轴长度最长的元素尺寸。其余情况下,无论元素尺寸是否设置,均拉伸到容器尺寸。 | 471| Baseline | 元素在Flex容器中,交叉轴方向文本基线对齐。 | 472 473## FlexDirection 474 475**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。 476 477**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 478 479**系统能力:** SystemCapability.ArkUI.ArkUI.Full 480 481| 名称 | 说明 | 482| ------------- | ---------------- | 483| Row | 主轴与行方向一致作为布局模式。 | 484| RowReverse | 与Row方向相反方向进行布局。 | 485| Column | 主轴与列方向一致作为布局模式。 | 486| ColumnReverse | 与Column相反方向进行布局。 | 487 488## FlexWrap 489 490**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。 491 492**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 493 494**系统能力:** SystemCapability.ArkUI.ArkUI.Full 495 496| 名称 | 说明 | 497| ----------- | --------------------------- | 498| NoWrap | Flex容器的元素单行/列布局,子元素尽可能约束在容器内。当子元素有最小尺寸约束等设置时,Flex容器不会对其强制弹性压缩。 | 499| Wrap | Flex容器的元素多行/列排布,子项允许超出容器。 | 500| WrapReverse | Flex容器的元素反向多行/列排布,子项允许超出容器。 | 501 502## VerticalAlign 503 504**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。 505 506**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 507 508**系统能力:** SystemCapability.ArkUI.ArkUI.Full 509 510| 名称 | 说明 | 511| ------ | ------------ | 512| Top | 顶部对齐。 | 513| Center | 居中对齐,默认对齐方式。 | 514| Bottom | 底部对齐。 | 515 516## ImageRepeat 517 518**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。 519 520**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 521 522**系统能力:** SystemCapability.ArkUI.ArkUI.Full 523 524| 名称 | 说明 | 525| -------- | ------------- | 526| X | 只在水平轴上重复绘制图片。 | 527| Y | 只在竖直轴上重复绘制图片。 | 528| XY | 在两个轴上重复绘制图片。 | 529| NoRepeat | 不重复绘制图片。 | 530 531## ImageSize 532 533**系统能力:** SystemCapability.ArkUI.ArkUI.Full 534 535| 名称 | 值 | 说明 | 536| ------- | -------------------------- | ----------------------------------- | 537| Cover | 1 | 保持宽高比进行缩小或者放大,使得图片两边都大于或等于显示边界。<br/>**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。<br />**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | 538| Contain | 2 | 保持宽高比进行缩小或者放大,使得图片完全显示在显示边界内。<br/>**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。<br /> **原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | 539| Auto | 0 | 默认值,保持原图的比例不变。<br/>**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。<br /> **原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | 540| FILL<sup>12+</sup> | 3 | 不保持宽高比进行放大缩小,使得图片充满显示边界。<br/>**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。| 541 542## GradientDirection 543 544**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。 545 546**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 547 548**系统能力:** SystemCapability.ArkUI.ArkUI.Full 549 550| 名称 | 说明 | 551| ----------- | ----- | 552| Left | 从右向左。 | 553| Top | 从下向上。 | 554| Right | 从左向右。 | 555| Bottom | 从上向下。 | 556| LeftTop | 左上。 | 557| LeftBottom | 左下。 | 558| RightTop | 右上。 | 559| RightBottom | 右下。 | 560| None | 无。 | 561 562## SharedTransitionEffectType 563 564**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 565 566**系统能力:** SystemCapability.ArkUI.ArkUI.Full 567 568| 名称 | 说明 | 569| -------- | ---------------------------------------- | 570| Static | 目标页面元素的位置保持不变,可以配置透明度动画。目前,只有为重定向到目标页面而配置的静态效果才会生效。 | 571| Exchange | 将源页面元素移动到目标页面元素位置并适当缩放。 | 572 573## FontStyle 574 575**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。 576 577**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 578 579**系统能力:** SystemCapability.ArkUI.ArkUI.Full 580 581| 名称 | 说明 | 582| ------ | -------- | 583| Normal | 标准的字体样式。 | 584| Italic | 斜体的字体样式。 | 585 586## FontWeight 587 588**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。 589 590**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 591 592**系统能力:** SystemCapability.ArkUI.ArkUI.Full 593 594| 名称 | 值 | 说明 | 595| ------- | ----- | ----------- | 596| Lighter | 100 | 字体较细。 | 597| Normal | 400 | 字体粗细正常。 | 598| Regular | 400 | 字体粗细正常。 | 599| Medium | 500 | 字体粗细适中。 | 600| Bold | 700 | 字体较粗。 | 601| Bolder | 900 | 字体非常粗。 | 602 603## TextAlign 604 605**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 606 607**系统能力:** SystemCapability.ArkUI.ArkUI.Full 608 609| 名称 | 说明 | 610| --------------------- | ------------------------------------------------------------ | 611| Start | 水平对齐首部。<br/>**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。 | 612| Center | 水平居中对齐。<br/>**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。 | 613| End | 水平对齐尾部。<br/>**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。 | 614| JUSTIFY<sup>10+</sup> | 双端对齐。<br/>**卡片能力:** 从API version 10开始,该接口支持在ArkTS卡片中使用。 | 615 616## TextOverflow 617 618**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 619 620**系统能力:** SystemCapability.ArkUI.ArkUI.Full 621 622| 名称 | 说明 | 623| --------------------- | ------------------- | 624| None | 文本超长时按最大行截断显示。<br/>**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。 | 625| Clip | 文本超长时按最大行截断显示。<br/>**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。 | 626| Ellipsis | 文本超长时显示不下的文本用省略号代替。<br/>**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。 | 627| MARQUEE<sup>10+</sup> | 文本超长时以跑马灯的方式展示。 | 628 629## TextDecorationType 630 631**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。 632 633**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 634 635**系统能力:** SystemCapability.ArkUI.ArkUI.Full 636 637| 名称 | 说明 | 638| ----------- | --------- | 639| Underline | 文字下划线修饰。 | 640| LineThrough | 穿过文本的修饰线。 | 641| Overline | 文字上划线修饰。 | 642| None | 不使用文本装饰线。 | 643 644## TextCase 645 646**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。 647 648**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 649 650**系统能力:** SystemCapability.ArkUI.ArkUI.Full 651 652| 名称 | 说明 | 653| --------- | ---------- | 654| Normal | 保持文本原有大小写。 | 655| LowerCase | 文本采用全小写。 | 656| UpperCase | 文本采用全大写。 | 657 658## ResponseType<sup>8+</sup> 659 660**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 661 662**系统能力:** SystemCapability.ArkUI.ArkUI.Full 663 664| 名称 | 说明 | 665| ---------- | ------------- | 666| LongPress | 通过长按触发菜单弹出。 | 667| RightClick | 通过鼠标右键触发菜单弹出。 | 668 669## HoverEffect<sup>8+</sup> 670 671**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 672 673**系统能力:** SystemCapability.ArkUI.ArkUI.Full 674 675| 名称 | 说明 | 676| --------- | -------------- | 677| Auto | 使用组件的系统默认悬浮效果。 | 678| Scale | 放大缩小效果。 | 679| Highlight | 背景淡入淡出的强调效果。 | 680| None | 不设置效果。 | 681 682## Placement<sup>8+</sup> 683 684**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 685 686**系统能力:** SystemCapability.ArkUI.ArkUI.Full 687 688| 名称 | 说明 | 689| ------------------------ | ------------------------------------------------------------ | 690| Left | 气泡提示位于组件左侧,与组件左侧中心对齐。 | 691| Right | 气泡提示位于组件右侧,与组件右侧中心对齐。 | 692| Top | 气泡提示位于组件上侧,与组件上侧中心对齐。 | 693| Bottom | 气泡提示位于组件下侧,与组件下侧中心对齐。 | 694| TopLeft | 气泡提示位于组件上侧,从API Version 9开始,与组件左侧边缘对齐。 | 695| TopRight | 气泡提示位于组件上侧,从API Version 9开始,与组件右侧边缘对齐。 | 696| BottomLeft | 气泡提示位于组件下侧,从API Version 9开始,与组件左侧边缘对齐。 | 697| BottomRight | 气泡提示位于组件下侧,从API Version 9开始,与组件右侧边缘对齐。 | 698| LeftTop<sup>9+</sup> | 气泡提示位于组件左侧,与组件上侧边缘对齐。 | 699| LeftBottom<sup>9+</sup> | 气泡提示位于组件左侧,与组件下侧边缘对齐。 | 700| RightTop<sup>9+</sup> | 气泡提示位于组件右侧,与组件上侧边缘对齐。 | 701| RightBottom<sup>9+</sup> | 气泡提示位于组件右侧,与组件下侧边缘对齐。 | 702 703## CopyOptions<sup>9+</sup> 704 705**系统能力:** SystemCapability.ArkUI.ArkUI.Full 706 707| 名称 | 值 | 说明 | 708| ----------- | --- | -------- | 709| None | 0 | 不支持复制。<br/>**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | 710| InApp | 1 | 支持应用内复制。<br/>**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | 711| LocalDevice | 2 | 支持设备内复制。<br/>**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | 712| CROSS_DEVICE<sup>(deprecated)</sup> | 3 | 支持跨设备复制。<br/>**卡片能力:** 从API version 11开始,该接口支持在ArkTS卡片中使用。<br/>**说明:** 从API version 11开始支持,从API version 12开始废弃。 | 713 714## HitTestMode<sup>9+</sup> 715 716**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 717 718**系统能力:** SystemCapability.ArkUI.ArkUI.Full 719 720| 名称 | 说明 | 721| ----------- | ---------------------------------------- | 722| Default | 自身节点和子节点都响应触摸事件的命中测试,但会阻止被该节点屏蔽的其他节点的命中测试。 | 723| Block | 自身节点响应触摸事件的命中测试,但阻止被该节点屏蔽的子节点和其他节点的命中测试。 | 724| Transparent | 自身节点和子节点响应触摸事件的命中测试,并允许对被该节点屏蔽的其他节点进行命中测试。 | 725| None | 自身节点不会响应触摸事件的命中测试,但子节点会对触摸事件进行命中测试。 | 726 727## DialogButtonStyle<sup>10+</sup> 728 729**系统能力:** SystemCapability.ArkUI.ArkUI.Full 730 731**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 732 733**系统能力:** SystemCapability.ArkUI.ArkUI.Full 734 735| 名称 | 值 | 说明 | 736| --------- | ---- | --------------------------------- | 737| DEFAULT | 0 | 白底蓝字(深色主题:白底=黑底)。 | 738| HIGHLIGHT | 1 | 蓝底白字。 | 739 740## TextHeightAdaptivePolicy<sup>10+</sup> 741 742**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 743 744**系统能力:** SystemCapability.ArkUI.ArkUI.Full 745 746| 名称 | 说明 | 747| ----------------------- | ------------------------ | 748| MAX_LINES_FIRST | 设置文本高度自适应方式为以MaxLines优先。 | 749| MIN_FONT_SIZE_FIRST | 设置文本高度自适应方式为以缩小字体优先。 | 750| LAYOUT_CONSTRAINT_FIRST | 设置文本高度自适应方式为以布局约束(高度)优先。 | 751 752## NestedScrollMode<sup>10+</sup> 753 754**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 755 756**系统能力:** SystemCapability.ArkUI.ArkUI.Full 757 758| 名称 | 说明 | 759| ------ | ------------------------------ | 760| SELF_ONLY | 只自身滚动,不与父组件联动。 | 761| SELF_FIRST | 自身先滚动,自身滚动到边缘以后父组件滚动。父组件滚动到边缘以后,如果父组件有边缘效果,则父组件触发边缘效果,否则子组件触发边缘效果。 | 762| PARENT_FIRST | 父组件先滚动,父组件滚动到边缘以后自身滚动。自身滚动到边缘后,如果有边缘效果,会触发自身的边缘效果,否则触发父组件的边缘效果。 | 763| PARALLEL | 自身和父组件同时滚动,自身和父组件都到达边缘以后,如果自身有边缘效果,则自身触发边缘效果,否则父组件触发边缘效果。| 764 765## ObscuredReasons<sup>10+</sup> 766 767**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 768 769**系统能力:** SystemCapability.ArkUI.ArkUI.Full 770 771| 名称 | 值 | 说明 | 772| ----------- | -- | ------------------------ | 773| PLACEHOLDER | 0 |显示的数据为通用占位符。 | 774 775## ColoringStrategy<sup>10+</sup> 776 777智能取色枚举类型。 778 779**系统能力:** SystemCapability.ArkUI.ArkUI.Full 780 781| 名称 | 值 | 说明 | 782| ------ | --- | --------------- | 783| INVERT | invert | 设置前景色为控件背景色的反色。仅支持在[foregroundColor](ts-universal-attributes-foreground-color.md#foregroundcolor)中设置该枚举。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | 784| AVERAGE<sup>11+</sup> | average | 设置控件背景阴影色为控件背景阴影区域的平均色。仅支持在入参类型为ShadowOptions的[shadow](ts-universal-attributes-image-effect.md#shadow)中设置该枚举。<br/>**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。 | 785| PRIMARY<sup>11+</sup> | primary | 设置控件背景阴影色为控件背景阴影区域的主色。仅支持在入参类型为ShadowOptions的[shadow](ts-universal-attributes-image-effect.md#shadow)中设置该枚举。<br/>**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。 | 786 787## ClickEffectLevel<sup>10+</sup> 788 789**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 790 791**系统能力:** SystemCapability.ArkUI.ArkUI.Full 792 793| 名称 | 说明 | 动效参数 | 默认缩放比 | 794| ------ | --------------------------------- | --------------------------------- | --------------------------------- | 795| LIGHT | 小面积(轻盈) | 弹簧动效, 刚性:410,阻尼:38,初始速度:1 | 90% | 796| MIDDLE | 中面积(稳定) | 弹簧动效, 刚性:350,阻尼:35,初始速度:0.5 | 95% | 797| HEAVY | 大面积(厚重) | 弹簧动效, 刚性:240,阻尼:28,初始速度:0 | 95% | 798 799## CheckBoxShape<sup>11+</sup> 800 801**卡片能力:** 从API version 11开始,该接口支持在ArkTS卡片中使用。 802 803**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。 804 805**系统能力:** SystemCapability.ArkUI.ArkUI.Full 806 807| 名称 | 值 | 说明 | 808| -------------- | ---- | -------- | 809| CIRCLE | 0 | 圆形 | 810| ROUNDED_SQUARE | 1 | 圆角方形 | 811 812## FoldStatus<sup>11+</sup> 813 814**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。 815 816**系统能力:** SystemCapability.ArkUI.ArkUI.Full 817 818| 名称 |值| 说明 | 819| ---------------------- |----|---------- | 820| FOLD_STATUS_UNKNOWN |0|表示设备当前折叠状态未知。 | 821| FOLD_STATUS_EXPANDED |1| 表示设备当前折叠状态为完全展开。 | 822| FOLD_STATUS_FOLDED |2|表示设备当前折叠状态为折叠。 | 823| FOLD_STATUS_HALF_FOLDED |3| 表示设备当前折叠状态为半折叠。半折叠指完全展开和折叠之间的状态。| 824 825## TextContentStyle<sup>10+</sup> 826 827**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 828 829**系统能力:** SystemCapability.ArkUI.ArkUI.Full 830 831| 名称 | 说明 | 832| ------- | ------------------------------------------------------------ | 833| DEFAULT | 默认风格,光标宽1.5vp,光标高度与文本选中底板高度和字体大小相关。 | 834| INLINE | 内联输入风格。文本选中底板高度与输入框高度相同。<br/>内联输入是在有明显的编辑态/非编辑态的区分场景下使用,例如:文件列表视图中的重命名。<br/>不支持showError属性。<br/>内联模式下,不支持拖入文本。 | 835 836 837## Nullable\<T><sup>11+</sup> 838 839type Nullable\<T> = T | undefined; 840 841开发者在使用该类型时候,该类型的对象可以是自定义类型,也可以是undefined。 842 843**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。 844 845**系统能力**:SystemCapability.ArkUI.ArkUI.Full 846 847| 类型 | 说明 | 848| ---- | -------------------------- | 849| T \| undefined | 该类型申明的对象可以是自定义类型,也可以是undefined。 | 850 851## WordBreak<sup>11+</sup> 852 853**系统能力:** SystemCapability.ArkUI.ArkUI.Full 854 855| 名称 | 值 | 说明 | 856| ----- | --- | -------------------------------------- | 857| NORMAL | 0 | CJK(中文、日文、韩文)文本可以在任意2个字符间断行,而Non-CJK文本(如英文等)只能在空白符处断行。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | 858| BREAK_ALL | 1 | 对于Non-CJK的文本,可在任意2个字符间断行。对于CJK与NORMAL效果一致。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | 859| BREAK_WORD | 2 | 与BREAK_ALL相同,对于Non-CJK的文本可在任意2个字符间断行,一行文本中有断行破发点(如空白符)时,优先按破发点换行,保障单词优先完整显示。若整一行文本均无断行破发点时,则在任意2个字符间断行。对于CJK与NORMAL效果一致。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | 860| HYPHENATION<sup>18+</sup> | 3 | 对于Non-CJK的文本,可以按照音节断行。对于CJK的文本,换行效果与NORMAL效果保持一致。<br/>**原子化服务API:** 从API version 18开始,该接口支持在原子化服务中使用。 | 861 862## LineBreakStrategy<sup>12+</sup> 863 864**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。 865 866**系统能力:** SystemCapability.ArkUI.ArkUI.Full 867 868| 名称 | 值 | 说明 | 869| ------------ | --- | ------------------------------------------------------------ | 870| GREEDY | 0 | 使每一行尽量显示多的字符,直到这一行不能显示更多字符再进行折行。 | 871| HIGH_QUALITY | 1 | 在BALANCED的基础上,尽可能填满行,在最后一行的权重上比较低,可能会出现最后一行留白比较多。 | 872| BALANCED | 2 | 尽可能保证在不拆词的情况下,使一个段落中每一行的宽度相同。 | 873 874## TextSelectableMode<sup>12+</sup> 875 876**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。 877 878**系统能力:** SystemCapability.ArkUI.ArkUI.Full 879 880| 名称 | 值 | 说明 | 881| ------------ | --- | ------------------------------------------------------------ | 882| SELECTABLE_UNFOCUSABLE | 0 | 文本可选择,但不可获焦,设置属性selection、bindSelectionMenu、copyOption不影响当前行为。 | 883| SELECTABLE_FOCUSABLE | 1 | 文本可选择,可获焦并Touch后获得焦点。 | 884| UNSELECTABLE | 2 | 文本不可选择,不可获焦,设置属性selection、bindSelectionMenu、copyOption都不生效。 | 885 886## AccessibilityHoverType<sup>12+</sup> 887 888**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。 889 890**系统能力:** SystemCapability.ArkUI.ArkUI.Full 891 892| 名称 | 值 | 说明 | 893| ------------ | - | ------------------------------------------------------------ | 894| HOVER_ENTER | 0 | 手指按下时触发。 | 895| HOVER_MOVE | 1 | 触摸移动时触发。 | 896| HOVER_EXIT | 2 | 抬手触发。 | 897| HOVER_CANCEL | 3 | 打断取消当前触发的事件。 | 898 899## EllipsisMode<sup>11+</sup> 900 901**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。 902 903**系统能力:** SystemCapability.ArkUI.ArkUI.Full 904 905| 名称 | 值 | 说明 | 906| ----- | --- | -------------------------------------- | 907| START | 0 | 省略行首内容。| 908| CENTER | 1 | 省略行中内容。| 909| END | 2 | 省略行末内容。| 910 911## ArrowPointPosition<sup>11+</sup> 912 913**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。 914 915**系统能力:** SystemCapability.ArkUI.ArkUI.Full 916 917| 名称 | 值 | 说明 | 918| ------------- | -------------------------------------- | -------------------------------------- | 919| START | 'Start' | 水平方向:位于父组件最左侧,垂直方向:位于父组件最上侧。 | 920| CENTER | 'Center' | 位于父组件居中位置。 | 921| END | 'End' | 水平方向:位于父组件最右侧,垂直方向:位于父组件最下侧。 | 922 923## OptionWidthMode<sup>11+</sup> 924 925**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。 926 927**系统能力:** SystemCapability.ArkUI.ArkUI.Full 928 929| 名称 | 值 | 说明 | 930| ----------- | ------------------------------ | ------------------------------ | 931| FIT_CONTENT | 'fit_content' | 设置该值时,下拉菜单宽度按默认2栅格显示。 | 932| FIT_TRIGGER | 'fit_trigger' | 设置下拉菜单继承下拉按钮宽度。 | 933 934## PixelRoundCalcPolicy<sup>11+</sup> 935 936组件边界像素取整计算策略。 937 938**卡片能力:** 从API version 11开始,该接口支持在ArkTS卡片中使用。 939 940**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 941 942**系统能力:** SystemCapability.ArkUI.ArkUI.Full 943 944| 名称 |值| 说明 | 945| ------ |----| ----------------------------- | 946| NO_FORCE_ROUND |0| 不取整计算。| 947| FORCE_CEIL |1| 取上整计算。| 948| FORCE_FLOOR |2| 取下整计算。| 949 950## TextDecorationStyle<sup>12+</sup> 951 952**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。 953 954**系统能力:** SystemCapability.ArkUI.ArkUI.Full 955 956| 名称 | 值 | 说明 | 957| ----------- | --- | --------- | 958| SOLID | 0 | 单实线(默认值)。 | 959| DOUBLE | 1 | 双实线。 | 960| DOTTED | 2 | 点线。 | 961| DASHED | 3 | 虚线。 | 962| WAVY | 4 | 波浪线。 | 963 964## EmbeddedType<sup>12+</sup> 965枚举类型,用于指定EmbeddedComponent可拉起的提供方类型。 966 967**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。 968 969**系统能力:** SystemCapability.ArkUI.ArkUI.Full 970 971| 名称 | 值 | 说明 | 972| --------------------- | - | ---------------------------------------------------- | 973| EMBEDDED_UI_EXTENSION | 0 | 表示当前拉起的提供方类型为EmbeddedUIExtensionAbility。| 974 975## MarqueeUpdateStrategy<sup>12+</sup> 976 977**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。 978 979**系统能力:** SystemCapability.ArkUI.ArkUI.Full 980 981| 名称 | 值 | 说明 | 982| ---------- | ------------------------ | ------------------------ | 983| DEFAULT | 0 | 跑马灯组件属性更新后, 从开始位置, 运行跑马灯效果。 | 984| PRESERVE_POSITION | 1 | 跑马灯组件属性更新后, 保持当前位置, 运行跑马灯效果。 | 985 986## AppRotation<sup>12+</sup> 987 988**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。 989 990**系统能力:** SystemCapability.ArkUI.ArkUI.Full 991 992| 名称 |值| 说明 | 993| ------ |----| ----------------------------- | 994| ROTATION_0 |0| 应用方向为0度。| 995| ROTATION_90 |1|应用方向为90度。| 996| ROTATION_180 |2| 应用方向为180度。| 997| ROTATION_270 |3| 应用方向为270度。| 998 999## ScrollSource<sup>12+</sup> 1000 1001滑动操作的来源。 1002 1003**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。 1004 1005**系统能力:** SystemCapability.ArkUI.ArkUI.Full 1006 1007| 名称 | 值 | 说明 | 1008| ------ | ------ | ---------------------------------------- | 1009| DRAG | 0 | 拖拽事件。 | 1010| FLING | 1 | 拖拽结束之后的惯性滑动。 | 1011| EDGE_EFFECT | 2 | EdgeEffect.Spring的边缘滚动效果。 | 1012| OTHER_USER_INPUT | 3 | 除拖拽外的其他用户输入,如鼠标滚轮、键盘事件等。 | 1013| SCROLL_BAR | 4 | 滚动条的拖拽事件。 | 1014| SCROLL_BAR_FLING | 5 | 滚动条拖拽结束后的带速度的惯性滑动。 | 1015| SCROLLER | 6 | Scroller的不带动效方法。 | 1016| SCROLLER_ANIMATION | 7 | Scroller的带动效方法。 | 1017 1018## ImageSpanAlignment<sup>10+</sup> 1019 1020**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 1021 1022**系统能力:** SystemCapability.ArkUI.ArkUI.Full 1023 1024| 名称 | 说明 | 1025| -------- | ------------------------------ | 1026| TOP | 图片上边沿与行上边沿对齐。 | 1027| CENTER | 图片中间与行中间对齐。 | 1028| BOTTOM | 图片下边沿与行下边沿对齐。 | 1029| BASELINE | 图片下边沿与文本BaseLine对齐。 | 1030 1031 1032## XComponentType<sup>10+</sup> 1033 1034**系统能力:** SystemCapability.ArkUI.ArkUI.Full 1035 1036| 名称 | 说明 | 1037| -------------------------------- | ------------------------------------------------------------ | 1038| SURFACE | 用于EGL/OpenGLES和媒体数据写入,开发者定制的绘制内容单独展示到屏幕上。背景色设置为黑色时会走显示子系统(DSS)。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | 1039| COMPONENT<sup>(deprecated)</sup> | XComponent将变成一个容器组件,并可在其中执行非UI逻辑以动态加载显示内容。<br/>**说明:**<br/>从API version 12 开始,该接口废弃,建议使用其他容器组件替代。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | 1040| TEXTURE | 用于EGL/OpenGLES和媒体数据写入,开发者定制的绘制内容会和XComponent组件的内容合成后展示到屏幕上。1、保持帧同步,保持在同一帧将图形处理器(GPU)纹理和ArkUI其他的绘制指令统一发给渲染服务(RenderService)。2、动效和系统组件统一。3、走图形处理器(GPU)合成,相比surface可能走显示子系统(DSS)功耗更高。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | 1041| NODE<sup>12+</sup> | 用于Native UI节点的占位容器,开发者通过Native API 开发的页面组件可展示在此容器区域内。<br/>**说明:**<br/>该类型不再演进,推荐使用[ContentSlot](../../../ui/state-management/arkts-rendering-control-contentslot.md)占位组件管理Native API创建的组件,ContentSlot在内存和性能方面都优于NODE类型的XComponent。<br/>**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。 | 1042 1043## HoverModeAreaType<sup>14+</sup> 1044 1045悬停态显示区域类型。 1046 1047**原子化服务API:** 从API version 14开始,该接口支持在原子化服务中使用。 1048 1049**系统能力**:SystemCapability.ArkUI.ArkUI.Full 1050 1051| 名称 | 值 | 说明 | 1052| ------ | ----------------------------- | ----------------------------- | 1053| TOP_SCREEN | 0 | 上半屏。| 1054| BOTTOM_SCREEN | 1 | 下半屏。| 1055 1056## WidthBreakpoint<sup>13+</sup> 1057 1058表示窗口不同宽度阈值下对应的宽度断点枚举值。通过[getWindowWidthBreakpoint](../js-apis-arkui-UIContext.md#getwindowwidthbreakpoint13)返回。 1059 1060**原子化服务API:** 从API version 13开始,该接口支持在原子化服务中使用。 1061 1062**系统能力:** SystemCapability.ArkUI.ArkUI.Full 1063 1064| 名称 | 值 | 说明 | 1065| -------- | ---- | ---------------------- | 1066| WIDTH_XS | 0 | 窗口宽度小于320vp。 | 1067| WIDTH_SM | 1 | 窗口宽度大于等于320vp,且小于600vp。 | 1068| WIDTH_MD | 2 | 窗口宽度大于等于600vp,且小于840vp。 | 1069| WIDTH_LG | 3 | 窗口宽度大于等于840vp,且小于1440vp。 | 1070| WIDTH_XL | 4 | 窗口宽度大于等于1440vp。 | 1071 1072## HeightBreakpoint<sup>13+</sup> 1073 1074表示窗口不同高宽比阈值下对应的高度断点枚举值。通过[getWindowHeightBreakpoint](../js-apis-arkui-UIContext.md#getwindowheightbreakpoint13)返回。 1075 1076**原子化服务API:** 从API version 13开始,该接口支持在原子化服务中使用。 1077 1078**系统能力:** SystemCapability.ArkUI.ArkUI.Full 1079 1080| 名称 | 值 | 说明 | 1081| -------- | ---- | ---------------------- | 1082| HEIGHT_SM | 0 | 窗口高宽比小于0.8。 | 1083| HEIGHT_MD | 1 | 窗口高宽比大于等于0.8,且小于1.2。 | 1084| HEIGHT_LG | 2 | 窗口高宽比大于等于1.2。 | 1085 1086## AxisModel<sup>15+</sup> 1087 1088定义焦点轴事件的轴类型。 1089 1090**原子化服务API:** 从API version 15开始,该接口支持在原子化服务中使用。 1091 1092**系统能力:** SystemCapability.ArkUI.ArkUI.Full 1093 1094| 名称 | 值 | 说明 | 1095| ------- | ---- | ---------------------------------- | 1096| ABS_X | 0 | 游戏手柄X轴。 | 1097| ABS_Y | 1 | 游戏手柄Y轴。 | 1098| ABS_Z | 2 | 游戏手柄Z轴。 | 1099| ABS_RZ | 3 | 游戏手柄RZ轴。 | 1100| ABS_GAS | 4 | 游戏手柄GAS轴。 | 1101| ABS_BRAKE | 5 | 游戏手柄BRAKE轴。 | 1102| ABS_HAT0X | 6 | 游戏手柄HAT0X轴。 | 1103| ABS_HAT0Y | 7 | 游戏手柄HAT0Y轴。 | 1104 1105## PageFlipMode<sup>15+</sup> 1106 1107表示鼠标滚轮翻页模式。 1108 1109**卡片能力:** 从API version 15开始,该接口支持在ArkTS卡片中使用。 1110 1111**原子化服务API:** 从API version 15开始,该接口支持在原子化服务中使用。 1112 1113**系统能力:** SystemCapability.ArkUI.ArkUI.Full 1114 1115| 名称 | 值 | 说明 | 1116| -------- | ---- | ---------------------- | 1117| CONTINUOUS | 0 | 连续翻页模式,鼠标滚轮连续滚动时连续翻多页。 | 1118| SINGLE | 1 | 单次翻页模式,在一次翻页动画结束前不响应滚轮事件。 | 1119 1120## RenderFit<sup>10+</sup> 1121 1122表示宽高动画过程中组件内容的填充方式。 1123 1124**卡片能力:** 从API version 18开始,该接口支持在ArkTS卡片中使用。 1125 1126**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 1127 1128**系统能力:** SystemCapability.ArkUI.ArkUI.Full 1129 1130| 名称 | 值 | 说明 | 1131| --------------------------- | -- | ---------------------------------------------------------------------------------- | 1132| CENTER | 0 | 保持动画终态的内容大小,并且内容始终与组件保持中心对齐。  | 1133| TOP | 1 | 保持动画终态的内容大小,并且内容始终与组件保持顶部中心对齐。  | 1134| BOTTOM | 2 | 保持动画终态的内容大小,并且内容始终与组件保持底部中心对齐。  | 1135| LEFT | 3 | 保持动画终态的内容大小,并且内容始终与组件保持左侧对齐。  | 1136| RIGHT | 4 | 保持动画终态的内容大小,并且内容始终与组件保持右侧对齐。  | 1137| TOP_LEFT | 5 | 保持动画终态的内容大小,并且内容始终与组件保持左上角对齐。  | 1138| TOP_RIGHT | 6 | 保持动画终态的内容大小,并且内容始终与组件保持右上角对齐。  | 1139| BOTTOM_LEFT | 7 | 保持动画终态的内容大小,并且内容始终与组件保持左下角对齐。  | 1140| BOTTOM_RIGHT | 8 | 保持动画终态的内容大小,并且内容始终与组件保持右下角对齐。  | 1141| RESIZE_FILL | 9 | 不考虑动画终态内容的宽高比,并且内容始终缩放到组件的大小。  | 1142| RESIZE_CONTAIN | 10 | 保持动画终态内容的宽高比进行缩小或放大,使内容完整显示在组件内,且与组件保持中心对齐。  | 1143| RESIZE_CONTAIN_TOP_LEFT | 11 | 保持动画终态内容的宽高比进行缩小或放大,使内容完整显示在组件内。当组件宽方向有剩余时,内容与组件保持左侧对齐,当组件高方向有剩余时,内容与组件保持顶部对齐。  | 1144| RESIZE_CONTAIN_BOTTOM_RIGHT | 12 | 保持动画终态内容的宽高比进行缩小或放大,使内容完整显示在组件内。当组件宽方向有剩余时,内容与组件保持右侧对齐,当组件高方向有剩余时,内容与组件保持底部对齐。  | 1145| RESIZE_COVER | 13 | 保持动画终态内容的宽高比进行缩小或放大,使内容两边都大于或等于组件两边,且与组件保持中心对齐,显示内容的中间部分。  | 1146| RESIZE_COVER_TOP_LEFT | 14 | 保持动画终态内容的宽高比进行缩小或放大,使内容的两边都恰好大于或等于组件两边。当内容宽方向有剩余时,内容与组件保持左侧对齐,显示内容的左侧部分。当内容高方向有剩余时,内容与组件保持顶部对齐,显示内容的顶侧部分。  | 1147| RESIZE_COVER_BOTTOM_RIGHT | 15 | 保持动画终态内容的宽高比进行缩小或放大,使内容的两边都恰好大于或等于组件两边。当内容宽方向有剩余时,内容与组件保持右侧对齐,显示内容的右侧部分。当内容高方向有剩余时,内容与组件保持底部对齐,显示内容的底侧部分。  | 1148 1149 1150> **说明:** 1151> 1152> - 示意图中,蓝色区域表示内容,橙黄色区域表示节点大小。 1153> - 不同的内容填充方式在宽高动画过程中效果不一致,开发者需要选择合适的内容填充方式以实现需要的动画效果。 1154 1155## CrownAction<sup>18+</sup> 1156 1157旋转表冠动作。 1158 1159**原子化服务API:** 从API version 18开始,该接口支持在原子化服务中使用。 1160 1161**系统能力:** SystemCapability.ArkUI.ArkUI.Full 1162 1163|名称 | 值 | 说明 | 1164|-------------------| -- | ------------------------------------- | 1165| BEGIN | 0 | 表冠开始转动。 | 1166| UPDATE | 1 | 表冠转动中。 | 1167| END | 2 | 表冠停止转动。 | 1168 1169## CrownSensitivity<sup>18+</sup> 1170 1171旋转表冠灵敏度。 1172 1173**原子化服务API:** 从API version 18开始,该接口支持在原子化服务中使用。 1174 1175**系统能力:** SystemCapability.ArkUI.ArkUI.Full 1176 1177| 名称 | 值 | 说明 | 1178| -------------- | -- | ---------------------------------------- | 1179| LOW | 0 | 低灵敏度。 | 1180| MEDIUM | 1 | 中灵敏度。 | 1181| HIGH | 2 | 高灵敏度。 | 1182 1183## AxisAction<sup>17+</sup> 1184 1185定义轴事件的轴动作类型。 1186 1187**原子化服务API:** 从API version 17开始,该接口支持在原子化服务中使用。 1188 1189**系统能力:** SystemCapability.ArkUI.ArkUI.Full 1190 1191| 名称 | 值 | 说明 | 1192| ------- | ---- | ---------------------------------- | 1193| NONE | 0 | 无轴事件。 | 1194| BEGIN | 1 | 轴事件开始。 | 1195| UPDATE | 2 | 轴事件触发中。 | 1196| END | 3 | 轴事件结束。 | 1197| CANCEL | 4 | 轴事件取消。 | 1198 1199## InteractionHand<sup>15+</sup> 1200 1201定义事件是由左手点击触发还是右手点击触发。 1202 1203**原子化服务API:** 从API version 15开始,该接口支持在原子化服务中使用。 1204 1205**系统能力:** SystemCapability.ArkUI.ArkUI.Full 1206 1207| 名称 | 值 | 说明 | 1208| -------- | ---- | ---------------------- | 1209| NONE | 0 | 未知。 | 1210| LEFT | 1 | 左手。 | 1211| RIGHT | 2 | 右手。 | 1212 1213## PixelRoundMode<sup>18+</sup> 1214 1215指定像素取整模式。 1216 1217**卡片能力:** 从API version 18开始,该接口支持在ArkTS卡片中使用。 1218 1219**原子化服务API:** 从API version 18开始,该接口支持在原子化服务中使用。 1220 1221**系统能力:** SystemCapability.ArkUI.ArkUI.Full 1222 1223| 名称 | 值 | 说明 | 1224| ------ |---- | -------------------- | 1225| PIXEL_ROUND_ON_LAYOUT_FINISH | 0 | 在组件测量大小和位置后进行像素取整,默认值为0。 | 1226| PIXEL_ROUND_AFTER_MEASURE | 1 | 在组件测量大小结束后进行像素取整。 | 1227 1228> **说明:** 1229> 在PIXEL_ROUND_AFTER_MEASURE模式下,组件会在测量时进行一次取整,也即最终大小与PIXEL_ROUND_ON_LAYOUT_FINISH会有1px的区别。