harmony 鸿蒙Basic Types

2025-06-12
浏览 (4)

Basic Types

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.

Resource

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

The Resource type is used to reference resources for setting component attributes.

You can use $r or $rawfile to create a Resource object, but its attribute values cannot be changed.

$r('belonging.type.name')

belonging: group to which the resource belongs, which can be ‘sys’ or ‘app’.

type: resource type, which can be ‘boolean’, ‘color’, ‘float’, ‘intarray’, ‘integer’, ‘pattern’, ‘plural’, ‘strarray’, ‘string’, or ‘media’.

name: resource name, which is determined during resource definition.

$rawfile('filename')

filename: name of the file in the resources/rawfile directory of the project.

NOTE
When referencing resources of the Resource type, make sure the data type is the same as that of the attribute method. For example, if an attribute method supports the string|Resource types, the data type of the Resource type must be string.

Length

The Length type is used to represent a size unit.

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

Type	Description
string	String type. Specify the length unit explicitly, for example, ‘10px’, or provide the length in percentage, for example, ‘100%’. NOTE If the unit is not specified, the default unit vp is used, in which case ‘10’ is equivalent to 10 vp.
number	Number type. The default unit is vp.
Resource	Size referenced from system or application resources.

ResourceStr

The ResourceStr type is used to represent the types that can be used by input parameters of the string type.

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

Type	Description
string	String type.
Resource	String referenced from system or application resources.

Padding

The Padding type is used to describe the paddings in different directions of a component.

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

Name	Type	Mandatory	Description
top	Length	No	Height of the padding on the top of the component.
right	Length	No	Width of the padding on the right of the component.
bottom	Length	No	Height of the padding at the bottom of the component.
left	Length	No	Width of the padding on the left of the component.

LocalizedPadding¹²⁺

The Padding type is used to describe the paddings in different directions of a component.

Name	Type	Mandatory	Description
top	LengthMetrics¹²⁺	No	Height of the padding on the top of the component.
end	LengthMetrics¹²⁺	No	Width of the padding on the right of the component. For right-to-left scripts: Width of the padding on the left of the component.
bottom	LengthMetrics¹²⁺	No	Height of the padding at the bottom of the component.
start	LengthMetrics¹²⁺	No	Width of the padding on the left of the component. For right-to-left scripts: Width of the padding on the right of the component.

Margin

The Margin type is used to describe the margins in different directions of a component.

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

Name	Type	Mandatory	Description
top	Length	No	Height of the margin above the component.
right	Length	No	Width of the margin on the right of the component.
bottom	Length	No	Height of the margin below the component.
left	Length	No	Width of the margin on the left of the component.

LocalizedMargin¹²⁺

The Margin type is used to describe the margins in different directions of a component.

Name	Type	Mandatory	Description
top	LengthMetrics¹²⁺	No	Height of the margin above the component.
end	LengthMetrics¹²⁺	No	Width of the margin on the right of the component. For right-to-left scripts: Width of the margin on the left of the component.
bottom	LengthMetrics¹²⁺	No	Height of the margin below the component.
start	LengthMetrics¹²⁺	No	Width of the margin on the left of the component. For right-to-left scripts: Width of the margin on the right of the component.

EdgeWidths⁹⁺

The EdgeWidths type is used to describe the edge widths in different directions of a component.

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

Name	Type	Mandatory	Description
top	Length	No	Width of the top edge of the component.
right	Length	No	Width of the right edge of the component.
bottom	Length	No	Width of the bottom edge of the component.
left	Length	No	Width of the left edge of the component.

LocalizedEdgeWidths¹²⁺

The EdgeWidths type is used to describe the edge widths in different directions of a component.

Name	Type	Mandatory	Description
top	LengthMetrics¹²⁺	No	Width of the top edge of the component.
end	LengthMetrics¹²⁺	No	Width of the right edge of the component. Width of the left edge of the component for right-to-left scripts.
bottom	LengthMetrics¹²⁺	No	Width of the bottom edge of the component.
start	LengthMetrics¹²⁺	No	Width of the left edge of the component. Width of the right edge of the component for right-to-left scripts.

