xref: /docs/en/application-dev/reference/apis-arkui/arkui-ts/ts-appendix-enums.md

# Enums

>**NOTE**
>
>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.

## Color

**Widget capability**: This API can be used in ArkTS widgets since API version 9.

**Atomic service API**: This API can be used in atomic services since API version 11.

| Color                    | Value          | Illustration                                    |
| ------------------------ | ------------- | ---------------------------------------- |
| Black                    | 0x000000      | ![en-us_image_0000001219864153](figures/en-us_image_0000001219864153.png) |
| Blue                     | 0x0000ff      | ![en-us_image_0000001174104404](figures/en-us_image_0000001174104404.png) |
| Brown                    | 0xa52a2a      | ![en-us_image_0000001219744201](figures/en-us_image_0000001219744201.png) |
| Gray                     | 0x808080      | ![en-us_image_0000001174264376](figures/en-us_image_0000001174264376.png) |
| Grey                     | 0x808080      | ![en-us_image_0000001174264376](figures/en-us_image_0000001174264376.png) |
| Green                    | 0x008000      | ![en-us_image_0000001174422914](figures/en-us_image_0000001174422914.png) |
| Orange                   | 0xffa500      | ![en-us_image_0000001219662661](figures/en-us_image_0000001219662661.png) |
| Pink                     | 0xffc0cb      | ![en-us_image_0000001219662663](figures/en-us_image_0000001219662663.png) |
| Red                      | 0xff0000      | ![en-us_image_0000001219662665](figures/en-us_image_0000001219662665.png) |
| White                    | 0xffffff      | ![en-us_image_0000001174582866](figures/en-us_image_0000001174582866.png) |
| Yellow                   | 0xffff00      | ![en-us_image_0000001174582864](figures/en-us_image_0000001174582864.png) |
| Transparent<sup>9+</sup> | rgba(0,0,0,0) | Transparent                                     |

## ImageFit

**Widget capability**: This API can be used in ArkTS widgets since API version 9.

**Atomic service API**: This API can be used in atomic services since API version 11.

| Name       | Description                             |
| --------- | ------------------------------- |
| Contain   | The image is scaled with its aspect ratio retained for the content to be completely displayed within the display boundaries.  |
| Cover     | The image is scaled with its aspect ratio retained for both sides to be greater than or equal to the display boundaries.|
| Auto      | The image is scaled automatically based on its own size and the size of the component to fit the display area.|
| Fill      | The image is scaled to fill the display area, and its aspect ratio is not retained.       |
| ScaleDown | The image is displayed with its aspect ratio retained, in a size smaller than or equal to the original size.            |
| None      | The original size is retained.                      |
| TOP_START<sup>12+</sup> | The image is displayed at the top start corner of the **Image** component, keeping its original size.|
| TOP<sup>12+</sup>       | The image is displayed horizontally centered at the top of the **Image** component, keeping its original size.|
| TOP_END<sup>12+</sup>   | The image is displayed at the top end corner of the **Image** component, keeping its original size.|
| START<sup>12+</sup>     | The image is displayed vertically centered at the start of the **Image** component, keeping its original size.|
| CENTER<sup>12+</sup>    | The image is displayed at the center of the **Image** component both horizontally and vertically, keeping its original size.|
| END<sup>12+</sup>       | The image is displayed vertically centered at the end of the **Image** component, keeping its original size.|
| BOTTOM_START<sup>12+</sup> | The image is displayed at the bottom start corner of the **Image** component, keeping its original size.|
| BOTTOM<sup>12+</sup>    | The image is displayed horizontally centered at the bottom of the **Image** component, keeping its original size.|
| BOTTOM_END<sup>12+</sup>| The image is displayed at the bottom end corner of the **Image** component, keeping its original size.|


## BorderStyle

**Widget capability**: This API can be used in ArkTS widgets since API version 9.

**Atomic service API**: This API can be used in atomic services since API version 11.

| Name    | Description                           |
| ------ | ----------------------------- |
| Dotted | Dotted border. The radius of a dot is half of **borderWidth**.|
| Dashed | Dashed border.                |
| Solid  | Solid border.                     |

## LineJoinStyle

**Widget capability**: This API can be used in ArkTS widgets since API version 9.

**Atomic service API**: This API can be used in atomic services since API version 11.

| Name   | Description        |
| ----- | ---------- |
| Bevel | Bevel is used to connect paths.|
| Miter | Miter is used to connect paths.|
| Round | Round is used to connect paths.|

## TouchType

**Atomic service API**: This API can be used in atomic services since API version 11.

| Name    | Description             |
| ------ | --------------- |
| Down   | A finger is pressed.       |
| Up     | A finger is lifted.       |
| Move   | A finger moves on the screen in pressed state.|
| Cancel | A touch event is canceled.     |

