From 0fb2649ffc09ddc2768399c74fb8196521a0616f Mon Sep 17 00:00:00 2001 From: "ester.zhou" Date: Fri, 21 Oct 2022 11:18:37 +0800 Subject: [PATCH] Update docs (9444) Signed-off-by: ester.zhou --- en/application-dev/reference/Readme-EN.md | 15 +- .../reference/arkui-js/Readme-EN.md | 2 +- .../arkui-js/js-components-basic-picker.md | 191 ++++++++--------- .../arkui-js/js-components-container-div.md | 148 +++++++------ .../js-components-container-stepper-item.md | 71 +++---- .../js-components-container-tab-content.md | 26 ++- .../arkui-js/js-components-svg-circle.md | 30 +-- .../js-components-svg-common-attributes.md | 36 ++-- .../arkui-js/js-components-svg-ellipse.md | 32 +-- .../arkui-js/js-components-svg-line.md | 35 ++-- .../arkui-js/js-components-svg-path.md | 25 ++- .../arkui-js/js-components-svg-polygon.md | 26 ++- .../arkui-js/js-components-svg-polyline.md | 26 ++- .../arkui-js/js-components-svg-rect.md | 36 ++-- .../arkui-js/js-components-svg-text.md | 62 +++--- .../arkui-js/js-components-svg-textpath.md | 133 ++++++------ .../arkui-js/js-components-svg-tspan.md | 104 ++++----- .../reference/arkui-js/js-components-svg.md | 36 ++-- .../reference/arkui-ts/ts-container-badge.md | 197 +++++++++++------- ...s-universal-component-area-change-event.md | 23 +- en/application-dev/ui/Readme-EN.md | 14 +- en/application-dev/ui/arkui-overview.md | 2 +- .../ui/ts-framework-file-access-rules.md | 15 +- en/application-dev/ui/ui-js-component-tabs.md | 47 ++--- en/application-dev/ui/ui-js-overview.md | 6 +- 25 files changed, 710 insertions(+), 628 deletions(-) diff --git a/en/application-dev/reference/Readme-EN.md b/en/application-dev/reference/Readme-EN.md index 4e8eb2c464..d3e0092def 100644 --- a/en/application-dev/reference/Readme-EN.md +++ b/en/application-dev/reference/Readme-EN.md @@ -1,15 +1,12 @@ # Development References -- [JavaScript-based Web-like Development Paradigm](arkui-js/Readme-EN.md) +- [Component Reference (ArkTS-based Declarative Development Paradigm)](arkui-ts/Readme-EN.md) -- [TypeScript-based Declarative Development Paradigm](arkui-ts/Readme-EN.md) - -- APIs - - - [JS and TS APIs](apis/Readme-EN.md) - - Native APIs - - [Standard Libraries](native-lib/third_party_libc/musl.md) - - [Node_API](native-lib/third_party_napi/napi.md) +- [Component Reference (JavaScript-compatible Web-like Development Paradigm)](arkui-js/Readme-EN.md) +- [API Reference (JS and TS APIs)](apis/Readme-EN.md) +- API Reference (Native APIs) + - [Standard Libraries Supported by Native APIs](native-lib/third_party_libc/musl.md) + - [Node_API](native-lib/third_party_napi/napi.md) diff --git a/en/application-dev/reference/arkui-js/Readme-EN.md b/en/application-dev/reference/arkui-js/Readme-EN.md index a34f071f9d..be19e4dc3b 100644 --- a/en/application-dev/reference/arkui-js/Readme-EN.md +++ b/en/application-dev/reference/arkui-js/Readme-EN.md @@ -1,4 +1,4 @@ -# JavaScript-based Web-like Development Paradigm +# JavaScript-compatible Web-like Development Paradigm - Universal Component Information - [Universal Attributes](js-components-common-attributes.md) diff --git a/en/application-dev/reference/arkui-js/js-components-basic-picker.md b/en/application-dev/reference/arkui-js/js-components-basic-picker.md index 6c50d6789a..f6425d9371 100644 --- a/en/application-dev/reference/arkui-js/js-components-basic-picker.md +++ b/en/application-dev/reference/arkui-js/js-components-basic-picker.md @@ -1,174 +1,169 @@ # picker +> **NOTE** +> +> This component is supported since API version 4. Updates will be marked with a superscript to indicate their earliest API version. + The **\** component supports common, date, time, data and time, and multi-column text selectors. + ## Required Permissions None -## Child Component -None +## Child Components -## Attributes +Not supported -In addition to the attributes in [Universal Attributes](js-components-common-attributes.md), the following attributes are supported. +## Attributes +In addition to the [universal attributes](../arkui-js/js-components-common-attributes.md), the following attributes are supported. -| Name | Type | Default Value | Mandatory | Description | -| ---- | ------ | ------------- | --------- | ------------------------------------------------------------ | -| type | string | - | No | Dynamic modification is not supported. Available values include:
-**text**: text selector
-**data**: date selector
-**time**: time selector
-**datetime**: date and time selector
-**multi-text**: multi-column text selector | +| Name | Type | Default Value | Mandatory | Description | +| ---- | ------ | ---- | ---- | ---------------------------------------- | +| type | string | - | No | Picker type. Dynamic modification is not supported. The options are as follows:
- **text**: text selector.
- **date**: date selector.
- **time**: time selector.
- **datetime**: date and time selector.
- **multi-text**: multi-column text selector.| -### Text Selector -When **type** is set to **text**, a text selector is used. +### Common Selector +When **type** is set to **text**, a common selector is used. +| Name | Type | Default Value | Mandatory | Description | +| -------- | ------ | ---- | ---- | ---------------------------------------- | +| range | Array | - | No | Value range of the common selector, for example, **["15", "20", "25"]**.
Use the data binding mode, for example, `range = {{data}}`. Declare the corresponding variable `data: ["15", "20", "25"]` in JavaScript.| +| selected | string | 0 | No | Default value of the common selector. The value should be the index of **range**.| +| value | string | - | No | Value of the common selector. | -| Name | Type | Default Value | Mandatory | Description | -| -------- | ------ | ------------- | --------- | ------------------------------------------------------------ | -| range | Array | - | No | Value range of the common selector, for example, **["15", "20", "25"]**.NOTE:Use the data binding mode, for example, range = {{data}}. Declare the corresponding variable **data: ["15", "20", "25"]** in the JavaScript. | -| selected | string | 0 | No | Default value of the common selector. The value should be the index of **range**. | -| value | string | - | No | Value of the common selector. | ### Date Selector When **type** is set to **date**, a date selector is used. +| Name | Type | Default Value | Mandatory | Description | +| ------------------ | ------------ | ---------- | ---- | ---------------------------------------- | +| start | <time> | 1970-1-1 | No | Start date of the date selector, in the format of YYYY-MM-DD. | +| end | <time> | 2100-12-31 | No | End date of the date selector, in the format of YYYY-MM-DD. | +| selected | string | Current date | No | Default value of the date selector, in format of YYYY-MM-DD.| +| value | string | - | Yes | Value of the date selector. | +| lunar5+ | boolean | false | No | Whether the pop-up window displays the lunar calendar. | +| lunarswitch | boolean | false | No | Whether the date selector displays the lunar calendar switch, which is used to switch between the Gregorian calendar and lunar calendar. The value **true** means to display the lunar calendar switch for users to switch between the Gregorian calendar and lunar calendar. The value **false** means not to display the lunar calendar switch.
When both **lunarswitch** and **lunar** are set to **true**, the switch is selected.| -| Name | Type | Default Value | Mandatory | Description | -| ----------- | ------- | ------------- | --------- | ------------------------------------------------------------ | -| start | \