BorderRadiuses⁹⁺

The BorderRadiuses type is used to describe the corner radius of a component’s border.

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

Name	Type	Mandatory	Description
topLeft	Length	No	Radius of the upper left corner of the component.
topRight	Length	No	Radius of the upper right corner of the component.
bottomLeft	Length	No	Radius of the lower left corner of the component.
bottomRight	Length	No	Radius of the lower right corner of the component.

LocalizedBorderRadiuses¹²⁺

The LocalizedBorderRadiuses type is used to describe the corner radius of a component’s border.

Name	Type	Mandatory	Description
topStart	LengthMetrics¹²⁺	No	Radius of the upper left corner of the component. For right-to-left scripts, this indicates the radius of the upper left right of the component.
topEnd	LengthMetrics¹²⁺	No	Radius of the upper right corner of the component. For right-to-left scripts, this indicates the radius of the upper left corner of the component.
bottomStart	LengthMetrics¹²⁺	No	Radius of the lower left corner of the component. For right-to-left scripts, this indicates the radius of the lower right corner of the component.
bottomEnd	LengthMetrics¹²⁺	No	Radius of the lower right corner of the component. For right-to-left scripts, this indicates the radius of the lower left corner of the component.

EdgeColors⁹⁺

The EdgeColors type is used to describe the edge colors of a component.

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

Name	Type	Mandatory	Description
top	ResourceColor	No	Color of the top edge of the component.
right	ResourceColor	No	Color of the right edge of the component.
bottom	ResourceColor	No	Color of the bottom edge of the component.
left	ResourceColor	No	Color of the left edge of the component.

LocalizedEdgeColors¹²⁺

The EdgeColors type is used to describe the edge colors of a component.

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

Name	Type	Mandatory	Description
top	ResourceColor	No	Color of the top edge of the component.
end	ResourceColor	No	Color of the right edge of the component. Color of the left edge of the component for right-to-left scripts.
bottom	ResourceColor	No	Color of the bottom edge of the component.
start	ResourceColor	No	Color of the left edge of the component. Color of the right edge of the component for right-to-left scripts.

EdgeStyles⁹⁺

The EdgeStyles type is used to describe the edge styles of a component.

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

Name	Type	Mandatory	Description
top	BorderStyle	No	Style of the top edge of the component.
right	BorderStyle	No	Style of the right edge of the component.
bottom	BorderStyle	No	Style of the bottom edge of the component.
left	BorderStyle	No	Style of the left edge of the component.

Offset

The Offset type is used to describe the offset coordinates of a component in the layout.

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

Name	Type	Mandatory	Description
dx	Length	Yes	X coordinate of the offset.
dy	Length	Yes	Y coordinate of the offset.

RectResult¹⁰⁺

The RectResult type is used to describe the position, width, and height of a component.

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

Name	Type	Description
x	number	Horizontal coordinate.
y	number	Vertical coordinate.
width	number	Content width.
height	number	Content height.

ResourceColor

The ResourceColor type is used to describe the color types of resources.

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

Type	Description
Color	Color enums.
number	Color in hexadecimal notation. RGB and ARGB are supported. Examples: 0xffffff and 0xffff0000. The number of input digits cannot be identified. The format is selected based on the value. For example, 0x00ffffff is parsed in RGB format.
string	Color in RGB or ARGB notation. Example: ’#ffffff’, ‘#ff000000’, ‘rgb(255, 100, 255)’, ‘rgba(255, 100, 255, 0.5)’
Resource	Color referenced from system or application resources.

LengthConstrain

The LengthConstrain type is used to describe the maximum and minimum lengths of a component.

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

Name	Type	Mandatory	Description
minLength	Length	Yes	Minimum length of the component.
maxLength	Length	Yes	Maximum length of the component.

Font

The Font type is used to set the text style.

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