## MouseButton

**Atomic service API**: This API can be used in atomic services since API version 11.

| Name     | Description      |
| ------- | -------- |
| Left    | Left button on the mouse.   |
| Right   | Right button on the mouse.   |
| Middle  | Middle button on the mouse.   |
| Back    | Back button on the left of the mouse.|
| Forward | Forward button on the left of the mouse.|
| None    | No button.    |

## MouseAction

**Atomic service API**: This API can be used in atomic services since API version 11.

| Name     | Description     |
| ------- | ------- |
| Press   | The mouse button is pressed.|
| Release | The mouse button is released.|
| Move    | The mouse cursor moves.  |
| Hover   | The mouse pointer is hovered on an element.<br>**NOTE**<br>This value has no effect.<br>  |

## Curve

**Widget capability**: This API can be used in ArkTS widgets since API version 9.

**Atomic service API**: This API can be used in atomic services since API version 11.

| Name                 | Description                                      |
| ------------------- | ---------------------------------------- |
| Linear              | The animation speed keeps unchanged.                       |
| 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.|
| 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.|
| EaseOut             | The animation ends at a low speed. The cubic-bezier curve (0.0, 0.0, 0.58, 1.0) is used.|
| EaseInOut           | The animation starts and ends at a low speed. The cubic-bezier curve (0.42, 0.0, 0.58, 1.0) is used.|
| FastOutSlowIn       | The animation uses the standard cubic-bezier curve (0.4, 0.0, 0.2, 1.0).  |
| LinearOutSlowIn     | The animation uses the deceleration cubic-bezier curve (0.0, 0.0, 0.2, 1.0).  |
| FastOutLinearIn     | The animation uses the acceleration cubic-bezier curve (0.4, 0.0, 1.0, 1.0).  |
| ExtremeDeceleration | The animation uses the extreme deceleration cubic-bezier curve (0.0, 0.0, 0.0, 1.0).  |
| Sharp               | The animation uses the sharp cubic-bezier curve (0.33, 0.0, 0.67, 1.0).|
| Rhythm              | The animation uses the rhythm cubic-bezier curve (0.7, 0.0, 0.2, 1.0).  |
| Smooth              | The animation uses the smooth cubic-bezier curve (0.4, 0.0, 0.4, 1.0).  |
| Friction            | The animation uses the friction cubic-bezier curve (0.2, 0.0, 0.2, 1.0).   |

## AnimationStatus

**Widget capability**: This API can be used in ArkTS widgets since API version 10.

**Atomic service API**: This API can be used in atomic services since API version 11.

| Name     | Description       |
| ------- | --------- |
| Initial | The animation is in the initial state.  |
| Running | The animation is being played.|
| Paused  | The animation is paused.|
| Stopped | The animation is stopped.|

## FillMode

**Widget capability**: This API can be used in ArkTS widgets since API version 10.

**Atomic service API**: This API can be used in atomic services since API version 11.

| Name       | Description                                      |
| --------- | ---------------------------------------- |
| 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.    |
| Forwards  | The target component retains the state set by the last keyframe encountered during execution of the animation.                  |
| 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.|
| Both      | The animation follows the rules for both **Forwards** and **Backwards**, extending the animation attributes in both directions.|

## PlayMode

**Widget capability**: This API can be used in ArkTS widgets since API version 9.

**Atomic service API**: This API can be used in atomic services since API version 11.

| Name              | Description                                      |
| ---------------- | ---------------------------------------- |
| Normal           | The animation is played forwards.                                |
| Reverse          | The animation is played backwards.                                 |
| 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...).|
| 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...).|

## KeyType

**Atomic service API**: This API can be used in atomic services since API version 11.

| Name  | Description   |
| ---- | ----- |
| Down | The key is pressed.|
| Up   | The key is released.|

## KeySource

**Atomic service API**: This API can be used in atomic services since API version 11.

| Name      | Description        |
| -------- | ---------- |
| Unknown  | Unknown input device. |
| Keyboard | The input device is a keyboard.|

## Edge

**Atomic service API**: This API can be used in atomic services since API version 11.

| Name                              | Description                                      |
| -------------------------------- | ---------------------------------------- |
| Top                              | Top edge in the vertical direction.<br>**Widget capability**: This API can be used in ArkTS widgets since API version 9.|
| Center<sup>(deprecated) </sup>   | Center position in the vertical direction.<br> This API is deprecated since API version 9.        |
| Bottom                           | Bottom edge in the vertical direction.<br>**Widget capability**: This API can be used in ArkTS widgets since API version 9.|
| Baseline<sup>(deprecated) </sup> | Text baseline position in the cross axis direction.<br> This API is deprecated since API version 9.   |
| Start                            | Start position in the horizontal direction.<br>**Widget capability**: This API can be used in ArkTS widgets since API version 9.|
| Middle<sup>(deprecated) </sup>   | Center position in the horizontal direction.<br> This API is deprecated since API version 9.     |
| End                              | End position in the horizontal direction.<br>**Widget capability**: This API can be used in ArkTS widgets since API version 9.|

