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