Name	Type	Mandatory	Description
size	Length	No	Font size. If the value is of the number type, the unit fp is used. The value cannot be a percentage. Default value: 16.0
weight	FontWeight \|number \|string	No	Font weight. For the number type, the value ranges from 100 to 900, at an interval of 100. A larger value indicates a thicker font. Default value: 400 \|FontWeight.Normal
family	string \|Resource	No	Font family of the text. Use commas (,) to separate multiple fonts. The priority of the fonts is the sequence in which they are placed. An example value is ‘Arial, HarmonyOS Sans’. The ‘HarmonyOS Sans’ font and registered custom fonts are supported.
style	FontStyle	No	Font style. Default value: FontStyle.Normal

Area⁸⁺

The Area type is used to describe the area information of a component.

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

Name	Type	Description
width	Length	Width of the component. The value is of the number type in vp when used as the return value.
height	Length	Height of the component. The value is of the number type in vp when used as the return value.
position	Position	Position of the upper left corner of the component relative to that of its parent container.
globalPosition	Position	Position of the upper left corner of the component relative to that of the page where the component resides.

Position

The Position type is used to represent coordinates of a point.

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

Name	Type	Mandatory	Description
x	Length	No	X coordinate. The value is of the number type in vp when used as the return value.
y	Length	No	Y coordinate. The value is of the number type in vp when used as the return value.

LocalizedPosition¹²⁺

The LocalizedPosition type is used to represent coordinates of a point.

Name	Type	Mandatory	Description
start	LengthMetrics	No	X-coordinate relative to the left for left-to-right scripts; X-coordinate relative to the right for right-to-left scripts.
top	LengthMetrics	No	Y-coordinate.

Edges¹²⁺

The Edges type is used to describe the offset relative to the four edges. If both top and bottom are set, only top takes effect. If both left and right are set, only left takes effect.

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

Name	Type	Mandatory	Description
top	Dimension	No	Offset relative to the top edge.
bottom	Dimension	No	Offset relative to the bottom edge.
left	Dimension	No	Offset relative to the left edge.
right	Dimension	No	Offset relative to the right edge.

LocalizedEdges¹²⁺

The LocalizedEdges type is used to describe the offset relative to the four edges. If both top and** bottom **are set, only top takes effect. If both start and end are set, only start takes effect.

Name	Type	Mandatory	Description
top	LengthMetrics	No	Offset relative to the top edge.
bottom	LengthMetrics	No	Offset relative to the bottom edge.
start	LengthMetrics	No	Offset relative to the left for left-to-right scripts; offset relative to the right for right-to-left scripts.
end	LengthMetrics	No	Offset relative to the right for left-to-right scripts; offset relative to the left for right-to-left scripts.

ConstraintSizeOptions

The ConstraintSizeOptions type is used to set the size constraints of a component during component layout.

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

Name	Type	Mandatory	Description
minWidth	Length	No	Minimum width of the component.
maxWidth	Length	No	Maximum width of the component.
minHeight	Length	No	Minimum height of the component.
maxHeight	Length	No	Maximum height of the component.

SizeOptions

The SizeOptions type is used to set the width and height.

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

Name	Type	Mandatory	Description
width	Length	No	Width of the component.
height	Length	No	Height of the component.

BorderOptions

The BorderOptions type is used to provide border information.

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

Name	Type	Mandatory	Description
width	Length \|EdgeWidths⁹⁺ \|LocalizedEdgeWidths¹²⁺	No	Border width.
color	ResourceColor \|EdgeColors⁹⁺	No	Border color.
radius	Length \|BorderRadiuses⁹⁺	No	Radius of the rounded corner border.
style	BorderStyle \|EdgeStyles⁹⁺	No	Border style.

ColorFilter⁹⁺

The ColorFilter type is used to create a color filter with a 4 x 5 matrix.

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

Name	Type	Mandatory	Description
constructor	number[]	Yes	Constructor for creating a color filter with a 45 matrix. The input parameter is [mn], which is the matrix value in row m and column n. The matrix is row-first.

