• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# Enums
2
3>**NOTE**
4>
5>The initial APIs of this module are supported since API version 7. Newly added APIs will be marked with a superscript to indicate their earliest API version.
6
7## Color
8
9**Widget capability**: This API can be used in ArkTS widgets since API version 9.
10
11**Atomic service API**: This API can be used in atomic services since API version 11.
12
13**System capability**: SystemCapability.ArkUI.ArkUI.Full
14
15| Color                    | Value          | Illustration                                    |
16| ------------------------ | ------------- | ---------------------------------------- |
17| Black                    | 0x000000      | ![en-us_image_0000001219864153](figures/en-us_image_0000001219864153.png) |
18| Blue                     | 0x0000ff      | ![en-us_image_0000001174104404](figures/en-us_image_0000001174104404.png) |
19| Brown                    | 0xa52a2a      | ![en-us_image_0000001219744201](figures/en-us_image_0000001219744201.png) |
20| Gray                     | 0x808080      | ![en-us_image_0000001174264376](figures/en-us_image_0000001174264376.png) |
21| Grey                     | 0x808080      | ![en-us_image_0000001174264376](figures/en-us_image_0000001174264376.png) |
22| Green                    | 0x008000      | ![en-us_image_0000001174422914](figures/en-us_image_0000001174422914.png) |
23| Orange                   | 0xffa500      | ![en-us_image_0000001219662661](figures/en-us_image_0000001219662661.png) |
24| Pink                     | 0xffc0cb      | ![en-us_image_0000001219662663](figures/en-us_image_0000001219662663.png) |
25| Red                      | 0xff0000      | ![en-us_image_0000001219662665](figures/en-us_image_0000001219662665.png) |
26| White                    | 0xffffff      | ![en-us_image_0000001174582866](figures/en-us_image_0000001174582866.png) |
27| Yellow                   | 0xffff00      | ![en-us_image_0000001174582864](figures/en-us_image_0000001174582864.png) |
28| Transparent<sup>9+</sup> | rgba(0,0,0,0) | Transparent                                     |
29
30## ImageFit
31
32**System capability**: SystemCapability.ArkUI.ArkUI.Full
33
34| Name       | Description                             |
35| --------- | ------------------------------- |
36| Contain   | The image is scaled with its aspect ratio retained for the content to be completely displayed within the display boundaries.<br>**Widget capability**: This API can be used in ArkTS widgets since API version 9.<br>**Atomic service API**: This API can be used in atomic services since API version 11.|
37| Cover     | The image is scaled with its aspect ratio retained for both sides to be greater than or equal to the display boundaries.<br>**Widget capability**: This API can be used in ArkTS widgets since API version 9.<br>**Atomic service API**: This API can be used in atomic services since API version 11.|
38| Auto      | The image is scaled automatically based on its own size and the size of the component to fit the display area.<br>**Widget capability**: This API can be used in ArkTS widgets since API version 9.<br>**Atomic service API**: This API can be used in atomic services since API version 11.|
39| Fill      | The image is scaled to fill the display area, and its aspect ratio is not retained.<br>**Widget capability**: This API can be used in ArkTS widgets since API version 9.<br>**Atomic service API**: This API can be used in atomic services since API version 11.|
40| ScaleDown | The image is displayed with its aspect ratio retained, in a size smaller than or equal to the original size.<br>**Widget capability**: This API can be used in ArkTS widgets since API version 9.<br>**Atomic service API**: This API can be used in atomic services since API version 11.|
41| None      | The image is displayed in its original size.<br>**Widget capability**: This API can be used in ArkTS widgets since API version 9.<br>**Atomic service API**: This API can be used in atomic services since API version 11.|
42| TOP_START<sup>12+</sup> | The image is displayed at the top start corner of the **Image** component, keeping its original size.<br>**Widget capability**: This API can be used in ArkTS widgets since API version 12.<br>**Atomic service API**: This API can be used in atomic services since API version 12.|
43| TOP<sup>12+</sup>       | The image is displayed horizontally centered at the top of the **Image** component, keeping its original size.<br>**Widget capability**: This API can be used in ArkTS widgets since API version 12.<br>**Atomic service API**: This API can be used in atomic services since API version 12.|
44| TOP_END<sup>12+</sup>   | The image is displayed at the top end corner of the **Image** component, keeping its original size.<br>**Widget capability**: This API can be used in ArkTS widgets since API version 12.<br>**Atomic service API**: This API can be used in atomic services since API version 12.|
45| START<sup>12+</sup>     | The image is displayed vertically centered at the start of the **Image** component, keeping its original size.<br>**Widget capability**: This API can be used in ArkTS widgets since API version 12.<br>**Atomic service API**: This API can be used in atomic services since API version 12.|
46| CENTER<sup>12+</sup>    | The image is displayed at the center of the **Image** component both horizontally and vertically, keeping its original size.<br>**Widget capability**: This API can be used in ArkTS widgets since API version 12.<br>**Atomic service API**: This API can be used in atomic services since API version 12.|
47| END<sup>12+</sup>       | The image is displayed vertically centered at the end of the **Image** component, keeping its original size.<br>**Widget capability**: This API can be used in ArkTS widgets since API version 12.<br>**Atomic service API**: This API can be used in atomic services since API version 12.|
48| BOTTOM_START<sup>12+</sup> | The image is displayed at the bottom start corner of the **Image** component, keeping its original size.<br>**Widget capability**: This API can be used in ArkTS widgets since API version 12.<br>**Atomic service API**: This API can be used in atomic services since API version 12.|
49| BOTTOM<sup>12+</sup>    | The image is displayed horizontally centered at the bottom of the **Image** component, keeping its original size.<br>**Widget capability**: This API can be used in ArkTS widgets since API version 12.<br>**Atomic service API**: This API can be used in atomic services since API version 12.|
50| BOTTOM_END<sup>12+</sup>| The image is displayed at the bottom end corner of the **Image** component, keeping its original size.<br>**Widget capability**: This API can be used in ArkTS widgets since API version 12.<br>**Atomic service API**: This API can be used in atomic services since API version 12.|
51
52
53## BorderStyle
54
55**Widget capability**: This API can be used in ArkTS widgets since API version 9.
56
57**Atomic service API**: This API can be used in atomic services since API version 11.
58
59**System capability**: SystemCapability.ArkUI.ArkUI.Full
60
61| Name    | Description                           |
62| ------ | ----------------------------- |
63| Dotted | Dotted border. The radius of a dot is half of **borderWidth**.|
64| Dashed | Dashed border.                |
65| Solid  | Solid border.                     |
66
67## LineJoinStyle
68
69**Widget capability**: This API can be used in ArkTS widgets since API version 9.
70
71**Atomic service API**: This API can be used in atomic services since API version 11.
72
73**System capability**: SystemCapability.ArkUI.ArkUI.Full
74
75| Name   | Description        |
76| ----- | ---------- |
77| Bevel | Bevel is used to connect paths.|
78| Miter | Miter is used to connect paths.|
79| Round | Round is used to connect paths.|
80
81## TouchType
82
83**Atomic service API**: This API can be used in atomic services since API version 11.
84
85**System capability**: SystemCapability.ArkUI.ArkUI.Full
86
87| Name    | Description             |
88| ------ | --------------- |
89| Down   | A finger is pressed.       |
90| Up     | A finger is lifted.       |
91| Move   | A finger moves on the screen in pressed state.|
92| Cancel | A touch event is canceled.     |
93
94## MouseButton<sup>8+</sup>
95
96**Atomic service API**: This API can be used in atomic services since API version 11.
97
98**System capability**: SystemCapability.ArkUI.ArkUI.Full
99
100| Name     | Description      |
101| ------- | -------- |
102| Left    | Left button on the mouse.   |
103| Right   | Right button on the mouse.   |
104| Middle  | Middle button on the mouse.   |
105| Back    | Back button on the left of the mouse.|
106| Forward | Forward button on the left of the mouse.|
107| None    | No button.    |
108
109## MouseAction<sup>8+</sup>
110
111**Atomic service API**: This API can be used in atomic services since API version 11.
112
113**System capability**: SystemCapability.ArkUI.ArkUI.Full
114
115| Name     | Description     |
116| ------- | ------- |
117| Press   | The mouse button is pressed.|
118| Release | The mouse button is released.|
119| Move    | The mouse cursor moves.  |
120| Hover   | The mouse pointer is hovered on an element.<br>**NOTE**<br>This value has no effect.  |
121
122## ModifierKey<sup>10+</sup>
123
124Enumerates the input method modifier keys.
125
126**Atomic service API**: This API can be used in atomic services since API version 11.
127
128**System capability**: SystemCapability.ArkUI.ArkUI.Full
129
130| Name   | Description          |
131| ----- | ------------ |
132| CTRL  | Ctrl key on the keyboard. |
133| SHIFT | Shift key on the keyboard.|
134| ALT   | Alt key on the keyboard.  |
135
136## FunctionKey<sup>10+</sup>
137
138Enumerates the input method function keys.
139
140**System capability**: SystemCapability.ArkUI.ArkUI.Full
141
142| Name  | Description          |
143| ---- | ------------ |
144| ESC  | Esc key on the keyboard.<br>**Atomic service API**: This API can be used in atomic services since API version 11.|
145| F1   | F1 key on the keyboard.<br>**Atomic service API**: This API can be used in atomic services since API version 11. |
146| F2   | F2 key on the keyboard.<br>**Atomic service API**: This API can be used in atomic services since API version 11. |
147| F3   | F3 key on the keyboard.<br>**Atomic service API**: This API can be used in atomic services since API version 11. |
148| F4   | F4 key on the keyboard.<br>**Atomic service API**: This API can be used in atomic services since API version 11. |
149| F5   | F5 key on the keyboard.<br>**Atomic service API**: This API can be used in atomic services since API version 11. |
150| F6   | F6 key on the keyboard.<br>**Atomic service API**: This API can be used in atomic services since API version 11. |
151| F7   | F7 key on the keyboard.<br>**Atomic service API**: This API can be used in atomic services since API version 11. |
152| F8   | F8 key on the keyboard.<br>**Atomic service API**: This API can be used in atomic services since API version 11. |
153| F9   | F9 key on the keyboard.<br>**Atomic service API**: This API can be used in atomic services since API version 11. |
154| F10  | F10 key on the keyboard.<br>**Atomic service API**: This API can be used in atomic services since API version 11.|
155| F11  | F11 key on the keyboard.<br>**Atomic service API**: This API can be used in atomic services since API version 11.|
156| F12  | F12 key on the keyboard.<br>**Atomic service API**: This API can be used in atomic services since API version 11.|
157| TAB<sup>12+</sup>  | Tab key on the keyboard.<br>**Atomic service API**: This API can be used in atomic services since API version 12.|
158| DPAD_UP<sup>12+</sup>   | Up arrow key on the keyboard.<br>**Atomic service API**: This API can be used in atomic services since API version 12.|
159| DPAD_DOWN<sup>12+</sup> | Down arrow key on the keyboard.<br>**Atomic service API**: This API can be used in atomic services since API version 12.|
160| DPAD_LEFT<sup>12+</sup> | Left arrow key on the keyboard.<br>**Atomic service API**: This API can be used in atomic services since API version 12.|
161| DPAD_RIGHT<sup>12+</sup> | Right arrow key on the keyboard.<br>**Atomic service API**: This API can be used in atomic services since API version 12.|
162
163## Curve
164
165Enumerates the interpolation curves.
166
167**Widget capability**: This API can be used in ArkTS widgets since API version 9.
168
169**Atomic service API**: This API can be used in atomic services since API version 11.
170
171**System capability**: SystemCapability.ArkUI.ArkUI.Full
172
173| Name                 | Description                                      |
174| ------------------- | ---------------------------------------- |
175| Linear              | The animation speed keeps unchanged.                       |
176| Ease                | The animation starts slowly, accelerates, and then slows down towards the end. The cubic-bezier curve (0.25, 0.1, 0.25, 1.0) is used.|
177| EaseIn              | The animation starts at a low speed and then picks up speed until the end. The cubic-bezier curve (0.42, 0.0, 1.0, 1.0) is used.|
178| EaseOut             | The animation ends at a low speed. The cubic-bezier curve (0.0, 0.0, 0.58, 1.0) is used.|
179| EaseInOut           | The animation starts and ends at a low speed. The cubic-bezier curve (0.42, 0.0, 0.58, 1.0) is used.|
180| FastOutSlowIn       | The animation uses the standard cubic-bezier curve (0.4, 0.0, 0.2, 1.0).  |
181| LinearOutSlowIn     | The animation uses the deceleration cubic-bezier curve (0.0, 0.0, 0.2, 1.0).  |
182| FastOutLinearIn     | The animation uses the acceleration cubic-bezier curve (0.4, 0.0, 1.0, 1.0).  |
183| ExtremeDeceleration | The animation uses the extreme deceleration cubic-bezier curve (0.0, 0.0, 0.0, 1.0).  |
184| Sharp               | The animation uses the sharp cubic-bezier curve (0.33, 0.0, 0.67, 1.0).|
185| Rhythm              | The animation uses the rhythm cubic-bezier curve (0.7, 0.0, 0.2, 1.0).  |
186| Smooth              | The animation uses the smooth cubic-bezier curve (0.4, 0.0, 0.4, 1.0).  |
187| Friction            | The animation uses the friction cubic-bezier curve (0.2, 0.0, 0.2, 1.0).   |
188
189## AnimationStatus
190
191**Widget capability**: This API can be used in ArkTS widgets since API version 10.
192
193**Atomic service API**: This API can be used in atomic services since API version 11.
194
195**System capability**: SystemCapability.ArkUI.ArkUI.Full
196
197| Name     | Description       |
198| ------- | --------- |
199| Initial | The animation is in the initial state.  |
200| Running | The animation is being played.|
201| Paused  | The animation is paused.|
202| Stopped | The animation is stopped.|
203
204## FillMode
205
206**Widget capability**: This API can be used in ArkTS widgets since API version 10.
207
208**Atomic service API**: This API can be used in atomic services since API version 11.
209
210**System capability**: SystemCapability.ArkUI.ArkUI.Full
211
212| Name       | Description                                      |
213| --------- | ---------------------------------------- |
214| None      | Before execution, the animation does not apply any styles to the target component. After execution, the animation restores the target component to its default state.    |
215| Forwards  | The target component retains the state set by the last keyframe encountered during execution of the animation.                  |
216| Backwards | The animation applies the values defined in the first relevant keyframe once it is applied to the target component, and retains the values during the period set by **delay**. The first relevant keyframe depends on the value of **playMode**. If **playMode** is **Normal** or **Alternate**, the first relevant keyframe is in the **from** state. If **playMode** is **Reverse** or **AlternateReverse**, the first relevant keyframe is in the **to** state.|
217| Both      | The animation follows the rules for both **Forwards** and **Backwards**, extending the animation attributes in both directions.|
218
219## PlayMode
220
221**Widget capability**: This API can be used in ArkTS widgets since API version 9.
222
223**Atomic service API**: This API can be used in atomic services since API version 11.
224
225**System capability**: SystemCapability.ArkUI.ArkUI.Full
226
227| Name              | Description                                      |
228| ---------------- | ---------------------------------------- |
229| Normal           | The animation is played forwards.                                |
230| Reverse          | The animation is played backwards.                                 |
231| Alternate        | The animation is played forwards for an odd number of times (1, 3, 5...) and backwards for an even number of times (2, 4, 6...).|
232| AlternateReverse | The animation is played backwards for an odd number of times (1, 3, 5...) and forwards for an even number of times (2, 4, 6...).|
233
234## KeyType
235
236**Atomic service API**: This API can be used in atomic services since API version 11.
237
238**System capability**: SystemCapability.ArkUI.ArkUI.Full
239
240| Name  | Description   |
241| ---- | ----- |
242| Down | The key is pressed.|
243| Up   | The key is released.|
244
245## KeySource
246
247**Atomic service API**: This API can be used in atomic services since API version 11.
248
249**System capability**: SystemCapability.ArkUI.ArkUI.Full
250
251| Name      | Description        |
252| -------- | ---------- |
253| Unknown  | Unknown input device. |
254| Keyboard | The input device is a keyboard.|
255| JOYSTICK<sup>15+</sup> | The input device is a joystick.<br>**Atomic service API**: This API can be used in atomic services since API version 15.|
256
257## Edge
258
259**System capability**: SystemCapability.ArkUI.ArkUI.Full
260
261| Name                            | Description                                                        |
262| -------------------------------- | ------------------------------------------------------------ |
263| Top                              | Top edge in the vertical direction.<br>**Atomic service API**: This API can be used in atomic services since API version 11.|
264| Center<sup>(deprecated) </sup>   | Center position in the vertical direction.<br> This API is deprecated since API version 9.           |
265| Bottom                           | Bottom edge in the vertical direction.<br>**Atomic service API**: This API can be used in atomic services since API version 11.|
266| Baseline<sup>(deprecated) </sup> | Text baseline position in the cross axis direction.<br> This API is deprecated since API version 9.     |
267| Start                            | Start position in the horizontal direction.<br>**Atomic service API**: This API can be used in atomic services since API version 11.|
268| Middle<sup>(deprecated) </sup>   | Center position in the horizontal direction.<br> This API is deprecated since API version 9.           |
269| End                              | End position in the horizontal direction.<br>**Atomic service API**: This API can be used in atomic services since API version 11.|
270
271## Week
272
273**Atomic service API**: This API can be used in atomic services since API version 11.
274
275**System capability**: SystemCapability.ArkUI.ArkUI.Full
276
277| Name  | Description  |
278| ---- | ---- |
279| Mon  | Monday. |
280| Tue  | Tuesday. |
281| Wed  | Wednesday. |
282| Thur | Thursday. |
283| Fri  | Friday. |
284| Sat  | Saturday. |
285| Sun  | Sunday. |
286
287## Direction
288
289**Widget capability**: This API can be used in ArkTS widgets since API version 9.
290
291**Atomic service API**: This API can be used in atomic services since API version 11.
292
293**System capability**: SystemCapability.ArkUI.ArkUI.Full
294
295| Name  | Description         |
296| ---- | ----------- |
297| Ltr  | Components are arranged from left to right.  |
298| Rtl  | Components are arranged from right to left.  |
299| Auto | The default layout direction is used.|
300
301## BarState
302
303**Widget capability**: This API can be used in ArkTS widgets since API version 9.
304
305**Atomic service API**: This API can be used in atomic services since API version 11.
306
307**System capability**: SystemCapability.ArkUI.ArkUI.Full
308
309| Name  | Description                |
310| ---- | ------------------ |
311| Off  | Not displayed.              |
312| On   | Always displayed.             |
313| Auto | Displayed when the screen is touched and hidden after 2s.|
314
315## TitleHeight<sup>9+</sup>
316
317**Atomic service API**: This API can be used in atomic services since API version 11.
318
319**System capability**: SystemCapability.ArkUI.ArkUI.Full
320
321| Name         | Description                        |
322| ----------- | -------------------------- |
323| MainOnly    | Recommended height (56 vp) of the title bar when only the main title is available.     |
324| MainWithSub | Recommended height (82 vp) of the title bar when both the main title and subtitle exist.|
325
326## EdgeEffect
327
328**Widget capability**: This API can be used in ArkTS widgets since API version 9.
329
330**Atomic service API**: This API can be used in atomic services since API version 11.
331
332**System capability**: SystemCapability.ArkUI.ArkUI.Full
333
334| Name    | Description                                      |
335| ------ | ---------------------------------------- |
336| Spring | Spring effect. When at one of the edges, the component can move beyond the bounds through touches, and produces a bounce effect when the user releases their finger.|
337| Fade   | Fade effect. When at one of the edges, the component produces a fade effect.                    |
338| None   | No effect when the component is at one of the edges.                              |
339
340## Alignment
341
342**Widget capability**: This API can be used in ArkTS widgets since API version 9.
343
344**Atomic service API**: This API can be used in atomic services since API version 11.
345
346**System capability**: SystemCapability.ArkUI.ArkUI.Full
347
348| Name         | Description      |
349| ----------- | -------- |
350| TopStart    | Top start.  |
351| Top         | Horizontally centered on the top. |
352| TopEnd      | Top end.   |
353| Start       | Vertically centered start.|
354| Center      | Horizontally and vertically centered.|
355| End         | Vertically centered end. |
356| BottomStart | Bottom start.  |
357| Bottom      | Horizontally centered on the bottom. |
358| BottomEnd   | Bottom end.   |
359
360## TransitionType
361
362**Widget capability**: This API can be used in ArkTS widgets since API version 9.
363
364**Atomic service API**: This API can be used in atomic services since API version 11.
365
366**System capability**: SystemCapability.ArkUI.ArkUI.Full
367
368| Name    | Description                            |
369| ------ | ------------------------------ |
370| All    | The transition takes effect in all scenarios.|
371| Insert | The transition takes effect when a component is inserted or displayed.|
372| Delete | The transition takes effect when a component is deleted or hidden.|
373
374## RelateType
375
376**Atomic service API**: This API can be used in atomic services since API version 11.
377
378**System capability**: SystemCapability.ArkUI.ArkUI.Full
379
380| Name  | Description            |
381| ---- | -------------- |
382| FILL | The current child component is scaled to fill the parent component.|
383| FIT  | The current child component is scaled to adapt to the parent component.|
384
385## Visibility
386
387**Widget capability**: This API can be used in ArkTS widgets since API version 9.
388
389**Atomic service API**: This API can be used in atomic services since API version 11.
390
391**System capability**: SystemCapability.ArkUI.ArkUI.Full
392
393| Name     | Description              |
394| ------- | ---------------- |
395| Hidden  | The component is hidden, and a placeholder is used for it in the layout.   |
396| Visible | The component is visible.             |
397| None    | The component is hidden. It is not involved in the layout, and no placeholder is used for it.|
398
399## LineCapStyle
400
401**Widget capability**: This API can be used in ArkTS widgets since API version 9.
402
403**Atomic service API**: This API can be used in atomic services since API version 11.
404
405**System capability**: SystemCapability.ArkUI.ArkUI.Full
406
407| Name    | Description                           |
408| ------ | ----------------------------- |
409| Butt   | The ends of the line are squared off, and the line does not extend beyond its two endpoints.              |
410| Round  | The line is extended at the endpoints by a half circle whose diameter is equal to the line width.           |
411| Square | The line is extended at the endpoints by a rectangle whose width is equal to half the line width and height equal to the line width.|
412
413## Axis
414
415**Widget capability**: This API can be used in ArkTS widgets since API version 9.
416
417**Atomic service API**: This API can be used in atomic services since API version 11.
418
419**System capability**: SystemCapability.ArkUI.ArkUI.Full
420
421| Name        | Description    |
422| ---------- | ------ |
423| Vertical   | Vertical direction.|
424| Horizontal | Horizontal direction.|
425
426## HorizontalAlign
427
428**Widget capability**: This API can be used in ArkTS widgets since API version 9.
429
430**Atomic service API**: This API can be used in atomic services since API version 11.
431
432**System capability**: SystemCapability.ArkUI.ArkUI.Full
433
434| Name    | Description          |
435| ------ | ------------ |
436| Start  | Aligned with the start edge in the same direction as the language in use.|
437| Center | Aligned with the center. This is the default alignment mode.|
438| End    | Aligned with the end edge in the same direction as the language in use. |
439
440## FlexAlign
441
442**Widget capability**: This API can be used in ArkTS widgets since API version 9.
443
444**Atomic service API**: This API can be used in atomic services since API version 11.
445
446**System capability**: SystemCapability.ArkUI.ArkUI.Full
447
448| Name          | Description                                      |
449| ------------ | ---------------------------------------- |
450| Start        | The child components are aligned with the start edge of the main axis. The first component is aligned with the main-start, and subsequent components are aligned with the previous one.   |
451| Center       | The child components are aligned in the center of the main axis. The space between the first component and the main-start is the same as that between the last component and the main-end.  |
452| End          | The child components are aligned with the end edge of the main axis. The last component is aligned with the main-end, and other components are aligned with the next one.     |
453| SpaceBetween | The child components are evenly distributed along the main axis. The space between any two adjacent components is the same. The first component is aligned with the main-start, the last component is aligned with the main-end, and the remaining components are distributed so that the space between any two adjacent components is the same.|
454| SpaceAround  | The child components are evenly distributed along the main axis. The space between any two adjacent components is the same. The space between the first component and main-start, and that between the last component and cross-main are both half the size of the space between two adjacent components.|
455| SpaceEvenly  | The child components are evenly distributed along the main axis. The space between the first component and main-start, the space between the last component and main-end, and the space between any two adjacent components are the same.|
456
457## ItemAlign
458
459**Widget capability**: This API can be used in ArkTS widgets since API version 9.
460
461**Atomic service API**: This API can be used in atomic services since API version 11.
462
463**System capability**: SystemCapability.ArkUI.ArkUI.Full
464
465| Name      | Description                                      |
466| -------- | ---------------------------------------- |
467| Auto     | The default configuration of the flex container is used.                          |
468| Start    | The items in the flex container are aligned with the cross-start edge.                   |
469| Center   | The items in the flex container are centered along the cross axis.                   |
470| End      | The items in the flex container are aligned with the cross-end edge.                   |
471| Stretch  | The items in the flex container are stretched and padded along the cross axis. If the flex container has the **Wrap** attribute set to **FlexWrap.Wrap** or **FlexWrap.WrapReverse**, the items are stretched to the cross size of the widest element on the current row or column. In other cases, the items are stretched to the container size regardless of whether their size is set.|
472| Baseline | The items in the flex container are aligned in such a manner that their text baselines are aligned along the cross axis.                 |
473
474## FlexDirection
475
476**Widget capability**: This API can be used in ArkTS widgets since API version 9.
477
478**Atomic service API**: This API can be used in atomic services since API version 11.
479
480**System capability**: SystemCapability.ArkUI.ArkUI.Full
481
482| Name           | Description              |
483| ------------- | ---------------- |
484| Row           | The child components are arranged in the same direction as the main axis runs along the rows. |
485| RowReverse    | The child components are arranged opposite to the **Row** direction. |
486| Column        | The child components are arranged in the same direction as the main axis runs down the columns. |
487| ColumnReverse | The child components are arranged opposite to the **Column** direction.|
488
489## FlexWrap
490
491**Widget capability**: This API can be used in ArkTS widgets since API version 9.
492
493**Atomic service API**: This API can be used in atomic services since API version 11.
494
495**System capability**: SystemCapability.ArkUI.ArkUI.Full
496
497| Name         | Description                         |
498| ----------- | --------------------------- |
499| NoWrap      | The child components in the flex container are arranged in a single line. If any of them have minimum size constraints applied, the flex container does not forcibly shrink them when overflow occurs. |
500| Wrap        | The child components in the flex container are arranged in multiple lines, and they may overflow.  |
501| WrapReverse | The child components in the flex container are reversely arranged in multiple lines, and they may overflow.|
502
503## VerticalAlign
504
505**Widget capability**: This API can be used in ArkTS widgets since API version 9.
506
507**Atomic service API**: This API can be used in atomic services since API version 11.
508
509**System capability**: SystemCapability.ArkUI.ArkUI.Full
510
511| Name    | Description          |
512| ------ | ------------ |
513| Top    | Top aligned.       |
514| Center | Center aligned. This is the default alignment mode.|
515| Bottom | Bottom aligned.       |
516
517## ImageRepeat
518
519**Widget capability**: This API can be used in ArkTS widgets since API version 9.
520
521**Atomic service API**: This API can be used in atomic services since API version 11.
522
523**System capability**: SystemCapability.ArkUI.ArkUI.Full
524
525| Name      | Description           |
526| -------- | ------------- |
527| X        | The image is repeatedly drawn only along the horizontal axis.|
528| Y        | The image is repeatedly drawn only along the vertical axis.|
529| XY       | The image is repeatedly drawn along both axes. |
530| NoRepeat | The image is not repeatedly drawn.     |
531
532## ImageSize
533
534**System capability**: SystemCapability.ArkUI.ArkUI.Full
535
536| Name   | Description                                 |
537| ------- | ----------------------------------- |
538| Cover   | The image is scaled with its aspect ratio retained for both sides to be greater than or equal to the display boundaries.<br>**Widget capability**: This API can be used in ArkTS widgets since API version 9.<br>**Atomic service API**: This API can be used in atomic services since API version 11.|
539| Contain | The image is scaled with its aspect ratio retained for the content to be completely displayed within the display boundaries.<br>**Widget capability**: This API can be used in ArkTS widgets since API version 9.<br> **Atomic service API**: This API can be used in atomic services since API version 11.     |
540| Auto    | The original image aspect ratio remains unchanged. Default value.<br>**Widget capability**: This API can be used in ArkTS widgets since API version 9.<br> **Atomic service API**: This API can be used in atomic services since API version 11.                        |
541| FILL<sup>12+</sup> | The image is scaled to fill the display area, and its aspect ratio is not retained.<br>**Atomic service API**: This API can be used in atomic services since API version 12.|
542
543## GradientDirection
544
545**Widget capability**: This API can be used in ArkTS widgets since API version 9.
546
547**Atomic service API**: This API can be used in atomic services since API version 11.
548
549**System capability**: SystemCapability.ArkUI.ArkUI.Full
550
551| Name         | Description   |
552| ----------- | ----- |
553| Left        | The gradient direction is from right to left.|
554| Top         | The gradient direction is from bottom to top.|
555| Right       | The gradient direction is from left to right.|
556| Bottom      | The gradient direction is from top to bottom.|
557| LeftTop     | The gradient direction is upper left.  |
558| LeftBottom  | The gradient direction is lower left.  |
559| RightTop    | The gradient direction is upper right.  |
560| RightBottom | The gradient direction is lower right.  |
561| None        | No gradient.   |
562
563## SharedTransitionEffectType
564
565**Atomic service API**: This API can be used in atomic services since API version 11.
566
567**System capability**: SystemCapability.ArkUI.ArkUI.Full
568
569| Name      | Description                                      |
570| -------- | ---------------------------------------- |
571| Static   | The element position remains unchanged on the target page, and transition opacity can be configured. Currently, this effect is only valid in redirecting to the target page.|
572| Exchange | The element is relocated and scaled properly on the target page.                 |
573
574## FontStyle
575
576**Widget capability**: This API can be used in ArkTS widgets since API version 9.
577
578**Atomic service API**: This API can be used in atomic services since API version 11.
579
580**System capability**: SystemCapability.ArkUI.ArkUI.Full
581
582| Name    | Description      |
583| ------ | -------- |
584| Normal | Standard font style.|
585| Italic | Italic font style.|
586
587## FontWeight
588
589**Widget capability**: This API can be used in ArkTS widgets since API version 9.
590
591**Atomic service API**: This API can be used in atomic services since API version 11.
592
593**System capability**: SystemCapability.ArkUI.ArkUI.Full
594
595| Name   |  Value  |    Description  |
596| ------- | ----- | ----------- |
597| Lighter |  100  |   The font weight is lighter.|
598| Normal  |  400  |   The font weight is normal.|
599| Regular |  400  |   The font weight is regular.|
600| Medium  |  500  |   The font weight is medium.|
601| Bold    |  700  |   The font weight is bold.  |
602| Bolder  |  900  |   The font weight is bolder.|
603
604## TextAlign
605
606**Atomic service API**: This API can be used in atomic services since API version 11.
607
608**System capability**: SystemCapability.ArkUI.ArkUI.Full
609
610| Name                 | Description                                                        |
611| --------------------- | ------------------------------------------------------------ |
612| Start                 | Aligned with the start.<br>**Widget capability**: This API can be used in ArkTS widgets since API version 9.|
613| Center                | Horizontally centered.<br>**Widget capability**: This API can be used in ArkTS widgets since API version 9.|
614| End                   | Aligned with the end.<br>**Widget capability**: This API can be used in ArkTS widgets since API version 9.|
615| JUSTIFY<sup>10+</sup> | Aligned with both margins.<br>**Widget capability**: This API can be used in ArkTS widgets since API version 10.|
616
617## TextOverflow
618
619**Atomic service API**: This API can be used in atomic services since API version 11.
620
621**System capability**: SystemCapability.ArkUI.ArkUI.Full
622
623| Name                   | Description                 |
624| --------------------- | ------------------- |
625| None                  | Overflowing content is clipped at the limit of the maximum line width.<br>**Widget capability**: This API can be used in ArkTS widgets since API version 9.|
626| Clip                  | Overflowing content is clipped at the limit of the maximum line width.<br>**Widget capability**: This API can be used in ArkTS widgets since API version 9.|
627| Ellipsis              | An ellipsis (...) is used to represent text overflow.<br>**Widget capability**: This API can be used in ArkTS widgets since API version 9.|
628| MARQUEE<sup>10+</sup> | Text continuously scrolls when text overflow occurs.|
629
630## TextDecorationType
631
632**Widget capability**: This API can be used in ArkTS widgets since API version 9.
633
634**Atomic service API**: This API can be used in atomic services since API version 11.
635
636**System capability**: SystemCapability.ArkUI.ArkUI.Full
637
638| Name         | Description       |
639| ----------- | --------- |
640| Underline   | Line under the text. |
641| LineThrough | Line through the text.|
642| Overline    | Line over the text. |
643| None        | No text decoration.|
644
645## TextCase
646
647**Widget capability**: This API can be used in ArkTS widgets since API version 9.
648
649**Atomic service API**: This API can be used in atomic services since API version 11.
650
651**System capability**: SystemCapability.ArkUI.ArkUI.Full
652
653| Name       | Description        |
654| --------- | ---------- |
655| Normal    | The original case of the text is retained.|
656| LowerCase | All letters in the text are in lowercase.  |
657| UpperCase | All letters in the text are in uppercase.  |
658
659## ResponseType<sup>8+</sup>
660
661**Atomic service API**: This API can be used in atomic services since API version 11.
662
663**System capability**: SystemCapability.ArkUI.ArkUI.Full
664
665| Name        | Description           |
666| ---------- | ------------- |
667| LongPress  | The menu is displayed when the component is long-pressed.  |
668| RightClick | The menu is displayed when the component is right-clicked.|
669
670## HoverEffect<sup>8+</sup>
671
672**Atomic service API**: This API can be used in atomic services since API version 11.
673
674**System capability**: SystemCapability.ArkUI.ArkUI.Full
675
676| Name       | Description            |
677| --------- | -------------- |
678| Auto      | Default hover effect.|
679| Scale     | Scale effect.       |
680| Highlight | Background fade-in and fade-out effect.  |
681| None      | No effect.        |
682
683## Placement<sup>8+</sup>
684
685**Atomic service API**: This API can be used in atomic services since API version 11.
686
687**System capability**: SystemCapability.ArkUI.ArkUI.Full
688
689| Name                    | Description                                                        |
690| ------------------------ | ------------------------------------------------------------ |
691| Left                     | The popup is on the left of the component, vertically aligned with the component on the left.                  |
692| Right                    | The popup is on the right of the component, vertically aligned with the component on the right.                  |
693| Top                      | The popup is at the top of the component, horizontally aligned with the component at the top.                  |
694| Bottom                   | The popup is at the bottom of the component, horizontally aligned with the component at the bottom.                  |
695| TopLeft                  | The popup is at the top of the component and, since API version 9, aligned with the left of the component.|
696| TopRight                 | The popup is at the top of the component and, since API version 9, aligned with the right of the component.|
697| BottomLeft               | The popup is at the bottom of the component and, since API version 9, aligned with the left of the component.|
698| BottomRight              | The popup is at the bottom of the component and, since API version 9, aligned with the right of the component.|
699| LeftTop<sup>9+</sup>     | The popup is on the left of the component and aligned with the top of the component.                  |
700| LeftBottom<sup>9+</sup>  | The popup is on the left of the component and aligned with the bottom of the component.                  |
701| RightTop<sup>9+</sup>    | The popup is on the right of the component and aligned with the top of the component.                  |
702| RightBottom<sup>9+</sup> | The popup is on the right of the component and aligned with the bottom of the component.                  |
703
704## CopyOptions<sup>9+</sup>
705
706**System capability**: SystemCapability.ArkUI.ArkUI.Full
707
708| Name         | Description      |
709| ----------- | -------- |
710| None        | Copy is not allowed.<br>**Widget capability**: This API can be used in ArkTS widgets since API version 9.<br>**Atomic service API**: This API can be used in atomic services since API version 11.|
711| InApp       | Intra-application copy is allowed.<br>**Widget capability**: This API can be used in ArkTS widgets since API version 9.<br>**Atomic service API**: This API can be used in atomic services since API version 11.|
712| LocalDevice | Intra-device copy is allowed.<br>**Widget capability**: This API can be used in ArkTS widgets since API version 9.<br>**Atomic service API**: This API can be used in atomic services since API version 11.|
713| CROSS_DEVICE<sup>(deprecated)</sup> | Cross-device copy is allowed.<br>**Widget capability**: This API can be used in ArkTS widgets since API version 11.<br>**NOTE**<br>This API is supported since API version 11 and deprecated since API version 12.|
714
715## HitTestMode<sup>9+</sup>
716
717**Atomic service API**: This API can be used in atomic services since API version 11.
718
719**System capability**: SystemCapability.ArkUI.ArkUI.Full
720
721| Name         | Description                                      |
722| ----------- | ---------------------------------------- |
723| Default     | Both the node and its child node respond to the hit test of a touch event, but its sibling node is blocked from the hit test.|
724| Block       | The node responds to the hit test of a touch event, but its child node and sibling node are blocked from the hit test.|
725| Transparent | Both the node and its child node respond to the hit test of a touch event, and its sibling node is also considered during the hit test.|
726| None        | The node does not respond to the hit test of a touch event, but its child node and sibling node are considered during the hit test.     |
727
728## DialogButtonStyle<sup>10+</sup>
729
730**System capability**: SystemCapability.ArkUI.ArkUI.Full
731
732**Atomic service API**: This API can be used in atomic services since API version 11.
733
734**System capability**: SystemCapability.ArkUI.ArkUI.Full
735
736| Name     | Description                             |
737| --------- | --------------------------------- |
738| DEFAULT   | Blue text on white background (black background under the dark theme).|
739| HIGHLIGHT | White text on blue background.                       |
740
741## TextHeightAdaptivePolicy<sup>10+</sup>
742
743**Atomic service API**: This API can be used in atomic services since API version 11.
744
745**System capability**: SystemCapability.ArkUI.ArkUI.Full
746
747| Name                     | Description                      |
748| ----------------------- | ------------------------ |
749| MAX_LINES_FIRST         | Prioritize the **maxLines** settings.|
750| MIN_FONT_SIZE_FIRST     | Prioritize the **minFontSize** settings.    |
751| LAYOUT_CONSTRAINT_FIRST | Prioritize the layout constraint settings in terms of height.|
752
753## NestedScrollMode<sup>10+</sup>
754
755**Atomic service API**: This API can be used in atomic services since API version 11.
756
757**System capability**: SystemCapability.ArkUI.ArkUI.Full
758
759| Name    | Description                            |
760| ------ | ------------------------------ |
761| SELF_ONLY   | The scrolling is contained within the component, and no scroll chaining occurs, that is, the parent component does not scroll when the component scrolling reaches the boundary. |
762| SELF_FIRST | The component scrolls first, and when it hits the boundary, the parent component scrolls. When the parent component hits the boundary, its edge effect is displayed. If no edge effect is specified for the parent component, the edge effect of the child component is displayed instead.       |
763| PARENT_FIRST  | The parent component scrolls first, and when it hits the boundary, the component scrolls. When the component hits the boundary, its edge effect is displayed. If no edge effect is specified for the component, the edge effect of the parent component is displayed instead.|
764| PARALLEL  | The component and its parent component scroll at the same time. When both the component and its parent component hit the boundary, the edge effect of the component is displayed. If no edge effect is specified for the component, the edge effect of the parent component is displayed instead.|
765
766## ObscuredReasons<sup>10+</sup>
767
768**Atomic service API**: This API can be used in atomic services since API version 11.
769
770**System capability**: SystemCapability.ArkUI.ArkUI.Full
771
772| Name       | Description                    |
773| ----------- | ------------------------ |
774| PLACEHOLDER | The content is replaced by a placeholder.|
775
776## ColoringStrategy<sup>10+</sup>
777
778Enumerates the coloring strategies.
779
780**System capability**: SystemCapability.ArkUI.ArkUI.Full
781
782| Name    | Description             |
783| ------ | --------------- |
784| INVERT | The foreground colors are the inverse of the component background colors. This strategy is only applicable when set within the [foregroundColor](ts-universal-attributes-foreground-color.md#foregroundcolor) attribute.<br>**Atomic service API**: This API can be used in atomic services since API version 11.|
785| AVERAGE<sup>11+</sup> | The shadow colors of the component are the average color obtained from the component background shadow area. This strategy is only applicable when set within the [shadow](ts-universal-attributes-image-effect.md#shadow) attribute whose input parameter type is ShadowOptions.<br>**Atomic service API**: This API can be used in atomic services since API version 12.|
786| PRIMARY<sup>11+</sup> | The shadow colors of the component are the primary color obtained from the component background shadow area. This strategy is only applicable when set within the [shadow](ts-universal-attributes-image-effect.md#shadow) attribute whose input parameter type is ShadowOptions.<br>**Atomic service API**: This API can be used in atomic services since API version 12.|
787
788## ClickEffectLevel<sup>10+</sup>
789
790**Atomic service API**: This API can be used in atomic services since API version 11.
791
792**System capability**: SystemCapability.ArkUI.ArkUI.Full
793
794| Name  | Description              | Animation Settings                         | Default Zoom Ratio                    |
795| ------ | --------------------------------- | --------------------------------- | --------------------------------- |
796| LIGHT  | Small area (light)| Spring effect, with stiffness of 410, damping of 38, and initial velocity of 1.| 90% |
797| MIDDLE | Medium area (stable)| Spring effect, with stiffness of 350, damping of 35, and initial velocity of 0.5.| 95% |
798| HEAVY  | Large area (heavy)| Spring effect, with stiffness of 240, damping of 28, and initial velocity of 0.| 95% |
799
800## CheckBoxShape<sup>11+</sup>
801
802**Widget capability**: This API can be used in ArkTS widgets since API version 11.
803
804**Atomic service API**: This API can be used in atomic services since API version 12.
805
806**System capability**: SystemCapability.ArkUI.ArkUI.Full
807
808| Name          | Value  | Description    |
809| -------------- | ---- | -------- |
810| CIRCLE         | 0    | Circle.    |
811| ROUNDED_SQUARE | 1    | Rounded square.|
812
813## FoldStatus<sup>11+</sup>
814
815**Atomic service API**: This API can be used in atomic services since API version 12.
816
817**System capability**: SystemCapability.ArkUI.ArkUI.Full
818
819| Name                     | Description        |
820| ----------------------  | ---------- |
821| FOLD_STATUS_UNKNOWN     | The folding status of the device is unknown.|
822| FOLD_STATUS_EXPANDED    | The device is fully open.  |
823| FOLD_STATUS_FOLDED      | The device is folded (completely closed).  |
824| FOLD_STATUS_HALF_FOLDED | The device is half-folded, somewhere between fully open and completely closed.|
825
826## TextContentStyle<sup>10+</sup>
827
828**Atomic service API**: This API can be used in atomic services since API version 11.
829
830**System capability**: SystemCapability.ArkUI.ArkUI.Full
831
832| Name   | Description                                                        |
833| ------- | ------------------------------------------------------------ |
834| DEFAULT | Default style. The caret width is fixed at 1.5 vp, and the caret height is subject to the background height and font size of the selected text.|
835| INLINE  | Inline input style. The background height of the selected text is the same as the height of the text box.<br>This style is used in scenarios where editing and non-editing states are obvious, for example, renaming in the file list view.<br>The **showError** attribute is not supported for this style.<br>This style does not allow for text dragging and dropping.|
836
837
838## Nullable<sup>11+</sup>
839
840Nullable\<T> {
841
842(data: T);
843
844}
845
846The object of this type can be of a custom type or **undefined**.
847
848**Atomic service API**: This API can be used in atomic services since API version 12.
849
850**System capability**: SystemCapability.ArkUI.ArkUI.Full
851
852| Name| Type| Mandatory| Description                      |
853| ---- | ---- | ---- | -------------------------- |
854| data | T    | Yes  | The object of this type can be of a custom type or **undefined**.|
855
856## WordBreak<sup>11+</sup>
857
858**Atomic service API**: This API can be used in atomic services since API version 11.
859
860**System capability**: SystemCapability.ArkUI.ArkUI.Full
861
862| Name | Description                                  |
863| ----- | -------------------------------------- |
864| NORMAL  | Word breaks can occur between any two characters for Chinese, Japanese, and Korean (CJK) text, but can occur only at a space character for non-CJK text (such as English).|
865| BREAK_ALL | Line breaks can occur between any two characters for non-CJK text. CJK text behavior is the same as for **NORMAL**.|
866| BREAK_WORD | This option has the same effect as **BREAK_ALL** for non-CJK text, except that if it preferentially wraps lines at appropriate characters (for example, spaces) whenever possible. CJK text behavior is the same as for **NORMAL**.|
867
868## LineBreakStrategy<sup>12+</sup>
869
870**Atomic service API**: This API can be used in atomic services since API version 12.
871
872**System capability**: SystemCapability.ArkUI.ArkUI.Full
873
874| Name        | Description                                                        |
875| ------------ | ------------------------------------------------------------ |
876| GREEDY       | Places as many words on a line as possible and moves to the next line only if no more words can fit into the same line.|
877| HIGH_QUALITY | Fills in lines as much as possible on the basis of **BALANCED**, which may results in a large blank area on the last line.|
878| BALANCED     | Balances the line length when possible without word splitting.  |
879
880## TextSelectableMode<sup>12+</sup>
881
882**Atomic service API**: This API can be used in atomic services since API version 12.
883
884**System capability**: SystemCapability.ArkUI.ArkUI.Full
885
886| Name        | Description                                                        |
887| ------------ | ------------------------------------------------------------ |
888| SELECTABLE_UNFOCUSABLE  | The text is selectable, but not focusable. Setting the **selection**, **bindSelectionMenu**, or **copyOption** attribute does not affect the behavior.|
889| SELECTABLE_FOCUSABLE | The text is selectable and focusable. It obtains focus when touched.|
890| UNSELECTABLE     | The text is not selectable nor focusable. The **selection**, **bindSelectionMenu**, and **copyOption** attributes do not work in this case. |
891
892## AccessibilityHoverType<sup>12+</sup>
893
894**Atomic service API**: This API can be used in atomic services since API version 12.
895
896**System capability**: SystemCapability.ArkUI.ArkUI.Full
897
898| Name        | Value| Description                                                        |
899| ------------ | - | ------------------------------------------------------------ |
900| HOVER_ENTER  | 0 | A finger is pressed.        |
901| HOVER_MOVE   | 1 | The touch moves.        |
902| HOVER_EXIT   | 2 | The finger is lifted.             |
903| HOVER_CANCEL | 3 | The current event is canceled. |
904
905## EllipsisMode<sup>11+</sup>
906
907**Atomic service API**: This API can be used in atomic services since API version 12.
908
909**System capability**: SystemCapability.ArkUI.ArkUI.Full
910
911| Name | Description                                  |
912| ----- | -------------------------------------- |
913| START  | An ellipsis is used at the start of the line of text.|
914| CENTER | An ellipsis is used at the center of the line of text.|
915| END | An ellipsis is used at the end of the line of text.|
916
917## ArrowPointPosition<sup>11+</sup>
918
919**Atomic service API**: This API can be used in atomic services since API version 12.
920
921**System capability**: SystemCapability.ArkUI.ArkUI.Full
922
923| Name           | Description                                    |
924| ------------- | -------------------------------------- |
925| START | On the leftmost side of the parent component in the horizontal layout; on the top of the parent component in the vertical layout.|
926| CENTER | In the center of the parent component.|
927| END | On the rightmost side of the parent component in the horizontal layout; at the bottom of the parent component in the vertical layout.|
928
929## OptionWidthMode<sup>11+</sup>
930
931**Atomic service API**: This API can be used in atomic services since API version 12.
932
933**System capability**: SystemCapability.ArkUI.ArkUI.Full
934
935| Name       | Description                          |
936| ----------- | ------------------------------ |
937| FIT_CONTENT | Uses the default width, that is, width of two columns.           |
938| FIT_TRIGGER | Inherits the width of the drop-down list button.|
939
940## PixelRoundCalcPolicy<sup>11+</sup>
941
942Enumerates the pixel rounding policies for component boundaries.
943
944**Widget capability**: This API can be used in ArkTS widgets since API version 11.
945
946**Atomic service API**: This API can be used in atomic services since API version 11.
947
948**System capability**: SystemCapability.ArkUI.ArkUI.Full
949
950| Name    | Description                           |
951| ------ | ----------------------------- |
952| NO_FORCE_ROUND | The value is not rounded off.|
953| FORCE_CEIL | The value is rounded up to the nearest integer.|
954| FORCE_FLOOR | The value is rounded down to the nearest integer.|
955
956## TextDecorationStyle<sup>12+</sup>
957
958**Atomic service API**: This API can be used in atomic services since API version 12.
959
960**System capability**: SystemCapability.ArkUI.ArkUI.Full
961
962| Name         | Description       |
963| ----------- | --------- |
964| SOLID   | Single solid line (default value). |
965| DOUBLE | Double solid line.|
966| DOTTED    | Dotted line. |
967| DASHED        | Dashed line.|
968| WAVY        | Wavy line.|
969
970## EmbeddedType<sup>12+</sup>
971Enumerates the types of the providers that can be started by the **EmbeddedComponent**.
972
973**Atomic service API**: This API can be used in atomic services since API version 12.
974
975**System capability**: SystemCapability.ArkUI.ArkUI.Full
976
977| Name                 | Value| Description                                               |
978| --------------------- | - | ---------------------------------------------------- |
979| EMBEDDED_UI_EXTENSION | 0 | EmbeddedUIExtensionAbility.|
980
981## MarqueeUpdateStrategy<sup>12+</sup>
982
983**Atomic service API**: This API can be used in atomic services since API version 12.
984
985**System capability**: SystemCapability.ArkUI.ArkUI.Full
986
987| Name      | Value     | Description                    |
988| ---------- | ------------------------ | ------------------------ |
989| DEFAULT | 0 | After the marquee attributes are updated, the marquee scrolls from the start position.    |
990| PRESERVE_POSITION  | 1 | After the marquee attributes are updated, the marquee scrolls from the current position.|
991
992## AppRotation<sup>12+</sup>
993
994**Atomic service API**: This API can be used in atomic services since API version 12.
995
996**System capability**: SystemCapability.ArkUI.ArkUI.Full
997
998| Name    | Description                           |
999| ------ | ----------------------------- |
1000| ROTATION_0 | 0 degrees.|
1001| ROTATION_90 |90 degrees.|
1002| ROTATION_180 | 180 degrees.|
1003| ROTATION_270 | 270 degrees.|
1004
1005## ScrollSource<sup>12+</sup>
1006
1007Enumerates the sources of scroll operations.
1008
1009**Atomic service API**: This API can be used in atomic services since API version 12.
1010
1011**System capability**: SystemCapability.ArkUI.ArkUI.Full
1012
1013| Name    |  Value | Description                                      |
1014| ------ | ------ | ---------------------------------------- |
1015| DRAG   |  0  | Drag event.|
1016| FLING |  1  | Inertia scrolling after the drag ends.|
1017| EDGE_EFFECT  |  2  | Edge scrolling effect with **EdgeEffect.Spring**.|
1018| OTHER_USER_INPUT  |  3  | Other user inputs aside from dragging, such as those from the mouse wheel and keyboard events.|
1019| SCROLL_BAR  |  4  | Drag event from the scrollbar.|
1020| SCROLL_BAR_FLING  |  5  | Inertia scrolling with velocity after the scrollbar is released.|
1021| SCROLLER  |  6  | Non-animated methods of the **Scroller** object.|
1022| SCROLLER_ANIMATION  |  7  | Animated methods of the **Scroller** object.|
1023
1024## ImageSpanAlignment<sup>10+</sup>
1025
1026**Atomic service API**: This API can be used in atomic services since API version 11.
1027
1028**System capability**: SystemCapability.ArkUI.ArkUI.Full
1029
1030| Name    | Description                          |
1031| -------- | ------------------------------ |
1032| TOP      | The image is top aligned with the line.  |
1033| CENTER   | The image is centered aligned with the line.      |
1034| BOTTOM   | The image is bottom aligned with the line.  |
1035| BASELINE | The image is bottom aligned with the text baseline.|
1036
1037
1038## XComponentType<sup>10+</sup>
1039
1040**System capability**: SystemCapability.ArkUI.ArkUI.Full
1041
1042| Name                            | Description                                                        |
1043| -------------------------------- | ------------------------------------------------------------ |
1044| SURFACE                          | The component is used for EGL/OpenGLES and media data input, where the custom content is displayed individually on the screen. When the background color is set to black, the display subsystem (DSS) is used.<br>**Atomic service API**: This API can be used in atomic services since API version 11.|
1045| COMPONENT<sup>(deprecated)</sup> | The component becomes a container where non-UI logic can be executed to dynamically load the display content.<br>**NOTE**<br>This API is deprecated since API version 12. You are advised to use other container components instead.<br>**Atomic service API**: This API can be used in atomic services since API version 11.|
1046| TEXTURE                          | The component is used for EGL/OpenGLES and media data input, where the custom content is combined with the content of the component and then displayed on the screen. 1. Frame synchronization is maintained, which ensures that the GPU textures and other ArkUI drawing commands are batched and sent to the RenderService within the same frame. 2. Animations are unified with built-in components. 3. As the GPU is used for composition, this type may consume more power compared to the surface type that uses the display subsystem (DSS).<br>**Atomic service API**: This API can be used in atomic services since API version 11.|
1047| NODE<sup>12+</sup>            | The component is used as a placeholder container for native UI nodes. Page components developed with native APIs can be displayed within this container's area.<br>**NOTE**<br>This type is no longer being evolved. You are advised to use the [ContentSlot](../../../quick-start/arkts-rendering-control-contentslot.md) placeholder component for managing components created with native APIs. **ContentSlot** is superior to the NODE-type **XComponent** in terms of memory and performance.<br>**Atomic service API**: This API can be used in atomic services since API version 12.|
1048
1049## HoverModeAreaType<sup>14+</sup>
1050
1051Enumerates the types of display areas for the hover mode.
1052
1053**Atomic service API**: This API can be used in atomic services since API version 14.
1054
1055**System capability**: SystemCapability.ArkUI.ArkUI.Full
1056
1057| Name    | Description                           |
1058| ------ | ----------------------------- |
1059| TOP_SCREEN | Upper half screen.|
1060| BOTTOM_SCREEN | Lower half screen.|
1061
1062## WidthBreakpoint<sup>13+</sup>
1063
1064Enumerates the width breakpoint values corresponding to different window width thresholds. The value is returned through [getWindowWidthBreakpoint](../js-apis-arkui-UIContext.md#getwindowwidthbreakpoint13).
1065
1066**Atomic service API**: This API can be used in atomic services since API version 13.
1067
1068**System capability**: SystemCapability.ArkUI.ArkUI.Full
1069
1070| Name    | Value  | Description                  |
1071| -------- | ---- | ---------------------- |
1072| WIDTH_XS | 0   | The window width is less than 320 vp.|
1073| WIDTH_SM | 1   | The window width is greater than or equal to 320 vp and less than 600 vp.|
1074| WIDTH_MD | 2   | The window width is greater than or equal to 600 vp and less than 840 vp.|
1075| WIDTH_LG | 3   | The window width is greater than or equal to 840 vp and less than 1440 vp.|
1076| WIDTH_XL | 4   | The window width is greater than or equal to 1440 vp.|
1077
1078## HeightBreakpoint<sup>13+</sup>
1079
1080Enumerates the height breakpoint values corresponding to different window aspect ratio thresholds. The value is returned through [getWindowHeightBreakpoint](../js-apis-arkui-UIContext.md#getwindowheightbreakpoint13).
1081
1082**Atomic service API**: This API can be used in atomic services since API version 13.
1083
1084**System capability**: SystemCapability.ArkUI.ArkUI.Full
1085
1086| Name    | Value  | Description                  |
1087| -------- | ---- | ---------------------- |
1088| HEIGHT_SM | 0   | The window aspect ratio is less than 0.8.|
1089| HEIGHT_MD | 1   | The window aspect ratio is greater than or equal to 0.8 and less than 1.2.|
1090| HEIGHT_LG | 2   | The window aspect ratio is greater than or equal to 1.2.|
1091
1092## AxisModel<sup>15+</sup>
1093
1094Enumerates the axis types for focus axis events.
1095
1096**Atomic service API**: This API can be used in atomic services since API version 15.
1097
1098**System capability**: SystemCapability.ArkUI.ArkUI.Full
1099
1100| Name   | Value  | Description                              |
1101| ------- | ---- | ---------------------------------- |
1102| ABS_X  | 0    | Game controller x-axis.|
1103| ABS_Y  | 1    | Game controller y-axis.|
1104| ABS_Z  | 2    | Game controller z-axis.|
1105| ABS_RZ | 3    | Game controller rz-axis.|
1106| ABS_GAS | 4    | Game controller GAS-axis.|
1107| ABS_BRAKE | 5    | Game controller BRAKE-axis.|
1108| ABS_HAT0X | 6    | Game controller HAT0X-axis.|
1109| ABS_HAT0Y | 7    | Game controller HAT0Y-axis.|
1110
1111## RenderFit<sup>10+</sup>
1112
1113Enumerates the modes in which the final state of the component's content is rendered during its width and height animation process.
1114
1115**Atomic service API**: This API can be used in atomic services since API version 11.
1116
1117**System capability**: SystemCapability.ArkUI.ArkUI.Full
1118
1119| Name                         | Description                                                                             |
1120| --------------------------- | ---------------------------------------------------------------------------------- |
1121| CENTER                      | The component's content stays at the final size and always aligned with the center of the component.               ![renderfit_center](figures/renderfit_center.png) |
1122| TOP                         | The component's content stays at the final size and always aligned with the top center of the component.             ![renderfit_top](figures/renderfit_top.png) |
1123| BOTTOM                      | The component's content stays at the final size and always aligned with the bottom center of the component.             ![renderfit_bottom](figures/renderfit_bottom.png) |
1124| LEFT                        | The component's content stays at the final size and always aligned with the left of the component.               ![renderfit_left](figures/renderfit_left.png) |
1125| RIGHT                       | The component's content stays at the final size and always aligned with the right of the component.              ![renderfit_right](figures/renderfit_right.png) |
1126| TOP_LEFT                    | The component's content stays at the final size and always aligned with the upper left corner of the component.              ![renderfit_top_left](figures/renderfit_top_left.png) |
1127| TOP_RIGHT                   | The component's content stays at the final size and always aligned with the upper right corner of the component.             ![renderfit_top_right](figures/renderfit_top_right.png) |
1128| BOTTOM_LEFT                 | The component's content stays at the final size and always aligned with the lower left corner of the component.              ![renderfit_bottom_left](figures/renderfit_bottom_left.png) |
1129| BOTTOM_RIGHT                | The component's content stays at the final size and always aligned with the lower right corner of the component.              ![renderfit_bottom_right](figures/renderfit_bottom_right.png) |
1130| RESIZE_FILL                 | The component's content is always resized to fill the component's content box, without considering its aspect ratio in the final state.              ![renderfit_resize_fill](figures/renderfit_resize_fill.png) |
1131| RESIZE_CONTAIN              | While maintaining its aspect ratio in the final state, the component's content is scaled to fit within the component's content box. It is always aligned with the center of the component.   ![renderfit_resize_contain](figures/renderfit_resize_contain.png) |
1132| RESIZE_CONTAIN_TOP_LEFT     | While maintaining its aspect ratio in the final state, the component's content is scaled to fit within the component's content box. When there is remaining space in the width direction of the component, the content is left-aligned with the component. When there is remaining space in the height direction of the component, the content is top-aligned with the component.   ![renderfit_resize_contain_top_left](figures/renderfit_resize_contain_top_left.png) |
1133| RESIZE_CONTAIN_BOTTOM_RIGHT | While maintaining its aspect ratio in the final state, the component's content is scaled to fit within the component's content box. When there is remaining space in the width direction of the component, the content is right-aligned with the component. When there is remaining space in the height direction of the component, the content is bottom-aligned with the component.   ![renderfit_resize_contain_bottom_right](figures/renderfit_resize_contain_bottom_right.png) |
1134| RESIZE_COVER                | While maintaining its aspect ratio in the final state, the component's content is scaled to cover the component's entire content box. It is always aligned with the center of the component, so that its middle part is displayed.   ![renderfit_resize_cover](figures/renderfit_resize_cover.png) |
1135| RESIZE_COVER_TOP_LEFT       | While maintaining its aspect ratio in the final state, the component's content is scaled to cover the component's entire content box. When there is remaining space in the width direction, the content is left-aligned with the component, so that its left part is displayed. When there is remaining space in the height direction, the content is top-aligned with the component, so that its top part is displayed.   ![renderfit_resize_cover_top_left](figures/renderfit_resize_cover_top_left.png) |
1136| RESIZE_COVER_BOTTOM_RIGHT   | While maintaining its aspect ratio in the final state, the component's content is scaled to cover the component's entire content box. When there is remaining space in the width direction, the content is right-aligned with the component, so that its right part is displayed. When there is remaining space in the height direction, the content is bottom-aligned with the component, so that its bottom part is displayed.   ![renderfit_resize_cover_bottom_right](figures/renderfit_resize_cover_bottom_right.png) |
1137
1138> **NOTE**
1139>
1140> - In the illustrative diagrams, the blue area indicates the content, and the orange area indicates the component content box.
1141> - Different render fit modes create different effects during the width and height animation process. Choose the one that best fits your need.
1142
1143## PageFlipMode<sup>15+</sup>
1144
1145Enumerates the modes for flipping pages using the mouse wheel.
1146
1147**Atomic service API**: This API can be used in atomic services since API version 15.
1148
1149**Atomic service API**: This API can be used in atomic services since API version 15.
1150
1151**System capability**: SystemCapability.ArkUI.ArkUI.Full
1152
1153| Name    | Value  | Description                  |
1154| -------- | ---- | ---------------------- |
1155| CONTINUOUS | 0   | Continuous page flipping mode where multiple pages are turned continuously when the user scrolls the mouse wheel without interruption.|
1156| SINGLE | 1   | Single-page flipping mode where the mouse wheel event is ignored until the current page flipping animation is complete.|
1157
1158## InteractionHand<sup>15+</sup>
1159
1160Defines whether an event is triggered by a left-hand or right-hand tap.
1161
1162**Atomic service API**: This API can be used in atomic services since API version 15.
1163
1164**System capability**: SystemCapability.ArkUI.ArkUI.Full
1165
1166| Name    | Value  | Description                  |
1167| -------- | ---- | ---------------------- |
1168| NONE     | 0   | Unknown.|
1169| LEFT     | 1   | Left hand.|
1170| RIGHT    | 2   | Right hand.|