## Week

**Atomic service API**: This API can be used in atomic services since API version 11.

| Name  | Description  |
| ---- | ---- |
| Mon  | Monday. |
| Tue  | Tuesday. |
| Wed  | Wednesday. |
| Thur | Thursday. |
| Fri  | Friday. |
| Sat  | Saturday. |
| Sun  | Sunday. |

## Direction

**Widget capability**: This API can be used in ArkTS widgets since API version 9.

**Atomic service API**: This API can be used in atomic services since API version 11.

| Name  | Description         |
| ---- | ----------- |
| Ltr  | Components are arranged from left to right.  |
| Rtl  | Components are arranged from right to left.  |
| Auto | The default layout direction is used.|

## BarState

**Widget capability**: This API can be used in ArkTS widgets since API version 9.

**Atomic service API**: This API can be used in atomic services since API version 11.

| Name  | Description                |
| ---- | ------------------ |
| Off  | Not displayed.              |
| On   | Always displayed.             |
| Auto | Displayed when the screen is touched and hidden after 2s.|

## EdgeEffect

**Widget capability**: This API can be used in ArkTS widgets since API version 9.

**Atomic service API**: This API can be used in atomic services since API version 11.

| Name    | Description                                      |
| ------ | ---------------------------------------- |
| 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.|
| Fade   | Fade effect. When at one of the edges, the component produces a fade effect.                    |
| None   | No effect when the component is at one of the edges.                              |

## Alignment

**Widget capability**: This API can be used in ArkTS widgets since API version 9.

**Atomic service API**: This API can be used in atomic services since API version 11.

| Name         | Description      |
| ----------- | -------- |
| TopStart    | Top start.  |
| Top         | Horizontally centered on the top. |
| TopEnd      | Top end.   |
| Start       | Vertically centered start.|
| Center      | Horizontally and vertically centered.|
| End         | Vertically centered end. |
| BottomStart | Bottom start.  |
| Bottom      | Horizontally centered on the bottom. |
| BottomEnd   | Bottom end.   |

## TransitionType

**Widget capability**: This API can be used in ArkTS widgets since API version 9.

**Atomic service API**: This API can be used in atomic services since API version 11.

| Name    | Description                            |
| ------ | ------------------------------ |
| All    | The transition takes effect in all scenarios.|
| Insert | The transition takes effect when a component is inserted or displayed.|
| Delete | The transition takes effect when a component is deleted or hidden.|

## RelateType

**Atomic service API**: This API can be used in atomic services since API version 11.

| Name  | Description            |
| ---- | -------------- |
| FILL | The current child component is scaled to fill the parent component.|
| FIT  | The current child component is scaled to adapt to the parent component.|

## Visibility

**Widget capability**: This API can be used in ArkTS widgets since API version 9.

**Atomic service API**: This API can be used in atomic services since API version 11.

| Name     | Description              |
| ------- | ---------------- |
| Hidden  | The component is hidden, and a placeholder is used for it in the layout.   |
| Visible | The component is visible.             |
| None    | The component is hidden. It is not involved in the layout, and no placeholder is used for it.|

## LineCapStyle

**Widget capability**: This API can be used in ArkTS widgets since API version 9.

**Atomic service API**: This API can be used in atomic services since API version 11.

| Name    | Description                           |
| ------ | ----------------------------- |
| Butt   | The ends of the line are squared off, and the line does not extend beyond its two endpoints.              |
| Round  | The line is extended at the endpoints by a half circle whose diameter is equal to the line width.           |
| 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.|

## Axis

**Widget capability**: This API can be used in ArkTS widgets since API version 9.

**Atomic service API**: This API can be used in atomic services since API version 11.

| Name        | Description    |
| ---------- | ------ |
| Vertical   | Vertical direction.|
| Horizontal | Horizontal direction.|

## HorizontalAlign

**Widget capability**: This API can be used in ArkTS widgets since API version 9.

**Atomic service API**: This API can be used in atomic services since API version 11.

| Name    | Description          |
| ------ | ------------ |
| Start  | Aligned with the start edge in the same direction as the language in use.|
| Center | Aligned with the center. This is the default alignment mode.|
| End    | Aligned with the end edge in the same direction as the language in use. |