CustomBuilder⁸⁺

The CustomBuilder type is used to define custom UI descriptions in component attribute methods.

Name	Type	Description
CustomBuilder	() => any \|void	Builder for creating a custom component; must be used with @Builder. For details, see @Builder.

MarkStyle¹⁰⁺

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

System capability: SystemCapability.ArkUI.ArkUI.Full

Name	Type	Mandatory	Default Value	Description
strokeColor	ResourceColor	No	Color.White	Color of the mark.
size	Length	No	-	Size of the mark, in vp. The default size is the same as the width of the check box. This parameter cannot be set in percentage. If it is set to an invalid value, the default value is used.
strokeWidth	Length	No	2	Stroke width of the mark, in vp. This parameter cannot be set in percentage. If it is set to an invalid value, the default value is used.

ModalTransition¹⁰⁺

The ModalTransition type is used to set the transition type for a full-screen modal.

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

Name	Description
NONE	No transition animation for the modal.
DEFAULT	Slide-up and slide-down animation for the modal.
ALPHA	Opacity gradient animation for the modal.

Dimension¹⁰⁺

The Length type is used to represent a size unit.

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

Type	Description
PX	Physical pixel unit type. The unit px must be included, for example, ‘10px’.
VP	Pixel unit type specific to the screen density. The unit vp can be included or omitted, for example, 10 or ‘10vp’.
FP	Font pixel unit type. The unit fp must be included, for example, ‘10fp’.
LPX	Logical pixel unit type. The unit lpx must be included, for example, ‘10lpx’.
Percentage	Percentage type. The unit % must be included, for example, ‘10%’.
Resource	Size referenced from system or application resources.

PX¹⁰⁺

The PX type is used to represent a length in px.

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

Type	Description
{number}px	Physical pixel unit type. The unit px must be included, for example, ‘10px’.

VP¹⁰⁺

The VP type is used to represent a length in vp.

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

Type	Description
{number}vp\|number	Pixel unit type specific to the screen density. The unit vp can be included or omitted, for example, 10 or ‘10vp’.

FP¹⁰⁺

The FP type is used to represent a length in fp.

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

Type	Description
{number}fp	Font pixel unit type. The unit fp must be included, for example, ‘10fp’.

LPX¹⁰⁺

The LPX type is used to represent a length in lpx.

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

Type	Description
{number}lpx	Logical pixel unit type. The unit lpx must be included, for example, ‘10lpx’.

Percentage¹⁰⁺

The Percentage type is used to represent a length in percentage.

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

Type	Description
{number}%	Percentage type. The unit % must be included, for example, ‘10%’.

Degree¹⁰⁺

The Degree type is used to represent a length in deg.

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

Type	Description
{number}deg	Degree type. The unit deg must be included, for example, ‘10deg’.

MultiShadowOptions¹⁰⁺

The MultiShadowOptions type is used to describe the shadow style.

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

Name	Type	Mandatory	Description
radius	number \|Resource	No	Shadow blur radius. The default value varies by API version. API version 10 and earlier versions: 5 Since API version 11: 20 Unit: vp NOTE A value less than or equal to 0 is handled as the default value.
offsetX	number \|Resource	No	Offset on the x-axis. Default value: 5 Unit: vp
offsetY	number \|Resource	No	Offset on the y-axis. Default value: 5 Unit: vp

SafeAreaType¹⁰⁺

The SafeAreaType type is used to describe the types of expanded safe areas.

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

Name	Description
SYSTEM	Default non-safe area of the system, including the status bar and navigation bar.
CUTOUT	Non-safe area of the device, for example, the notch area.
KEYBOARD	Soft keyboard area.

SafeAreaEdge¹⁰⁺

The SafeAreaEdge type is used to define the edge for expanding the safe area.

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

Name	Description
TOP	Top edge.
BOTTOM	Bottom edge.
START	Start edge.
END	End edge.

KeyboardAvoidMode¹²⁺

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	Automatically avoids the soft keyboard and compresses the height when reaching the maximum limit.
NONE	1	Does not avoid the soft keyboard.

