Skip to content

D
Docs

OpenHarmony / Docs
10 个月 前同步成功

通知 158
Star 292
Fork 28
D
Docs

前往新版Gitcode，体验更适合开发者的 AI 搜索 >>

未验证 提交 5fc3cfaa 编写于 作者: O openharmony_ci 提交者： Gitee
浏览文件
操作

!15132 翻译完成 14119：自检格式问题修改 

Merge pull request !15132 from ester.zhou/TR-14119
上级 3a2ec3f3 d70019d3
隐藏空白更改
内联 并排
Showing with 51 addition and 43 deletion
en/application-dev/reference/arkui-ts/ts-basic-components-datepicker.md
浏览文件 @ 5fc3cfaa
......@@ -19,6 +19,7 @@ DatePicker(options?: {start?: Date, end?: Date, selected?: Date})
Creates a date picker in the given date range.
**Parameters**
| Name| Type| Mandatory | Description|
| -------- | -------- | ------------- | -------- |
| start | Date | No | Start date of the picker.<br>Default value: **Date('1970-1-1')**|
......
en/application-dev/reference/arkui-ts/ts-basic-components-remotewindow.md
浏览文件 @ 5fc3cfaa
......@@ -18,12 +18,14 @@ RemoteWindow(target: WindowAnimationTarget)
Creates a **\<RemoteWindow>** through a window animation object.
- Parameters
| Name| Type| Mandatory| Default Value| Description|
| -------- | -------- | -------- | -------- | -------- |
| target | [WindowAnimationTarget](#windowanimationtarget) | Yes| - | Description of the animation window to control.|
**Parameters**
| Name| Type| Mandatory| Default Value| Description|
| -------- | -------- | -------- | -------- | -------- |
| target | [WindowAnimationTarget](#windowanimationtarget) | Yes| - | Description of the animation window to control.|
## WindowAnimationTarget
Implements a target window, which is used to remotely control the animation.
| Name | Type | Description|
......@@ -34,6 +36,7 @@ Implements a target window, which is used to remotely control the animation.
| missionId | number | Mission ID.|
## RRect
Implements a rounded rectangle.
| Name | Type | Description|
......
en/application-dev/reference/arkui-ts/ts-basic-components-slider.md
浏览文件 @ 5fc3cfaa
......@@ -24,7 +24,7 @@ Slider(options?: {value?: number, min?: number, max?: number, step?: number, sty
| min | number | No| Minimum value.<br>Default value: **0**|
| max | number | No| Maximum value.<br>Default value: **100**|
| step | number | No| Step of the slider.<br>Default value: **1**<br>Value range: [0.01, max]|
| style | SliderStyle | No| Style of the slider thumb and track.<br>Default value: **SliderStyle.OutSet**|
| style | [SliderStyle](#sliderstyle) | No| Style of the slider thumb and track.<br>Default value: **SliderStyle.OutSet**|
| direction<sup>8+</sup> | [Axis](ts-appendix-enums.md#axis) | No| Whether the slider moves horizontally or vertically.<br>Default value: **Axis.Horizontal**|
| reverse<sup>8+</sup> | boolean | No| Whether the slider values are reversed. By default, the values increase from left to right for a horizontal slider and from top to bottom for a vertical slider.<br>Default value: **false**|
......
en/application-dev/reference/arkui-ts/ts-basic-components-textinput.md
浏览文件 @ 5fc3cfaa
......@@ -53,7 +53,7 @@ In addition to the [universal attributes](ts-universal-attributes-size.md), the
| Next | The Enter key is labeled "Next."|
| Done | The Enter key is labeled "Done." |
## InputType enums
## InputType
| Name | Description |
| ------------------ | ------------- |
......@@ -70,7 +70,7 @@ In addition to the [universal attributes](ts-universal-attributes-size.md), the
| 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. |
## Event
## Events
In addition to the [universal events](ts-universal-events-click.md), the following events are supported.
......
en/application-dev/reference/arkui-ts/ts-basic-components-toggle.md
浏览文件 @ 5fc3cfaa
......@@ -26,9 +26,9 @@ Toggle(options: { type: ToggleType, isOn?: boolean })
## ToggleType
| Name | Description |
| -------- | ---------------- |
| Checkbox | Check box type.<br>> **NOTE**<br>> The default value of the universal attribute [padding](ts-universal-attributes-size.md) is as follows:<br>{<br> top: 14 vp,<br> right: 6 vp,<br> bottom: 14 vp,<br> left: 6 vp<br> } |
| Checkbox | Check box type.<br>**NOTE**<br>The default value of the universal attribute [padding](ts-universal-attributes-size.md) is as follows:<br>{<br> top: 14 vp,<br> right: 6 vp,<br> bottom: 14 vp,<br> left: 6 vp<br> } |
| Button | Button type. The set string, if any, will be displayed inside the button. |
| Switch | Switch type.<br>> **NOTE**<br>> The default value of the universal attribute [padding](ts-universal-attributes-size.md) is as follows:<br>{<br> top: 12 vp,<br> right: 12 vp,<br> bottom: 12 vp,<br> left: 12 vp<br> } |
| Switch | Switch type.<br>**NOTE**<br>The default value of the universal attribute [padding](ts-universal-attributes-size.md) is as follows:<br>{<br> top: 12 vp,<br> right: 12 vp,<br> bottom: 12 vp,<br> left: 12 vp<br> } |
## Attributes
......@@ -36,7 +36,7 @@ Toggle(options: { type: ToggleType, isOn?: boolean })
| Name | Parameter | Description |
| ---------------- | --------------------------- | ---------------------- |
| selectedColor | [ResourceColor](ts-types.md#resourcecolor) | Background color of the component when it is turned on.|
| switchPointColor | [ResourceColor](ts-types.md#resourcecolor) | Color of the circular slider when the component is of the **Switch** type.<br>> **NOTE**<br>> This attribute is valid only when **type** is set to **ToggleType.Switch**.|
| switchPointColor | [ResourceColor](ts-types.md#resourcecolor) | Color of the circular slider when the component is of the **Switch** type.<br>**NOTE**<br>This attribute is valid only when **type** is set to **ToggleType.Switch**. |
## Events
......
en/application-dev/reference/arkui-ts/ts-combined-gestures.md
浏览文件 @ 5fc3cfaa
......@@ -6,18 +6,19 @@ Continuous recognition, parallel recognition, and exclusive recognition are supp
>
> The APIs of this module are supported since API version 7. Updates will be marked with a superscript to indicate their earliest API version.
## APIs
GestureGroup(mode: GestureMode, ...gesture: GestureType[])
- Parameters
| Name| Type| Mandatory| Default Value| Description|
| -------- | -------- | -------- | -------- | -------- |
| mode | [GestureMode](#gesturemode) | Yes| - | Recognition mode of combined gestures.|
| gesture | [TapGesture](ts-basic-gestures-tapgesture.md)<br>\| [LongPressGesture](ts-basic-gestures-longpressgesture.md)<br>\| [PanGesture](ts-basic-gestures-pangesture.md)<br>\| [PinchGesture](ts-basic-gestures-pinchgesture.md)<br>\| [RotationGesture](ts-basic-gestures-rotationgesture.md) | Yes| - | Variable-length parameter, indicating one or more basic gesture types. These gestures are recognized in combination.|
**Parameters**
| Name| Type| Mandatory| Default Value| Description|
| -------- | -------- | -------- | -------- | -------- |
| mode | [GestureMode](#gesturemode) | Yes| - | Recognition mode of combined gestures.|
| gesture | [TapGesture](ts-basic-gestures-tapgesture.md)<br>\| [LongPressGesture](ts-basic-gestures-longpressgesture.md)<br>\| [PanGesture](ts-basic-gestures-pangesture.md)<br>\| [PinchGesture](ts-basic-gestures-pinchgesture.md)<br>\| [RotationGesture](ts-basic-gestures-rotationgesture.md) | Yes| - | Variable-length parameter, indicating one or more basic gesture types. These gestures are recognized in combination.|
## GestureMode
| Name| Description|
| -------- | -------- |
| Sequence | Sequential recognition: Gestures are recognized in the registration sequence until all gestures are recognized successfully. When one gesture fails to be recognized, all gestures fail to be recognized.|
......
en/application-dev/reference/arkui-ts/ts-container-badge.md
浏览文件 @ 5fc3cfaa
......@@ -19,6 +19,7 @@ This component supports only one child component.
Creates a badge.
**Parameters**
| Name| Type| Mandatory| Default Value| Description|
| -------- | -------- | -------- | -------- | -------- |
| count | number | Yes| - | Number of notifications.|
......
en/application-dev/reference/arkui-ts/ts-container-flex.md
浏览文件 @ 5fc3cfaa
......@@ -3,15 +3,11 @@
The **\<Flex>** component allows for flexible layout of child components.
> **NOTE**
>
> - This component is supported since API version 7. Updates will be marked with a superscript to indicate their earliest API version.
> - The **\<Flex>** component adapts the layout of flex items during rendering. This may affect the performance. Therefore, you are advised to use **[\<Column>](ts-container-column.md)** or **[\<Row>](ts-container-row.md)** instead under scenarios where consistently high performance is required.
## Required Permissions
None
## Child Components
Supported
......@@ -23,14 +19,15 @@ Flex(value?: { direction?: FlexDirection, wrap?: FlexWrap, justifyContent?: Fle
Creates a standard **\<Flex>** component.
- Parameters
| Name | Type | Mandatory | Default Value | Description |
| -------------- | ---------------------------------------- | ---- | ----------------- | ---------------------------------------- |
| direction | [FlexDirection](ts-appendix-enums.md#flexdirection) | No | FlexDirection.Row | Direction in which child components are arranged in the **\<Flex>** component, that is, the direction of the main axis. |
| wrap | [FlexWrap](ts-appendix-enums.md#flexwrap) | No | FlexWrap.NoWrap | Whether the **\<Flex>** component has a single line or multiple lines. |
| justifyContent | [FlexAlign](ts-appendix-enums.md#flexalign) | No | FlexAlign.Start | Alignment mode of the child components in the **\<Flex>** component along the main axis. |
| alignItems | [ItemAlign](ts-appendix-enums.md#itemalign) | No | ItemAlign.Start | Alignment mode of the child components in the **\<Flex>** component along the cross axis. |
| alignContent | [FlexAlign](ts-appendix-enums.md#flexalign) | No | FlexAlign.Start | Alignment mode of the child components in a multi-line **\<Flex>** component along the cross axis. This parameter is valid only when **wrap** is set to **Wrap** or **WrapReverse**. |
**Parameters**
| Name | Type | Mandatory | Default Value | Description |
| -------------- | ---------------------------------------- | ---- | ----------------- | ---------------------------------------- |
| direction | [FlexDirection](ts-appendix-enums.md#flexdirection) | No | FlexDirection.Row | Direction in which child components are arranged in the **\<Flex>** component, that is, the direction of the main axis. |
| wrap | [FlexWrap](ts-appendix-enums.md#flexwrap) | No | FlexWrap.NoWrap | Whether the **\<Flex>** component has a single line or multiple lines. |
| justifyContent | [FlexAlign](ts-appendix-enums.md#flexalign) | No | FlexAlign.Start | Alignment mode of the child components in the **\<Flex>** component along the main axis. |
| alignItems | [ItemAlign](ts-appendix-enums.md#itemalign) | No | ItemAlign.Start | Alignment mode of the child components in the **\<Flex>** component along the cross axis. |
| alignContent | [FlexAlign](ts-appendix-enums.md#flexalign) | No | FlexAlign.Start | Alignment mode of the child components in a multi-line **\<Flex>** component along the cross axis. This parameter is valid only when **wrap** is set to **Wrap** or **WrapReverse**. |
## Example
......@@ -96,7 +93,7 @@ struct FlexExample1 {
}
```
![en-us_image_0000001256978365](figures/en-us_image_0000001256978365.gif)
![en-us_image_0000001219744189](figures/en-us_image_0000001219744189.PNG)
```ts
// xxx.ets
......@@ -142,7 +139,7 @@ struct FlexExample2 {
}
```
![en-us_image_0000001211898500](figures/en-us_image_0000001211898500.png)
![en-us_image_0000001174264366](figures/en-us_image_0000001174264366.png)
```ts
// xxx.ets
......@@ -191,7 +188,7 @@ struct FlexExample3 {
}
```
![en-us_image_0000001212218462](figures/en-us_image_0000001212218462.gif)
![en-us_image_0000001174582854](figures/en-us_image_0000001174582854.PNG)
```ts
// xxx.ets
......@@ -289,4 +286,4 @@ struct FlexExample5 {
}
```
![en-us_image_0000001256858413](figures/en-us_image_0000001256858413.gif)
![en-us_image_0000001174422906](figures/en-us_image_0000001174422906.PNG)
en/application-dev/reference/arkui-ts/ts-container-grid.md
浏览文件 @ 5fc3cfaa
......@@ -17,6 +17,7 @@ This component contains the child component **[\<GridItem>](ts-container-gridite
Grid(scroller?: Scroller)
**Parameters**
| Name | Type | Mandatory | Description |
| --------- | ---------------------------------------- | ---- | ----------------------- |
| scroller | [Scroller](ts-container-scroll.md#scroller) | No | Scroller, which can be bound to scrollable components.|
......
en/application-dev/reference/arkui-ts/ts-container-gridrow.md
浏览文件 @ 5fc3cfaa
......@@ -16,6 +16,7 @@ This component can contain the **\<GridCol>** child component.
GridRow(option?: {columns?: number | GridRowColumnOption, gutter?: Length | GutterOption, breakpoints?: BreakPoints, direction?: GridRowDirection})
**Parameters**
| Name|Type|Mandatory|Description|
|-----|-----|----|----|
|gutter|Length \| GutterOption| No |Gutter of the grid layout. **x** indicates the horizontal direction.|
......@@ -37,11 +38,11 @@ Describes the numbers of grid columns for different device width types.
| Name | Type | Mandatory | Description |
| ----- | ------ | ---- | ---------------------------------------- |
| xs | number | No | Device of the minimum size. |
| sm | number | No | Small-sized device. |
| md | number | No | Medium-sized device. |
| lg | number | No | Large-sized device. |
| xl | number | No | Extra-large-sized device. |
| xxl | number | No | Ultra-large-sized device. |
| sm | number | No | Small-sized device. |
| md | number | No | Medium-sized device. |
| lg | number | No | Large-sized device. |
| xl | number | No | Extra-large-sized device. |
| xxl | number | No | Ultra-large-sized device. |
## GridRowSizeOption
......@@ -50,11 +51,11 @@ Describes the gutter sizes for different device width types.
| Name | Type | Mandatory | Description |
| ----- | ------ | ---- | ---------------------------------------- |
| xs | Length | No | Device of the minimum size. |
| sm | Length | No | Small-sized device. |
| md | Length | No | Medium-sized device. |
| lg | Length | No | Large-sized device. |
| xl | Length | No | Extra-large-sized device. |
| xxl | Length | No | Ultra-large-sized device. |
| sm | Length | No | Small-sized device. |
| md | Length | No | Medium-sized device. |
| lg | Length | No | Large-sized device. |
| xl | Length | No | Extra-large-sized device. |
| xxl | Length | No | Ultra-large-sized device. |
## BreakPoints
......
en/application-dev/reference/arkui-ts/ts-container-listitemgroup.md
浏览文件 @ 5fc3cfaa
......@@ -5,7 +5,9 @@ The **\<ListItemGroup>** component is used to display list item groups. It must
> **NOTE**
>
> This component is supported since API version 9. Updates will be marked with a superscript to indicate their earliest API version.
## Usage Guidelines
If the **listDirection** attribute of the parent **\<List>** component is set to **Axis.Vertical**, the **height** attribute of the **\<ListItemGroup>** component cannot be set. The height of a **\<ListItemGroup>** component is the sum of its header height, footer height, and total height of the list items. If the **listDirection** attribute of the parent **\<List>** component is set to **Axis.Horizontal**, the **width** attribute of the **\<ListItemGroup>** component cannot be set. The width of a **\<ListItemGroup>** component is the sum of its header width, footer width, and total width of the list items.
The list items in the **\<ListItemGroup>** component cannot be edited, selected, or dragged. That is, the **editable** and **selectable** attributes of these list items do not take effect.
......
en/application-dev/reference/arkui-ts/ts-universal-attributes-focus.md
浏览文件 @ 5fc3cfaa
......@@ -48,6 +48,7 @@ Requests the focus to move to the specified component. This API can be used in g
defaultFocus/groupDefaultFocus/focusOnTouch:
**defaultFocus** sets the bound component as the initial focus of the page after the page is created. **groupDefaultFocus** sets the bound component as the initial focus of the **tabIndex** container after the container is created. **focusOnTouch** sets the bound component to obtain focus upon being clicked.
```ts
// focusTest.ets
@Entry
......
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或