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| Color | Value | Illustration | 14| ------------------------ | ------------- | ---------------------------------------- | 15| Black | 0x000000 |  | 16| Blue | 0x0000ff |  | 17| Brown | 0xa52a2a |  | 18| Gray | 0x808080 |  | 19| Grey | 0x808080 |  | 20| Green | 0x008000 |  | 21| Orange | 0xffa500 |  | 22| Pink | 0xffc0cb |  | 23| Red | 0xff0000 |  | 24| White | 0xffffff |  | 25| Yellow | 0xffff00 |  | 26| Transparent<sup>9+</sup> | rgba(0,0,0,0) | Transparent | 27 28## ImageFit 29 30**Widget capability**: This API can be used in ArkTS widgets since API version 9. 31 32**Atomic service API**: This API can be used in atomic services since API version 11. 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. | 37| Cover | The image is scaled with its aspect ratio retained for both sides to be greater than or equal to the display boundaries.| 38| Auto | The image is scaled automatically based on its own size and the size of the component to fit the display area.| 39| Fill | The image is scaled to fill the display area, and its aspect ratio is not retained. | 40| ScaleDown | The image is displayed with its aspect ratio retained, in a size smaller than or equal to the original size. | 41| None | The original size is retained. | 42| TOP_START<sup>12+</sup> | The image is displayed at the top start corner of the **Image** component, keeping its original size.| 43| TOP<sup>12+</sup> | The image is displayed horizontally centered at the top of the **Image** component, keeping its original size.| 44| TOP_END<sup>12+</sup> | The image is displayed at the top end corner of the **Image** component, keeping its original size.| 45| START<sup>12+</sup> | The image is displayed vertically centered at the start of the **Image** component, keeping its original size.| 46| CENTER<sup>12+</sup> | The image is displayed at the center of the **Image** component both horizontally and vertically, keeping its original size.| 47| END<sup>12+</sup> | The image is displayed vertically centered at the end of the **Image** component, keeping its original size.| 48| BOTTOM_START<sup>12+</sup> | The image is displayed at the bottom start corner of the **Image** component, keeping its original size.| 49| BOTTOM<sup>12+</sup> | The image is displayed horizontally centered at the bottom of the **Image** component, keeping its original size.| 50| BOTTOM_END<sup>12+</sup>| The image is displayed at the bottom end corner of the **Image** component, keeping its original size.| 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| Name | Description | 60| ------ | ----------------------------- | 61| Dotted | Dotted border. The radius of a dot is half of **borderWidth**.| 62| Dashed | Dashed border. | 63| Solid | Solid border. | 64 65## LineJoinStyle 66 67**Widget capability**: This API can be used in ArkTS widgets since API version 9. 68 69**Atomic service API**: This API can be used in atomic services since API version 11. 70 71| Name | Description | 72| ----- | ---------- | 73| Bevel | Bevel is used to connect paths.| 74| Miter | Miter is used to connect paths.| 75| Round | Round is used to connect paths.| 76 77## TouchType 78 79**Atomic service API**: This API can be used in atomic services since API version 11. 80 81| Name | Description | 82| ------ | --------------- | 83| Down | A finger is pressed. | 84| Up | A finger is lifted. | 85| Move | A finger moves on the screen in pressed state.| 86| Cancel | A touch event is canceled. | 87 88## MouseButton 89 90**Atomic service API**: This API can be used in atomic services since API version 11. 91 92| Name | Description | 93| ------- | -------- | 94| Left | Left button on the mouse. | 95| Right | Right button on the mouse. | 96| Middle | Middle button on the mouse. | 97| Back | Back button on the left of the mouse.| 98| Forward | Forward button on the left of the mouse.| 99| None | No button. | 100 101## MouseAction 102 103**Atomic service API**: This API can be used in atomic services since API version 11. 104 105| Name | Description | 106| ------- | ------- | 107| Press | The mouse button is pressed.| 108| Release | The mouse button is released.| 109| Move | The mouse cursor moves. | 110| Hover | The mouse pointer is hovered on an element.<br>**NOTE**<br>This value has no effect.<br> | 111 112## Curve 113 114**Widget capability**: This API can be used in ArkTS widgets since API version 9. 115 116**Atomic service API**: This API can be used in atomic services since API version 11. 117 118| Name | Description | 119| ------------------- | ---------------------------------------- | 120| Linear | The animation speed keeps unchanged. | 121| 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.| 122| 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.| 123| EaseOut | The animation ends at a low speed. The cubic-bezier curve (0.0, 0.0, 0.58, 1.0) is used.| 124| EaseInOut | The animation starts and ends at a low speed. The cubic-bezier curve (0.42, 0.0, 0.58, 1.0) is used.| 125| FastOutSlowIn | The animation uses the standard cubic-bezier curve (0.4, 0.0, 0.2, 1.0). | 126| LinearOutSlowIn | The animation uses the deceleration cubic-bezier curve (0.0, 0.0, 0.2, 1.0). | 127| FastOutLinearIn | The animation uses the acceleration cubic-bezier curve (0.4, 0.0, 1.0, 1.0). | 128| ExtremeDeceleration | The animation uses the extreme deceleration cubic-bezier curve (0.0, 0.0, 0.0, 1.0). | 129| Sharp | The animation uses the sharp cubic-bezier curve (0.33, 0.0, 0.67, 1.0).| 130| Rhythm | The animation uses the rhythm cubic-bezier curve (0.7, 0.0, 0.2, 1.0). | 131| Smooth | The animation uses the smooth cubic-bezier curve (0.4, 0.0, 0.4, 1.0). | 132| Friction | The animation uses the friction cubic-bezier curve (0.2, 0.0, 0.2, 1.0). | 133 134## AnimationStatus 135 136**Widget capability**: This API can be used in ArkTS widgets since API version 10. 137 138**Atomic service API**: This API can be used in atomic services since API version 11. 139 140| Name | Description | 141| ------- | --------- | 142| Initial | The animation is in the initial state. | 143| Running | The animation is being played.| 144| Paused | The animation is paused.| 145| Stopped | The animation is stopped.| 146 147## FillMode 148 149**Widget capability**: This API can be used in ArkTS widgets since API version 10. 150 151**Atomic service API**: This API can be used in atomic services since API version 11. 152 153| Name | Description | 154| --------- | ---------------------------------------- | 155| 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. | 156| Forwards | The target component retains the state set by the last keyframe encountered during execution of the animation. | 157| 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.| 158| Both | The animation follows the rules for both **Forwards** and **Backwards**, extending the animation attributes in both directions.| 159 160## PlayMode 161 162**Widget capability**: This API can be used in ArkTS widgets since API version 9. 163 164**Atomic service API**: This API can be used in atomic services since API version 11. 165 166| Name | Description | 167| ---------------- | ---------------------------------------- | 168| Normal | The animation is played forwards. | 169| Reverse | The animation is played backwards. | 170| 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...).| 171| 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...).| 172 173## KeyType 174 175**Atomic service API**: This API can be used in atomic services since API version 11. 176 177| Name | Description | 178| ---- | ----- | 179| Down | The key is pressed.| 180| Up | The key is released.| 181 182## KeySource 183 184**Atomic service API**: This API can be used in atomic services since API version 11. 185 186| Name | Description | 187| -------- | ---------- | 188| Unknown | Unknown input device. | 189| Keyboard | The input device is a keyboard.| 190 191## Edge 192 193**Atomic service API**: This API can be used in atomic services since API version 11. 194 195| Name | Description | 196| -------------------------------- | ---------------------------------------- | 197| Top | Top edge in the vertical direction.<br>**Widget capability**: This API can be used in ArkTS widgets since API version 9.| 198| Center<sup>(deprecated) </sup> | Center position in the vertical direction.<br> This API is deprecated since API version 9. | 199| Bottom | Bottom edge in the vertical direction.<br>**Widget capability**: This API can be used in ArkTS widgets since API version 9.| 200| Baseline<sup>(deprecated) </sup> | Text baseline position in the cross axis direction.<br> This API is deprecated since API version 9. | 201| Start | Start position in the horizontal direction.<br>**Widget capability**: This API can be used in ArkTS widgets since API version 9.| 202| Middle<sup>(deprecated) </sup> | Center position in the horizontal direction.<br> This API is deprecated since API version 9. | 203| End | End position in the horizontal direction.<br>**Widget capability**: This API can be used in ArkTS widgets since API version 9.| 204 205## Week 206 207**Atomic service API**: This API can be used in atomic services since API version 11. 208 209| Name | Description | 210| ---- | ---- | 211| Mon | Monday. | 212| Tue | Tuesday. | 213| Wed | Wednesday. | 214| Thur | Thursday. | 215| Fri | Friday. | 216| Sat | Saturday. | 217| Sun | Sunday. | 218 219## Direction 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| Name | Description | 226| ---- | ----------- | 227| Ltr | Components are arranged from left to right. | 228| Rtl | Components are arranged from right to left. | 229| Auto | The default layout direction is used.| 230 231## BarState 232 233**Widget capability**: This API can be used in ArkTS widgets since API version 9. 234 235**Atomic service API**: This API can be used in atomic services since API version 11. 236 237| Name | Description | 238| ---- | ------------------ | 239| Off | Not displayed. | 240| On | Always displayed. | 241| Auto | Displayed when the screen is touched and hidden after 2s.| 242 243## EdgeEffect 244 245**Widget capability**: This API can be used in ArkTS widgets since API version 9. 246 247**Atomic service API**: This API can be used in atomic services since API version 11. 248 249| Name | Description | 250| ------ | ---------------------------------------- | 251| 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.| 252| Fade | Fade effect. When at one of the edges, the component produces a fade effect. | 253| None | No effect when the component is at one of the edges. | 254 255## Alignment 256 257**Widget capability**: This API can be used in ArkTS widgets since API version 9. 258 259**Atomic service API**: This API can be used in atomic services since API version 11. 260 261| Name | Description | 262| ----------- | -------- | 263| TopStart | Top start. | 264| Top | Horizontally centered on the top. | 265| TopEnd | Top end. | 266| Start | Vertically centered start.| 267| Center | Horizontally and vertically centered.| 268| End | Vertically centered end. | 269| BottomStart | Bottom start. | 270| Bottom | Horizontally centered on the bottom. | 271| BottomEnd | Bottom end. | 272 273## TransitionType 274 275**Widget capability**: This API can be used in ArkTS widgets since API version 9. 276 277**Atomic service API**: This API can be used in atomic services since API version 11. 278 279| Name | Description | 280| ------ | ------------------------------ | 281| All | The transition takes effect in all scenarios.| 282| Insert | The transition takes effect when a component is inserted or displayed.| 283| Delete | The transition takes effect when a component is deleted or hidden.| 284 285## RelateType 286 287**Atomic service API**: This API can be used in atomic services since API version 11. 288 289| Name | Description | 290| ---- | -------------- | 291| FILL | The current child component is scaled to fill the parent component.| 292| FIT | The current child component is scaled to adapt to the parent component.| 293 294## Visibility 295 296**Widget capability**: This API can be used in ArkTS widgets since API version 9. 297 298**Atomic service API**: This API can be used in atomic services since API version 11. 299 300| Name | Description | 301| ------- | ---------------- | 302| Hidden | The component is hidden, and a placeholder is used for it in the layout. | 303| Visible | The component is visible. | 304| None | The component is hidden. It is not involved in the layout, and no placeholder is used for it.| 305 306## LineCapStyle 307 308**Widget capability**: This API can be used in ArkTS widgets since API version 9. 309 310**Atomic service API**: This API can be used in atomic services since API version 11. 311 312| Name | Description | 313| ------ | ----------------------------- | 314| Butt | The ends of the line are squared off, and the line does not extend beyond its two endpoints. | 315| Round | The line is extended at the endpoints by a half circle whose diameter is equal to the line width. | 316| 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.| 317 318## Axis 319 320**Widget capability**: This API can be used in ArkTS widgets since API version 9. 321 322**Atomic service API**: This API can be used in atomic services since API version 11. 323 324| Name | Description | 325| ---------- | ------ | 326| Vertical | Vertical direction.| 327| Horizontal | Horizontal direction.| 328 329## HorizontalAlign 330 331**Widget capability**: This API can be used in ArkTS widgets since API version 9. 332 333**Atomic service API**: This API can be used in atomic services since API version 11. 334 335| Name | Description | 336| ------ | ------------ | 337| Start | Aligned with the start edge in the same direction as the language in use.| 338| Center | Aligned with the center. This is the default alignment mode.| 339| End | Aligned with the end edge in the same direction as the language in use. | 340 341## FlexAlign 342 343**Widget capability**: This API can be used in ArkTS widgets since API version 9. 344 345**Atomic service API**: This API can be used in atomic services since API version 11. 346 347| Name | Description | 348| ------------ | ---------------------------------------- | 349| 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. | 350| 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. | 351| 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. | 352| 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.| 353| 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.| 354| 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.| 355 356## ItemAlign 357 358**Widget capability**: This API can be used in ArkTS widgets since API version 9. 359 360**Atomic service API**: This API can be used in atomic services since API version 11. 361 362| Name | Description | 363| -------- | ---------------------------------------- | 364| Auto | The default configuration of the flex container is used. | 365| Start | The items in the flex container are aligned with the cross-start edge. | 366| Center | The items in the flex container are centered along the cross axis. | 367| End | The items in the flex container are aligned with the cross-end edge. | 368| 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.| 369| Baseline | The items in the flex container are aligned in such a manner that their text baselines are aligned along the cross axis. | 370 371## FlexDirection 372 373**Widget capability**: This API can be used in ArkTS widgets since API version 9. 374 375**Atomic service API**: This API can be used in atomic services since API version 11. 376 377| Name | Description | 378| ------------- | ---------------- | 379| Row | The child components are arranged in the same direction as the main axis runs along the rows. | 380| RowReverse | The child components are arranged opposite to the **Row** direction. | 381| Column | The child components are arranged in the same direction as the main axis runs down the columns. | 382| ColumnReverse | The child components are arranged opposite to the **Column** direction.| 383 384## FlexWrap 385 386**Widget capability**: This API can be used in ArkTS widgets since API version 9. 387 388**Atomic service API**: This API can be used in atomic services since API version 11. 389 390| Name | Description | 391| ----------- | --------------------------- | 392| 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. | 393| Wrap | The child components in the flex container are arranged in multiple lines, and they may overflow. | 394| WrapReverse | The child components in the flex container are reversely arranged in multiple lines, and they may overflow.| 395 396## VerticalAlign 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| Name | Description | 403| ------ | ------------ | 404| Top | Top aligned. | 405| Center | Center aligned. This is the default alignment mode.| 406| Bottom | Bottom aligned. | 407 408## ImageRepeat 409 410**Widget capability**: This API can be used in ArkTS widgets since API version 9. 411 412**Atomic service API**: This API can be used in atomic services since API version 11. 413 414| Name | Description | 415| -------- | ------------- | 416| X | The image is repeatedly drawn only along the horizontal axis.| 417| Y | The image is repeatedly drawn only along the vertical axis.| 418| XY | The image is repeatedly drawn along both axes. | 419| NoRepeat | The image is not repeatedly drawn. | 420 421## ImageSize 422 423**Widget capability**: This API can be used in ArkTS widgets since API version 9. 424 425| Type | Description | 426| ------- | ----------------------------------- | 427| Cover | Default value. The image is scaled with its aspect ratio retained for both sides to be greater than or equal to the display boundaries.<br>**Atomic service API**: This API can be used in atomic services since API version 11.| 428| Contain | The image is scaled with its aspect ratio retained for the content to be completely displayed within the display boundaries.<br> **Atomic service API**: This API can be used in atomic services since API version 11. | 429| Auto | The original image aspect ratio is retained.<br> **Atomic service API**: This API can be used in atomic services since API version 11. | 430| 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.| 431 432## GradientDirection 433 434**Widget capability**: This API can be used in ArkTS widgets since API version 9. 435 436**Atomic service API**: This API can be used in atomic services since API version 11. 437 438| Name | Description | 439| ----------- | ----- | 440| Left | The gradient direction is from right to left.| 441| Top | The gradient direction is from bottom to top.| 442| Right | The gradient direction is from left to right.| 443| Bottom | The gradient direction is from top to bottom.| 444| LeftTop | The gradient direction is upper left. | 445| LeftBottom | The gradient direction is lower left. | 446| RightTop | The gradient direction is upper right. | 447| RightBottom | The gradient direction is lower right. | 448| None | No gradient. | 449 450## SharedTransitionEffectType 451 452**Atomic service API**: This API can be used in atomic services since API version 11. 453 454| Name | Description | 455| -------- | ---------------------------------------- | 456| 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.| 457| Exchange | The element is relocated and scaled properly on the target page. | 458 459## FontStyle 460 461**Widget capability**: This API can be used in ArkTS widgets since API version 9. 462 463**Atomic service API**: This API can be used in atomic services since API version 11. 464 465| Name | Description | 466| ------ | -------- | 467| Normal | Standard font style.| 468| Italic | Italic font style.| 469 470## FontWeight 471 472**Widget capability**: This API can be used in ArkTS widgets since API version 9. 473 474**Atomic service API**: This API can be used in atomic services since API version 11. 475 476| Name | Description | 477| ------- | ------- | 478| Lighter | The font weight is lighter. | 479| Normal | The font weight is normal.| 480| Regular | The font weight is regular.| 481| Medium | The font weight is medium.| 482| Bold | The font weight is bold. | 483| Bolder | The font weight is bolder. | 484 485## TextAlign 486 487**Widget capability**: This API can be used in ArkTS widgets since API version 9. 488 489**Atomic service API**: This API can be used in atomic services since API version 11. 490 491| Name | Description | 492| --------------------- | ------- | 493| Start | Aligned with the start.| 494| Center | Horizontally centered.| 495| End | Aligned with the end.| 496| JUSTIFY<sup>10+</sup> | Aligned with both margins. | 497 498## TextOverflow 499 500**Widget capability**: This API can be used in ArkTS widgets since API version 9. 501 502**Atomic service API**: This API can be used in atomic services since API version 11. 503 504| Name | Description | 505| --------------------- | ------------------- | 506| None | Overflowing content is clipped at the limit of the maximum line width. | 507| Clip | Overflowing content is clipped at the limit of the maximum line width. | 508| Ellipsis | An ellipsis (...) is used to represent text overflow.| 509| MARQUEE<sup>10+</sup> | Text continuously scrolls when text overflow occurs. | 510 511## TextDecorationType 512 513**Widget capability**: This API can be used in ArkTS widgets since API version 9. 514 515**Atomic service API**: This API can be used in atomic services since API version 11. 516 517| Name | Description | 518| ----------- | --------- | 519| Underline | Line under the text. | 520| LineThrough | Line through the text.| 521| Overline | Line over the text. | 522| None | No text decoration.| 523 524## TextCase 525 526**Widget capability**: This API can be used in ArkTS widgets since API version 9. 527 528**Atomic service API**: This API can be used in atomic services since API version 11. 529 530| Name | Description | 531| --------- | ---------- | 532| Normal | The original case of the text is retained.| 533| LowerCase | All letters in the text are in lowercase. | 534| UpperCase | All letters in the text are in uppercase. | 535 536## ResponseType<sup>8+</sup> 537 538**Atomic service API**: This API can be used in atomic services since API version 11. 539 540| Name | Description | 541| ---------- | ------------- | 542| LongPress | The menu is displayed when the component is long-pressed. | 543| RightClick | The menu is displayed when the component is right-clicked.| 544 545## RichEditorResponseType<sup>11+</sup> 546 547**Atomic service API**: This API can be used in atomic services since API version 12. 548 549| Name | Description | 550| ---------- | ------------- | 551| LONG_PRESS | The menu is displayed when the component is long-pressed. | 552| RIGHT_CLICK | The menu is displayed when the component is right-clicked.| 553| SELECT | The menu is displayed when the component is selected.| 554 555## HoverEffect<sup>8+</sup> 556 557**Atomic service API**: This API can be used in atomic services since API version 11. 558 559| Name | Description | 560| --------- | -------------- | 561| Auto | Default hover effect.| 562| Scale | Scale effect. | 563| Highlight | Background fade-in and fade-out effect. | 564| None | No effect. | 565 566## Placement<sup>8+</sup> 567 568**Atomic service API**: This API can be used in atomic services since API version 11. 569 570| Name | Description | 571| ------------- | -------------------------------------- | 572| Left | The popup is on the left of the component, vertically aligned with the component on the left. | 573| Right | The popup is on the right of the component, vertically aligned with the component on the right. | 574| Top | The popup is at the top of the component, horizontally aligned with the component at the top. | 575| Bottom | The popup is at the bottom of the component, horizontally aligned with the component at the bottom. | 576| TopLeft | The popup is at the top of the component and, since API version 9, aligned with the left of the component.| 577| TopRight | The popup is at the top of the component and, since API version 9, aligned with the right of the component.| 578| BottomLeft | The popup is at the bottom of the component and, since API version 9, aligned with the left of the component.| 579| BottomRight | The popup is at the bottom of the component and, since API version 9, aligned with the right of the component.| 580| LeftTop9+ | The popup is on the left of the component and aligned with the top of the component. | 581| LeftBottom9+ | The popup is on the left of the component and aligned with the bottom of the component. | 582| RightTop9+ | The popup is on the right of the component and aligned with the top of the component. | 583| RightBottom9+ | The popup is on the right of the component and aligned with the bottom of the component. | 584 585## CopyOptions<sup>9+</sup> 586 587**Widget capability**: This API can be used in ArkTS widgets since API version 9. 588 589| Name | Description | 590| ----------- | -------- | 591| None | Copy is not allowed.<br>**Atomic service API**: This API can be used in atomic services since API version 11. | 592| InApp | Intra-application copy is allowed.<br>**Atomic service API**: This API can be used in atomic services since API version 11.| 593| LocalDevice | Intra-device copy is allowed.<br>**Atomic service API**: This API can be used in atomic services since API version 11.| 594| CROSS_DEVICE<sup>(deprecated)</sup> | Cross-device copy is allowed.<br>**NOTE**<br>This API is supported since API version 11 and deprecated since API version 12.| 595 596## HitTestMode<sup>9+</sup> 597 598**Atomic service API**: This API can be used in atomic services since API version 11. 599 600| Name | Description | 601| ----------- | ---------------------------------------- | 602| 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.| 603| 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.| 604| 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.| 605| 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. | 606 607## DialogButtonStyle<sup>10+</sup> 608 609**System capability**: SystemCapability.ArkUI.ArkUI.Full 610 611**Atomic service API**: This API can be used in atomic services since API version 11. 612 613| Name | Description | 614| --------- | --------------------------------- | 615| DEFAULT | Blue text on white background (black background under the dark theme).| 616| HIGHLIGHT | White text on blue background. | 617 618## ThemeColorMode<sup>10+</sup> 619 620**Atomic service API**: This API can be used in atomic services since API version 11. 621 622**System capability**: SystemCapability.ArkUI.ArkUI.Full 623 624| Name | Description | 625| ------ | ---------- | 626| SYSTEM | Following the system color mode.| 627| LIGHT | Light color mode. | 628| DARK | Dark color mode. | 629 630## TextHeightAdaptivePolicy<sup>10+</sup> 631 632**Atomic service API**: This API can be used in atomic services since API version 11. 633 634| Name | Description | 635| ----------------------- | ------------------------ | 636| MAX_LINES_FIRST | Prioritize the **maxLines** settings.| 637| MIN_FONT_SIZE_FIRST | Prioritize the **minFontSize** settings. | 638| LAYOUT_CONSTRAINT_FIRST | Prioritize the layout constraint settings in terms of height.| 639 640## NestedScrollMode<sup>10+</sup> 641 642**Atomic service API**: This API can be used in atomic services since API version 11. 643 644**System capability**: SystemCapability.ArkUI.ArkUI.Full 645 646| Name | Description | 647| ------ | ------------------------------ | 648| 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. | 649| 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. | 650| 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.| 651| 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.| 652 653## ObscuredReasons<sup>10+</sup> 654 655This API is supported in ArkTS widgets. 656 657**Atomic service API**: This API can be used in atomic services since API version 11. 658 659| Name | Description | 660| ----------- | ------------------------ | 661| PLACEHOLDER | The content is replaced by a placeholder.| 662 663## ClickEffectLevel<sup>10+</sup> 664 665**Atomic service API**: This API can be used in atomic services since API version 11. 666 667**System capability**: SystemCapability.ArkUI.ArkUI.Full 668 669| Name | Description | Animation Settings | Default Zoom Ratio | 670| ------ | --------------------------------- | --------------------------------- | --------------------------------- | 671| LIGHT | Small area (light)| Spring effect, with stiffness of 410, damping of 38, and initial velocity of 1.| 90% | 672| MIDDLE | Medium area (stable)| Spring effect, with stiffness of 350, damping of 35, and initial velocity of 0.5.| 95% | 673| HEAVY | Large area (heavy)| Spring effect, with stiffness of 240, damping of 28, and initial velocity of 0.| 95% | 674 675## FoldStatus<sup>11+</sup> 676 677**Atomic service API**: This API can be used in atomic services since API version 12. 678 679| Name | Description | 680| ---------------------- | ---------- | 681| FOLD_STATUS_UNKNOWN | The folding status of the device is unknown.| 682| FOLD_STATUS_EXPANDED | The device is fully open. | 683| FOLD_STATUS_FOLDED | The device is folded (completely closed). | 684| FOLD_STATUS_HALF_FOLDED | The device is half-folded, somewhere between fully open and completely closed.| 685 686## TextContentStyle<sup>10+</sup> 687 688**Atomic service API**: This API can be used in atomic services since API version 11. 689 690| Name | Description | 691| ------- | ------------------------------------------------------------ | 692| 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.| 693| 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.| 694 695 696## Nullable <sup>11+</sup> 697 698Nullable\<T> { 699 700(data: T); 701 702} 703 704The object of this type can be of a custom type or **undefined**. 705 706**Atomic service API**: This API can be used in atomic services since API version 12. 707 708**System capability**: SystemCapability.ArkUI.ArkUI.Full 709 710| Name| Type| Mandatory| Description | 711| ---- | ---- | ---- | -------------------------- | 712| data | T | Yes | The object of this type can be of a custom type or **undefined**.| 713 714## WordBreak<sup>11+</sup> 715 716**Atomic service API**: This API can be used in atomic services since API version 11. 717 718| Name | Description | 719| ----- | -------------------------------------- | 720| 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).| 721| BREAK_ALL | Word breaks can occur between any two characters for non-CJK text. CJK text behavior is the same as for **NORMAL**.| 722| 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**.| 723 724## LineBreakStrategy<sup>12+</sup> 725 726**Atomic service API**: This API can be used in atomic services since API version 12. 727 728| Name | Description | 729| ------------ | ------------------------------------------------------------ | 730| 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.| 731| 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.| 732| BALANCED | Balances the line length when possible without word splitting. | 733 734## TextSelectableMode<sup>12+</sup> 735| Name | Description | 736| ------------ | ------------------------------------------------------------ | 737| SELECTABLE_UNFOCUSABLE | The text is selectable, but not focusable. Setting the **selection**, **bindSelectionMenu**, or **copyOption** attribute does not affect the behavior.| 738| SELECTABLE_FOCUSABLE | The text is selectable and focusable. It obtains focus when touched.| 739| UNSELECTABLE | The text is not selectable nor focusable. The **selection**, **bindSelectionMenu**, and **copyOption** attributes do not work in this case. | 740 741## EllipsisMode<sup>11+</sup> 742 743**Widget capability**: This API can be used in ArkTS widgets since API version 11. 744 745**Atomic service API**: This API can be used in atomic services since API version 12. 746 747| Name | Description | 748| ----- | -------------------------------------- | 749| START | An ellipsis is used at the start of the line of text.| 750| CENTER | An ellipsis is used at the center of the line of text.| 751| END | An ellipsis is used at the end of the line of text.| 752 753## ArrowPointPosition<sup>11+</sup> 754 755**Atomic service API**: This API can be used in atomic services since API version 12. 756 757| Name | Description | 758| ------------- | -------------------------------------- | 759| START | On the leftmost side of the parent component in the horizontal layout; on the top of the parent component in the vertical layout.| 760| CENTER | In the center of the parent component.| 761| END | On the rightmost side of the parent component in the horizontal layout; at the bottom of the parent component in the vertical layout.| 762 763## OptionWidthMode<sup>11+</sup> 764 765**System capability**: SystemCapability.ArkUI.ArkUI.Full 766 767**Atomic service API**: This API can be used in atomic services since API version 12. 768 769| Name | Description | 770| ----------- | ------------------------------ | 771| FIT_CONTENT | Uses the default width, that is, width of two columns. | 772| FIT_TRIGGER | Inherits the width of the drop-down list button.| 773 774## SelectionMenuOptions<sup>11+</sup> 775 776Provides the span range information. 777 778**Atomic service API**: This API can be used in atomic services since API version 11. 779 780| Name| Type | Read Only| Mandatory | Description | 781| ------ | ------ | ------ | ------ | -------------------------------------- | 782| onAppear | [MenuOnAppearCallback](ts-basic-components-richeditor.md#menuonappearcallback12) | No| No| Callback invoked when the custom context menu on selection is displayed.| 783| onDisappear | () => void | No| No| Callback invoked when the custom context menu on selection is closed.| 784 785## DismissReason<sup>12+</sup> 786 787**Atomic service API**: This API can be used in atomic services since API version 12. 788 789**System capability**: SystemCapability.ArkUI.ArkUI.Full 790 791| Name | Value | Description | 792| ------------- | ---- | ------------------------------------------------------------ | 793| PRESS_BACK | 0 | Touching the Back button, swiping left or right on the screen, or pressing the Esc key. | 794| TOUCH_OUTSIDE | 1 | Touching the mask. | 795| CLOSE_BUTTON | 2 | Touching the Close button. | 796| SLIDE_DOWN | 3 | Sliding down.<br>**NOTE**<br>This API is effective only in [sheet transition]ts-universal-attributes-sheet-transition.md).| 797 798## ChainStyle<sup>12+</sup> 799 800**Atomic service API**: This API can be used in atomic services since API version 12. 801 802Defines the chain style. 803 804| Name | Description | 805| ------ | ----------------------------- | 806| SPREAD | Child components are evenly distributed among constraint anchors. For details, see [Example 7 in RelativeContainer](ts-container-relativecontainer.md#example-7).| 807| SPREAD_INSIDE | All child components except the first and last ones are evenly distributed among constraint anchors. For details, see [Example 7 in RelativeContainer](ts-container-relativecontainer.md#example-7). | 808| PACKED | There is no gap between child components in the chain. For details, see [Example 7 in RelativeContainer](ts-container-relativecontainer.md#example-7). | 809 810## BarrierDirection<sup>12+</sup> 811 812Defines the barrier direction. 813 814**Atomic service API**: This API can be used in atomic services since API version 12. 815 816| Name | Description | 817| ------ | ----------------------------- | 818| LEFT | The barrier is on the left side of all the referenced components specified by [referencedId](ts-container-relativecontainer.md#barrierstyle12). | 819| RIGHT | The barrier is on the right side of all the referenced components specified by [referencedId](ts-container-relativecontainer.md#barrierstyle12). | 820| TOP | The barrier is at the top of all the referenced components specified by [referencedId](ts-container-relativecontainer.md#barrierstyle12). | 821| BOTTOM | The barrier is at the top of all the referenced components specified by [referencedId](ts-container-relativecontainer.md#barrierstyle12).| 822 823## PixelRoundCalcPolicy<sup>11+</sup> 824 825Defines the pixel-level rounding policy for component boundaries. 826 827**Atomic service API**: This API can be used in atomic services since API version 11. 828 829| Name | Description | 830| ------ | ----------------------------- | 831| NO_FORCE_ROUND | The value is not rounded off.| 832| FORCE_CEIL | The value is rounded up to the nearest integer.| 833| FORCE_FLOOR | The value is rounded down to the nearest integer.| 834 835## TextDecorationStyle<sup>12+</sup> 836 837**Atomic service API**: This API can be used in atomic services since API version 12. 838 839| Name | Description | 840| ----------- | --------- | 841| SOLID | Single solid line (default value). | 842| DOUBLE | Double solid line.| 843| DOTTED | Dotted line. | 844| DASHED | Dashed line.| 845| WAVY | Wavy line.| 846 847## FlexSpaceOptions<sup>12+</sup> 848 849| Name | Type | Read Only | Mandatory | Description | 850| ----------- | --------- | ----------- | --------- |----------- | 851| main | [LengthMetrics](../js-apis-arkui-graphics.md#lengthmetrics12) | No| No| Space on the main axis of the flex container.<br> space: {main: LengthMetrics.unit(value)} | 852| cross | [LengthMetrics](../js-apis-arkui-graphics.md#lengthmetrics12) | No| No| Space on the cross axis of the flex container.<br> space: {cross: LengthMetrics.unit(value)} | 853 854## MenuPolicy<sup>12+</sup> 855 856Defines the menu display policy. 857 858**Atomic service API**: This API can be used in atomic services since API version 12. 859 860**System capability**: SystemCapability.ArkUI.ArkUI.Full 861 862| Name | Value | Description | 863| ------- | ---- | ---------------------------------- | 864| DEFAULT | 0 | Whether the menu is displayed depends on the underlying default logic.| 865| HIDE | 1 | The menu is always hidden. | 866| SHOW | 2 | The menu is always displayed. | 867 868## EmbeddedType<sup>12+</sup> 869Enumerates the types of the providers that can be started by the **\<EmbeddedComponent>**. 870 871**Atomic service API**: This API can be used in atomic services since API version 12. 872 873| Name | Value| Description | 874| --------------------- | - | ---------------------------------------------------- | 875| EMBEDDED_UI_EXTENSION | 0 | EmbeddedUIExtensionAbility.| 876 877## MarqueeUpdateStrategy<sup>12+</sup> 878 879**Atomic service API**: This API can be used in atomic services since API version 12. 880 881**System capability**: SystemCapability.ArkUI.ArkUI.Full 882 883| Name | Value | Description | 884| ---------- | ------------------------ | ------------------------ | 885| DEFAULT | 0 | After the marquee attributes are updated, the marquee scrolls from the start position. | 886| PRESERVE_POSITION | 1 | After the marquee attributes are updated, the marquee scrolls from the current position.| 887 888## AppRotation<sup>12+</sup> 889 890**Atomic service API**: This API can be used in atomic services since API version 12. 891 892| Name | Description | 893| ------ | ----------------------------- | 894| ROTATION_0 | 0 degrees.| 895| ROTATION_90 |90 degrees.| 896| ROTATION_180 | 180 degrees.| 897| ROTATION_270 | 270 degrees.| 898 899## BlurStyleActivePolicy<sup>13+</sup> 900 901**Atomic service API**: This API can be used in atomic services since API version 13. 902 903**System capability**: SystemCapability.ArkUI.ArkUI.Full 904 905| Name | Description | 906| ------ | ----------------------------- | 907| ALWAYS_ACTIVE | The blur effect is always active.| 908| FOLLOWS_WINDOW_ACTIVE_STATE | The blur effect changes according to the window's focus state; it is inactive when the window is not in focus and active when the window is in focus.| 909| ALWAYS_INACTIVE | The blur effect is always inactive.| 910 911## BlurType<sup>13+</sup> 912 913**Atomic service API**: This API can be used in atomic services since API version 13. 914 915**System capability**: SystemCapability.ArkUI.ArkUI.Full 916 917| Name | Description | 918| ------ | ----------------------------- | 919| WITHIN_WINDOW | The blur effect is applied within the window.| 920| BEHIND_WINDOW | The blur effect is applied behind the window.| 921 922## ScrollSource<sup>12+</sup> 923 924Enumerates the sources of scroll operations. 925 926**Atomic service API**: This API can be used in atomic services since API version 12. 927 928**System capability**: SystemCapability.ArkUI.ArkUI.Full 929 930| Name | Value | Description | 931| ------ | ------ | ---------------------------------------- | 932| DRAG | 0 | Drag event.| 933| FLING | 1 | Inertia scrolling after the drag ends.| 934| EDGE_EFFECT | 2 | Edge scrolling effect with **EdgeEffect.Spring**.| 935| OTHER_USER_INPUT | 3 | Other user inputs aside from dragging, such as those from the mouse wheel and keyboard events.| 936| SCROLL_BAR | 4 | Drag event from the scrollbar.| 937| SCROLL_BAR_FLING | 5 | Inertia scrolling with velocity after the scrollbar is released.| 938| SCROLLER | 6 | Non-animated methods of the **Scroller** object.| 939| SCROLLER_ANIMATION | 7 | Animated methods of the **Scroller** object.| 940 941## ImageSpanAlignment<sup>10+</sup> 942 943**Atomic service API**: This API can be used in atomic services since API version 11. 944 945**System capability**: SystemCapability.ArkUI.ArkUI.Full 946 947| Name | Description | 948| -------- | ------------------------------ | 949| TOP | The image is top aligned with the line. | 950| CENTER | The image is centered aligned with the line. | 951| BOTTOM | The image is bottom aligned with the line. | 952| BASELINE | The image is bottom aligned with the text baseline.| 953