LayoutSafeAreaType¹²⁺

The LayoutSafeAreaType type is used to describe the types of expanded safe areas in layout.

Name	Description
SYSTEM	Default non-safe area of the system, including the status bar and navigation bar.

LayoutSafeAreaEdge¹²⁺

The LayoutSafeAreaEdge type is used to define the edge for expanding the safe area.

Name	Description
TOP	Top edge.
BOTTOM	Bottom edge.

TouchPoint¹¹⁺

The TouchPoint type is used to define the coordinates of the touch point.

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

Name	Type	Description
X	Dimension	X coordinate of the touch point.
Y	Dimension	Y coordinate of the touch point.

PixelRoundPolicy¹¹⁺

The PixelRoundPolicy type is used to describe the direction of pixel rounding at the component level.

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

Name	Type	Mandatory	Description
start	PixelRoundCalcPolicy	No	Rounding for alignment with the start edge.
top	PixelRoundCalcPolicy	No	Rounding for alignment with the top edge.
end	PixelRoundCalcPolicy	No	Rounding for alignment with the end edge.
bottom	PixelRoundCalcPolicy	No	Rounding for alignment with the bottom edge.

VoidCallback¹²⁺

type VoidCallback: () => void;

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

Callback¹²⁺

Callback = (data: T) => V;

The Callback type is used to represent the callback with parameters.

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

HoverCallback¹²⁺

The HoverCallback type is used to represent the callback for the hover event.

type HoverCallback = (isHover: boolean, event: HoverEvent) => void;

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

Name	Type	Description
HoverCallback	(isHover: boolean, event: HoverEvent) => void	Callback for the hover event.

VisibleAreaEventOptions¹²⁺

The VisibleAreaEventOptions type is used to describe visible area changes.

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

Name	Type	Mandatory	Description
ratios	Array<number>	Yes	Threshold array. Each threshold represents a ratio of the component’s visible area (that is, the area of the component that is visible on screen; only the area within the parent component is counted) to the component’s total area. The value range of the threshold is [0.0, 1.0]. If the threshold set exceeds this range, the value 0.0 or 1.0 will be used.
expectedUpdateInterval	number	No	Expected update interval, in milliseconds. You can set it as appropriate. Default value: 1000

VisibleAreaChangeCallback¹²⁺

The VisibleAreaChangeCallback type is used to represent a callback for visible area changes of the component.

type VisibleAreaChangeCallback = (isExpanding: boolean, currentRatio: number) => void;

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

Name	Type	Description
VisibleAreaChangeCallback	(isExpanding: boolean, currentRatio: number) => void	Callback for visible area changes of the component. - isExpanding: whether the ratio of the component’s visible area to its total area is greater than the previous one. The value true means that the ratio is greater than the previous one, and false means the opposite. - currentRatio: ratio of the component’s visible area to its total area when this callback is invoked.

DividerStyleOptions¹²⁺

The DividerStyleOptions type is used to provide the information about the divider.

System capability: SystemCapability.ArkUI.ArkUI.Full

Name	Type	Mandatory	Description
strokeWidth	LengthMetrics¹²⁺	No	Width of the divider.
color	ResourceColor	No	Color of the divider.
startMargin	LengthMetrics¹²⁺	No	Distance between the divider and the start edge of the menu.
endMargin	LengthMetrics¹²⁺	No	Distance between the divider and the end edge of the menu.
mode	DividerMode¹⁸⁺	No	Mode of the divider.

TextContentControllerBase¹⁰⁺

The TextContentControllerBase type is used to represent the base controller for TextInput, TextArea, and Search components.

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

System capability: SystemCapability.ArkUI.ArkUI.Full

getTextContentRect¹⁰⁺

getTextContentRect(): RectResult

The getTextContentRect type is used to obtain the position of the edited text area relative to the component and its size. The unit of the return value is pixel.

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

System capability: SystemCapability.ArkUI.ArkUI.Full