## FlexAlign

**Widget capability**: This API can be used in ArkTS widgets since API version 9.

**Atomic service API**: This API can be used in atomic services since API version 11.

| Name          | Description                                      |
| ------------ | ---------------------------------------- |
| 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.   |
| 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.  |
| 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.     |
| 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.|
| 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.|
| 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.|

## ItemAlign

**Widget capability**: This API can be used in ArkTS widgets since API version 9.

**Atomic service API**: This API can be used in atomic services since API version 11.

| Name      | Description                                      |
| -------- | ---------------------------------------- |
| Auto     | The default configuration of the flex container is used.                          |
| Start    | The items in the flex container are aligned with the cross-start edge.                   |
| Center   | The items in the flex container are centered along the cross axis.                   |
| End      | The items in the flex container are aligned with the cross-end edge.                   |
| 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.|
| Baseline | The items in the flex container are aligned in such a manner that their text baselines are aligned along the cross axis.                 |

## FlexDirection

**Widget capability**: This API can be used in ArkTS widgets since API version 9.

**Atomic service API**: This API can be used in atomic services since API version 11.

| Name           | Description              |
| ------------- | ---------------- |
| Row           | The child components are arranged in the same direction as the main axis runs along the rows. |
| RowReverse    | The child components are arranged opposite to the **Row** direction. |
| Column        | The child components are arranged in the same direction as the main axis runs down the columns. |
| ColumnReverse | The child components are arranged opposite to the **Column** direction.|

## FlexWrap

**Widget capability**: This API can be used in ArkTS widgets since API version 9.

**Atomic service API**: This API can be used in atomic services since API version 11.

| Name         | Description                         |
| ----------- | --------------------------- |
| 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. |
| Wrap        | The child components in the flex container are arranged in multiple lines, and they may overflow.  |
| WrapReverse | The child components in the flex container are reversely arranged in multiple lines, and they may overflow.|

## VerticalAlign

**Widget capability**: This API can be used in ArkTS widgets since API version 9.

**Atomic service API**: This API can be used in atomic services since API version 11.

| Name    | Description          |
| ------ | ------------ |
| Top    | Top aligned.       |
| Center | Center aligned. This is the default alignment mode.|
| Bottom | Bottom aligned.       |

## ImageRepeat

**Widget capability**: This API can be used in ArkTS widgets since API version 9.

**Atomic service API**: This API can be used in atomic services since API version 11.

| Name      | Description           |
| -------- | ------------- |
| X        | The image is repeatedly drawn only along the horizontal axis.|
| Y        | The image is repeatedly drawn only along the vertical axis.|
| XY       | The image is repeatedly drawn along both axes. |
| NoRepeat | The image is not repeatedly drawn.     |

## ImageSize

**Widget capability**: This API can be used in ArkTS widgets since API version 9.

| Type     | Description                                 |
| ------- | ----------------------------------- |
| 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.|
| 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.     |
| Auto    | The original image aspect ratio is retained.<br> **Atomic service API**: This API can be used in atomic services since API version 11.                        |
| 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.|

## GradientDirection

**Widget capability**: This API can be used in ArkTS widgets since API version 9.

**Atomic service API**: This API can be used in atomic services since API version 11.

| Name         | Description   |
| ----------- | ----- |
| Left        | The gradient direction is from right to left.|
| Top         | The gradient direction is from bottom to top.|
| Right       | The gradient direction is from left to right.|
| Bottom      | The gradient direction is from top to bottom.|
| LeftTop     | The gradient direction is upper left.  |
| LeftBottom  | The gradient direction is lower left.  |
| RightTop    | The gradient direction is upper right.  |
| RightBottom | The gradient direction is lower right.  |
| None        | No gradient.   |

## SharedTransitionEffectType

**Atomic service API**: This API can be used in atomic services since API version 11.

| Name      | Description                                      |
| -------- | ---------------------------------------- |
| 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.|
| Exchange | The element is relocated and scaled properly on the target page.                 |

## FontStyle

**Widget capability**: This API can be used in ArkTS widgets since API version 9.

**Atomic service API**: This API can be used in atomic services since API version 11.

| Name    | Description      |
| ------ | -------- |
| Normal | Standard font style.|
| Italic | Italic font style.|

## FontWeight

**Widget capability**: This API can be used in ArkTS widgets since API version 9.

**Atomic service API**: This API can be used in atomic services since API version 11.

| Name     | Description     |
| ------- | ------- |
| Lighter | The font weight is lighter.  |
| Normal  | The font weight is normal.|
| Regular | The font weight is regular.|
| Medium  | The font weight is medium.|
| Bold    | The font weight is bold.  |
| Bolder  | The font weight is bolder. |

