Skip to content

D
Docs

OpenHarmony / Docs
大约 2 年 前同步成功

通知 161
Star 293
Fork 28
D
Docs
提交 b7f455f4 编写于 作者: E ester.zhou
浏览文件
操作

Update docs (19147) 

Signed-off-by: Nester.zhou <ester.zhou@huawei.com>
上级 da44d9ac
展开全部 隐藏空白更改
内联 并排
Showing with 291 addition and 146 deletion
en/application-dev/reference/apis/js-apis-inputmethod.md
浏览文件 @ b7f455f4
...@@ -60,7 +60,7 @@ For details about the error codes, see [Input Method Framework Error Codes](../e ...@@ -60,7 +60,7 @@ For details about the error codes, see [Input Method Framework Error Codes](../e
| Error Code ID| Error Message | | Error Code ID| Error Message |
| -------- | ------------------------------ | | -------- | ------------------------------ |
| 12800006 | Input method controller error. | | 12800006 | input method controller error. |
**Example** **Example**
...@@ -88,7 +88,7 @@ For details about the error codes, see [Input Method Framework Error Codes](../e ...@@ -88,7 +88,7 @@ For details about the error codes, see [Input Method Framework Error Codes](../e
| Error Code ID| Error Message | | Error Code ID| Error Message |
| -------- | -------------------------------------- | | -------- | -------------------------------------- |
| 12800007 | Input method settings extension error. | | 12800007 | input method settings extension error. |
**Example** **Example**
...@@ -119,8 +119,8 @@ For details about the error codes, see [Input Method Framework Error Codes](../e ...@@ -119,8 +119,8 @@ For details about the error codes, see [Input Method Framework Error Codes](../e
| Error Code ID| Error Message | | Error Code ID| Error Message |
| -------- | -------------------------------------- | | -------- | -------------------------------------- |
| 12800005 | Configuration persisting error. | | 12800005 | configuration persisting error. |
| 12800008 | Input method manager service error. | | 12800008 | input method manager service error. |
**Example** **Example**
...@@ -176,8 +176,8 @@ For details about the error codes, see [Input Method Framework Error Codes](../e ...@@ -176,8 +176,8 @@ For details about the error codes, see [Input Method Framework Error Codes](../e
| Error Code ID| Error Message | | Error Code ID| Error Message |
| -------- | -------------------------------------- | | -------- | -------------------------------------- |
| 12800005 | Configuration persisting error. | | 12800005 | configuration persisting error. |
| 12800008 | Input method manager service error. | | 12800008 | input method manager service error. |
**Example** **Example**
...@@ -248,8 +248,8 @@ For details about the error codes, see [Input Method Framework Error Codes](../e ...@@ -248,8 +248,8 @@ For details about the error codes, see [Input Method Framework Error Codes](../e
| Error Code ID| Error Message | | Error Code ID| Error Message |
| -------- | -------------------------------------- | | -------- | -------------------------------------- |
| 12800005 | Configuration persisting error. | | 12800005 | configuration persisting error. |
| 12800008 | Input method manager service error. | | 12800008 | input method manager service error. |
**Example** **Example**
...@@ -309,8 +309,8 @@ For details about the error codes, see [Input Method Framework Error Codes](../e ...@@ -309,8 +309,8 @@ For details about the error codes, see [Input Method Framework Error Codes](../e
| Error Code ID| Error Message | | Error Code ID| Error Message |
| -------- | -------------------------------------- | | -------- | -------------------------------------- |
| 12800005 | Configuration persisting error. | | 12800005 | configuration persisting error. |
| 12800008 | Input method manager service error. | | 12800008 | input method manager service error. |
**Example** **Example**
...@@ -384,8 +384,8 @@ For details about the error codes, see [Input Method Framework Error Codes](../e ...@@ -384,8 +384,8 @@ For details about the error codes, see [Input Method Framework Error Codes](../e
| Error Code ID| Error Message | | Error Code ID| Error Message |
| -------- | -------------------------------------- | | -------- | -------------------------------------- |
| 12800005 | Configuration persisting error. | | 12800005 | configuration persisting error. |
| 12800008 | Input method manager service error. | | 12800008 | input method manager service error. |
**Example** **Example**
...@@ -438,8 +438,8 @@ For details about the error codes, see [Input Method Framework Error Codes](../e ...@@ -438,8 +438,8 @@ For details about the error codes, see [Input Method Framework Error Codes](../e
| Error Code ID| Error Message | | Error Code ID| Error Message |
| -------- | -------------------------------------- | | -------- | -------------------------------------- |
| 12800005 | Configuration persisting error. | | 12800005 | configuration persisting error. |
| 12800008 | Input method manager service error. | | 12800008 | input method manager service error. |
**Example** **Example**
...@@ -447,7 +447,7 @@ For details about the error codes, see [Input Method Framework Error Codes](../e ...@@ -447,7 +447,7 @@ For details about the error codes, see [Input Method Framework Error Codes](../e
let im = inputMethod.getCurrentInputMethod(); let im = inputMethod.getCurrentInputMethod();
let imSubType = inputMethod.getCurrentInputMethodSubtype(); let imSubType = inputMethod.getCurrentInputMethodSubtype();
try { try {
inputMethod.switchCurrentInputMethodAndSubtype(inputMethodProperty, imSubType).then((result) => { inputMethod.switchCurrentInputMethodAndSubtype(im, imSubType).then((result) => {
if (result) { if (result) {
console.info('Succeeded in switching currentInputMethodAndSubtype.'); console.info('Succeeded in switching currentInputMethodAndSubtype.');
} else { } else {
...@@ -533,8 +533,8 @@ For details about the error codes, see [Input Method Framework Error Codes](../e ...@@ -533,8 +533,8 @@ For details about the error codes, see [Input Method Framework Error Codes](../e
| Error Code ID| Error Message | | Error Code ID| Error Message |
| -------- | -------------------------------------- | | -------- | -------------------------------------- |
| 12800003 | Input method client error. | | 12800003 | input method client error. |
| 12800008 | Input method manager service error. | | 12800008 | input method manager service error. |
**Example** **Example**
...@@ -576,8 +576,8 @@ For details about the error codes, see [Input Method Framework Error Codes](../e ...@@ -576,8 +576,8 @@ For details about the error codes, see [Input Method Framework Error Codes](../e
| Error Code ID| Error Message | | Error Code ID| Error Message |
| -------- | -------------------------------------- | | -------- | -------------------------------------- |
| 12800003 | Input method client error. | | 12800003 | input method client error. |
| 12800008 | Input method manager service error. | | 12800008 | input method manager service error. |
**Example** **Example**
...@@ -619,8 +619,8 @@ For details about the error codes, see [Input Method Framework Error Codes](../e ...@@ -619,8 +619,8 @@ For details about the error codes, see [Input Method Framework Error Codes](../e
| Error Code ID| Error Message | | Error Code ID| Error Message |
| -------- | -------------------------------------- | | -------- | -------------------------------------- |
| 12800003 | Input method client error. | | 12800003 | input method client error. |
| 12800008 | Input method manager service error. | | 12800008 | input method manager service error. |
**Example** **Example**
...@@ -656,8 +656,8 @@ For details about the error codes, see [Input Method Framework Error Codes](../e ...@@ -656,8 +656,8 @@ For details about the error codes, see [Input Method Framework Error Codes](../e
| Error Code ID| Error Message | | Error Code ID| Error Message |
| -------- | -------------------------------------- | | -------- | -------------------------------------- |
| 12800003 | Input method client error. | | 12800003 | input method client error. |
| 12800008 | Input method manager service error. | | 12800008 | input method manager service error. |
**Example** **Example**
...@@ -691,8 +691,8 @@ For details about the error codes, see [Input Method Framework Error Codes](../e ...@@ -691,8 +691,8 @@ For details about the error codes, see [Input Method Framework Error Codes](../e
| Error Code ID| Error Message | | Error Code ID| Error Message |
| -------- | -------------------------------------- | | -------- | -------------------------------------- |
| 12800003 | Input method client error. | | 12800003 | input method client error. |
| 12800008 | Input method manager service error. | | 12800008 | input method manager service error. |
**Example** **Example**
...@@ -728,8 +728,8 @@ For details about the error codes, see [Input Method Framework Error Codes](../e ...@@ -728,8 +728,8 @@ For details about the error codes, see [Input Method Framework Error Codes](../e
| Error Code ID| Error Message | | Error Code ID| Error Message |
| -------- | -------------------------------------- | | -------- | -------------------------------------- |
| 12800003 | Input method client error. | | 12800003 | input method client error. |
| 12800008 | Input method manager service error. | | 12800008 | input method manager service error. |
**Example** **Example**
...@@ -876,8 +876,8 @@ For details about the error codes, see [Input Method Framework Error Codes](../e ...@@ -876,8 +876,8 @@ For details about the error codes, see [Input Method Framework Error Codes](../e
| Error Code ID| Error Message | | Error Code ID| Error Message |
| -------- | -------------------------------------- | | -------- | -------------------------------------- |
| 12800001 | Package manager error. | | 12800001 | package manager error. |
| 12800008 | Input method manager service error. | | 12800008 | input method manager service error. |
**Example** **Example**
...@@ -928,8 +928,8 @@ For details about the error codes, see [Input Method Framework Error Codes](../e ...@@ -928,8 +928,8 @@ For details about the error codes, see [Input Method Framework Error Codes](../e
| Error Code ID| Error Message | | Error Code ID| Error Message |
| -------- | -------------------------------------- | | -------- | -------------------------------------- |
| 12800001 | Package manager error. | | 12800001 | package manager error. |
| 12800008 | Input method manager service error. | | 12800008 | input method manager service error. |
**Example** **Example**
...@@ -972,8 +972,8 @@ For details about the error codes, see [Input Method Framework Error Codes](../e ...@@ -972,8 +972,8 @@ For details about the error codes, see [Input Method Framework Error Codes](../e
| Error Code ID| Error Message | | Error Code ID| Error Message |
| -------- | -------------------------------------- | | -------- | -------------------------------------- |
| 12800001 | Package manager error. | | 12800001 | package manager error. |
| 12800008 | Input method manager service error. | | 12800008 | input method manager service error. |
**Example** **Example**
...@@ -1011,8 +1011,8 @@ For details about the error codes, see [Input Method Framework Error Codes](../e ...@@ -1011,8 +1011,8 @@ For details about the error codes, see [Input Method Framework Error Codes](../e
| Error Code ID| Error Message | | Error Code ID| Error Message |
| -------- | -------------------------------------- | | -------- | -------------------------------------- |
| 12800001 | Package manager error. | | 12800001 | package manager error. |
| 12800008 | Input method manager service error. | | 12800008 | input method manager service error. |
**Example** **Example**
...@@ -1049,8 +1049,8 @@ For details about the error codes, see [Input Method Framework Error Codes](../e ...@@ -1049,8 +1049,8 @@ For details about the error codes, see [Input Method Framework Error Codes](../e
| Error Code ID| Error Message | | Error Code ID| Error Message |
| -------- | -------------------------------------- | | -------- | -------------------------------------- |
| 12800001 | Package manager error. | | 12800001 | package manager error. |
| 12800008 | Input method manager service error. | | 12800008 | input method manager service error. |
**Example** **Example**
...@@ -1088,8 +1088,8 @@ For details about the error codes, see [Input Method Framework Error Codes](../e ...@@ -1088,8 +1088,8 @@ For details about the error codes, see [Input Method Framework Error Codes](../e
| Error Code ID| Error Message | | Error Code ID| Error Message |
| -------- | -------------------------------------- | | -------- | -------------------------------------- |
| 12800001 | Package manager error. | | 12800001 | package manager error. |
| 12800008 | Input method manager service error. | | 12800008 | input method manager service error. |
**Return value** **Return value**
...@@ -1131,7 +1131,7 @@ For details about the error codes, see [Input Method Framework Error Codes](../e ...@@ -1131,7 +1131,7 @@ For details about the error codes, see [Input Method Framework Error Codes](../e
| Error Code ID| Error Message | | Error Code ID| Error Message |
| -------- | -------------------------------------- | | -------- | -------------------------------------- |
| 12800008 | Input method manager service error. | | 12800008 | input method manager service error. |
**Example** **Example**
...@@ -1169,7 +1169,7 @@ For details about the error codes, see [Input Method Framework Error Codes](../e ...@@ -1169,7 +1169,7 @@ For details about the error codes, see [Input Method Framework Error Codes](../e
| Error Code ID| Error Message | | Error Code ID| Error Message |
| -------- | -------------------------------------- | | -------- | -------------------------------------- |
| 12800008 | Input method manager service error. | | 12800008 | input method manager service error. |
**Example** **Example**
......
en/application-dev/reference/arkui-ts/ts-basic-components-blank.md
浏览文件 @ b7f455f4
# Blank # Blank
The **\<Blank>** component is able to automatically fill the empty spaces in the container along the main axis. It is valid only when the parent container is **\<Row>** or **\<Column>**. The **\<Blank>** component is able to automatically fill the empty spaces in the container along the main axis. It works only when the parent component is **\<Row>**, **\<Column>**, or **\<Flex>**.
> **NOTE** > **NOTE**
> >
...@@ -30,7 +30,7 @@ In addition to the [universal attributes](ts-universal-attributes-size.md), the ...@@ -30,7 +30,7 @@ In addition to the [universal attributes](ts-universal-attributes-size.md), the
| Name| Type| Description| | Name| Type| Description|
| -------- | -------- | -------- | | -------- | -------- | -------- |
| color | [ResourceColor](ts-types.md#resourcecolor) | Color to fill the empty spaces.<br>Default value: **Color.Transparent**<br>Since API version 9, this API is supported in ArkTS widgets. | | color | [ResourceColor](ts-types.md#resourcecolor) | Color to fill the empty spaces.<br>Default value: **Color.Transparent**<br>Since API version 9, this API is supported in ArkTS widgets.|
## Events ## Events
...@@ -50,7 +50,7 @@ struct BlankExample { ...@@ -50,7 +50,7 @@ struct BlankExample {
Row() { Row() {
Text('Bluetooth').fontSize(18) Text('Bluetooth').fontSize(18)
Blank() Blank()
Toggle({ type: ToggleType.Switch }) Toggle({ type: ToggleType.Switch }).margin({ top: 14, bottom: 14, left: 6, right: 6 })
}.width('100%').backgroundColor(0xFFFFFF).borderRadius(15).padding({ left: 12 }) }.width('100%').backgroundColor(0xFFFFFF).borderRadius(15).padding({ left: 12 })
}.backgroundColor(0xEFEFEF).padding(20) }.backgroundColor(0xEFEFEF).padding(20)
} }
...@@ -80,16 +80,16 @@ struct BlankExample { ...@@ -80,16 +80,16 @@ struct BlankExample {
Row() { Row() {
Text('Bluetooth').fontSize(18) Text('Bluetooth').fontSize(18)
Blank().color(Color.Yellow) Blank().color(Color.Yellow)
Toggle({ type: ToggleType.Switch }) Toggle({ type: ToggleType.Switch }).margin({ top: 14, bottom: 14, left: 6, right: 6 })
}.backgroundColor(0xFFFFFF).borderRadius(15).padding({ left: 12 }) }.backgroundColor(0xFFFFFF).borderRadius(15).padding({ left: 12 })
Row() { Row() {
Text('Bluetooth').fontSize(18) Text('Bluetooth').fontSize(18)
// Set the minimum width to 160. // Set the minimum width to 160.
Blank('160').color(Color.Yellow) Blank('160').color(Color.Yellow)
Toggle({ type: ToggleType.Switch }) Toggle({ type: ToggleType.Switch }).margin({ top: 14, bottom: 14, left: 6, right: 6 })
}.backgroundColor(0xFFFFFF).borderRadius(15).padding({ left: 12 }) }.backgroundColor(0xFFFFFF).borderRadius(15).padding({ left: 12 })
}.backgroundColor(0xEFEFEF).padding(20).width('100%') }.backgroundColor(0xEFEFEF).padding(20).width('100%')
} }
} }
......
en/application-dev/reference/arkui-ts/ts-basic-components-image.md
浏览文件 @ b7f455f4
...@@ -29,7 +29,7 @@ Since API version 9, this API is supported in ArkTS widgets. ...@@ -29,7 +29,7 @@ Since API version 9, this API is supported in ArkTS widgets.
| Name | Type | Mandatory | Description | | Name | Type | Mandatory | Description |
| ---- | ---------------------------------------- | ---- | ---------------------------------------- | | ---- | ---------------------------------------- | ---- | ---------------------------------------- |
| src | [PixelMap](../apis/js-apis-image.md#pixelmap7) \| [Resource](ts-types.md#resource) | Yes | Image source. Both local and online images are supported.<br>When using an image referenced using a relative path, for example, **Image("common/test.jpg")**, the **\<Image>** component cannot be called across bundles or modules. Therefore, you are advised to use **\$r** to reference image resources that need to be used globally.<br>- The following image formats are supported: PNG, JPG, BMP, SVG, GIF.<br>\- Base64 strings are supported. The value format is data:image/[png\|jpeg\|bmp\|webp];base64,[base64 data], where [base64 data] is a Base64 string.<br/>\- Strings with the **datashare://** path prefix are supported, which are used to access the image path provided by a Data ability.<br/>\- Strings with the **file:///data/storage** prefix are supported, which are used to read image resources in the **files** folder in the installation directory of the application. Ensure that the application has the read permission to the files in the specified path.<br/>**NOTE**<br/>- ArkTS widgets support GIF images, but the images are played only once when they are displayed.<br/>- ArkTS widgets do not support the **http://**, **datashare://**, or **file://data/storage** path prefixes.<br>- ArkTS widgets do not support the [PixelMap](../apis/js-apis-image.md#pixelmap7) type. | | src | string \| [PixelMap](../apis/js-apis-image.md#pixelmap7) \| [Resource](ts-types.md#resource) | Yes | Image source. Both local and online images are supported.<br>When using an image referenced using a relative path, for example, **Image("common/test.jpg")**, the **\<Image>** component cannot be called across bundles or modules. Therefore, you are advised to use **\$r** to reference image resources that need to be used globally.<br>- The following image formats are supported: PNG, JPG, BMP, SVG, GIF.<br>\- Base64 strings are supported. The value format is data:image/[png\|jpeg\|bmp\|webp];base64,[base64 data], where [base64 data] is a Base64 string.<br/>\- Strings with the **datashare://** prefix are supported, which are used to access the image path provided by a Data ability.<br/>\- Strings with the **file:///data/storage** prefix are supported, which are used to read image resources in the **files** folder in the installation directory of the current application. Ensure that the application has the read permission to the files in the specified path.<br/>**NOTE**<br/>- ArkTS widgets support GIF animations, but the animations only play once on display.<br/>- ArkTS widgets do not support the strings with the **http://**, **datashare://**, or **file:///data/storage** prefix.<br>- ArkTS widgets do not support the [PixelMap](../apis/js-apis-image.md#pixelmap7) type. |
## Attributes ## Attributes
...@@ -55,7 +55,7 @@ In addition to the [universal attributes](ts-universal-attributes-size.md), the ...@@ -55,7 +55,7 @@ In addition to the [universal attributes](ts-universal-attributes-size.md), the
> >
> To use shortcut keys to copy the image, the image must be in focus. To enable the image to gain focus, set both the **focusable** and **focusOnTouch** attributes to **true**. > To use shortcut keys to copy the image, the image must be in focus. To enable the image to gain focus, set both the **focusable** and **focusOnTouch** attributes to **true**.
> >
> For SVG images, only the following tags are included in the supported list: **svg**, **rect**, **circle**, **ellipse**, **path**, **line**, **polyline**, **polygon**, and **animate**. > For SVG images, only the following tags are included in the supported list: **svg**, **rect**, **circle**, **ellipse**, **path**, **line**, **polyline**, and **polygon**.
### ImageInterpolation ### ImageInterpolation
...@@ -224,7 +224,7 @@ struct Index { ...@@ -224,7 +224,7 @@ struct Index {
``` ```
> **NOTE** > **NOTE**
> >
> For details about the request mode, timeout, and additional request parameters for loading online images, see [request()](../../reference/apis/js-apis-http.md) in the HTTP module. > For details about the request mode, timeout, and additional request parameters for loading online images, see [request()](../../reference/apis/js-apis-http.md) in the HTTP module.
### Setting Attributes ### Setting Attributes
...@@ -415,4 +415,86 @@ struct LoadImageExample { ...@@ -415,4 +415,86 @@ struct LoadImageExample {
} }
} }
``` ```
<!--no_check-->
\ No newline at end of file ### Applying a Filter to an Image
```ts
// xxx.ets
@Entry
@Component
struct colorFilterExample {
@State colorFilterR: number = 0
@State colorFilterG: number = 0
@State colorFilterB: number = 0
@State colorFilterA: number = 0
build() {
Row() {
Column() {
Image($r('app.media.sky'))
.width(200)
.height(200)
Image($r('app.media.sky'))
.width(200)
.height(200)
.colorFilter([
this.colorFilterR, 0, this.colorFilterR, 0, 0,
0, this.colorFilterG, this.colorFilterG, 0, 0,
this.colorFilterB, 0, this.colorFilterB, 0, 0,
0, 0, this.colorFilterA, 0, 0
])
Row() {
Text('R')
Slider({
min: 0,
max: 1,
step: 0.01
})
.onChange((valueR) => {
this.colorFilterR = valueR
})
}
Row() {
Text('G')
Slider({
min: 0,
max: 1,
step: 0.01
})
.onChange((valueG) => {
this.colorFilterG = valueG
})
}
Row() {
Text('B')
Slider({
min: 0,
max: 1,
step: 0.01
})
.onChange((valueB) => {
this.colorFilterB = valueB
})
}
Row() {
Text('A')
Slider({
min: 0,
max: 1,
step: 0.01
})
.onChange((valueA) => {
this.colorFilterA = valueA
})
}
}.width('90%').alignItems(HorizontalAlign.Center)
}.height('100%').width('100%').justifyContent(FlexAlign.Center)
}
}
```
![colorFilter](figures/colorFilter.gif)
en/application-dev/reference/arkui-ts/ts-basic-components-qrcode.md
浏览文件 @ b7f455f4
...@@ -22,7 +22,7 @@ Since API version 9, this API is supported in ArkTS widgets. ...@@ -22,7 +22,7 @@ Since API version 9, this API is supported in ArkTS widgets.
| Name| Type| Mandatory| Description| | Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| value | string | Yes| Content of the QR code.| | value | string | Yes| Content of the QR code. A maximum of 256 characters are supported. If the number of characters exceeds 256, the first 256 characters are used.<br>**NOTE**<br>The string cannot be **null**, **undefined**, or empty.|
## Attributes ## Attributes
......
en/application-dev/reference/arkui-ts/ts-basic-components-search.md
浏览文件 @ b7f455f4
...@@ -18,8 +18,8 @@ Search(options?: { value?: string; placeholder?: string; icon?: string; controll ...@@ -18,8 +18,8 @@ Search(options?: { value?: string; placeholder?: string; icon?: string; controll
| Name | Type | Mandatory| Description | | Name | Type | Mandatory| Description |
| ----------- | ---------------------------------------------------- | ---- | ------------------------------------------------------------ | | ----------- | ---------------------------------------------------- | ---- | ------------------------------------------------------------ |
| value | string | No | Text input in the search text box.<br>Since API version 10, this parameter supports two-way binding through [$$](../../quick-start/arkts-two-way-sync.md).| | value | string | No | Text input in the search text box. |
| icon | string | No | Path to the search icon. By default, the system search icon is used.<br>For details about the supported image types, see [Image](ts-basic-components-image.md).| | icon | string | No | Path to the search icon. By default, the system search icon is used.<br>**NOTE**<br>The icon data source can be a local or online image.<br>- The supported formats include PNG, JPG, BMP, SVG, GIF, and pixelmap.<br>- The Base64 string is supported in the following format: data:image/[png\|jpeg\|bmp\|webp];base64,[base64 data], where [base64 data] is a Base64 string.|
| controller | SearchController | No | Controller of the **\<Search>** component. | | controller | SearchController | No | Controller of the **\<Search>** component. |
## Attributes ## Attributes
......
en/application-dev/reference/arkui-ts/ts-basic-components-slider.md
浏览文件 @ b7f455f4
...@@ -22,7 +22,7 @@ Since API version 9, this API is supported in ArkTS widgets. ...@@ -22,7 +22,7 @@ Since API version 9, this API is supported in ArkTS widgets.
| Name| Type| Mandatory| Description| | Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| value | number | No| Current progress.<br>Default value: **0**| | value | number | No| Current progress.<br>Default value: min|
| min | number | No| Minimum value.<br>Default value: **0**| | min | number | No| Minimum value.<br>Default value: **0**|
| max | number | No| Maximum value.<br>Default value: **100**<br>**NOTE**<br>If the value of **min** is greater than or equal to the value of **max**, the default value **0** is used for **min** and the default value **100** is used for **max**.<br>If the value is not within the [min, max] range, the value of **min** or **max**, whichever is closer.| | max | number | No| Maximum value.<br>Default value: **100**<br>**NOTE**<br>If the value of **min** is greater than or equal to the value of **max**, the default value **0** is used for **min** and the default value **100** is used for **max**.<br>If the value is not within the [min, max] range, the value of **min** or **max**, whichever is closer.|
| step | number | No| Step of the slider.<br>Default value: **1**<br>Value range: [0.01, max]<br>**NOTE**<br>If this parameter is set to a value less than 0 or a percentage, the default value is used.| | step | number | No| Step of the slider.<br>Default value: **1**<br>Value range: [0.01, max]<br>**NOTE**<br>If this parameter is set to a value less than 0 or a percentage, the default value is used.|
...@@ -48,7 +48,7 @@ Except touch target attributes, the universal attributes are supported. ...@@ -48,7 +48,7 @@ Except touch target attributes, the universal attributes are supported.
| selectedColor | [ResourceColor](ts-types.md#resourcecolor) | Color of the selected part of the slider track.<br>Since API version 9, this API is supported in ArkTS widgets.| | selectedColor | [ResourceColor](ts-types.md#resourcecolor) | Color of the selected part of the slider track.<br>Since API version 9, this API is supported in ArkTS widgets.|
| showSteps | boolean | Whether to display the current step.<br>Default value: **false**<br>Since API version 9, this API is supported in ArkTS widgets.| | showSteps | boolean | Whether to display the current step.<br>Default value: **false**<br>Since API version 9, this API is supported in ArkTS widgets.|
| showTips | boolean | Whether to display a bubble to indicate the percentage when the user drags the slider.<br>Default value: **false**<br>Since API version 9, this API is supported in ArkTS widgets.<br>**NOTE**<br>When **direction** is set to **Axis.Horizontal**, the bubble is displayed right above the slider. When **direction** is set to **Axis.Vertical**, the bubble is displayed on the left of the slider.<br>The drawing area of the bubble is the overlay of the slider.<br>If no margin is set for the slider or the margin is not large enough, the bubble will be clipped.| | showTips | boolean | Whether to display a bubble to indicate the percentage when the user drags the slider.<br>Default value: **false**<br>Since API version 9, this API is supported in ArkTS widgets.<br>**NOTE**<br>When **direction** is set to **Axis.Horizontal**, the bubble is displayed right above the slider. When **direction** is set to **Axis.Vertical**, the bubble is displayed on the left of the slider.<br>The drawing area of the bubble is the overlay of the slider.<br>If no margin is set for the slider or the margin is not large enough, the bubble will be clipped.|
| trackThickness | [Length](ts-types.md#length) | Track thickness of the slider.<br>Since API version 9, this API is supported in ArkTS widgets.| | trackThickness | [Length](ts-types.md#length) | Track thickness of the slider.<br>Default value: **4.0vp** when **style** is set to **[SliderStyle](#sliderstyle).OutSet**; **20.0vp** when **style** is set to **[SliderStyle](#sliderstyle).InSet**<br>Since API version 9, this API is supported in ArkTS widgets.<br>**NOTE**<br>A value less than 0 evaluates to the default value.|
## Events ## Events
......
en/application-dev/reference/arkui-ts/ts-basic-components-stepperitem.md
浏览文件 @ b7f455f4
...@@ -24,7 +24,7 @@ StepperItem() ...@@ -24,7 +24,7 @@ StepperItem()
| -------- | -------- | -------- | | -------- | -------- | -------- |
| prevLabel | string | Text label of the button on the left, which is not displayed on the first page. When the **\<Stepper>** contains more than one page, the default value for all pages except the first page is **Back**.| | prevLabel | string | Text label of the button on the left, which is not displayed on the first page. When the **\<Stepper>** contains more than one page, the default value for all pages except the first page is **Back**.|
| nextLabel | string | Text label of the button on the right. The default value is **Start** for the last page and **Next** for the other pages.| | nextLabel | string | Text label of the button on the right. The default value is **Start** for the last page and **Next** for the other pages.|
| status | ItemState | Display status of **nextLabel** in the stepper.<br>Default value: **ItemState.Normal**| | status | [ItemState](#itemstate) | Display status of **nextLabel** in the stepper. Optional.<br>Default value: **ItemState.Normal**|
## ItemState ## ItemState
......
en/application-dev/reference/arkui-ts/ts-basic-components-text.md
浏览文件 @ b7f455f4
...@@ -30,7 +30,7 @@ In addition to the [universal attributes](ts-universal-attributes-size.md), the ...@@ -30,7 +30,7 @@ In addition to the [universal attributes](ts-universal-attributes-size.md), the
| Name | Type | Description | | Name | Type | Description |
| ----------------------- | ----------------------------------- | ------------------------------------------- | | ----------------------- | ----------------------------------- | ------------------------------------------- |
| textAlign | [TextAlign](ts-appendix-enums.md#textalign) | Horizontal alignment mode of the text.<br>Default value: **TextAlign.Start**<br>**NOTE**<br>The text takes up the full width of the **\<Text>** component. To set the vertical alignment for the text, use the [align](ts-universal-attributes-location.md) attribute.<br>Since API version 9, this API is supported in ArkTS widgets.| | textAlign | [TextAlign](ts-appendix-enums.md#textalign) | Horizontal alignment mode of the text.<br>Default value: **TextAlign.Start**<br>**NOTE**<br>The text takes up the full width of the **\<Text>** component. To set vertical alignment for the text, use the [align](ts-universal-attributes-location.md) attribute. The **align** attribute alone does not control the horizontal position of the text. In other words, **Alignment.TopStart**, **Alignment.Top**, and **Alignment.TopEnd** produce the same effect, top-aligning the text; **Alignment.Start**, **Alignment.Center**, and **Alignment.End** produce the same effect, centered-aligning the text vertically; **Alignment.BottomStart**, **Alignment.Bottom**, and **Alignment.BottomEnd** produce the same effect, bottom-aligning the text. Yet, it can work with the **textAlign** attribute to jointly determine the horizontal position of the text.<br>Since API version 9, this API is supported in ArkTS widgets.|
| textOverflow | {overflow: [TextOverflow](ts-appendix-enums.md#textoverflow)} | Display mode when the text is too long.<br>Default value: **{overflow: TextOverflow.Clip}**<br>**NOTE**<br/>Text is clipped at the transition between words. To clip text in the middle of a word, add **\u200B** between characters.<br>This attribute must be used with `maxLines` to take effect.<br>Since API version 9, this API is supported in ArkTS widgets.| | textOverflow | {overflow: [TextOverflow](ts-appendix-enums.md#textoverflow)} | Display mode when the text is too long.<br>Default value: **{overflow: TextOverflow.Clip}**<br>**NOTE**<br/>Text is clipped at the transition between words. To clip text in the middle of a word, add **\u200B** between characters.<br>This attribute must be used with `maxLines` to take effect.<br>Since API version 9, this API is supported in ArkTS widgets.|
| maxLines | number | Maximum number of lines in the text.<br>Default value: **Infinity**<br>**NOTE**<br/>By default, text is automatically folded. If this attribute is specified, the text will not exceed the specified number of lines. If there is extra text, you can use **textOverflow** to specify how it is displayed.<br>Since API version 9, this API is supported in ArkTS widgets.| | maxLines | number | Maximum number of lines in the text.<br>Default value: **Infinity**<br>**NOTE**<br/>By default, text is automatically folded. If this attribute is specified, the text will not exceed the specified number of lines. If there is extra text, you can use **textOverflow** to specify how it is displayed.<br>Since API version 9, this API is supported in ArkTS widgets.|
| lineHeight | string \| number \| [Resource](ts-types.md#resource) | Text line height. If the value is less than or equal to **0**, the line height is not limited and the font size is adaptive. If the value of the number type, the unit fp is used.<br>Since API version 9, this API is supported in ArkTS widgets.| | lineHeight | string \| number \| [Resource](ts-types.md#resource) | Text line height. If the value is less than or equal to **0**, the line height is not limited and the font size is adaptive. If the value of the number type, the unit fp is used.<br>Since API version 9, this API is supported in ArkTS widgets.|
...@@ -109,7 +109,7 @@ struct TextExample1 { ...@@ -109,7 +109,7 @@ struct TextExample1 {
Text('TextOverflow+maxLines').fontSize(9).fontColor(0xCCCCCC) Text('TextOverflow+maxLines').fontSize(9).fontColor(0xCCCCCC)
// Clip the text when the value of maxLines is exceeded. // Clip the text when the value of maxLines is exceeded.
Text('This is the setting of textOverflow to Clip text content This is the setting of textOverflow to None text content. This is the setting of textOverflow to Clip text content This is the setting of textOverflow to None text content.') Text('This is the setting of textOverflow to Clip text content This is the setting of textOverflow to None text content. This is the setting of textOverflow to Clip text content This is the setting of textOverflow to None text content.')
.textOverflow({ overflow: TextOverflow.None }) .textOverflow({ overflow: TextOverflow.Clip })
.maxLines(1) .maxLines(1)
.fontSize(12) .fontSize(12)
.border({ width: 1 }) .border({ width: 1 })
......
en/application-dev/reference/arkui-ts/ts-basic-components-toggle.md
浏览文件 @ b7f455f4
...@@ -31,9 +31,9 @@ Since API version 9, this API is supported in ArkTS widgets. ...@@ -31,9 +31,9 @@ Since API version 9, this API is supported in ArkTS widgets.
| Name | Description | | Name | Description |
| -------- | ---------------- | | -------- | ---------------- |
| Checkbox | Check box type.<br>**NOTE**<br>The default value of the universal attribute [margin](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> } | | Checkbox | Check box type.<br>**NOTE**<br>The default value of the universal attribute [margin](ts-universal-attributes-size.md) is as follows:<br>{<br> top: 12 px,<br> right: 12 px,<br> bottom: 12 px,<br> left: 12 px<br> } |
| Button | Button type. The set string, if any, will be displayed inside the button. | | 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 [margin](ts-universal-attributes-size.md) is as follows:<br>{<br> top: 14 vp,<br> right:6 vp,<br> bottom: 6 vp,<br> left: 14 vp<br> } | | Switch | Switch type.<br>**NOTE**<br>The default value of the universal attribute [margin](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> } |
## Attributes ## Attributes
......
en/application-dev/reference/arkui-ts/ts-container-waterflow.md
浏览文件 @ b7f455f4
...@@ -14,6 +14,9 @@ The **\<WaterFlow>** component is a container that consists of cells formed by r ...@@ -14,6 +14,9 @@ The **\<WaterFlow>** component is a container that consists of cells formed by r
The [\<FlowItem>](ts-container-flowitem.md) child component is supported. The [\<FlowItem>](ts-container-flowitem.md) child component is supported.
> **NOTE**
>
> When the **visibility** attribute of a child component in **\<WaterFlow >** is set to **None**, the child component is not displayed, but still takes up cells.
## APIs ## APIs
...@@ -257,9 +260,11 @@ struct WaterflowDemo { ...@@ -257,9 +260,11 @@ struct WaterflowDemo {
Text("N" + item).fontSize(12).height('16') Text("N" + item).fontSize(12).height('16')
Image('res/waterFlowTest(' + item % 5 + ').jpg') Image('res/waterFlowTest(' + item % 5 + ').jpg')
.objectFit(ImageFit.Fill) .objectFit(ImageFit.Fill)
.width('100%')
.layoutWeight(1)
} }
} }
.width(this.itemWidthArray[item]) .width('100%')
.height(this.itemHeightArray[item]) .height(this.itemHeightArray[item])
.backgroundColor(this.colors[item % 5]) .backgroundColor(this.colors[item % 5])
}, item => item) }, item => item)
......
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或