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