## TextAlign

**Widget capability**: This API can be used in ArkTS widgets since API version 9.

**Atomic service API**: This API can be used in atomic services since API version 11.

| Name                   | Description     |
| --------------------- | ------- |
| Start                 | Aligned with the start.|
| Center                | Horizontally centered.|
| End                   | Aligned with the end.|
| JUSTIFY<sup>10+</sup> | Aligned with both margins.  |

## TextOverflow

**Widget capability**: This API can be used in ArkTS widgets since API version 9.

**Atomic service API**: This API can be used in atomic services since API version 11.

| Name                   | Description                 |
| --------------------- | ------------------- |
| None                  | Overflowing content is clipped at the limit of the maximum line width.         |
| Clip                  | Overflowing content is clipped at the limit of the maximum line width.       |
| Ellipsis              | An ellipsis (...) is used to represent text overflow.|
| MARQUEE<sup>10+</sup> | Text continuously scrolls when text overflow occurs.    |

## TextDecorationType

**Widget capability**: This API can be used in ArkTS widgets since API version 9.

**Atomic service API**: This API can be used in atomic services since API version 11.

| Name         | Description       |
| ----------- | --------- |
| Underline   | Line under the text. |
| LineThrough | Line through the text.|
| Overline    | Line over the text. |
| None        | No text decoration.|

## TextCase

**Widget capability**: This API can be used in ArkTS widgets since API version 9.

**Atomic service API**: This API can be used in atomic services since API version 11.

| Name       | Description        |
| --------- | ---------- |
| Normal    | The original case of the text is retained.|
| LowerCase | All letters in the text are in lowercase.  |
| UpperCase | All letters in the text are in uppercase.  |

## ResponseType<sup>8+</sup>

**Atomic service API**: This API can be used in atomic services since API version 11.

| Name        | Description           |
| ---------- | ------------- |
| LongPress  | The menu is displayed when the component is long-pressed.  |
| RightClick | The menu is displayed when the component is right-clicked.|

## RichEditorResponseType<sup>11+</sup>

**Atomic service API**: This API can be used in atomic services since API version 12.

| Name        | Description           |
| ---------- | ------------- |
| LONG_PRESS  | The menu is displayed when the component is long-pressed.  |
| RIGHT_CLICK | The menu is displayed when the component is right-clicked.|
| SELECT | The menu is displayed when the component is selected.|

## HoverEffect<sup>8+</sup>

**Atomic service API**: This API can be used in atomic services since API version 11.

| Name       | Description            |
| --------- | -------------- |
| Auto      | Default hover effect.|
| Scale     | Scale effect.       |
| Highlight | Background fade-in and fade-out effect.  |
| None      | No effect.        |

## Placement<sup>8+</sup>

**Atomic service API**: This API can be used in atomic services since API version 11.

| Name           | Description                                    |
| ------------- | -------------------------------------- |
| Left          | The popup is on the left of the component, vertically aligned with the component on the left.                 |
| Right         | The popup is on the right of the component, vertically aligned with the component on the right.                 |
| Top           | The popup is at the top of the component, horizontally aligned with the component at the top.                 |
| Bottom        | The popup is at the bottom of the component, horizontally aligned with the component at the bottom.                 |
| TopLeft       | The popup is at the top of the component and, since API version 9, aligned with the left of the component.|
| TopRight      | The popup is at the top of the component and, since API version 9, aligned with the right of the component.|
| BottomLeft    | The popup is at the bottom of the component and, since API version 9, aligned with the left of the component.|
| BottomRight   | The popup is at the bottom of the component and, since API version 9, aligned with the right of the component.|
| LeftTop9+     | The popup is on the left of the component and aligned with the top of the component.                 |
| LeftBottom9+  | The popup is on the left of the component and aligned with the bottom of the component.                 |
| RightTop9+    | The popup is on the right of the component and aligned with the top of the component.                 |
| RightBottom9+ | The popup is on the right of the component and aligned with the bottom of the component.                 |

## CopyOptions<sup>9+</sup>

**Widget capability**: This API can be used in ArkTS widgets since API version 9.

| Name         | Description      |
| ----------- | -------- |
| None        | Copy is not allowed.<br>**Atomic service API**: This API can be used in atomic services since API version 11.  |
| InApp       | Intra-application copy is allowed.<br>**Atomic service API**: This API can be used in atomic services since API version 11.|
| LocalDevice | Intra-device copy is allowed.<br>**Atomic service API**: This API can be used in atomic services since API version 11.|
| 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.|

## HitTestMode<sup>9+</sup>

**Atomic service API**: This API can be used in atomic services since API version 11.