Return value

Type	Description
RectResult	Position of the edited text area relative to the component and its size.

NOTE

If no text is entered, the return value contains the position information, but the size is 0.

The position information is the offset of the first character relative to the editable area.

For the Search component, the returned position information is the offset of the first character relative to the search icon in the component.

If there is input, the width in the return value is the fixed width of the editable area.

getTextContentLineCount¹⁰⁺

getTextContentLineCount(): number

The getTextContentLineCount type is used to obtain the number of lines of the edited text.

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

System capability: SystemCapability.ArkUI.ArkUI.Full

Return value

Type	Description
number	Number of lines of the edited text.

getCaretOffset¹¹⁺

getCaretOffset(): CaretOffset

The getCaretOffset type is used to obtain the position information of the caret.

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

System capability: SystemCapability.ArkUI.ArkUI.Full

Return value

Type	Description
CaretOffset	Position of the caret relative to the text box.

NOTE

If this API is called when the caret position is updated in the current frame, it will not take effect.

For the Search component, the returned position information is the offset of the first character relative to the search icon in the component.

If no text is entered in the Search component, the return value contains the position information relative to the component.

The location information in the return value is the location of the caret relative to the editable component.

addText¹⁵⁺

addText(text: string, textOperationOptions?: TextContentControllerOptions): number

Inserts text at a specified position in the editable content. If no position is specified, the text is appended to the end of the existing content. This API does not work when the text is being dragged.

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

System capability: SystemCapability.ArkUI.ArkUI.Full

Parameters

Name	Type	Mandatory	Description
text	string	Yes	Text to insert.
textOperationOptions	TextContentControllerOptions	No	Configuration option for inserting text. If this parameter is not provided, the text is appended to the end.

deleteText¹⁵⁺

deleteText(range?: TextRange): void

Deletes text within a specified range in the editable content. This API does not work when the text is being dragged.

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

System capability: SystemCapability.ArkUI.ArkUI.Full

Parameters

Name	Type	Mandatory	Description
range	TextRange	No	Range of the text to be deleted, including the start and end positions. If the range is not specified, the entire text is deleted. If the start position is not specified, deletion starts from index 0. If the end position is not specified, deletion ends at the end of the text.

getSelection¹⁵⁺

getSelection(): TextRange

Obtains the current text selection range.

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

System capability: SystemCapability.ArkUI.ArkUI.Full

Return value

Type	Description
TextRange	Current text selection range, or cursor position if no text is selected.

clearPreviewText¹⁸⁺

clearPreviewText(): void

Clears the current preview text.

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

System capability: SystemCapability.ArkUI.ArkUI.Full

getText¹⁸⁺

getText(range?: TextRange): string

Obtains the text content within a specified range.

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

System capability: SystemCapability.ArkUI.ArkUI.Full

Parameters

Name	Type	Mandatory	Description
range	TextRange	No	Range of the text content to obtain, defined by start and end positions. If the range is not specified, the entire text is obtained by default. If the start position is not specified, it defaults to index 0. If the end position is not specified, it defaults to the end of the text.

Return value

Type	Description
string	Text content within the specified range.

TextDecorationOptions¹²⁺

System capability: SystemCapability.ArkUI.ArkUI.Full

Name	Type	Mandatory	Description
type	TextDecorationType	Yes	Style of the text decorative line. Atomic service API: This API can be used in atomic services since API version 11.
color	ResourceColor	No	Color of the text decorative line. Atomic service API: This API can be used in atomic services since API version 11.
style	TextDecorationStyle	No	Style of the text decorative line. Atomic service API: This API can be used in atomic services since API version 12.

SelectionOptions¹²⁺

The SelectionOptions type is used to describe the configuration options for text selection.

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
menuPolicy	MenuPolicy	No	Menu display policy.

MenuPolicy¹²⁺

The MenuPolicy type is used to describe 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.

CaretOffset¹¹⁺

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

System capability: SystemCapability.ArkUI.ArkUI.Full

