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 |  | 18| Blue | 0x0000ff |  | 19| Brown | 0xa52a2a |  | 20| Gray | 0x808080 |  | 21| Grey | 0x808080 |  | 22| Green | 0x008000 |  | 23| Orange | 0xffa500 |  | 24| Pink | 0xffc0cb |  | 25| Red | 0xff0000 |  | 26| White | 0xffffff |  | 27| Yellow | 0xffff00 |  | 28| Transparent<sup>9+</sup> | rgba(0,0,0,0) | Transparent | 29 30## ImageFit 31 32**System capability**: SystemCapability.ArkUI.ArkUI.Full 33 34| Name | Value | Description | 35| --------- | ----- | ------------------------------- | 36| Contain | 0 | 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.<br> | 37| Cover | 1 | 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.<br> | 38| Auto | 2 | 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.<br> | 39| Fill | 3 | 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.<br> | 40| ScaleDown | 4 | 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.<br> | 41| None | 5 | 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.<br> | 42| TOP_START<sup>12+</sup> | 7 | 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.<br> | 43| TOP<sup>12+</sup> | 8 | 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.<br> | 44| TOP_END<sup>12+</sup> | 9 | 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.<br> | 45| START<sup>12+</sup> | 10 | 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.<br> | 46| CENTER<sup>12+</sup> | 11 | 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.<br> | 47| END<sup>12+</sup> | 12 | 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.<br> | 48| BOTTOM_START<sup>12+</sup> | 13 | 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.<br> | 49| BOTTOM<sup>12+</sup> | 14 | 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.<br> | 50| BOTTOM_END<sup>12+</sup>| 15 | 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.<br> | 51| MATRIX<sup>15+</sup>| 16 | The image, with the use of [imageMatrix](ts-basic-components-image.md#imagematrix15), is displayed in the specified position of the **Image component**, keeping its original size. SVG images are not supported.<br>**Atomic service API**: This API can be used in atomic services since API version 15.| 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**System capability**: SystemCapability.ArkUI.ArkUI.Full 84 85| Name | Description | 86| ------ | --------------- | 87| Down | A finger is pressed. | 88| Up | A finger is lifted. | 89| Move | A finger moves on the screen in pressed state.| 90| Cancel | A touch event is canceled. Examples: 1. touching the home button to return to the home screen while keeping a finger on the screen; 2. folding a foldable phone to switch to the external screen while keeping a finger on the screen.| 91 92## MouseButton<sup>8+</sup> 93 94**Atomic service API**: This API can be used in atomic services since API version 11. 95 96**System capability**: SystemCapability.ArkUI.ArkUI.Full 97 98| Name | Description | 99| ------- | -------- | 100| Left | Left button on the mouse. | 101| Right | Right button on the mouse. | 102| Middle | Middle button on the mouse. | 103| Back | Back button on the left of the mouse.| 104| Forward | Forward button on the left of the mouse.| 105| None | No button. | 106 107## MouseAction<sup>8+</sup> 108 109**System capability**: SystemCapability.ArkUI.ArkUI.Full 110 111| Name | Description | 112| ------- | ------- | 113| Press | The mouse button is pressed.<br>**Atomic service API**: This API can be used in atomic services since API version 11.| 114| Release | The mouse button is released.<br>**Atomic service API**: This API can be used in atomic services since API version 11.| 115| Move | The mouse cursor moves.<br>**Atomic service API**: This API can be used in atomic services since API version 11. | 116| Hover | The mouse pointer is hovered on an element.<br>**NOTE**<br>This value has no effect.<br>**Atomic service API**: This API can be used in atomic services since API version 11. | 117| CANCEL<sup>18+</sup> | The mouse button action is canceled.<br>**Atomic service API**: This API can be used in atomic services since API version 18.| 118 119## ModifierKey<sup>10+</sup> 120 121Enumerates the input method modifier keys. 122 123**Atomic service API**: This API can be used in atomic services since API version 11. 124 125**System capability**: SystemCapability.ArkUI.ArkUI.Full 126 127| Name | Description | 128| ----- | ------------ | 129| CTRL | Ctrl key on the keyboard. | 130| SHIFT | Shift key on the keyboard.| 131| ALT | Alt key on the keyboard. | 132 133## FunctionKey<sup>10+</sup> 134 135Enumerates the input method function keys. 136 137**System capability**: SystemCapability.ArkUI.ArkUI.Full 138 139| Name | Description | 140| ---- | ------------ | 141| ESC | Esc key on the keyboard.<br>**Atomic service API**: This API can be used in atomic services since API version 11.| 142| F1 | F1 key on the keyboard.<br>**Atomic service API**: This API can be used in atomic services since API version 11. | 143| F2 | F2 key on the keyboard.<br>**Atomic service API**: This API can be used in atomic services since API version 11. | 144| F3 | F3 key on the keyboard.<br>**Atomic service API**: This API can be used in atomic services since API version 11. | 145| F4 | F4 key on the keyboard.<br>**Atomic service API**: This API can be used in atomic services since API version 11. | 146| F5 | F5 key on the keyboard.<br>**Atomic service API**: This API can be used in atomic services since API version 11. | 147| F6 | F6 key on the keyboard.<br>**Atomic service API**: This API can be used in atomic services since API version 11. | 148| F7 | F7 key on the keyboard.<br>**Atomic service API**: This API can be used in atomic services since API version 11. | 149| F8 | F8 key on the keyboard.<br>**Atomic service API**: This API can be used in atomic services since API version 11. | 150| F9 | F9 key on the keyboard.<br>**Atomic service API**: This API can be used in atomic services since API version 11. | 151| F10 | F10 key on the keyboard.<br>**Atomic service API**: This API can be used in atomic services since API version 11.| 152| F11 | F11 key on the keyboard.<br>**Atomic service API**: This API can be used in atomic services since API version 11.| 153| F12 | F12 key on the keyboard.<br>**Atomic service API**: This API can be used in atomic services since API version 11.| 154| 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.| 155| 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.| 156| 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.| 157| 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.| 158| 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.| 159 160## Curve 161 162Enumerates the interpolation curves. For details about the animation, see <!--RP1-->[Bezier Curve](../../../../design/ux-design/animation-attributes.md)<!--RP1End-->. 163 164**Widget capability**: This API can be used in ArkTS widgets since API version 9. 165 166**Atomic service API**: This API can be used in atomic services since API version 11. 167 168**System capability**: SystemCapability.ArkUI.ArkUI.Full 169 170| Name | Description | 171| ------------------- | ---------------------------------------- | 172| Linear | The animation speed keeps unchanged. | 173| 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.| 174| 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.| 175| EaseOut | The animation ends at a low speed. The cubic-bezier curve (0.0, 0.0, 0.58, 1.0) is used.| 176| EaseInOut | The animation starts and ends at a low speed. The cubic-bezier curve (0.42, 0.0, 0.58, 1.0) is used.| 177| FastOutSlowIn | The animation uses the standard cubic-bezier curve (0.4, 0.0, 0.2, 1.0). | 178| LinearOutSlowIn | The animation uses the deceleration cubic-bezier curve (0.0, 0.0, 0.2, 1.0). | 179| FastOutLinearIn | The animation uses the acceleration cubic-bezier curve (0.4, 0.0, 1.0, 1.0). | 180| ExtremeDeceleration | The animation uses the extreme deceleration cubic-bezier curve (0.0, 0.0, 0.0, 1.0). | 181| Sharp | The animation uses the sharp cubic-bezier curve (0.33, 0.0, 0.67, 1.0).| 182| Rhythm | The animation uses the rhythm cubic-bezier curve (0.7, 0.0, 0.2, 1.0). | 183| Smooth | The animation uses the smooth cubic-bezier curve (0.4, 0.0, 0.4, 1.0). | 184| Friction | The animation uses the friction cubic-bezier curve (0.2, 0.0, 0.2, 1.0). | 185 186## AnimationStatus 187 188**Widget capability**: This API can be used in ArkTS widgets since API version 10. 189 190**Atomic service API**: This API can be used in atomic services since API version 11. 191 192**System capability**: SystemCapability.ArkUI.ArkUI.Full 193 194| Name | Description | 195| ------- | --------- | 196| Initial | The animation is in the initial state. | 197| Running | The animation is being played.| 198| Paused | The animation is paused.| 199| Stopped | The animation is stopped.| 200 201## FillMode 202 203**Widget capability**: This API can be used in ArkTS widgets since API version 10. 204 205**Atomic service API**: This API can be used in atomic services since API version 11. 206 207**System capability**: SystemCapability.ArkUI.ArkUI.Full 208 209| Name | Description | 210| --------- | ---------------------------------------- | 211| 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. | 212| Forwards | The target component retains the state set by the last keyframe encountered during execution of the animation. | 213| 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.| 214| Both | The animation follows the rules for both **Forwards** and **Backwards**, extending the animation attributes in both directions.| 215 216## PlayMode 217 218**Widget capability**: This API can be used in ArkTS widgets since API version 9. 219 220**Atomic service API**: This API can be used in atomic services since API version 11. 221 222**System capability**: SystemCapability.ArkUI.ArkUI.Full 223 224| Name | Description | 225| ---------------- | ---------------------------------------- | 226| Normal | The animation is played forwards. | 227| Reverse | The animation is played backwards. | 228| 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...).| 229| 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...).| 230 231## KeyType 232 233**Atomic service API**: This API can be used in atomic services since API version 11. 234 235**System capability**: SystemCapability.ArkUI.ArkUI.Full 236 237| Name | Description | 238| ---- | ----- | 239| Down | The key is pressed.| 240| Up | The key is released.| 241 242## KeySource 243 244**Atomic service API**: This API can be used in atomic services since API version 11. 245 246**System capability**: SystemCapability.ArkUI.ArkUI.Full 247 248| Name | Description | 249| -------- | ---------- | 250| Unknown | Unknown input device. | 251| Keyboard | The input device is a keyboard.| 252| 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.| 253 254## Edge 255 256**System capability**: SystemCapability.ArkUI.ArkUI.Full 257 258| Name | Description | 259| -------------------------------- | ------------------------------------------------------------ | 260| Top | Top edge in the vertical direction.<br>**Atomic service API**: This API can be used in atomic services since API version 11.| 261| Center<sup>(deprecated) </sup> | Center position in the vertical direction.<br> This API is deprecated since API version 9. | 262| Bottom | Bottom edge in the vertical direction.<br>**Atomic service API**: This API can be used in atomic services since API version 11.| 263| Baseline<sup>(deprecated) </sup> | Text baseline position in the cross axis direction.<br> This API is deprecated since API version 9. | 264| Start | Start position in the horizontal direction.<br>**Atomic service API**: This API can be used in atomic services since API version 11.| 265| Middle<sup>(deprecated) </sup> | Center position in the horizontal direction.<br> This API is deprecated since API version 9. | 266| End | End position in the horizontal direction.<br>**Atomic service API**: This API can be used in atomic services since API version 11.| 267 268## Week 269 270**Atomic service API**: This API can be used in atomic services since API version 11. 271 272**System capability**: SystemCapability.ArkUI.ArkUI.Full 273 274| Name | Description | 275| ---- | ---- | 276| Mon | Monday. | 277| Tue | Tuesday. | 278| Wed | Wednesday. | 279| Thur | Thursday. | 280| Fri | Friday. | 281| Sat | Saturday. | 282| Sun | Sunday. | 283 284## Direction 285 286**Widget capability**: This API can be used in ArkTS widgets since API version 9. 287 288**Atomic service API**: This API can be used in atomic services since API version 11. 289 290**System capability**: SystemCapability.ArkUI.ArkUI.Full 291 292| Name | Description | 293| ---- | ----------- | 294| Ltr | Components are arranged from left to right. | 295| Rtl | Components are arranged from right to left. | 296| Auto | The default layout direction is used.| 297 298## BarState 299 300**Widget capability**: This API can be used in ArkTS widgets since API version 9. 301 302**Atomic service API**: This API can be used in atomic services since API version 11. 303 304**System capability**: SystemCapability.ArkUI.ArkUI.Full 305 306| Name | Description | 307| ---- | ------------------ | 308| Off | Not displayed. | 309| On | Always displayed. | 310| Auto | Displayed when the screen is touched and hidden after 2s.| 311 312## TitleHeight<sup>9+</sup> 313 314**Atomic service API**: This API can be used in atomic services since API version 11. 315 316**System capability**: SystemCapability.ArkUI.ArkUI.Full 317 318| Name | Description | 319| ----------- | -------------------------- | 320| MainOnly | Recommended height (56 vp) of the title bar when only the main title is available. | 321| MainWithSub | Recommended height (82 vp) of the title bar when both the main title and subtitle exist.| 322 323## EdgeEffect 324 325**Widget capability**: This API can be used in ArkTS widgets since API version 9. 326 327**Atomic service API**: This API can be used in atomic services since API version 11. 328 329**System capability**: SystemCapability.ArkUI.ArkUI.Full 330 331| Name | Description | 332| ------ | ---------------------------------------- | 333| 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.| 334| Fade | Fade effect. When at one of the edges, the component produces a fade effect. | 335| None | No effect when the component is at one of the edges. | 336 337## Alignment 338 339**Widget capability**: This API can be used in ArkTS widgets since API version 9. 340 341**Atomic service API**: This API can be used in atomic services since API version 11. 342 343**System capability**: SystemCapability.ArkUI.ArkUI.Full 344 345| Name | Description | 346| ----------- | -------- | 347| TopStart | Top start. | 348| Top | Horizontally centered on the top. | 349| TopEnd | Top end. | 350| Start | Vertically centered start.| 351| Center | Horizontally and vertically centered.| 352| End | Vertically centered end. | 353| BottomStart | Bottom start. | 354| Bottom | Horizontally centered on the bottom. | 355| BottomEnd | Bottom end. | 356 357## TransitionType 358 359**Widget capability**: This API can be used in ArkTS widgets since API version 9. 360 361**Atomic service API**: This API can be used in atomic services since API version 11. 362 363**System capability**: SystemCapability.ArkUI.ArkUI.Full 364 365| Name | Description | 366| ------ | ------------------------------ | 367| All | The transition takes effect in all scenarios.| 368| Insert | The transition takes effect when a component is inserted or displayed.| 369| Delete | The transition takes effect when a component is deleted or hidden.| 370 371## RelateType 372 373**Atomic service API**: This API can be used in atomic services since API version 11. 374 375**System capability**: SystemCapability.ArkUI.ArkUI.Full 376 377| Name | Description | 378| ---- | -------------- | 379| FILL | The current child component is scaled to fill the parent component.| 380| FIT | The current child component is scaled to adapt to the parent component.| 381 382## Visibility 383 384**Widget capability**: This API can be used in ArkTS widgets since API version 9. 385 386**Atomic service API**: This API can be used in atomic services since API version 11. 387 388**System capability**: SystemCapability.ArkUI.ArkUI.Full 389 390| Name | Description | 391| ------- | ---------------- | 392| Hidden | The component is hidden, and a placeholder is used for it in the layout. | 393| Visible | The component is visible. | 394| None | The component is hidden. It is not involved in the layout, and no placeholder is used for it.| 395 396## LineCapStyle 397 398**Widget capability**: This API can be used in ArkTS widgets since API version 9. 399 400**Atomic service API**: This API can be used in atomic services since API version 11. 401 402**System capability**: SystemCapability.ArkUI.ArkUI.Full 403 404| Name | Description | 405| ------ | ----------------------------- | 406| Butt | The ends of the line are squared off, and the line does not extend beyond its two endpoints. | 407| Round | The line is extended at the endpoints by a half circle whose diameter is equal to the line width. | 408| 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.| 409 410## Axis 411 412**Widget capability**: This API can be used in ArkTS widgets since API version 9. 413 414**Atomic service API**: This API can be used in atomic services since API version 11. 415 416**System capability**: SystemCapability.ArkUI.ArkUI.Full 417 418| Name | Value| Description | 419| ---------- | -- | ------ | 420| Vertical | 0 | Vertical direction.| 421| Horizontal | 1 | Horizontal direction.| 422 423## HorizontalAlign 424 425**Widget capability**: This API can be used in ArkTS widgets since API version 9. 426 427**Atomic service API**: This API can be used in atomic services since API version 11. 428 429**System capability**: SystemCapability.ArkUI.ArkUI.Full 430 431| Name | Description | 432| ------ | ------------ | 433| Start | Aligned with the start edge in the same direction as the language in use.| 434| Center | Aligned with the center. This is the default alignment mode.| 435| End | Aligned with the end edge in the same direction as the language in use. | 436 437## FlexAlign 438 439**Widget capability**: This API can be used in ArkTS widgets since API version 9. 440 441**Atomic service API**: This API can be used in atomic services since API version 11. 442 443**System capability**: SystemCapability.ArkUI.ArkUI.Full 444 445| Name | Description | 446| ------------ | ---------------------------------------- | 447| 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. | 448| 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. | 449| 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. | 450| 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.| 451| 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.| 452| 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.| 453 454## ItemAlign 455 456**Widget capability**: This API can be used in ArkTS widgets since API version 9. 457 458**Atomic service API**: This API can be used in atomic services since API version 11. 459 460**System capability**: SystemCapability.ArkUI.ArkUI.Full 461 462| Name | Description | 463| -------- | ---------------------------------------- | 464| Auto | The default configuration of the flex container is used. | 465| Start | The items in the flex container are aligned with the cross-start edge. | 466| Center | The items in the flex container are centered along the cross axis. | 467| End | The items in the flex container are aligned with the cross-end edge. | 468| 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.| 469| Baseline | The items in the flex container are aligned in such a manner that their text baselines are aligned along the cross axis. | 470 471## FlexDirection 472 473**Widget capability**: This API can be used in ArkTS widgets since API version 9. 474 475**Atomic service API**: This API can be used in atomic services since API version 11. 476 477**System capability**: SystemCapability.ArkUI.ArkUI.Full 478 479| Name | Description | 480| ------------- | ---------------- | 481| Row | The child components are arranged in the same direction as the main axis runs along the rows. | 482| RowReverse | The child components are arranged opposite to the **Row** direction. | 483| Column | The child components are arranged in the same direction as the main axis runs down the columns. | 484| ColumnReverse | The child components are arranged opposite to the **Column** direction.| 485 486## FlexWrap 487 488**Widget capability**: This API can be used in ArkTS widgets since API version 9. 489 490**Atomic service API**: This API can be used in atomic services since API version 11. 491 492**System capability**: SystemCapability.ArkUI.ArkUI.Full 493 494| Name | Description | 495| ----------- | --------------------------- | 496| 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. | 497| Wrap | The child components in the flex container are arranged in multiple lines, and they may overflow. | 498| WrapReverse | The child components in the flex container are reversely arranged in multiple lines, and they may overflow. **WrapReverse** reverses the in-line direction of components.| 499 500## VerticalAlign 501 502**Widget capability**: This API can be used in ArkTS widgets since API version 9. 503 504**Atomic service API**: This API can be used in atomic services since API version 11. 505 506**System capability**: SystemCapability.ArkUI.ArkUI.Full 507 508| Name | Description | 509| ------ | ------------ | 510| Top | Top aligned. | 511| Center | Center aligned. This is the default alignment mode.| 512| Bottom | Bottom aligned. | 513 514## ImageRepeat 515 516**Widget capability**: This API can be used in ArkTS widgets since API version 9. 517 518**Atomic service API**: This API can be used in atomic services since API version 11. 519 520**System capability**: SystemCapability.ArkUI.ArkUI.Full 521 522| Name | Description | 523| -------- | ------------- | 524| X | The image is repeatedly drawn only along the horizontal axis.| 525| Y | The image is repeatedly drawn only along the vertical axis.| 526| XY | The image is repeatedly drawn along both axes. | 527| NoRepeat | The image is not repeatedly drawn. | 528 529## ImageSize 530 531**System capability**: SystemCapability.ArkUI.ArkUI.Full 532 533| Name | Value | Description | 534| ------- | -------------------------- | ----------------------------------- | 535| Cover | 1 | 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.| 536| Contain | 2 | 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. | 537| Auto | 0 | The original image aspect ratio is 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. | 538| FILL<sup>12+</sup> | 3 | 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.| 539 540## GradientDirection 541 542**Widget capability**: This API can be used in ArkTS widgets since API version 9. 543 544**Atomic service API**: This API can be used in atomic services since API version 11. 545 546**System capability**: SystemCapability.ArkUI.ArkUI.Full 547 548| Name | Description | 549| ----------- | ----- | 550| Left | The gradient direction is from right to left.| 551| Top | The gradient direction is from bottom to top.| 552| Right | The gradient direction is from left to right.| 553| Bottom | The gradient direction is from top to bottom.| 554| LeftTop | The gradient direction is upper left. | 555| LeftBottom | The gradient direction is lower left. | 556| RightTop | The gradient direction is upper right. | 557| RightBottom | The gradient direction is lower right. | 558| None | No gradient. | 559 560## SharedTransitionEffectType 561 562**Atomic service API**: This API can be used in atomic services since API version 11. 563 564**System capability**: SystemCapability.ArkUI.ArkUI.Full 565 566| Name | Description | 567| -------- | ---------------------------------------- | 568| 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.| 569| Exchange | The element is relocated and scaled properly on the target page. | 570 571## FontStyle 572 573**Widget capability**: This API can be used in ArkTS widgets since API version 9. 574 575**Atomic service API**: This API can be used in atomic services since API version 11. 576 577**System capability**: SystemCapability.ArkUI.ArkUI.Full 578 579| Name | Description | 580| ------ | -------- | 581| Normal | Standard font style.| 582| Italic | Italic font style.| 583 584## FontWeight 585 586**Widget capability**: This API can be used in ArkTS widgets since API version 9. 587 588**Atomic service API**: This API can be used in atomic services since API version 11. 589 590**System capability**: SystemCapability.ArkUI.ArkUI.Full 591 592| Name | Value | Description | 593| ------- | ----- | ----------- | 594| Lighter | 100 | The font weight is lighter.| 595| Normal | 400 | The font weight is normal.| 596| Regular | 400 | The font weight is normal. Same effect as **Normal**.| 597| Medium | 500 | The font weight is medium.| 598| Bold | 700 | The font weight is bold. | 599| Bolder | 900 | The font weight is bolder.| 600 601## TextAlign 602 603**Atomic service API**: This API can be used in atomic services since API version 11. 604 605**System capability**: SystemCapability.ArkUI.ArkUI.Full 606 607| Name | Description | 608| --------------------- | ------------------------------------------------------------ | 609| Start | Aligned with the start.<br>**Widget capability**: This API can be used in ArkTS widgets since API version 9.| 610| Center | Horizontally centered.<br>**Widget capability**: This API can be used in ArkTS widgets since API version 9.| 611| End | Aligned with the end.<br>**Widget capability**: This API can be used in ArkTS widgets since API version 9.| 612| JUSTIFY<sup>10+</sup> | Aligned with both margins.<br>**Widget capability**: This API can be used in ArkTS widgets since API version 10.| 613 614## TextOverflow 615 616**Atomic service API**: This API can be used in atomic services since API version 11. 617 618**System capability**: SystemCapability.ArkUI.ArkUI.Full 619 620| Name | Description | 621| --------------------- | ------------------- | 622| None | Overflowing content is clipped at the limit of the maximum line width. Same effect as **Clip**.<br>**Widget capability**: This API can be used in ArkTS widgets since API version 9.| 623| 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.| 624| Ellipsis | An ellipsis (...) is used to represent text overflow.<br>**Widget capability**: This API can be used in ArkTS widgets since API version 9.| 625| MARQUEE<sup>10+</sup> | Text continuously scrolls when text overflow occurs.| 626 627## TextDecorationType 628 629**Widget capability**: This API can be used in ArkTS widgets since API version 9. 630 631**Atomic service API**: This API can be used in atomic services since API version 11. 632 633**System capability**: SystemCapability.ArkUI.ArkUI.Full 634 635| Name | Description | 636| ----------- | --------- | 637| Underline | Line below the text. | 638| LineThrough | Line through the text.| 639| Overline | Line above the text. | 640| None | No text decorations.| 641 642## TextCase 643 644**Widget capability**: This API can be used in ArkTS widgets since API version 9. 645 646**Atomic service API**: This API can be used in atomic services since API version 11. 647 648**System capability**: SystemCapability.ArkUI.ArkUI.Full 649 650| Name | Description | 651| --------- | ---------- | 652| Normal | The original case of the text is retained.| 653| LowerCase | All letters in the text are in lowercase. | 654| UpperCase | All letters in the text are in uppercase. | 655 656## ResponseType<sup>8+</sup> 657 658**Atomic service API**: This API can be used in atomic services since API version 11. 659 660**System capability**: SystemCapability.ArkUI.ArkUI.Full 661 662| Name | Description | 663| ---------- | ------------- | 664| LongPress | The menu is displayed when the component is long-pressed. | 665| RightClick | The menu is displayed when the component is right-clicked.| 666 667## HoverEffect<sup>8+</sup> 668 669**Atomic service API**: This API can be used in atomic services since API version 11. 670 671**System capability**: SystemCapability.ArkUI.ArkUI.Full 672 673| Name | Description | 674| --------- | -------------- | 675| Auto | Default hover effect.| 676| Scale | Scale effect. | 677| Highlight | Background fade-in and fade-out effect. | 678| None | No effect. | 679 680## Placement<sup>8+</sup> 681 682**Atomic service API**: This API can be used in atomic services since API version 11. 683 684**System capability**: SystemCapability.ArkUI.ArkUI.Full 685 686| Name | Description | 687| ------------------------ | ------------------------------------------------------------ | 688| Left | The popup is on the left of the component, vertically aligned with the component on the left. | 689| Right | The popup is on the right of the component, vertically aligned with the component on the right. | 690| Top | The popup is at the top of the component, horizontally aligned with the component at the top. | 691| Bottom | The popup is at the bottom of the component, horizontally aligned with the component at the bottom. | 692| TopLeft | The popup is at the top of the component and, since API version 9, aligned with the left of the component.| 693| TopRight | The popup is at the top of the component and, since API version 9, aligned with the right of the component.| 694| BottomLeft | The popup is at the bottom of the component and, since API version 9, aligned with the left of the component.| 695| BottomRight | The popup is at the bottom of the component and, since API version 9, aligned with the right of the component.| 696| LeftTop<sup>9+</sup> | The popup is on the left of the component and aligned with the top of the component. | 697| LeftBottom<sup>9+</sup> | The popup is on the left of the component and aligned with the bottom of the component. | 698| RightTop<sup>9+</sup> | The popup is on the right of the component and aligned with the top of the component. | 699| RightBottom<sup>9+</sup> | The popup is on the right of the component and aligned with the bottom of the component. | 700 701## CopyOptions<sup>9+</sup> 702 703**System capability**: SystemCapability.ArkUI.ArkUI.Full 704 705| Name | Value| Description | 706| ----------- | --- | -------- | 707| None | 0 | 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.| 708| InApp | 1 | 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.| 709| LocalDevice | 2 | 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.| 710| CROSS_DEVICE<sup>(deprecated)</sup> | 3 | 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.| 711 712## HitTestMode<sup>9+</sup> 713 714**Atomic service API**: This API can be used in atomic services since API version 11. 715 716**System capability**: SystemCapability.ArkUI.ArkUI.Full 717 718| Name | Description | 719| ----------- | ---------------------------------------- | 720| 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.| 721| 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.| 722| 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.| 723| 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. | 724 725## DialogButtonStyle<sup>10+</sup> 726 727**System capability**: SystemCapability.ArkUI.ArkUI.Full 728 729**Atomic service API**: This API can be used in atomic services since API version 11. 730 731**System capability**: SystemCapability.ArkUI.ArkUI.Full 732 733| Name | Value | Description | 734| --------- | ---- | --------------------------------- | 735| DEFAULT | 0 | Blue text on white background (black background under the dark theme).| 736| HIGHLIGHT | 1 | White text on blue background. | 737 738## TextHeightAdaptivePolicy<sup>10+</sup> 739 740**Atomic service API**: This API can be used in atomic services since API version 11. 741 742**System capability**: SystemCapability.ArkUI.ArkUI.Full 743 744| Name | Description | 745| ----------------------- | ------------------------ | 746| MAX_LINES_FIRST | Prioritize the **maxLines** settings.| 747| MIN_FONT_SIZE_FIRST | Prioritize the **minFontSize** settings. | 748| LAYOUT_CONSTRAINT_FIRST | Prioritize the layout constraint settings in terms of height.| 749 750## NestedScrollMode<sup>10+</sup> 751 752**Atomic service API**: This API can be used in atomic services since API version 11. 753 754**System capability**: SystemCapability.ArkUI.ArkUI.Full 755 756| Name | Description | 757| ------ | ------------------------------ | 758| 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. | 759| 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. | 760| 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.| 761| 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.| 762 763## ObscuredReasons<sup>10+</sup> 764 765**Atomic service API**: This API can be used in atomic services since API version 11. 766 767**System capability**: SystemCapability.ArkUI.ArkUI.Full 768 769| Name | Value| Description | 770| ----------- | -- | ------------------------ | 771| PLACEHOLDER | 0 |The content is replaced by a placeholder.| 772 773## ColoringStrategy<sup>10+</sup> 774 775Enumerates the coloring strategies. 776 777**System capability**: SystemCapability.ArkUI.ArkUI.Full 778 779| Name | Value| Description | 780| ------ | --- | --------------- | 781| INVERT | 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.| 782| AVERAGE<sup>11+</sup> | average | 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.| 783| PRIMARY<sup>11+</sup> | primary | 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.| 784 785## ClickEffectLevel<sup>10+</sup> 786 787**Atomic service API**: This API can be used in atomic services since API version 11. 788 789**System capability**: SystemCapability.ArkUI.ArkUI.Full 790 791| Name | Description | Animation Settings | Default Zoom Ratio | 792| ------ | --------------------------------- | --------------------------------- | --------------------------------- | 793| LIGHT | Small area (light)| Spring effect, with stiffness of 410, damping of 38, and initial velocity of 1.| 90% | 794| MIDDLE | Medium area (stable)| Spring effect, with stiffness of 350, damping of 35, and initial velocity of 0.5.| 95% | 795| HEAVY | Large area (heavy)| Spring effect, with stiffness of 240, damping of 28, and initial velocity of 0.| 95% | 796 797## CheckBoxShape<sup>11+</sup> 798 799**Widget capability**: This API can be used in ArkTS widgets since API version 11. 800 801**Atomic service API**: This API can be used in atomic services since API version 12. 802 803**System capability**: SystemCapability.ArkUI.ArkUI.Full 804 805| Name | Value | Description | 806| -------------- | ---- | -------- | 807| CIRCLE | 0 | Circle. | 808| ROUNDED_SQUARE | 1 | Rounded square.| 809 810## FoldStatus<sup>11+</sup> 811 812**Atomic service API**: This API can be used in atomic services since API version 12. 813 814**System capability**: SystemCapability.ArkUI.ArkUI.Full 815 816| Name |Value| Description | 817| ---------------------- |----| ---------- | 818| FOLD_STATUS_UNKNOWN |0| The folding status of the device is unknown.| 819| FOLD_STATUS_EXPANDED |1| The device is fully open. | 820| FOLD_STATUS_FOLDED |2| The device is folded (completely closed). | 821| FOLD_STATUS_HALF_FOLDED |3| The device is half-folded, somewhere between fully open and completely closed.| 822 823## TextContentStyle<sup>10+</sup> 824 825**Atomic service API**: This API can be used in atomic services since API version 11. 826 827**System capability**: SystemCapability.ArkUI.ArkUI.Full 828 829| Name | Description | 830| ------- | ------------------------------------------------------------ | 831| 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.| 832| 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.| 833 834 835## Nullable\<T><sup>11+</sup> 836 837type Nullable\<T> = T | undefined 838 839The object of this type can be of a custom type or **undefined**. 840 841**Atomic service API**: This API can be used in atomic services since API version 12. 842 843**System capability**: SystemCapability.ArkUI.ArkUI.Full 844 845| Type| Description | 846| ---- | -------------------------- | 847| T \| undefined | The object of this type can be of a custom type or **undefined**.| 848 849## WordBreak<sup>11+</sup> 850 851**System capability**: SystemCapability.ArkUI.ArkUI.Full 852 853| Name | Value| Description | 854| ----- | --- | -------------------------------------- | 855| NORMAL | 0 | 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).<br>**Atomic service API**: This API can be used in atomic services since API version 11.| 856| BREAK_ALL | 1 | Line breaks can occur between any two characters for non-CJK text. CJK text behavior is the same as for **NORMAL**.<br>**Atomic service API**: This API can be used in atomic services since API version 11.| 857| BREAK_WORD | 2 | This option has the same effect as **BREAK_ALL** for non-CJK text, except that it preferentially wraps lines at appropriate characters (for example, spaces) whenever possible. CJK text behavior is the same as for **NORMAL**.<br>**Atomic service API**: This API can be used in atomic services since API version 11.| 858| HYPHENATION<sup>18+</sup> | 3 | Attempts are made to hyphenate words at the end of each line using a hyphen. If a hyphen cannot be added, this option behaves like **BREAK_WORD**.<br>**Atomic service API**: This API can be used in atomic services since API version 18.| 859 860 861## LineBreakStrategy<sup>12+</sup> 862 863**Atomic service API**: This API can be used in atomic services since API version 12. 864 865**System capability**: SystemCapability.ArkUI.ArkUI.Full 866 867| Name | Value| Description | 868| ------------ | --- | ------------------------------------------------------------ | 869| GREEDY | 0 | 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.| 870| HIGH_QUALITY | 1 | Fills in lines as much as possible on the basis of **BALANCED**, which may results in a large blank area on the last line.| 871| BALANCED | 2 | Balances the line length when possible without word splitting. | 872 873## TextSelectableMode<sup>12+</sup> 874 875**Atomic service API**: This API can be used in atomic services since API version 12. 876 877**System capability**: SystemCapability.ArkUI.ArkUI.Full 878 879| Name | Value| Description | 880| ------------ | --- | ------------------------------------------------------------ | 881| SELECTABLE_UNFOCUSABLE | 0 | The text is selectable, but not focusable. Setting the **selection**, **bindSelectionMenu**, or **copyOption** attribute does not affect the behavior.| 882| SELECTABLE_FOCUSABLE | 1 | The text is selectable and focusable. It obtains focus when touched.| 883| UNSELECTABLE | 2 | The text is not selectable nor focusable. The **selection**, **bindSelectionMenu**, and **copyOption** attributes do not work in this case. | 884 885## AccessibilityHoverType<sup>12+</sup> 886 887**Atomic service API**: This API can be used in atomic services since API version 12. 888 889**System capability**: SystemCapability.ArkUI.ArkUI.Full 890 891| Name | Value| Description | 892| ------------ | - | ------------------------------------------------------------ | 893| HOVER_ENTER | 0 | A finger is pressed. | 894| HOVER_MOVE | 1 | The touch moves. | 895| HOVER_EXIT | 2 | The finger is lifted. | 896| HOVER_CANCEL | 3 | The current event is canceled. | 897 898## EllipsisMode<sup>11+</sup> 899 900**Atomic service API**: This API can be used in atomic services since API version 12. 901 902**System capability**: SystemCapability.ArkUI.ArkUI.Full 903 904| Name | Value| Description | 905| ----- | --- | -------------------------------------- | 906| START | 0 | An ellipsis is used at the start of the line of text.| 907| CENTER | 1 | An ellipsis is used at the center of the line of text.| 908| END | 2 | An ellipsis is used at the end of the line of text.| 909 910## ArrowPointPosition<sup>11+</sup> 911 912**Atomic service API**: This API can be used in atomic services since API version 12. 913 914**System capability**: SystemCapability.ArkUI.ArkUI.Full 915 916| Name | Value | Description | 917| ------------- | -------------------------------------- | -------------------------------------- | 918| START | 'Start' | On the leftmost side of the parent component in the horizontal layout; on the top of the parent component in the vertical layout.| 919| CENTER | 'Center' | In the center of the parent component.| 920| END | 'End' | On the rightmost side of the parent component in the horizontal layout; at the bottom of the parent component in the vertical layout.| 921 922## OptionWidthMode<sup>11+</sup> 923 924**Atomic service API**: This API can be used in atomic services since API version 12. 925 926**System capability**: SystemCapability.ArkUI.ArkUI.Full 927 928| Name | Value | Description | 929| ----------- | ------------------------------ | ------------------------------ | 930| FIT_CONTENT | 'fit_content' | Uses the default width, that is, width of two columns. | 931| FIT_TRIGGER | 'fit_trigger' | Inherits the width of the drop-down list button.| 932 933## PixelRoundCalcPolicy<sup>11+</sup> 934 935Enumerates the pixel rounding policies for component boundaries. 936 937**Widget capability**: This API can be used in ArkTS widgets since API version 11. 938 939**Atomic service API**: This API can be used in atomic services since API version 11. 940 941**System capability**: SystemCapability.ArkUI.ArkUI.Full 942 943| Name |Value| Description | 944| ------ | ----|----------------------------- | 945| NO_FORCE_ROUND |0| The value is not rounded off.| 946| FORCE_CEIL |1| The value is rounded up to the nearest integer.| 947| FORCE_FLOOR |2| The value is rounded down to the nearest integer.| 948 949## TextDecorationStyle<sup>12+</sup> 950 951**Atomic service API**: This API can be used in atomic services since API version 12. 952 953**System capability**: SystemCapability.ArkUI.ArkUI.Full 954 955| Name | Value| Description | 956| ----------- | --- | --------- | 957| SOLID | 0 | Single solid line (default value). | 958| DOUBLE | 1 | Double solid line.| 959| DOTTED | 2 | Dotted line. | 960| DASHED | 3 | Dashed line.| 961| WAVY | 4 | Wavy line.| 962 963## EmbeddedType<sup>12+</sup> 964Enumerates the types of the providers that can be started by the **EmbeddedComponent**. 965 966**Atomic service API**: This API can be used in atomic services since API version 12. 967 968**System capability**: SystemCapability.ArkUI.ArkUI.Full 969 970| Name | Value| Description | 971| --------------------- | - | ---------------------------------------------------- | 972| EMBEDDED_UI_EXTENSION | 0 | EmbeddedUIExtensionAbility.| 973 974## MarqueeUpdateStrategy<sup>12+</sup> 975 976**Atomic service API**: This API can be used in atomic services since API version 12. 977 978**System capability**: SystemCapability.ArkUI.ArkUI.Full 979 980| Name | Value | Description | 981| ---------- | ------------------------ | ------------------------ | 982| DEFAULT | 0 | After the marquee attributes are updated, the marquee scrolls from the start position. | 983| PRESERVE_POSITION | 1 | After the marquee attributes are updated, the marquee scrolls from the current position.| 984 985## AppRotation<sup>12+</sup> 986 987**Atomic service API**: This API can be used in atomic services since API version 12. 988 989**System capability**: SystemCapability.ArkUI.ArkUI.Full 990 991| Name |Value| Description | 992| ------ |-----| ----------------------------- | 993| ROTATION_0 |0| 0 degrees.| 994| ROTATION_90 |1|90 degrees.| 995| ROTATION_180 |2| 180 degrees.| 996| ROTATION_270 |3| 270 degrees.| 997 998## ScrollSource<sup>12+</sup> 999 1000Enumerates the sources of scroll operations. 1001 1002**Atomic service API**: This API can be used in atomic services since API version 12. 1003 1004**System capability**: SystemCapability.ArkUI.ArkUI.Full 1005 1006| Name | Value | Description | 1007| ------ | ------ | ---------------------------------------- | 1008| DRAG | 0 | Drag event.| 1009| FLING | 1 | Inertia scrolling after the drag ends.| 1010| EDGE_EFFECT | 2 | Edge scrolling effect with **EdgeEffect.Spring**.| 1011| OTHER_USER_INPUT | 3 | Other user inputs aside from dragging, such as those from the mouse wheel and keyboard events.| 1012| SCROLL_BAR | 4 | Drag event from the scrollbar.| 1013| SCROLL_BAR_FLING | 5 | Inertia scrolling with velocity after the scrollbar is released.| 1014| SCROLLER | 6 | Non-animated methods of the **Scroller** object.| 1015| SCROLLER_ANIMATION | 7 | Animated methods of the **Scroller** object.| 1016 1017## ImageSpanAlignment<sup>10+</sup> 1018 1019**System capability**: SystemCapability.ArkUI.ArkUI.Full 1020 1021| Name | Description | 1022| -------- | ------------------------------ | 1023| TOP | The image is top aligned with the line. | 1024| CENTER | The image is centered aligned with the line. | 1025| BOTTOM | The image is bottom aligned with the line. | 1026| BASELINE | The image is bottom aligned with the text baseline.| 1027 1028 1029## XComponentType<sup>10+</sup> 1030 1031**System capability**: SystemCapability.ArkUI.ArkUI.Full 1032 1033| Name | Description | 1034| -------------------------------- | ------------------------------------------------------------ | 1035| 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.| 1036| 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.| 1037| 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.| 1038| 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](../../../ui/state-management/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.| 1039 1040## HoverModeAreaType<sup>14+</sup> 1041 1042Enumerates the types of display areas for the hover mode. 1043 1044**Atomic service API**: This API can be used in atomic services since API version 14. 1045 1046**System capability**: SystemCapability.ArkUI.ArkUI.Full 1047 1048| Name | Value | Description | 1049| ------ | ----------------------------- | ----------------------------- | 1050| TOP_SCREEN | 0 | Upper half screen.| 1051| BOTTOM_SCREEN | 1 | Lower half screen.| 1052 1053## WidthBreakpoint<sup>13+</sup> 1054 1055Enumerates the width breakpoint values corresponding to different window width thresholds. The value is returned through [getWindowWidthBreakpoint](../js-apis-arkui-UIContext.md#getwindowwidthbreakpoint13). 1056 1057**Atomic service API**: This API can be used in atomic services since API version 13. 1058 1059**System capability**: SystemCapability.ArkUI.ArkUI.Full 1060 1061The following table lists default width breakpoint thresholds for typical devices, serving as a reference for responsive layout design based on window width breakpoints. Device manufacturers may customize these thresholds through product-specific configurations when needed. 1062 1063| Name | Value | Description | 1064| -------- | ---- | ---------------------- | 1065| WIDTH_XS | 0 | The window width is less than 320 vp.| 1066| WIDTH_SM | 1 | The window width is greater than or equal to 320 vp and less than 600 vp.| 1067| WIDTH_MD | 2 | The window width is greater than or equal to 600 vp and less than 840 vp.| 1068| WIDTH_LG | 3 | The window width is greater than or equal to 840 vp and less than 1440 vp.| 1069| WIDTH_XL | 4 | The window width is greater than or equal to 1440 vp.| 1070 1071> **NOTE** 1072> 1073> For most applications, considering window width breakpoints alone is sufficient for building adaptive layouts. 1074 1075## HeightBreakpoint<sup>13+</sup> 1076 1077Enumerates the height breakpoint values corresponding to different window aspect ratio thresholds. The value is returned through [getWindowHeightBreakpoint](../js-apis-arkui-UIContext.md#getwindowheightbreakpoint13). 1078 1079**Atomic service API**: This API can be used in atomic services since API version 13. 1080 1081**System capability**: SystemCapability.ArkUI.ArkUI.Full 1082 1083The following table lists default aspect ratio breakpoint thresholds for typical devices, serving as a reference for responsive layout design based on window aspect ratios. Device manufacturers may customize these thresholds through product-specific configurations when needed. 1084 1085| Name | Value | Description | 1086| -------- | ---- | ---------------------- | 1087| HEIGHT_SM | 0 | The window aspect ratio is less than 0.8.| 1088| HEIGHT_MD | 1 | The window aspect ratio is greater than or equal to 0.8 and less than 1.2.| 1089| HEIGHT_LG | 2 | The window aspect ratio is greater than or equal to 1.2.| 1090 1091## AxisModel<sup>15+</sup> 1092 1093Enumerates the axis types for focus axis events. 1094 1095**Atomic service API**: This API can be used in atomic services since API version 15. 1096 1097**System capability**: SystemCapability.ArkUI.ArkUI.Full 1098 1099| Name | Value | Description | 1100| ------- | ---- | ---------------------------------- | 1101| ABS_X | 0 | Game controller x-axis.| 1102| ABS_Y | 1 | Game controller y-axis.| 1103| ABS_Z | 2 | Game controller z-axis.| 1104| ABS_RZ | 3 | Game controller rz-axis.| 1105| ABS_GAS | 4 | Game controller GAS-axis.| 1106| ABS_BRAKE | 5 | Game controller BRAKE-axis.| 1107| ABS_HAT0X | 6 | Game controller HAT0X-axis.| 1108| ABS_HAT0Y | 7 | Game controller HAT0Y-axis.| 1109 1110## PageFlipMode<sup>15+</sup> 1111 1112Enumerates the modes for flipping pages using the mouse wheel. 1113 1114**Widget capability**: This API can be used in ArkTS widgets since API version 15. 1115 1116**Atomic service API**: This API can be used in atomic services since API version 15. 1117 1118**System capability**: SystemCapability.ArkUI.ArkUI.Full 1119 1120| Name | Value | Description | 1121| -------- | ---- | ---------------------- | 1122| CONTINUOUS | 0 | Continuous page flipping mode where multiple pages are turned continuously when the user scrolls the mouse wheel without interruption.| 1123| SINGLE | 1 | Single-page flipping mode where the mouse wheel event is ignored until the current page flipping animation is complete.| 1124 1125## RenderFit<sup>10+</sup> 1126 1127Enumerates the modes in which the final state of the component's content is rendered during its width and height animation process. 1128 1129**Widget capability**: This API can be used in ArkTS widgets since API version 18. 1130 1131**Atomic service API**: This API can be used in atomic services since API version 11. 1132 1133**System capability**: SystemCapability.ArkUI.ArkUI.Full 1134 1135| Name | Value | Description | 1136| --------------------------- | -- | ---------------------------------------------------------------------------------- | 1137| CENTER | 0 | The component's content stays at the final size and always aligned with the center of the component.  | 1138| TOP | 1 | The component's content stays at the final size and always aligned with the top center of the component.  | 1139| BOTTOM | 2 | The component's content stays at the final size and always aligned with the bottom center of the component.  | 1140| LEFT | 3 | The component's content stays at the final size and always aligned with the left of the component.  | 1141| RIGHT | 4 | The component's content stays at the final size and always aligned with the right of the component.  | 1142| TOP_LEFT | 5 | The component's content stays at the final size and always aligned with the upper left corner of the component.  | 1143| TOP_RIGHT | 6 | The component's content stays at the final size and always aligned with the upper right corner of the component.  | 1144| BOTTOM_LEFT | 7 | The component's content stays at the final size and always aligned with the lower left corner of the component.  | 1145| BOTTOM_RIGHT | 8 | The component's content stays at the final size and always aligned with the lower right corner of the component.  | 1146| RESIZE_FILL | 9 | The component's content is always resized to fill the component's content box, without considering its aspect ratio in the final state.  | 1147| RESIZE_CONTAIN | 10 | 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.  | 1148| RESIZE_CONTAIN_TOP_LEFT | 11 | 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.  | 1149| RESIZE_CONTAIN_BOTTOM_RIGHT | 12 | 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.  | 1150| RESIZE_COVER | 13 | 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.  | 1151| RESIZE_COVER_TOP_LEFT | 14 | 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.  | 1152| RESIZE_COVER_BOTTOM_RIGHT | 15 | 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.  | 1153 1154 1155> **NOTE** 1156> 1157> - In the illustrative diagrams, the blue area indicates the content, and the orange area indicates the component content box. 1158> - Different render fit modes create different effects during the width and height animation process. Choose the one that best fits your need. 1159 1160## CrownAction<sup>18+</sup> 1161 1162Enumerates the crown actions. 1163 1164**Atomic service API**: This API can be used in atomic services since API version 18. 1165 1166**System capability**: SystemCapability.ArkUI.ArkUI.Full 1167 1168|Name | Value| Description | 1169|-------------------| -- | ------------------------------------- | 1170| BEGIN | 0 | The crown starts to rotate. | 1171| UPDATE | 1 | The crown is rotating. | 1172| END | 2 | The crown stops rotating. | 1173 1174## CrownSensitivity<sup>18+</sup> 1175 1176Enumerates the sensitivity levels for crown rotation. 1177 1178**Atomic service API**: This API can be used in atomic services since API version 18. 1179 1180**System capability**: SystemCapability.ArkUI.ArkUI.Full 1181 1182| Name | Value | Description | 1183| -------------- | -- | ---------------------------------------- | 1184| LOW | 0 | Low sensitivity. | 1185| MEDIUM | 1 | Medium sensitivity. | 1186| HIGH | 2 | High sensitivity. | 1187 1188## AxisAction<sup>17+</sup> 1189 1190Enumerates the types of axis actions for axis events. 1191 1192**Atomic service API**: This API can be used in atomic services since API version 17. 1193 1194**System capability**: SystemCapability.ArkUI.ArkUI.Full 1195 1196| Name | Value | Description | 1197| ------- | ---- | ---------------------------------- | 1198| NONE | 0 | No axis event.| 1199| BEGIN | 1 | The axis event begins.| 1200| UPDATE | 2 | The axis event is in progress.| 1201| END | 3 | The axis event ends.| 1202| CANCEL | 4 | The axis event is canceled.| 1203 1204## InteractionHand<sup>15+</sup> 1205 1206Defines whether an event is triggered by a left-hand or right-hand tap. 1207 1208**Atomic service API**: This API can be used in atomic services since API version 15. 1209 1210**System capability**: SystemCapability.ArkUI.ArkUI.Full 1211 1212| Name | Value | Description | 1213| -------- | ---- | ---------------------- | 1214| NONE | 0 | Unknown.| 1215| LEFT | 1 | Left hand.| 1216| RIGHT | 2 | Right hand.| 1217 1218## FocusDrawLevel<sup>19+</sup> 1219 1220Enumerates the drawing levels of the focus box for a node. 1221 1222**Widget capability**: This API can be used in ArkTS widgets since API version 19. 1223 1224**Atomic service API**: This API can be used in atomic services since API version 19. 1225 1226**System capability**: SystemCapability.ArkUI.ArkUI.Full 1227 1228| Name | Value | Description | 1229| -------------- | -- | ---------------------------------------- | 1230| SELF | 0 | The focus box is drawn on the node's own layer. | 1231| TOP | 1 | The focus box is drawn on the topmost layer of the current instance's z-order. | 1232 1233## PixelRoundMode<sup>18+</sup> 1234 1235Enumerates pixel rounding modes. 1236 1237**Widget capability**: This API can be used in ArkTS widgets since API version 18. 1238 1239**Atomic service API**: This API can be used in atomic services since API version 18. 1240 1241**System capability**: SystemCapability.ArkUI.ArkUI.Full 1242 1243| Name | Value | Description | 1244| ------ |---- | -------------------- | 1245| PIXEL_ROUND_ON_LAYOUT_FINISH | 0 | Performs pixel rounding after the component finishes measuring its size and position. Default value.| 1246| PIXEL_ROUND_AFTER_MEASURE | 1 | Performs pixel rounding after the component finishes measuring its size.| 1247 1248> **NOTE** 1249> In **PIXEL_ROUND_AFTER_MEASURE** mode, the component performs rounding when size measurement ends, meaning the final size may be 1 px larger than in **PIXEL_ROUND_ON_LAYOUT_FINISH** mode. 1250 1251## EventQueryType<sup>19+</sup> 1252 1253Enumerates interaction event types that can be queried. 1254 1255**Atomic service API**: This API can be used in atomic services since API version 19. 1256 1257**System capability**: SystemCapability.ArkUI.ArkUI.Full 1258 1259| Name| Value| Description| 1260| -------- | -------- | -------- | 1261| ON_CLICK | 0 | Click event.| 1262 1263## DividerMode<sup>19+</sup> 1264 1265Enumerates divider modes. 1266 1267**Atomic service API**: This API can be used in atomic services since API version 19. 1268 1269**System capability**: SystemCapability.ArkUI.ArkUI.Full 1270 1271| Name | Value| Description | 1272| ------------------ | - | ---------------------------------------- | 1273| FLOATING_ABOVE_MENU| 0 | The divider floats above the menu without affecting the layout height. This is the default mode. | 1274| EMBEDDED_IN_MENU | 1 | The divider is embedded in the menu and affects the layout height. | 1275