| Name         | Description                                      |
| ----------- | ---------------------------------------- |
| 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.|
| 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.|
| 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.|
| 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.     |

## DialogButtonStyle<sup>10+</sup>

**System capability**: SystemCapability.ArkUI.ArkUI.Full

**Atomic service API**: This API can be used in atomic services since API version 11.

| Name     | Description                             |
| --------- | --------------------------------- |
| DEFAULT   | Blue text on white background (black background under the dark theme).|
| HIGHLIGHT | White text on blue background.                       |

## ThemeColorMode<sup>10+</sup>

**Atomic service API**: This API can be used in atomic services since API version 11.

**System capability**: SystemCapability.ArkUI.ArkUI.Full

| Name    | Description        |
| ------ | ---------- |
| SYSTEM | Following the system color mode.|
| LIGHT  | Light color mode. |
| DARK   | Dark color mode. |

## TextHeightAdaptivePolicy<sup>10+</sup>

**Atomic service API**: This API can be used in atomic services since API version 11.

| Name                     | Description                      |
| ----------------------- | ------------------------ |
| MAX_LINES_FIRST         | Prioritize the **maxLines** settings.|
| MIN_FONT_SIZE_FIRST     | Prioritize the **minFontSize** settings.    |
| LAYOUT_CONSTRAINT_FIRST | Prioritize the layout constraint settings in terms of height.|

## NestedScrollMode<sup>10+</sup>

**Atomic service API**: This API can be used in atomic services since API version 11.

**System capability**: SystemCapability.ArkUI.ArkUI.Full

| Name    | Description                            |
| ------ | ------------------------------ |
| 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. |
| 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.       |
| 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.|
| 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.|

## ObscuredReasons<sup>10+</sup>

This API is supported in ArkTS widgets.

**Atomic service API**: This API can be used in atomic services since API version 11.

| Name       | Description                    |
| ----------- | ------------------------ |
| PLACEHOLDER | The content is replaced by a placeholder.|

## ClickEffectLevel<sup>10+</sup>

**Atomic service API**: This API can be used in atomic services since API version 11.

**System capability**: SystemCapability.ArkUI.ArkUI.Full

| Name  | Description              | Animation Settings                         | Default Zoom Ratio                    |
| ------ | --------------------------------- | --------------------------------- | --------------------------------- |
| LIGHT  | Small area (light)| Spring effect, with stiffness of 410, damping of 38, and initial velocity of 1.| 90% |
| MIDDLE | Medium area (stable)| Spring effect, with stiffness of 350, damping of 35, and initial velocity of 0.5.| 95% |
| HEAVY  | Large area (heavy)| Spring effect, with stiffness of 240, damping of 28, and initial velocity of 0.| 95% |

## FoldStatus<sup>11+</sup>

**Atomic service API**: This API can be used in atomic services since API version 12.

| Name                     | Description        |
| ----------------------  | ---------- |
| FOLD_STATUS_UNKNOWN     | The folding status of the device is unknown.|
| FOLD_STATUS_EXPANDED    | The device is fully open.  |
| FOLD_STATUS_FOLDED      | The device is folded (completely closed).  |
| FOLD_STATUS_HALF_FOLDED | The device is half-folded, somewhere between fully open and completely closed.|

## TextContentStyle<sup>10+</sup>

**Atomic service API**: This API can be used in atomic services since API version 11.

| Name   | Description                                                        |
| ------- | ------------------------------------------------------------ |
| 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.|
| 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.|


## Nullable <sup>11+</sup>

Nullable\<T> {

(data: T);

}

The object of this type can be of a custom type or **undefined**.

**Atomic service API**: This API can be used in atomic services since API version 12.

**System capability**: SystemCapability.ArkUI.ArkUI.Full

| Name| Type| Mandatory| Description                      |
| ---- | ---- | ---- | -------------------------- |
| data | T    | Yes  | The object of this type can be of a custom type or **undefined**.|

## WordBreak<sup>11+</sup>

**Atomic service API**: This API can be used in atomic services since API version 11.

| Name | Description                                  |
| ----- | -------------------------------------- |
| 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).|
| BREAK_ALL | Word breaks can occur between any two characters for non-CJK text. CJK text behavior is the same as for **NORMAL**.|
| 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**.|

## LineBreakStrategy<sup>12+</sup>

**Atomic service API**: This API can be used in atomic services since API version 12.

| Name        | Description                                                        |
| ------------ | ------------------------------------------------------------ |
| 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.|
| 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.|
| BALANCED     | Balances the line length when possible without word splitting.  |