Name	Type	Description
index	number	Index of the caret position.
x	number	X coordinate of the caret relative to the text box, in px.
y	number	Y coordinate of the caret relative to the text box, in px.

InputCounterOptions¹¹⁺

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

System capability: SystemCapability.ArkUI.ArkUI.Full

Name	Type	Description
thresholdPercentage	number	Threshold percentage for displaying the character counter. The character counter is displayed when the number of characters that have been entered is greater than the maximum number of characters multiplied by the threshold percentage value. When displayed, the character counter is in the following format: Number of characters that have been entered/Maximum number of characters allowed. It is visible when the number of characters entered is greater than the character limit multiplied by the threshold percentage value. Value range: [1, 100] If the value is not an integer, it is rounded down to the nearest integer. If the value exceeds the valid value range, the character counter is not displayed. If the value is undefined, the character counter is displayed, but this parameter has no effect.
highlightBorder	boolean	Whether to highlight the text box border and character counter subscript in red. If options is not set, the text box border and character counter subscript turn red when the number of characters entered reaches the limit. If the character counter is displayed and thresholdPercentage is set to a valid value, the text box border and character counter subscript turn red when the number of entered characters exceeds the limit. The value true (default) means to highlight the text box border and character counter subscript in red.

ChainWeightOptions¹⁴⁺

The ChainWeightOptions type is used to describe the layout weight of a component within a chain.

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

System capability: SystemCapability.ArkUI.ArkUI.Full

Name	Type	Description
horizontal	number	Layout weight of the component in the horizontal direction. It is effective when set to a value greater than 0. Default value: 0 Invalid values are treated as 0.
vertical	number	Layout weight of the component in the vertical direction. It is effective when set to a value greater than 0. Default value: 0 Invalid values are treated as 0.

Configuration

The Configuration type is used to describe the color mode and font scale.

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.

System capability: SystemCapability.ArkUI.ArkUI.Full

Name	Type	Read Only	Optional	Description
colorMode	string	Yes	No	Color mode.
fontScale	number	Yes	No	Font scale.

LayoutPolicy¹⁵⁺

The LayoutPolicy type is used to set the layout strategy for linear layouts.

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

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

System capability: SystemCapability.ArkUI.ArkUI.Full

Name	Type	Read Only	Description
MATCH_PARENT	LayoutPolicy	Yes	Adjusts the size to match the parent component’s layout.

NOTE

When the parent container of a linear layout component has its length set, the component will automatically adjust its size based on the parent container’s size. If the parent container does not have a length set, the linear layout component will wait for all child components to complete their layout before adjusting its size to match the parent container’s layout.

If multiple child components under the same parent are set to MATCH_PARENT, all these child components will be resized to the parent’s size, potentially causing overflow.

Setting MATCH_PARENT will force the component to match the parent’s size, overriding any other size constraints set on the component.

TextContentControllerOptions¹⁵⁺

The TextContentControllerOptions type is used to configure the insertion of text into a text box.

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

System capability: SystemCapability.ArkUI.ArkUI.Full

Name	Type	Read Only	Optional	Description
offset	number	Yes	Yes	Position where the text will be inserted.

DividerMode¹⁸⁺

The DividerMode type is used to configure the mode of the divider.

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

System capability: SystemCapability.ArkUI.ArkUI.Full

|Name |Value|Description | |——————|-|—————————————-| |FLOATING_ABOVE_MENU|0|The divider floats above the menu without affecting the layout height. This is the default mode. | |EMBEDDED_IN_MENU |1|The divider is embedded in the menu and affects the layout height. |

你可能感兴趣的鸿蒙文章

harmony 鸿蒙ComposeListItem

harmony 鸿蒙ComposeTitleBar

harmony 鸿蒙advanced.Counter

harmony 鸿蒙Dialog Box (Dialog)

harmony 鸿蒙DialogV2

harmony 鸿蒙DownloadFileButton

0 赞

所属分类： 后端技术
本文标签：
版权声明： 原创文章如转载，请注明本文链接: https://m.seaxiang.com/blog/QdcP30