## TextSelectableMode<sup>12+</sup>
| Name        | Description                                                        |
| ------------ | ------------------------------------------------------------ |
| SELECTABLE_UNFOCUSABLE  | The text is selectable, but not focusable. Setting the **selection**, **bindSelectionMenu**, or **copyOption** attribute does not affect the behavior.|
| SELECTABLE_FOCUSABLE | The text is selectable and focusable. It obtains focus when touched.|
| UNSELECTABLE     | The text is not selectable nor focusable. The **selection**, **bindSelectionMenu**, and **copyOption** attributes do not work in this case. |

## EllipsisMode<sup>11+</sup>

**Widget capability**: This API can be used in ArkTS widgets since API version 11.

**Atomic service API**: This API can be used in atomic services since API version 12.

| Name | Description                                  |
| ----- | -------------------------------------- |
| START  | An ellipsis is used at the start of the line of text.|
| CENTER | An ellipsis is used at the center of the line of text.|
| END | An ellipsis is used at the end of the line of text.|

## ArrowPointPosition<sup>11+</sup>

**Atomic service API**: This API can be used in atomic services since API version 12.

| Name           | Description                                    |
| ------------- | -------------------------------------- |
| START | On the leftmost side of the parent component in the horizontal layout; on the top of the parent component in the vertical layout.|
| CENTER | In the center of the parent component.|
| END | On the rightmost side of the parent component in the horizontal layout; at the bottom of the parent component in the vertical layout.|

## OptionWidthMode<sup>11+</sup>

**System capability**: SystemCapability.ArkUI.ArkUI.Full

**Atomic service API**: This API can be used in atomic services since API version 12.

| Name       | Description                          |
| ----------- | ------------------------------ |
| FIT_CONTENT | Uses the default width, that is, width of two columns.           |
| FIT_TRIGGER | Inherits the width of the drop-down list button.|

## SelectionMenuOptions<sup>11+</sup>

Provides the span range information.

**Atomic service API**: This API can be used in atomic services since API version 11.

| Name| Type | Read Only| Mandatory | Description                              |
| ------ | ------ | ------ | ------ | -------------------------------------- |
| onAppear | [MenuOnAppearCallback](ts-basic-components-richeditor.md#menuonappearcallback12) | No| No| Callback invoked when the custom context menu on selection is displayed.|
| onDisappear | () => void | No| No| Callback invoked when the custom context menu on selection is closed.|

## DismissReason<sup>12+</sup>

**Atomic service API**: This API can be used in atomic services since API version 12.

**System capability**: SystemCapability.ArkUI.ArkUI.Full

| Name         | Value  | Description                                                        |
| ------------- | ---- | ------------------------------------------------------------ |
| PRESS_BACK    | 0    | Touching the Back button, swiping left or right on the screen, or pressing the Esc key.                          |
| TOUCH_OUTSIDE | 1    | Touching the mask.                                              |
| CLOSE_BUTTON  | 2    | Touching the Close button.                                              |
| SLIDE_DOWN    | 3    | Sliding down.<br>**NOTE**<br>This API is effective only in [sheet transition]ts-universal-attributes-sheet-transition.md).|

## ChainStyle<sup>12+</sup>

**Atomic service API**: This API can be used in atomic services since API version 12.

Defines the chain style.