harmony 鸿蒙Basic Types

Basic Types

Resource

Length

ResourceStr

Padding

LocalizedPadding12+

Margin

LocalizedMargin12+

EdgeWidths9+

LocalizedEdgeWidths12+

BorderRadiuses9+

LocalizedBorderRadiuses12+

EdgeColors9+

LocalizedEdgeColors12+

EdgeStyles9+

Offset

RectResult10+

ResourceColor

LengthConstrain

Font

Area8+

Position

LocalizedPosition12+

Edges12+

LocalizedEdges12+

ConstraintSizeOptions

SizeOptions

BorderOptions

ColorFilter9+

CustomBuilder8+

MarkStyle10+

ModalTransition10+

Dimension10+

PX10+

VP10+

FP10+

LPX10+

Percentage10+

Degree10+

MultiShadowOptions10+

SafeAreaType10+

SafeAreaEdge10+

KeyboardAvoidMode12+

LayoutSafeAreaType12+

LayoutSafeAreaEdge12+

TouchPoint11+

PixelRoundPolicy11+

VoidCallback12+

Callback12+

HoverCallback12+

VisibleAreaEventOptions12+

VisibleAreaChangeCallback12+

DividerStyleOptions12+

TextContentControllerBase10+

getTextContentRect10+

getTextContentLineCount10+

getCaretOffset11+

addText15+

deleteText15+

getSelection15+

clearPreviewText18+

getText18+

TextDecorationOptions12+

SelectionOptions12+

MenuPolicy12+

CaretOffset11+

InputCounterOptions11+

ChainWeightOptions14+

Configuration

LayoutPolicy15+

TextContentControllerOptions15+

DividerMode18+

你可能感兴趣的鸿蒙文章

热门推荐

标签云

最新文章

本文目录

LocalizedPadding¹²⁺

LocalizedMargin¹²⁺

EdgeWidths⁹⁺

LocalizedEdgeWidths¹²⁺

BorderRadiuses⁹⁺

LocalizedBorderRadiuses¹²⁺

EdgeColors⁹⁺

LocalizedEdgeColors¹²⁺

EdgeStyles⁹⁺

RectResult¹⁰⁺

Area⁸⁺

LocalizedPosition¹²⁺

Edges¹²⁺

LocalizedEdges¹²⁺

ColorFilter⁹⁺

CustomBuilder⁸⁺

MarkStyle¹⁰⁺

ModalTransition¹⁰⁺

Dimension¹⁰⁺

PX¹⁰⁺

VP¹⁰⁺

FP¹⁰⁺

LPX¹⁰⁺

Percentage¹⁰⁺

Degree¹⁰⁺

MultiShadowOptions¹⁰⁺

SafeAreaType¹⁰⁺

SafeAreaEdge¹⁰⁺

KeyboardAvoidMode¹²⁺

LayoutSafeAreaType¹²⁺

LayoutSafeAreaEdge¹²⁺

TouchPoint¹¹⁺

PixelRoundPolicy¹¹⁺

VoidCallback¹²⁺

Callback¹²⁺

HoverCallback¹²⁺

VisibleAreaEventOptions¹²⁺

VisibleAreaChangeCallback¹²⁺

DividerStyleOptions¹²⁺

TextContentControllerBase¹⁰⁺

getTextContentRect¹⁰⁺

getTextContentLineCount¹⁰⁺

getCaretOffset¹¹⁺

addText¹⁵⁺

deleteText¹⁵⁺

getSelection¹⁵⁺

clearPreviewText¹⁸⁺

getText¹⁸⁺

TextDecorationOptions¹²⁺

SelectionOptions¹²⁺

MenuPolicy¹²⁺

CaretOffset¹¹⁺

InputCounterOptions¹¹⁺

ChainWeightOptions¹⁴⁺

LayoutPolicy¹⁵⁺

TextContentControllerOptions¹⁵⁺

DividerMode¹⁸⁺