| Name    | Description                           |
| ------ | ----------------------------- |
| SPREAD | Child components are evenly distributed among constraint anchors. For details, see [Example 7 in RelativeContainer](ts-container-relativecontainer.md#example-7).|
| 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).                |
| PACKED  | There is no gap between child components in the chain. For details, see [Example 7 in RelativeContainer](ts-container-relativecontainer.md#example-7).                     |

## BarrierDirection<sup>12+</sup>

Defines the barrier direction.

**Atomic service API**: This API can be used in atomic services since API version 12.

| Name    | Description                           |
| ------ | ----------------------------- |
| LEFT | The barrier is on the left side of all the referenced components specified by [referencedId](ts-container-relativecontainer.md#barrierstyle12).   |
| RIGHT | The barrier is on the right side of all the referenced components specified by [referencedId](ts-container-relativecontainer.md#barrierstyle12).  |
| TOP  | The barrier is at the top of all the referenced components specified by [referencedId](ts-container-relativecontainer.md#barrierstyle12).   |
| BOTTOM  | The barrier is at the top of all the referenced components specified by [referencedId](ts-container-relativecontainer.md#barrierstyle12).|

## PixelRoundCalcPolicy<sup>11+</sup>

Defines the pixel-level rounding policy for component boundaries.

**Atomic service API**: This API can be used in atomic services since API version 11.

| Name    | Description                           |
| ------ | ----------------------------- |
| NO_FORCE_ROUND | The value is not rounded off.|
| FORCE_CEIL | The value is rounded up to the nearest integer.|
| FORCE_FLOOR | The value is rounded down to the nearest integer.|

## TextDecorationStyle<sup>12+</sup>

**Atomic service API**: This API can be used in atomic services since API version 12.

| Name         | Description       |
| ----------- | --------- |
| SOLID   | Single solid line (default value). |
| DOUBLE | Double solid line.|
| DOTTED    | Dotted line. |
| DASHED        | Dashed line.|
| WAVY        | Wavy line.|

## FlexSpaceOptions<sup>12+</sup>

| Name         | Type       |  Read Only    | Mandatory     | Description     |
| ----------- | --------- | ----------- | --------- |----------- |
| 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)} |
| 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)} |

## MenuPolicy<sup>12+</sup>

Defines the menu display policy.

**Atomic service API**: This API can be used in atomic services since API version 12.

**System capability**: SystemCapability.ArkUI.ArkUI.Full

| Name   | Value  | Description                              |
| ------- | ---- | ---------------------------------- |
| DEFAULT | 0    | Whether the menu is displayed depends on the underlying default logic.|
| HIDE    | 1    | The menu is always hidden.                  |
| SHOW    | 2    | The menu is always displayed.                    |

## EmbeddedType<sup>12+</sup>
Enumerates the types of the providers that can be started by the **\<EmbeddedComponent>**.

**Atomic service API**: This API can be used in atomic services since API version 12.

| Name                 | Value| Description                                               |
| --------------------- | - | ---------------------------------------------------- |
| EMBEDDED_UI_EXTENSION | 0 | EmbeddedUIExtensionAbility.|

## MarqueeUpdateStrategy<sup>12+</sup>

**Atomic service API**: This API can be used in atomic services since API version 12.

**System capability**: SystemCapability.ArkUI.ArkUI.Full

| Name      | Value     | Description                    |
| ---------- | ------------------------ | ------------------------ |
| DEFAULT | 0 | After the marquee attributes are updated, the marquee scrolls from the start position.    |
| PRESERVE_POSITION  | 1 | After the marquee attributes are updated, the marquee scrolls from the current position.|

## AppRotation<sup>12+</sup>

**Atomic service API**: This API can be used in atomic services since API version 12.

| Name    | Description                           |
| ------ | ----------------------------- |
| ROTATION_0 | 0 degrees.|
| ROTATION_90 |90 degrees.|
| ROTATION_180 | 180 degrees.|
| ROTATION_270 | 270 degrees.|

## BlurStyleActivePolicy<sup>13+</sup>

**Atomic service API**: This API can be used in atomic services since API version 13.

**System capability**: SystemCapability.ArkUI.ArkUI.Full

| Name    | Description                           |
| ------ | ----------------------------- |
| ALWAYS_ACTIVE | The blur effect is always active.|
| 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.|
| ALWAYS_INACTIVE | The blur effect is always inactive.|

## BlurType<sup>13+</sup>

**Atomic service API**: This API can be used in atomic services since API version 13.

**System capability**: SystemCapability.ArkUI.ArkUI.Full

| Name    | Description                           |
| ------ | ----------------------------- |
| WITHIN_WINDOW | The blur effect is applied within the window.|
| BEHIND_WINDOW | The blur effect is applied behind the window.|

## ScrollSource<sup>12+</sup>

Enumerates the sources of scroll operations.

**Atomic service API**: This API can be used in atomic services since API version 12.

**System capability**: SystemCapability.ArkUI.ArkUI.Full

| Name    |  Value | Description                                      |
| ------ | ------ | ---------------------------------------- |
| DRAG   |  0  | Drag event.|
| FLING |  1  | Inertia scrolling after the drag ends.|
| EDGE_EFFECT  |  2  | Edge scrolling effect with **EdgeEffect.Spring**.|
| OTHER_USER_INPUT  |  3  | Other user inputs aside from dragging, such as those from the mouse wheel and keyboard events.|
| SCROLL_BAR  |  4  | Drag event from the scrollbar.|
| SCROLL_BAR_FLING  |  5  | Inertia scrolling with velocity after the scrollbar is released.|
| SCROLLER  |  6  | Non-animated methods of the **Scroller** object.|
| SCROLLER_ANIMATION  |  7  | Animated methods of the **Scroller** object.|

## ImageSpanAlignment<sup>10+</sup>

**Atomic service API**: This API can be used in atomic services since API version 11.

**System capability**: SystemCapability.ArkUI.ArkUI.Full

| Name    | Description                          |
| -------- | ------------------------------ |
| TOP      | The image is top aligned with the line.  |
| CENTER   | The image is centered aligned with the line.      |
| BOTTOM   | The image is bottom aligned with the line.  |
| BASELINE | The image is bottom aligned with the text baseline.|