diff --git a/en/application-dev/reference/apis/js-apis-system-sensor.md b/en/application-dev/reference/apis/js-apis-system-sensor.md index a551dea9a8f79c5d153649ce69dc912f93ddd4b6..7df5f6675bb53168935ada36ca1d0675e49da978 100644 --- a/en/application-dev/reference/apis/js-apis-system-sensor.md +++ b/en/application-dev/reference/apis/js-apis-system-sensor.md @@ -21,9 +21,9 @@ import sensor from '@system.sensor'; ## Error Codes -| Error Code | Description | -| ---- | -------------- | -| 900 | The current device does not support the corresponding sensor.| +| Error Code | Description | +| ---------- | ---------------------------------------- | +| 900 | The current device does not support the corresponding sensor. | ## sensor.subscribeAccelerometer @@ -37,19 +37,19 @@ Subscribes to data changes of the acceleration sensor. If this API is called mul **Parameters** -| Name | Type | Mandatory | Description | -| -------- | -------- | ---- | ---------------------------------------- | -| interval | string | Yes | Execution frequency of the callback for returning the acceleration sensor data.The default value is **normal**. The options are as follows:- **game**: called at an interval of 20 ms, which is applicable to gaming scenarios.- **ui**: called at an interval of 60 ms, which is applicable to UI updating scenarios.- **normal**: called at an interval of 200 ms, which is applicable to power-saving scenarios.| -| success | Function | Yes | Called when the acceleration sensor data changes. | -| fail | Function | No | Callback upon failure. | +| Name | Type | Mandatory | Description | +| -------- | -------- | --------- | ---------------------------------------- | +| interval | string | Yes | Execution frequency of the callback for returning the acceleration sensor data.The default value is **normal**. The options are as follows:- **game**: called at an interval of 20 ms, which is applicable to gaming scenarios.- **ui**: called at an interval of 60 ms, which is applicable to UI updating scenarios.- **normal**: called at an interval of 200 ms, which is applicable to power-saving scenarios. | +| success | Function | Yes | Called when the acceleration sensor data changes. | +| fail | Function | No | Callback upon failure. | Return values of the success callback -| Name | Type | Description | -| ---- | ------ | ------- | -| x | number | Acceleration on the x-axis.| -| y | number | Acceleration on the y-axis.| -| z | number | Acceleration on the z-axis.| +| Name | Type | Description | +| ---- | ------ | --------------------------- | +| x | number | Acceleration on the x-axis. | +| y | number | Acceleration on the y-axis. | +| z | number | Acceleration on the z-axis. | **Example** @@ -97,16 +97,16 @@ Subscribes to data changes of the compass sensor. If this API is called multiple **Parameters** -| Name | Type | Mandatory | Description | -| ------- | -------- | ---- | --------------- | -| success | Function | Yes | Called when the compass sensor data changes.| -| fail | Function | No | Callback upon failure. | +| Name | Type | Mandatory | Description | +| ------- | -------- | --------- | ---------------------------------------- | +| success | Function | Yes | Called when the compass sensor data changes. | +| fail | Function | No | Callback upon failure. | Return values of the success callback -| Name | Type | Description | -| --------- | ------ | ---------- | -| direction | number | Direction of the device, in degrees.| +| Name | Type | Description | +| --------- | ------ | ------------------------------------ | +| direction | number | Direction of the device, in degrees. | **Example** @@ -149,16 +149,16 @@ Subscribes to data changes of the proximity sensor. If this API is called multip **Parameters** -| Name | Type | Mandatory | Description | -| ------- | -------- | ---- | ----------------- | -| success | Function | Yes | Called when the proximity sensor data changes.| -| fail | Function | No | Callback upon failure. | +| Name | Type | Mandatory | Description | +| ------- | -------- | --------- | ---------------------------------------- | +| success | Function | Yes | Called when the proximity sensor data changes. | +| fail | Function | No | Callback upon failure. | Return values of the success callback -| Name | Type | Description | -| -------- | ------ | --------------------- | -| distance | number | Distance between a visible object and the device screen.| +| Name | Type | Description | +| -------- | ------ | ---------------------------------------- | +| distance | number | Distance between a visible object and the device screen. | **Example** @@ -201,16 +201,16 @@ Subscribes to data changes of the ambient light sensor. If this API is called mu **Parameters** -| Name | Type | Mandatory | Description | -| ------- | -------- | ---- | --------------- | -| success | Function | Yes | Called when the ambient light sensor data changes| -| fail | Function | No | Callback upon failure. | +| Name | Type | Mandatory | Description | +| ------- | -------- | --------- | ---------------------------------------- | +| success | Function | Yes | Called when the ambient light sensor data changes | +| fail | Function | No | Callback upon failure. | Return values of the success callback -| Name | Type | Description | -| --------- | ------ | ------------ | -| intensity | number | Light intensity, in lux.| +| Name | Type | Description | +| --------- | ------ | ------------------------ | +| intensity | number | Light intensity, in lux. | **Example** @@ -255,16 +255,16 @@ Subscribes to data changes of the step counter sensor. If this API is called mul **Parameters** -| Name | Type | Mandatory | Description | -| ------- | -------- | ---- | ---------------- | -| success | Function | Yes | Called when the step counter sensor data changes.| -| fail | Function | No | Callback upon failure. | +| Name | Type | Mandatory | Description | +| ------- | -------- | --------- | ---------------------------------------- | +| success | Function | Yes | Called when the step counter sensor data changes. | +| fail | Function | No | Callback upon failure. | Return values of the success callback -| Name | Type | Description | -| ----- | ------ | --------------------- | -| steps | number | Number of counted steps after the sensor is restarted.| +| Name | Type | Description | +| ----- | ------ | ---------------------------------------- | +| steps | number | Number of counted steps after the sensor is restarted. | **Example** @@ -302,7 +302,7 @@ sensor.unsubscribeStepCounter(); ## sensor.subscribeBarometer -subcribeBarometer(Object): void +subscribeBarometer(Object): void Subscribes to data changes of the barometer sensor. If this API is called multiple times for the same application, the last call takes effect. @@ -310,16 +310,16 @@ Subscribes to data changes of the barometer sensor. If this API is called multip **Parameters** -| Name | Type | Mandatory | Description | -| ------- | -------- | ---- | ---------------- | -| success | Function | Yes | Called when the barometer sensor data changes.| -| fail | Function | No | Callback upon failure. | +| Name | Type | Mandatory | Description | +| ------- | -------- | --------- | ---------------------------------------- | +| success | Function | Yes | Called when the barometer sensor data changes. | +| fail | Function | No | Callback upon failure. | Return values of the success callback -| Name | Type | Description | -| -------- | ------ | ----------- | -| pressure | number | Pressure, in pascal.| +| Name | Type | Description | +| -------- | ------ | -------------------- | +| pressure | number | Pressure, in pascal. | **Example** @@ -366,16 +366,16 @@ Subscribes to data changes of the heart rate sensor. If this API is called multi **Parameters** -| Name | Type | Mandatory | Description | -| ------- | -------- | ---- | ------------------------- | -| success | Function | Yes | Called when the heart rate sensor data changes. This callback is invoked every five seconds.| -| fail | Function | No | Callback upon failure. | +| Name | Type | Mandatory | Description | +| ------- | -------- | --------- | ---------------------------------------- | +| success | Function | Yes | Called when the heart rate sensor data changes. This callback is invoked every five seconds. | +| fail | Function | No | Callback upon failure. | Return values of the success callback -| Name | Type | Description | -| --------- | ------ | ---- | -| heartRate | number | Heart rate.| +| Name | Type | Description | +| --------- | ------ | ----------- | +| heartRate | number | Heart rate. | **Example** @@ -421,16 +421,16 @@ Subscribes to changes of the wearing state of a wearable device. If this API is **Parameters** -| Name | Type | Mandatory | Description | -| ------- | -------- | ---- | ------------- | -| success | Function | Yes | Called when the wearing state changes.| -| fail | Function | No | Callback upon failure. | +| Name | Type | Mandatory | Description | +| ------- | -------- | --------- | -------------------------------------- | +| success | Function | Yes | Called when the wearing state changes. | +| fail | Function | No | Callback upon failure. | Return values of the success callback -| Name | Type | Description | -| ----- | ------- | ------ | -| value | boolean | Whether the wearable device is worn.| +| Name | Type | Description | +| ----- | ------- | ------------------------------------ | +| value | boolean | Whether the wearable device is worn. | **Example** @@ -473,17 +473,17 @@ Obtains the wearing state of a wearable device. **Parameters** -| Name | Type | Mandatory | Description | -| -------- | -------- | ---- | ------------ | -| success | Function | No | Callback upon success.| -| fail | Function | No | Callback upon failure.| -| complete | Function | No | Called when the execution is complete.| +| Name | Type | Mandatory | Description | +| -------- | -------- | --------- | -------------------------------------- | +| success | Function | No | Callback upon success. | +| fail | Function | No | Callback upon failure. | +| complete | Function | No | Called when the execution is complete. | Return values of the success callback -| Name | Type | Description | -| ----- | ------- | ------ | -| value | boolean | Whether the wearable device is worn.| +| Name | Type | Description | +| ----- | ------- | ------------------------------------ | +| value | boolean | Whether the wearable device is worn. | **Example** @@ -510,18 +510,18 @@ If this API is called multiple times for the same application, the last call tak **Parameters** -| Name | Type | Mandatory | Description | -| -------- | -------- | ---- | ---------------------------------------- | -| interval | string | Yes | Interval at which the callback is invoked to return the device orientation sensor data.The default value is **normal**. The options are as follows:- **game**: called at an interval of 20 ms, which is applicable to gaming scenarios.- **ui**: called at an interval of 60 ms, which is applicable to UI updating scenarios.- **normal**: called at an interval of 200 ms, which is applicable to power-saving scenarios.| -| success | Function | Yes | Called when the device orientation sensor data changes. | -| fail | Function | No | Callback upon failure. | +| Name | Type | Mandatory | Description | +| -------- | -------- | --------- | ---------------------------------------- | +| interval | string | Yes | Interval at which the callback is invoked to return the device orientation sensor data.The default value is **normal**. The options are as follows:- **game**: called at an interval of 20 ms, which is applicable to gaming scenarios.- **ui**: called at an interval of 60 ms, which is applicable to UI updating scenarios.- **normal**: called at an interval of 200 ms, which is applicable to power-saving scenarios. | +| success | Function | Yes | Called when the device orientation sensor data changes. | +| fail | Function | No | Callback upon failure. | Return values of the success callback -| Name | Type | Description | +| Name | Type | Description | | ----- | ------ | ---------------------------------------- | -| alpha | number | Rotation angle around the Z axis when the X/Y axis of the device coincides with the X/Y axis of the earth.| -| beta | number | Rotation angle around the X axis when the Y/Z axis of the device coincides with the Y/Z axis of the earth.| -| gamma | number | Rotation angle around the Y axis when the X/Z axis of the device coincides with the X/Z axis of the earth.| +| alpha | number | Rotation angle around the Z axis when the X/Y axis of the device coincides with the X/Y axis of the earth. | +| beta | number | Rotation angle around the X axis when the Y/Z axis of the device coincides with the Y/Z axis of the earth. | +| gamma | number | Rotation angle around the Y axis when the X/Z axis of the device coincides with the X/Z axis of the earth. | **Example** @@ -571,19 +571,19 @@ If this API is called multiple times for the same application, the last call tak **Parameters** -| Name | Type | Mandatory | Description | -| -------- | -------- | ---- | ---------------------------------------- | -| interval | string | Yes | Interval at which the callback is invoked to return the gyroscope sensor data.The default value is **normal**. The options are as follows:- **game**: called at an interval of 20 ms, which is applicable to gaming scenarios.- **ui**: called at an interval of 60 ms, which is applicable to UI updating scenarios.- **normal**: called at an interval of 200 ms, which is applicable to power-saving scenarios.| -| success | Function | Yes | Called when the gyroscope sensor data changes. | -| fail | Function | No | Callback upon failure. | +| Name | Type | Mandatory | Description | +| -------- | -------- | --------- | ---------------------------------------- | +| interval | string | Yes | Interval at which the callback is invoked to return the gyroscope sensor data.The default value is **normal**. The options are as follows:- **game**: called at an interval of 20 ms, which is applicable to gaming scenarios.- **ui**: called at an interval of 60 ms, which is applicable to UI updating scenarios.- **normal**: called at an interval of 200 ms, which is applicable to power-saving scenarios. | +| success | Function | Yes | Called when the gyroscope sensor data changes. | +| fail | Function | No | Callback upon failure. | Return values of the success callback -| Name | Type | Description | -| ---- | ------ | --------- | -| x | number | Rotation angular velocity of the X axis.| -| y | number | Rotation angular velocity of the Y axis.| -| z | number | Rotation angular velocity of the Z axis.| +| Name | Type | Description | +| ---- | ------ | ---------------------------------------- | +| x | number | Rotation angular velocity of the X axis. | +| y | number | Rotation angular velocity of the Y axis. | +| z | number | Rotation angular velocity of the Z axis. | **Example** diff --git a/en/application-dev/reference/arkui-js/js-components-basic-input.md b/en/application-dev/reference/arkui-js/js-components-basic-input.md index 066da49683ce647db66b9c8cdecd551550b23844..2ce4c7d3b07a6e8dbdcd47c4d3143ec8e4b285df 100644 --- a/en/application-dev/reference/arkui-js/js-components-basic-input.md +++ b/en/application-dev/reference/arkui-js/js-components-basic-input.md @@ -20,44 +20,44 @@ Not supported 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 | text| No | Type of the input component. Available values include **text**, **email**, **date**, **time**, **number**, **password**, **button**, **checkbox**, and **radio**.The **text**, **email**, **date**, **time**, **number**, and **password** types can be dynamically switched and modified.The **button**, **checkbox**, and **radio** types cannot be dynamically modified. - **button**: a button that can be clicked.- **checkbox**: a check box.- **radio**: a radio button that allows users to select one from multiple others with the same name.- **text**: a single-line text field.- **email**: a field used for an email address.- **date**: date component, including the year, month, and day, but excluding time.- **time**: time component, without the time zone.- **number**: field for entering digits.- **password**: password field, in which characters will be shielded.| -| checked | boolean | false | No | Whether the **\** component is selected. This attribute is valid only when **type** is set to **checkbox** or **radio**. | -| name | string | - | No | Name of the **\** component.This attribute is mandatory when **type** is set to **radio**. | -| value | string | - | No | Value of the **\** component. When **type** is **radio**, this attribute is mandatory and the value must be unique for radio buttons with the same name.| -| placeholder | string | - | No | Content of the hint text. This attribute is available only when the component type is set to **text** \|email\|date\|time\|number\|**password**.| -| maxlength | number | - | No | Maximum number of characters that can be entered in the input box. The empty value indicates no limit. | -| enterkeytype | string | default | No | Type of the **Enter** key on the soft keyboard. The value cannot be dynamically updated.Available values include:- default- next- go- done- send- searchExcept for the **next** type, clicking the Enter key hides the soft keyboard.| -| headericon | string | - | No | Icon resource path before text input. This icon does not support click events and is unavailable for **button**, **checkbox**, and **radio** types. The supported icon image formats are JPG, PNG, and SVG.| -| showcounter5+ | boolean | false | No | Whether to display the character counter for an input box. This attribute takes effect only when **maxlength** is set. | -| menuoptions5+ | Array<MeunOption> | - | No | Menu options displayed after users click the **More** button. | -| autofocus6+ | boolean | false | No | Whether to automatically obtain focus.This attribute setting does not take effect on the application home page. You can enable a text box on the home page to automatically obtain focus, by delaying the **focus** method call (for about 100–500 ms) in **onActive**.| -| selectedstart6+ | number | -1 | No | Start position for text selection. | -| selectedend6+ | number | -1 | No | End position for text selection. | -| softkeyboardenabled6+ | boolean | true | No | Whether to display the soft keyboard during editing. | -| showpasswordicon6+ | boolean | true | No | Whether to display the icon at the end of the password text box. This attribute is available only when **type** is set to **password**. | +| Name | Type | Default Value | Mandatory | Description | +| -------------------------------- | ----------------------- | ------------- | --------- | ---------------------------------------- | +| type | string | text | No | Type of the input component. Available values include **text**, **email**, **date**, **time**, **number**, **password**, **button**, **checkbox**, and **radio**.The **text**, **email**, **date**, **time**, **number**, and **password** types can be dynamically switched and modified.The **button**, **checkbox**, and **radio** types cannot be dynamically modified. - **button**: a button that can be clicked.- **checkbox**: a check box.- **radio**: a radio button that allows users to select one from multiple others with the same name.- **text**: a single-line text field.- **email**: a field used for an email address.- **date**: date component, including the year, month, and day, but excluding time.- **time**: time component, without the time zone.- **number**: field for entering digits.- **password**: password field, in which characters will be shielded. | +| checked | boolean | false | No | Whether the **\** component is selected. This attribute is valid only when **type** is set to **checkbox** or **radio**. | +| name | string | - | No | Name of the **\** component.This attribute is mandatory when **type** is set to **radio**. | +| value | string | - | No | Value of the **\** component. When **type** is **radio**, this attribute is mandatory and the value must be unique for radio buttons with the same name. | +| placeholder | string | - | No | Content of the hint text. This attribute is available only when the component type is set to **text** \|email\|date\|time\|number\|**password**. | +| maxlength | number | - | No | Maximum number of characters that can be entered in the input box. The empty value indicates no limit. | +| enterkeytype | string | default | No | Type of the **Enter** key on the soft keyboard. The value cannot be dynamically updated.Available values include:- default- next- go- done- send- searchExcept for the **next** type, clicking the Enter key hides the soft keyboard. | +| headericon | string | - | No | Icon resource path before text input. This icon does not support click events and is unavailable for **button**, **checkbox**, and **radio** types. The supported icon image formats are JPG, PNG, and SVG. | +| showcounter5+ | boolean | false | No | Whether to display the character counter for an input box. This attribute takes effect only when **maxlength** is set. | +| menuoptions5+ | Array<MenuOption> | - | No | Menu options displayed after users click the **More** button. | +| autofocus6+ | boolean | false | No | Whether to automatically obtain focus.This attribute setting does not take effect on the application home page. You can enable a text box on the home page to automatically obtain focus, by delaying the **focus** method call (for about 100–500 ms) in **onActive**. | +| selectedstart6+ | number | -1 | No | Start position for text selection. | +| selectedend6+ | number | -1 | No | End position for text selection. | +| softkeyboardenabled6+ | boolean | true | No | Whether to display the soft keyboard during editing. | +| showpasswordicon6+ | boolean | true | No | Whether to display the icon at the end of the password text box. This attribute is available only when **type** is set to **password**. | **Table 1** MenuOption5+ -| Name | Type | Description | -| ------- | ------ | ----------- | -| icon | string | Path of the icon for a menu option.| -| content | string | Text content of a menu option.| +| Name | Type | Description | +| ------- | ------ | ----------------------------------- | +| icon | string | Path of the icon for a menu option. | +| content | string | Text content of a menu option. | ## Styles In addition to the [universal styles](../arkui-js/js-components-common-styles.md), the following styles are supported. -| Name | Type | Default Value | Mandatory | Description | -| ------------------------ | -------------------------- | ---------- | ---- | ---------------------------------------- | -| color | <color> | \#e6000000 | No | Font color of the single-line text box or button. | -| font-size | <length> | 16px | No | Font size of the single-line text box or button. | -| allow-scale | boolean | true | No | Whether the font size changes with the system's font size settings.If the **config-changes** tag of **fontSize** is configured for abilities in the **config.json** file, the setting takes effect without application restart.| -| placeholder-color | <color> | \#99000000 | No | Color of the hint text in the single-line text box. This attribute is available only when **type** is set to **text**, **email**, **date**, **time**, **number**, or **password**. | -| font-weight | number \| string | normal | No | Font weight of the single-line text box or button. For details, see **font-weight** of the [**\**](../arkui-js/js-components-basic-text.md) component. | -| caret-color6+ | <color> | - | No | Color of the caret. | +| Name | Type | Default Value | Mandatory | Description | +| ------------------------ | ---------------- | ------------- | --------- | ---------------------------------------- | +| color | <color> | \#e6000000 | No | Font color of the single-line text box or button. | +| font-size | <length> | 16px | No | Font size of the single-line text box or button. | +| allow-scale | boolean | true | No | Whether the font size changes with the system's font size settings.If the **config-changes** tag of **fontSize** is configured for abilities in the **config.json** file, the setting takes effect without application restart. | +| placeholder-color | <color> | \#99000000 | No | Color of the hint text in the single-line text box. This attribute is available only when **type** is set to **text**, **email**, **date**, **time**, **number**, or **password**. | +| font-weight | number \| string | normal | No | Font weight of the single-line text box or button. For details, see **font-weight** of the [**\**](../arkui-js/js-components-basic-text.md) component. | +| caret-color6+ | <color> | - | No | Color of the caret. | ## Events @@ -65,31 +65,31 @@ In addition to the [universal styles](../arkui-js/js-components-common-styles.md In addition to the [universal events](../arkui-js/js-components-common-events.md), the following events are supported. - When **type** is set to **text**, **email**, **date**, **time**, **number**, or **password**, the following events are supported. - - | Name | Parameter | Description | + + | Name | Parameter | Description | | ------------------------- | ---------------------------------------- | ---------------------------------------- | - | change | { value: inputValue } | Triggered when the content entered in the input box changes. The most recent content entered by the user is returned.If you change the **value** attribute directly, this event will not be triggered.| - | enterkeyclick | { value: enterKey } | Triggered when the **Enter** key on the soft keyboard is clicked. The type of the **Enter** key is returned, which is of the number type. Available values are as follows:- **2**: returned if **enterkeytype** is **go**.- **3**: returned if **enterkeytype** is **search**.- **4**: returned if **enterkeytype** is **send**.- **5**: returned if **enterkeytype** is **next**.- **6**: returned if **enterkeytype** is **default**, **done**, or is not set.| - | translate5+ | { value: selectedText } | Triggered when users click the translate button in the menu displayed after they select a text segment. The selected text content is returned.| - | share5+ | { value: selectedText } | Triggered when users click the share button in the menu displayed after they select a text segment. The selected text content is returned.| - | search5+ | { value: selectedText } | Triggered when users click the search button in the menu displayed after they select a text segment. The selected text content is returned.| - | optionselect5+ | { index: optionIndex, value: selectedText } | Triggered when users click a menu option in the menu displayed after they select a text segment. This event is valid only when the **menuoptions** attribute is set. The option index and selected text content are returned.| - | selectchange6+ | {start: number,end: number } | Triggered when the text selection changes. | + | change | { value: inputValue } | Triggered when the content entered in the input box changes. The most recent content entered by the user is returned.If you change the **value** attribute directly, this event will not be triggered. | + | enterkeyclick | { value: enterKey } | Triggered when the **Enter** key on the soft keyboard is clicked. The type of the **Enter** key is returned, which is of the number type. Available values are as follows:- **2**: returned if **enterkeytype** is **go**.- **3**: returned if **enterkeytype** is **search**.- **4**: returned if **enterkeytype** is **send**.- **5**: returned if **enterkeytype** is **next**.- **6**: returned if **enterkeytype** is **default**, **done**, or is not set. | + | translate5+ | { value: selectedText } | Triggered when users click the translate button in the menu displayed after they select a text segment. The selected text content is returned. | + | share5+ | { value: selectedText } | Triggered when users click the share button in the menu displayed after they select a text segment. The selected text content is returned. | + | search5+ | { value: selectedText } | Triggered when users click the search button in the menu displayed after they select a text segment. The selected text content is returned. | + | optionselect5+ | { index: optionIndex, value: selectedText } | Triggered when users click a menu option in the menu displayed after they select a text segment. This event is valid only when the **menuoptions** attribute is set. The option index and selected text content are returned. | + | selectchange6+ | {start: number,end: number } | Triggered when the text selection changes. | - When **type** is set to **checkbox** or **radio**, the following events are supported. - - | Name | Parameter | Description | - | ------ | ---------------------------------------- | ---------------------------------------- | - | change | { checked:true \| false } | Triggered when the checked status of the **checkbox** or **radio** button changes.| + + | Name | Parameter | Description | + | ------ | --------------------------------- | ---------------------------------------- | + | change | { checked:true \| false } | Triggered when the checked status of the **checkbox** or **radio** button changes. | ## Methods In addition to the [universal methods](../arkui-js/js-components-common-methods.md), the following methods are supported. -| Name | Parameter | Description | +| Name | Parameter | Description | | ------------------- | ---------------------------------------- | ---------------------------------------- | -| focus | { focus: true\|false }:If **focus** is not passed, the default value **true** is used.| Obtains or loses focus. When **type** is set to **text**, **email**, **date**, **time**, **number**, or **password**, the input method can be displayed or collapsed. | -| showError | { error: string } | Displays the error message. This method is available when **type** is set to **text**, **email**, **date**, **time**, **number**, or **password**. | +| focus | { focus: true\|false }:If **focus** is not passed, the default value **true** is used. | Obtains or loses focus. When **type** is set to **text**, **email**, **date**, **time**, **number**, or **password**, the input method can be displayed or collapsed. | +| showError | { error: string } | Displays the error message. This method is available when **type** is set to **text**, **email**, **date**, **time**, **number**, or **password**. | | delete6+ | - | Deletes text based on the current caret position when **type** is set to **text**, **email**, **date**, **time**, **number**, or **password**; deletes the last character and displays the caret if the current input component does not have a caret. | ## Example diff --git a/en/application-dev/reference/arkui-js/js-components-media-video.md b/en/application-dev/reference/arkui-js/js-components-media-video.md index 18c3fbef3bff790dfea6359d7a5d7c5516d0ecd5..c024cbe0058093b754c98f04f579b1cd7dac620f 100644 --- a/en/application-dev/reference/arkui-js/js-components-media-video.md +++ b/en/application-dev/reference/arkui-js/js-components-media-video.md @@ -3,17 +3,17 @@ > **NOTE** > -> - This component is supported since API version 4. Updates will be marked with a superscript to indicate their earliest API version. +> - This component is supported since API version 4. Updates will be marked with a superscript to indicate their earliest API version. > -> - Set **configChanges** under **abilities** in the **config.json** file to **orientation**. -> ``` -> "abilities": [ -> { -> "configChanges": ["orientation"], -> ... -> } -> ] -> ``` +> - Set **configChanges** under **abilities** in the **config.json** file to **orientation**. +> ``` +> "abilities": [ +> { +> "configChanges": ["orientation"], +> ... +> } +> ] +> ``` The **\** component provides a video player. @@ -27,54 +27,54 @@ Not supported In addition to the [universal attributes](../arkui-js/js-components-common-attributes.md), the following attributes are supported. -| Name| Type| Default Value| Mandatory| Description| -| -------- | -------- | -------- | -------- | -------- | -| muted | boolean | false | No| Whether the video is muted.| -| src | string | - | No| Path of the video content to play.| -| autoplay | boolean | false | No| Whether the video is played automatically after being rendered.| -| controls | boolean | true | No| Whether the control bar is displayed during video playback. If the value is set to **false**, the control bar is not displayed. The default value is **true**, indicating that the platform can either show or hide the control bar.| +| Name | Type | Default Value | Mandatory | Description | +| -------- | ------- | ------------- | --------- | ---------------------------------------- | +| muted | boolean | false | No | Whether the video is muted. | +| src | string | - | No | Path of the video content to play. | +| autoplay | boolean | false | No | Whether the video is played automatically after being rendered. | +| controls | boolean | true | No | Whether the control bar is displayed during video playback. If the value is set to **false**, the control bar is not displayed. The default value is **true**, indicating that the platform can either show or hide the control bar. | ## Styles In addition to the [universal styles](../arkui-js/js-components-common-styles.md), the following styles are supported. -| Name| Type| Default Value| Mandatory| Description| -| -------- | -------- | -------- | -------- | -------- | -| object-fit | string | contain | No| Video scale type. If **poster** has been assigned a value, the setting of this style will affect the scaling type of the video poster. For details, see object-fit enums.| +| Name | Type | Default Value | Mandatory | Description | +| ---------- | ------ | ------------- | --------- | ---------------------------------------- | +| object-fit | string | contain | No | Video scale type. If **poster** has been assigned a value, the setting of this style will affect the scaling type of the video poster. For details, see object-fit enums. | **Table 1** object-fit enums -| Type| Description| -| -------- | -------- | -| fill | The image is resized to fill the display area, and its aspect ratio is not retained.| +| Type | Description | +| ---- | ---------------------------------------- | +| fill | The image is resized to fill the display area, and its aspect ratio is not retained. | ## Events In addition to the [universal events](../arkui-js/js-components-common-events.md), the following events are supported. -| Name| Parameter| Description| -| -------- | -------- | -------- | -| prepared | { duration: value }5+ | Triggered when the video preparation is complete. The video duration (in seconds) is obtained from **duration**.| -| start | - | Triggered when the video is played.| -| pause | - | Triggered when the video playback is paused.| -| finish | - | Triggered when the video playback is finished.| -| error | - | Triggered when the video playback fails.| -| seeking | { currenttime: value } | Triggered to report the time (in seconds) when the progress bar is being dragged.| -| seeked | { currenttime: value } | Triggered to report the playback time (in seconds) when the user finishes dragging the progress bar.| -| timeupdate | { currenttime: value } | Triggered once per 250 ms when the playback progress changes. The unit of the current playback time is second.| +| Name | Parameter | Description | +| ---------- | ---------------------------------------- | ---------------------------------------- | +| prepared | { duration: value }5+ | Triggered when the video preparation is complete. The video duration (in seconds) is obtained from **duration**. | +| start | - | Triggered when the video is played. | +| pause | - | Triggered when the video playback is paused. | +| finish | - | Triggered when the video playback is finished. | +| error | - | Triggered when the video playback fails. | +| seeking | { currenttime: value } | Triggered to report the time (in seconds) when the progress bar is being dragged. | +| seeked | { currenttime: value } | Triggered to report the playback time (in seconds) when the user finishes dragging the progress bar. | +| timeupdate | { currenttime: value } | Triggered once per 250 ms when the playback progress changes. The unit of the current playback time is second. | ## Methods In addition to the [universal methods](../arkui-js/js-components-common-methods.md), the following methods are supported. -| Name| Parameter| Description| -| -------- | -------- | -------- | -| start | - | Starts playing a video.| -| pause | - | Pauses a video.| -| setCurrentTime | { currenttime: value } | Sets the video playback position, in seconds.| +| Name | Parameter | Description | +| -------------- | ------------------------------------- | ---------------------------------------- | +| start | - | Starts playing a video. | +| pause | - | Pauses a video. | +| setCurrentTime | { currenttime: value } | Sets the video playback position, in seconds. | > **NOTE** > @@ -87,7 +87,7 @@ In addition to the [universal methods](../arkui-js/js-components-common-methods. { **系统能力**:SystemCapability.MultimodalInput.Input.Pointer -| 名称 | 值 | 说明 | -| ------------------- | ---- | --------- | -| DEFAULT | 0 | 默认 | -| EAST | 1 | 向东箭头 | -| WEST | 2 | 向西箭头| -| SOUTH | 3 | 向南箭头 | -| NORTH | 4 | 向北箭头 | -| WEST_EAST | 5 | 向西东箭头 | -| NORTH_SOUTH | 6 | 向北南箭头 | -| NORTH_EAST | 7 | 向东北箭头 | -| NORTH_WEST | 8 | 向西北箭头 | -| SOUTH_EAST | 9 | 向东南箭头 | -| SOUTH_WEST | 10 | 向西南箭头 | -| NORTH_EAST_SOUTH_WEST | 11 | 东北西南调整 | -| NORTH_WEST_SOUTH_EAST | 12 | 西北东南调整 | -| CROSS | 13 | 准确选择 | -| CURSOR_COPY | 14 | 拷贝 | -| CURSOR_FORBID | 15 | 不可用 | -| COLOR_SUCKER | 16 | 滴管 | -| HAND_GRABBING | 17 | 并拢的手 | -| HAND_OPEN | 18 | 张开的手 | -| HAND_POINTING | 19 | 手形指针 | -| HELP | 20 | 帮助选择 | -| MOVE | 21 | 移动 | -| RESIZE_LEFT_RIGHT | 22 | 内部左右调整 | -| RESIZE_UP_DOWN | 23 | 内部上下调整 | -| SCREENSHOT_CHOOSE | 24 | 截图十字准星 | -| SCREENSHOT_CURSOR | 25 | 截图 | -| TEXT_CURSOR | 26 | 文本选择 | -| ZOOM_IN | 27 | 放大 | -| ZOOM_OUT | 28 | 缩小 | -| MIDDLE_BTN_EAST | 29 | 向东滚动 | -| MIDDLE_BTN_WEST | 30 | 向西滚动 | -| MIDDLE_BTN_SOUTH | 31 | 向南滚动 | -| MIDDLE_BTN_NORTH | 32 | 向北滚动 | -| MIDDLE_BTN_NORTH_SOUTH | 33 | 向北南滚动 | -| MIDDLE_BTN_NORTH_EAST | 34 | 向东北滚动 | -| MIDDLE_BTN_NORTH_WEST | 35 | 向西北滚动 | -| MIDDLE_BTN_SOUTH_EAST | 36 | 向东南滚动 | -| MIDDLE_BTN_SOUTH_WEST | 37 | 向西南滚动 | -| MIDDLE_BTN_NORTH_SOUTH_WEST_EAST | 38 | 四向锥形移动 | +| 名称 | 值 | 说明 | +| -------------------------------- | ---- | ------ | +| DEFAULT | 0 | 默认 | +| EAST | 1 | 向东箭头 | +| WEST | 2 | 向西箭头 | +| SOUTH | 3 | 向南箭头 | +| NORTH | 4 | 向北箭头 | +| WEST_EAST | 5 | 向西东箭头 | +| NORTH_SOUTH | 6 | 向北南箭头 | +| NORTH_EAST | 7 | 向东北箭头 | +| NORTH_WEST | 8 | 向西北箭头 | +| SOUTH_EAST | 9 | 向东南箭头 | +| SOUTH_WEST | 10 | 向西南箭头 | +| NORTH_EAST_SOUTH_WEST | 11 | 东北西南调整 | +| NORTH_WEST_SOUTH_EAST | 12 | 西北东南调整 | +| CROSS | 13 | 准确选择 | +| CURSOR_COPY | 14 | 拷贝 | +| CURSOR_FORBID | 15 | 不可用 | +| COLOR_SUCKER | 16 | 滴管 | +| HAND_GRABBING | 17 | 并拢的手 | +| HAND_OPEN | 18 | 张开的手 | +| HAND_POINTING | 19 | 手形指针 | +| HELP | 20 | 帮助选择 | +| MOVE | 21 | 移动 | +| RESIZE_LEFT_RIGHT | 22 | 内部左右调整 | +| RESIZE_UP_DOWN | 23 | 内部上下调整 | +| SCREENSHOT_CHOOSE | 24 | 截图十字准星 | +| SCREENSHOT_CURSOR | 25 | 截图 | +| TEXT_CURSOR | 26 | 文本选择 | +| ZOOM_IN | 27 | 放大 | +| ZOOM_OUT | 28 | 缩小 | +| MIDDLE_BTN_EAST | 29 | 向东滚动 | +| MIDDLE_BTN_WEST | 30 | 向西滚动 | +| MIDDLE_BTN_SOUTH | 31 | 向南滚动 | +| MIDDLE_BTN_NORTH | 32 | 向北滚动 | +| MIDDLE_BTN_NORTH_SOUTH | 33 | 向北南滚动 | +| MIDDLE_BTN_NORTH_EAST | 34 | 向东北滚动 | +| MIDDLE_BTN_NORTH_WEST | 35 | 向西北滚动 | +| MIDDLE_BTN_SOUTH_EAST | 36 | 向东南滚动 | +| MIDDLE_BTN_SOUTH_WEST | 37 | 向西南滚动 | +| MIDDLE_BTN_NORTH_SOUTH_WEST_EAST | 38 | 四向锥形移动 | diff --git a/zh-cn/application-dev/reference/apis/js-apis-system-sensor.md b/zh-cn/application-dev/reference/apis/js-apis-system-sensor.md index 9ea3ec4f43e8307c4264d4ee6fffd86a67e03273..70767067ee993b7213eba74b8e7d08bd4f36388d 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-system-sensor.md +++ b/zh-cn/application-dev/reference/apis/js-apis-system-sensor.md @@ -299,7 +299,7 @@ sensor.unsubscribeStepCounter(); ## sensor.subscribeBarometer -subcribeBarometer(Object): void +subscribeBarometer(Object): void 订阅气压传感器数据变化。针对同一个应用,多次点击调用时,会覆盖前面的调用效果,即仅最后一次调用生效。 diff --git a/zh-cn/application-dev/reference/arkui-js/js-components-basic-input.md b/zh-cn/application-dev/reference/arkui-js/js-components-basic-input.md index 3d08d858cdc7f5c54673e3d1755a9fdd42eced56..73d0d355a411f3cf549ace6f870427b80fc357cc 100644 --- a/zh-cn/application-dev/reference/arkui-js/js-components-basic-input.md +++ b/zh-cn/application-dev/reference/arkui-js/js-components-basic-input.md @@ -23,14 +23,14 @@ | -------------------------------- | ----------------------- | --------- | ---- | ---------------------------------------- | | type | string | text | 否 | input组件类型,可选值为text,email,date,time,number,password,button,checkbox,radio。其中text,email,date,time,number,password这六种类型之间支持动态切换修改。button,checkbox,radio不支持动态修改。可选值定义如下:- button:定义可点击的按钮;- checkbox:定义多选框;- radio:定义单选按钮,允许在多个拥有相同name值的选项中选中其中一个;- text:定义一个单行的文本字段;- email:定义用于e-mail地址的字段;- date:定义 date 控件(包括年、月、日,不包括时间);- time:定义用于输入时间的控件(不带时区);- number:定义用于输入数字的字段;- password:定义密码字段(字段中的字符会被遮蔽)。 | | checked | boolean | false | 否 | 当前组件是否选中,仅type为checkbox和radio生效。 | -| name | string | - | 否 | input组件的名称。type为radio时,name为必填。 | +| name | string | - | 否 | input组件的名称。type为radio时,name为必填。 | | value | string | - | 否 | input组件的value值,当类型为radio时必填且相同name值的选项该值唯一。 | | placeholder | string | - | 否 | 设置提示文本的内容,仅在type为text\|email\|date\|time\|number\|password时生效。 | | maxlength | number | - | 否 | 输入框可输入的最多字符数量,不填表示不限制输入框中字符数量。 | | enterkeytype | string | default | 否 | 不支持动态修改。设置软键盘Enter按钮的类型,可选值为:- default:默认- next:下一项- go:前往- done:完成- send:发送- search:搜索除“next”外,点击后会自动收起软键盘。 | | headericon | string | - | 否 | 在文本输入前的图标资源路径,该图标不支持点击事件(button,checkbox和radio不生效),图标格式为jpg,png和svg。 | | showcounter5+ | boolean | false | 否 | 文本输入框是否显示计数下标,需要配合maxlength一起使用。 | -| menuoptions5+ | Array<MeunOption> | - | 否 | 设置文本选择弹框点击更多按钮之后显示的菜单项。 | +| menuoptions5+ | Array<MenuOption> | - | 否 | 设置文本选择弹框点击更多按钮之后显示的菜单项。 | | autofocus6+ | boolean | false | 否 | 是否自动获焦。应用首页中设置不生效,可在onActive中延迟(100-500ms左右)调用focus方法实现输入框在首页中自动获焦。 | | selectedstart6+ | number | -1 | 否 | 开始选择文本时初始选择位置。 | | selectedend6+ | number | -1 | 否 | 开始选择文本时结尾选择位置。 | @@ -64,8 +64,8 @@ 除支持[通用事件](../arkui-js/js-components-common-events.md)外,还支持如下事件: - 当input类型为text、email、date、time、number、password时,支持如下事件: - - | 名称 | 参数 | 描述 | + + | 名称 | 参数 | 描述 | | ------------------------- | ---------------------------------------- | ---------------------------------------- | | change | { value: inputValue } | 输入框输入内容发生变化时触发该事件,返回用户当前输入值。改变value属性值不会触发该回调。 | | enterkeyclick | { value: enterKey } | 软键盘enter键点击后触发该事件,返回enter按钮的类型,enterKey类型为number,可选值为:- 2:设置enterkeytype属性为go时生效。- 3:设置enterkeytype属性为search时生效。- 4:设置enterkeytype属性为send时生效。- 5:设置enterkeytype属性为next时生效。- 6:不设置enterkeytype或者设置enterkeytype属性为default、done时生效。 | @@ -76,7 +76,7 @@ | selectchange6+ | {start: number,end: number } | 文本选择变化时触发事件。 | - 当input类型为checkbox、radio时,支持如下事件: - + | 名称 | 参数 | 描述 | | ------ | ---------------------------------------- | ---------------------------------------- | | change | { checked:true \| false } | checkbox多选框或radio单选框的checked状态发生变化时触发该事件。 | diff --git a/zh-cn/application-dev/reference/arkui-js/js-components-canvas-canvasrenderingcontext2d.md b/zh-cn/application-dev/reference/arkui-js/js-components-canvas-canvasrenderingcontext2d.md index 639d952b396a54ea009ec293b03053db53ea904f..fa2d921d02097ffda89f80b016ab3b7f5661b0bc 100644 --- a/zh-cn/application-dev/reference/arkui-js/js-components-canvas-canvasrenderingcontext2d.md +++ b/zh-cn/application-dev/reference/arkui-js/js-components-canvas-canvasrenderingcontext2d.md @@ -1428,7 +1428,7 @@ transform方法对应一个变换矩阵,想对一个图形进行变化的时 setTransform(scaleX: number, skewX: number, skewY: number, scale: number, translateX: number, translateY: number): void -setTransfrom方法使用的参数和transform()方法相同,但setTransform()方法会重置现有的变换矩阵并创建新的变换矩阵。 +setTransform方法使用的参数和transform()方法相同,但setTransform()方法会重置现有的变换矩阵并创建新的变换矩阵。 **参数:** diff --git a/zh-cn/application-dev/reference/arkui-js/js-components-media-video.md b/zh-cn/application-dev/reference/arkui-js/js-components-media-video.md index 77020ff73bf8959e9bbaddd5cd7eae70f6468380..64066963bcd7664ceb0a409403984bf8ead3c203 100644 --- a/zh-cn/application-dev/reference/arkui-js/js-components-media-video.md +++ b/zh-cn/application-dev/reference/arkui-js/js-components-media-video.md @@ -3,17 +3,17 @@ > **说明:** > -> - 从API version 4开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。 +> - 从API version 4开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。 > -> - 需要在config.json对应的"abilities"中设置"configChanges"属性为"orientation" -> ``` -> "abilities": [ -> { -> "configChanges": ["orientation"], -> ... -> } -> ] -> ``` +> - 需要在config.json对应的"abilities"中设置"configChanges"属性为"orientation" +> ``` +> "abilities": [ +> { +> "configChanges": ["orientation"], +> ... +> } +> ] +> ``` 视频播放组件。 @@ -27,26 +27,26 @@ 除支持[通用属性](../arkui-js/js-components-common-attributes.md)外,还支持如下属性: -| 名称 | 类型 | 默认值 | 必填 | 描述 | -| -------- | -------- | -------- | -------- | -------- | -| muted | boolean | false | 否 | 视频是否静音播放。 | -| src | string | - | 否 | 播放视频内容的路径。 | -| autoplay | boolean | false | 否 | 视频是否自动播放。 | -| controls | boolean | true | 否 | 控制视频播放的控制栏是否显示,如果设置为false,则不显示控制栏。默认为true,由系统决定显示或隐藏控制栏。 | +| 名称 | 类型 | 默认值 | 必填 | 描述 | +| -------- | ------- | ----- | ---- | ---------------------------------------- | +| muted | boolean | false | 否 | 视频是否静音播放。 | +| src | string | - | 否 | 播放视频内容的路径。 | +| autoplay | boolean | false | 否 | 视频是否自动播放。 | +| controls | boolean | true | 否 | 控制视频播放的控制栏是否显示,如果设置为false,则不显示控制栏。默认为true,由系统决定显示或隐藏控制栏。 | ## 样式 除支持[通用样式](../arkui-js/js-components-common-styles.md)外,还支持如下样式: -| 名称 | 类型 | 默认值 | 必填 | 描述 | -| -------- | -------- | -------- | -------- | -------- | -| object-fit | string | contain | 否 | 视频源的缩放类型,如果poster设置了值,那么此配置还会影响视频海报的缩放类型,可选值参考表 object-fit 类型说明。 | +| 名称 | 类型 | 默认值 | 必填 | 描述 | +| ---------- | ------ | ------- | ---- | ---------------------------------------- | +| object-fit | string | contain | 否 | 视频源的缩放类型,如果poster设置了值,那么此配置还会影响视频海报的缩放类型,可选值参考表 object-fit 类型说明。 | **表1** object-fit 类型说明 -| 类型 | 描述 | -| -------- | -------- | +| 类型 | 描述 | +| ---- | ------------------------- | | fill | 不保持宽高比进行放大缩小,使得图片填充满显示边界。 | @@ -54,30 +54,30 @@ 除支持[通用事件](../arkui-js/js-components-common-events.md)外,还支持如下事件: -| 名称 | 参数 | 描述 | -| -------- | -------- | -------- | -| prepared | { duration: value }5+ | 视频准备完成时触发该事件,通过duration可以获取视频时长,单位为s。 | -| start | - | 播放时触发该事件。 | -| pause | - | 暂停时触发该事件。 | -| finish | - | 播放结束时触发该事件。 | -| error | - | 播放失败时触发该事件。 | -| seeking | { currenttime: value } | 操作进度条过程时上报时间信息,单位为s。 | -| seeked | { currenttime: value } | 操作进度条完成后,上报播放时间信息,单位为s。 | -| timeupdate | { currenttime: value } | 播放进度变化时触发该事件,单位为s,更新时间间隔为250ms。 | +| 名称 | 参数 | 描述 | +| ---------- | ---------------------------------------- | ------------------------------------- | +| prepared | { duration: value }5+ | 视频准备完成时触发该事件,通过duration可以获取视频时长,单位为s。 | +| start | - | 播放时触发该事件。 | +| pause | - | 暂停时触发该事件。 | +| finish | - | 播放结束时触发该事件。 | +| error | - | 播放失败时触发该事件。 | +| seeking | { currenttime: value } | 操作进度条过程时上报时间信息,单位为s。 | +| seeked | { currenttime: value } | 操作进度条完成后,上报播放时间信息,单位为s。 | +| timeupdate | { currenttime: value } | 播放进度变化时触发该事件,单位为s,更新时间间隔为250ms。 | ## 方法 除支持[通用方法](../arkui-js/js-components-common-methods.md)外,还支持如下方法: -| 名称 | 参数 | 描述 | -| -------- | -------- | -------- | -| start | - | 请求播放视频。 | -| pause | - | 请求暂停播放视频。 | +| 名称 | 参数 | 描述 | +| -------------- | ------------------------------------- | ----------------- | +| start | - | 请求播放视频。 | +| pause | - | 请求暂停播放视频。 | | setCurrentTime | { currenttime: value } | 指定视频播放的进度位置,单位为s。 | > **说明:** -> 在attached组件生命周期回调后,可以调用上述组件方法。 +> 在attached组件生命周期回调后,可以调用上述组件方法。 ## 示例 @@ -86,7 +86,7 @@ **说明:** -> 从 API Version 8 开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。 +> 从 API Version 8 开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。 使用OffscreenCanvasRenderingContext2D在Canvas上进行离屏绘制,绘制对象可以是矩形、文本、图片等。离屏绘制是指将需要绘制的内容先绘制在缓存区,然后将其转换成图片,一次性绘制绘制到canvas上,加快了绘制速度。 @@ -27,24 +27,24 @@ OffscreenCanvasRenderingContext2D(width: number, height: number, setting: Render | [fillStyle](#fillstyle) | string \| [CanvasGradient](ts-components-canvas-canvasgradient.md) \| [CanvasPattern](#canvaspattern) | 指定绘制的填充色。- 类型为string时,表示设置填充区域的颜色。- 类型为CanvasGradient时,表示渐变对象,使用[createLinearGradient](#createlineargradient)方法创建。- 类型为CanvasPattern时,使用[createPattern](#createpattern)方法创建。 | | [lineWidth](#linewidth) | number | 设置绘制线条的宽度。 | | [strokeStyle](#strokestyle) | string \| [CanvasGradient](ts-components-canvas-canvasgradient.md) \| [CanvasPattern](#canvaspattern) | 设置描边的颜色。- 类型为string时,表示设置描边使用的颜色。- 类型为CanvasGradient时,表示渐变对象,使用[createLinearGradient](#createlineargradient)方法创建。- 类型为CanvasPattern时,使用[createPattern](#createpattern)方法创建。 | -| [lineCap](#linecap) | CanvasLineCap | 指定线端点的样式,可选值为:- 'butt':线端点以方形结束。- 'round':线端点以圆形结束。- 'square':线端点以方形结束,该样式下会增加一个长度和线段厚度相同,宽度是线段厚度一半的矩形。- 默认值:'butt'。 | -| [lineJoin](#linejoin) | CanvasLineJoin | 指定线段间相交的交点样式,可选值为:- 'round':在线段相连处绘制一个扇形,扇形的圆角半径是线段的宽度。- 'bevel':在线段相连处使用三角形为底填充, 每个部分矩形拐角独立。- 'miter':在相连部分的外边缘处进行延伸,使其相交于一点,形成一个菱形区域,该属性可以通过设置miterLimit属性展现效果。- 默认值:'miter'。 | -| [miterLimit](#miterlimit) | number | 设置斜接面限制值,该值指定了线条相交处内角和外角的距离。 - 默认值:10。 | -| [font](#font) | string | 设置文本绘制中的字体样式。语法:ctx.font='font-size font-family'- font-size(可选),指定字号和行高,单位只支持px。- font-family(可选),指定字体系列。语法:ctx.font='font-style font-weight font-size font-family'- font-style(可选),用于指定字体样式,支持如下几种样式:'normal','italic'。- font-weight(可选),用于指定字体的粗细,支持如下几种类型:'normal', 'bold', 'bolder', 'lighter', 100, 200, 300, 400, 500, 600, 700, 800, 900。- font-size(可选),指定字号和行高,单位只支持px。- font-family(可选),指定字体系列,支持如下几种类型:'sans-serif', 'serif', 'monospace'。- 默认值:'normal normal 14px sans-serif'。 | -| [textAlign](#textalign) | CanvasTextAlign | 设置文本绘制中的文本对齐方式,可选值为:- 'left':文本左对齐。- 'right':文本右对齐。- 'center':文本居中对齐。- 'start':文本对齐界线开始的地方。- 'end':文本对齐界线结束的地方。> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**> ltr布局模式下'start'和'left'一致,rtl布局模式下'start'和'right'一致·。- 默认值:'left'。 | -| [textBaseline](#textbaseline) | CanvasTextBaseline | 设置文本绘制中的水平对齐方式,可选值为:- 'alphabetic':文本基线是标准的字母基线。- 'top':文本基线在文本块的顶部。- 'hanging':文本基线是悬挂基线。- 'middle':文本基线在文本块的中间。- 'ideographic':文字基线是表意字基线;如果字符本身超出了alphabetic基线,那么ideograhpic基线位置在字符本身的底部。- 'bottom':文本基线在文本块的底部。 与ideographic基线的区别在于ideographic基线不需要考虑下行字母。- 默认值:'alphabetic'。 | +| [lineCap](#linecap) | CanvasLineCap | 指定线端点的样式,可选值为:- 'butt':线端点以方形结束。- 'round':线端点以圆形结束。- 'square':线端点以方形结束,该样式下会增加一个长度和线段厚度相同,宽度是线段厚度一半的矩形。- 默认值:'butt'。 | +| [lineJoin](#linejoin) | CanvasLineJoin | 指定线段间相交的交点样式,可选值为:- 'round':在线段相连处绘制一个扇形,扇形的圆角半径是线段的宽度。- 'bevel':在线段相连处使用三角形为底填充, 每个部分矩形拐角独立。- 'miter':在相连部分的外边缘处进行延伸,使其相交于一点,形成一个菱形区域,该属性可以通过设置miterLimit属性展现效果。- 默认值:'miter'。 | +| [miterLimit](#miterlimit) | number | 设置斜接面限制值,该值指定了线条相交处内角和外角的距离。 - 默认值:10。 | +| [font](#font) | string | 设置文本绘制中的字体样式。语法:ctx.font='font-size font-family'- font-size(可选),指定字号和行高,单位只支持px。- font-family(可选),指定字体系列。语法:ctx.font='font-style font-weight font-size font-family'- font-style(可选),用于指定字体样式,支持如下几种样式:'normal','italic'。- font-weight(可选),用于指定字体的粗细,支持如下几种类型:'normal', 'bold', 'bolder', 'lighter', 100, 200, 300, 400, 500, 600, 700, 800, 900。- font-size(可选),指定字号和行高,单位只支持px。- font-family(可选),指定字体系列,支持如下几种类型:'sans-serif', 'serif', 'monospace'。- 默认值:'normal normal 14px sans-serif'。 | +| [textAlign](#textalign) | CanvasTextAlign | 设置文本绘制中的文本对齐方式,可选值为:- 'left':文本左对齐。- 'right':文本右对齐。- 'center':文本居中对齐。- 'start':文本对齐界线开始的地方。- 'end':文本对齐界线结束的地方。> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**> ltr布局模式下'start'和'left'一致,rtl布局模式下'start'和'right'一致·。- 默认值:'left'。 | +| [textBaseline](#textbaseline) | CanvasTextBaseline | 设置文本绘制中的水平对齐方式,可选值为:- 'alphabetic':文本基线是标准的字母基线。- 'top':文本基线在文本块的顶部。- 'hanging':文本基线是悬挂基线。- 'middle':文本基线在文本块的中间。- 'ideographic':文字基线是表意字基线;如果字符本身超出了alphabetic基线,那么ideograhpic基线位置在字符本身的底部。- 'bottom':文本基线在文本块的底部。 与ideographic基线的区别在于ideographic基线不需要考虑下行字母。- 默认值:'alphabetic'。 | | [globalAlpha](#globalalpha) | number | 设置透明度,0.0为完全透明,1.0为完全不透明。 | -| [lineDashOffset](#linedashoffset) | number | 设置画布的虚线偏移量,精度为float。 - 默认值:0.0。 | +| [lineDashOffset](#linedashoffset) | number | 设置画布的虚线偏移量,精度为float。 - 默认值:0.0。 | | [globalCompositeOperation](#globalcompositeoperation) | string | 设置合成操作的方式。类型字段可选值有'source-over','source-atop','source-in','source-out','destination-over','destination-atop','destination-in','destination-out','lighter','copy','xor'。- 默认值:'source-over'。 | -| [shadowBlur](#shadowblur) | number | 设置绘制阴影时的模糊级别,值越大越模糊,精度为float。 - 默认值:0.0。 | -| [shadowColor](#shadowcolor) | string | 设置绘制阴影时的阴影颜色。 | +| [shadowBlur](#shadowblur) | number | 设置绘制阴影时的模糊级别,值越大越模糊,精度为float。 - 默认值:0.0。 | +| [shadowColor](#shadowcolor) | string | 设置绘制阴影时的阴影颜色。 | | [shadowOffsetX](#shadowoffsetx) | number | 设置绘制阴影时和原有对象的水平偏移值。 | | [shadowOffsetY](#shadowoffsety) | number | 设置绘制阴影时和原有对象的垂直偏移值。 | -| [imageSmoothingEnabled](#imagesmoothingenabled) | boolean | 用于设置绘制图片时是否进行图像平滑度调整,true为启用,false为不启用。 - 默认值:true。 | +| [imageSmoothingEnabled](#imagesmoothingenabled) | boolean | 用于设置绘制图片时是否进行图像平滑度调整,true为启用,false为不启用。 - 默认值:true。 | | imageSmoothingQuality | string | 用于设置图像平滑度,支持如下三种类型:'low', 'medium', 'high'。- 默认值:'low'。 | > ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:** ->fillStyle、shadowColor与 strokeStyle 中string类型格式为 'rgb(255, 255, 255)','rgba(255, 255, 255, 1.0)','\#FFFFFF'。 +> fillStyle、shadowColor与 strokeStyle 中string类型格式为 'rgb(255, 255, 255)','rgba(255, 255, 255, 1.0)','\#FFFFFF'。 ### fillStyle @@ -703,12 +703,12 @@ fillRect(x: number, y: number, w: number, h: number): void **参数:** - | 参数 | 类型 | 必填 | 默认值 | 说明 | - | ------ | ------ | ---- | ---- | ------------- | - | x | number | 是 | 0 | 指定矩形左上角点的x坐标。 | - | y | number | 是 | 0 | 指定矩形左上角点的y坐标。 | - | width | number | 是 | 0 | 指定矩形的宽度。 | - | height | number | 是 | 0 | 指定矩形的高度。 | +| 参数 | 类型 | 必填 | 默认值 | 说明 | +| ------ | ------ | ---- | ---- | ------------- | +| x | number | 是 | 0 | 指定矩形左上角点的x坐标。 | +| y | number | 是 | 0 | 指定矩形左上角点的y坐标。 | +| width | number | 是 | 0 | 指定矩形的宽度。 | +| height | number | 是 | 0 | 指定矩形的高度。 | **示例:** @@ -750,12 +750,12 @@ strokeRect(x: number, y: number, w: number, h: number): void **参数:** - | 参数 | 类型 | 必填 | 默认值 | 说明 | - | ------ | ------ | ---- | ---- | ------------ | - | x | number | 是 | 0 | 指定矩形的左上角x坐标。 | - | y | number | 是 | 0 | 指定矩形的左上角y坐标。 | - | width | number | 是 | 0 | 指定矩形的宽度。 | - | height | number | 是 | 0 | 指定矩形的高度。 | +| 参数 | 类型 | 必填 | 默认值 | 说明 | +| ------ | ------ | ---- | ---- | ------------ | +| x | number | 是 | 0 | 指定矩形的左上角x坐标。 | +| y | number | 是 | 0 | 指定矩形的左上角y坐标。 | +| width | number | 是 | 0 | 指定矩形的宽度。 | +| height | number | 是 | 0 | 指定矩形的高度。 | **示例:** @@ -796,12 +796,12 @@ clearRect(x: number, y: number, w: number, h: number): void **参数:** - | 参数 | 类型 | 必填 | 默认值 | 描述 | - | ------ | ------ | ---- | ---- | ------------- | - | x | number | 是 | 0 | 指定矩形上的左上角x坐标。 | - | y | number | 是 | 0 | 指定矩形上的左上角y坐标。 | - | width | number | 是 | 0 | 指定矩形的宽度。 | - | height | number | 是 | 0 | 指定矩形的高度。 | +| 参数 | 类型 | 必填 | 默认值 | 描述 | +| ------ | ------ | ---- | ---- | ------------- | +| x | number | 是 | 0 | 指定矩形上的左上角x坐标。 | +| y | number | 是 | 0 | 指定矩形上的左上角y坐标。 | +| width | number | 是 | 0 | 指定矩形的宽度。 | +| height | number | 是 | 0 | 指定矩形的高度。 | **示例:** @@ -844,12 +844,12 @@ fillText(text: string, x: number, y: number, maxWidth?: number): void **参数:** - | 参数 | 类型 | 必填 | 默认值 | 说明 | - | ---- | ------ | ---- | ---- | --------------- | - | text | string | 是 | “” | 需要绘制的文本内容。 | - | x | number | 是 | 0 | 需要绘制的文本的左下角x坐标。 | - | y | number | 是 | 0 | 需要绘制的文本的左下角y坐标。 | - | maxWidth | number | 否 | - | 指定文本允许的最大宽度。 | +| 参数 | 类型 | 必填 | 默认值 | 说明 | +| -------- | ------ | ---- | ---- | --------------- | +| text | string | 是 | “” | 需要绘制的文本内容。 | +| x | number | 是 | 0 | 需要绘制的文本的左下角x坐标。 | +| y | number | 是 | 0 | 需要绘制的文本的左下角y坐标。 | +| maxWidth | number | 否 | - | 指定文本允许的最大宽度。 | **示例:** @@ -891,12 +891,12 @@ strokeText(text: string, x: number, y: number): void **参数:** - | 参数 | 类型 | 必填 | 默认值 | 描述 | - | ---- | ------ | ---- | ---- | --------------- | - | text | string | 是 | “” | 需要绘制的文本内容。 | - | x | number | 是 | 0 | 需要绘制的文本的左下角x坐标。 | - | y | number | 是 | 0 | 需要绘制的文本的左下角y坐标。 | - | maxWidth | number | 否 | - | 需要绘制的文本的最大宽度 。| +| 参数 | 类型 | 必填 | 默认值 | 描述 | +| -------- | ------ | ---- | ---- | --------------- | +| text | string | 是 | “” | 需要绘制的文本内容。 | +| x | number | 是 | 0 | 需要绘制的文本的左下角x坐标。 | +| y | number | 是 | 0 | 需要绘制的文本的左下角y坐标。 | +| maxWidth | number | 否 | - | 需要绘制的文本的最大宽度 。 | **示例:** @@ -938,33 +938,33 @@ measureText(text: string): TextMetrics **参数:** - | 参数 | 类型 | 必填 | 默认值 | 说明 | - | ---- | ------ | ---- | ---- | ---------- | - | text | string | 是 | "" | 需要进行测量的文本。 | +| 参数 | 类型 | 必填 | 默认值 | 说明 | +| ---- | ------ | ---- | ---- | ---------- | +| text | string | 是 | "" | 需要进行测量的文本。 | **返回值:** - | 类型 | 说明 | - | ----------- | ------- | - | TextMetrics | 文本的尺寸信息 | +| 类型 | 说明 | +| ----------- | ------- | +| TextMetrics | 文本的尺寸信息 | **TextMetrics类型描述:** - | 属性 | 类型 | 描述 | - | ----- | ------ | ------- | - | width | number | 字符串的宽度。 | - | height | number | 字符串的高度。 | - | actualBoundingBoxAscent | number | 从CanvasRenderingContext2D.textBaseline 属性标明的水平线到渲染文本的矩形边界顶部的距离,当前值为0。 | - | actualBoundingBoxDescent | number | 从CanvasRenderingContext2D.textBaseline 属性标明的水平线到渲染文本的矩形边界底部的距离,当前值为0。 | - | actualBoundingBoxLeft | number | 平行于基线,从CanvasRenderingContext2D.textAlign 属性确定的对齐点到文本矩形边界左侧的距离,当前值为0。 | - | actualBoundingBoxRight | number | 平行于基线,从CanvasRenderingContext2D.textAlign 属性确定的对齐点到文本矩形边界右侧的距离,当前值为0。| - | alphabeticBaseline | number | 从CanvasRenderingContext2D.textBaseline 属性标明的水平线到线框的 alphabetic 基线的距离,当前值为0。| - | emHeightAscent | number | 从CanvasRenderingContext2D.textBaseline 属性标明的水平线到线框中 em 方块顶部的距离,当前值为0。| - | emHeightDescent | number | 从CanvasRenderingContext2D.textBaseline 属性标明的水平线到线框中 em 方块底部的距离,当前值为0。| - | fontBoundingBoxAscent | number | 从CanvasRenderingContext2D.textBaseline 属性标明的水平线到渲染文本的所有字体的矩形最高边界顶部的距离,当前值为0。| - | fontBoundingBoxDescent | number | 从CanvasRenderingContext2D.textBaseline 属性标明的水平线到渲染文本的所有字体的矩形边界最底部的距离,当前值为0。| - | hangingBaseline | number | 从CanvasRenderingContext2D.textBaseline 属性标明的水平线到线框的 hanging 基线的距离,当前值为0。| - | ideographicBaseline | number | 从CanvasRenderingContext2D.textBaseline 属性标明的水平线到线框的 ideographic 基线的距离,当前值为0。| +| 属性 | 类型 | 描述 | +| ------------------------ | ------ | ---------------------------------------- | +| width | number | 字符串的宽度。 | +| height | number | 字符串的高度。 | +| actualBoundingBoxAscent | number | 从CanvasRenderingContext2D.textBaseline 属性标明的水平线到渲染文本的矩形边界顶部的距离,当前值为0。 | +| actualBoundingBoxDescent | number | 从CanvasRenderingContext2D.textBaseline 属性标明的水平线到渲染文本的矩形边界底部的距离,当前值为0。 | +| actualBoundingBoxLeft | number | 平行于基线,从CanvasRenderingContext2D.textAlign 属性确定的对齐点到文本矩形边界左侧的距离,当前值为0。 | +| actualBoundingBoxRight | number | 平行于基线,从CanvasRenderingContext2D.textAlign 属性确定的对齐点到文本矩形边界右侧的距离,当前值为0。 | +| alphabeticBaseline | number | 从CanvasRenderingContext2D.textBaseline 属性标明的水平线到线框的 alphabetic 基线的距离,当前值为0。 | +| emHeightAscent | number | 从CanvasRenderingContext2D.textBaseline 属性标明的水平线到线框中 em 方块顶部的距离,当前值为0。 | +| emHeightDescent | number | 从CanvasRenderingContext2D.textBaseline 属性标明的水平线到线框中 em 方块底部的距离,当前值为0。 | +| fontBoundingBoxAscent | number | 从CanvasRenderingContext2D.textBaseline 属性标明的水平线到渲染文本的所有字体的矩形最高边界顶部的距离,当前值为0。 | +| fontBoundingBoxDescent | number | 从CanvasRenderingContext2D.textBaseline 属性标明的水平线到渲染文本的所有字体的矩形边界最底部的距离,当前值为0。 | +| hangingBaseline | number | 从CanvasRenderingContext2D.textBaseline 属性标明的水平线到线框的 hanging 基线的距离,当前值为0。 | +| ideographicBaseline | number | 从CanvasRenderingContext2D.textBaseline 属性标明的水平线到线框的 ideographic 基线的距离,当前值为0。 | **示例:** @@ -1007,9 +1007,9 @@ stroke(path?: Path2D): void **参数:** - | 参数 | 类型 | 必填 | 默认值 | 描述 | - | ---- | ---------------------------------------- | ---- | ---- | ------------ | - | path | [Path2D](ts-components-canvas-path2d.md) | 否 | null | 需要绘制的Path2D。 | +| 参数 | 类型 | 必填 | 默认值 | 描述 | +| ---- | ---------------------------------------- | ---- | ---- | ------------ | +| path | [Path2D](ts-components-canvas-path2d.md) | 否 | null | 需要绘制的Path2D。 | **示例:** @@ -1095,10 +1095,10 @@ moveTo(x: number, y: number): void **参数:** - | 参数 | 类型 | 必填 | 默认值 | 说明 | - | ---- | ------ | ---- | ---- | --------- | - | x | number | 是 | 0 | 指定位置的x坐标。 | - | y | number | 是 | 0 | 指定位置的y坐标。 | +| 参数 | 类型 | 必填 | 默认值 | 说明 | +| ---- | ------ | ---- | ---- | --------- | +| x | number | 是 | 0 | 指定位置的x坐标。 | +| y | number | 是 | 0 | 指定位置的y坐标。 | **示例:** @@ -1142,10 +1142,10 @@ lineTo(x: number, y: number): void **参数:** - | 参数 | 类型 | 必填 | 默认值 | 描述 | - | ---- | ------ | ---- | ---- | --------- | - | x | number | 是 | 0 | 指定位置的x坐标。 | - | y | number | 是 | 0 | 指定位置的y坐标。 | +| 参数 | 类型 | 必填 | 默认值 | 描述 | +| ---- | ------ | ---- | ---- | --------- | +| x | number | 是 | 0 | 指定位置的x坐标。 | +| y | number | 是 | 0 | 指定位置的y坐标。 | **示例:** @@ -1231,16 +1231,16 @@ createPattern(image: ImageBitmap, repetition: string | null): CanvasPattern | nu **参数:** - | 参数 | 类型 | 必填 | 默认值 | 描述 | - | ---------- | ---------------------------------------- | ---- | ---- | ---------------------------------------- | - | image | [ImageBitmap](ts-components-canvas-imagebitmap.md) | 是 | null | 图源对象,具体参考ImageBitmap对象。 | - | repetition | string | 是 | “” | 设置图像重复的方式,取值为:'repeat'、'repeat-x'、 'repeat-y'、'no-repeat'。 | +| 参数 | 类型 | 必填 | 默认值 | 描述 | +| ---------- | ---------------------------------------- | ---- | ---- | ---------------------------------------- | +| image | [ImageBitmap](ts-components-canvas-imagebitmap.md) | 是 | null | 图源对象,具体参考ImageBitmap对象。 | +| repetition | string | 是 | “” | 设置图像重复的方式,取值为:'repeat'、'repeat-x'、 'repeat-y'、'no-repeat'。 | **返回值:** - | 类型 | 说明 | - | ---------- | ---------------------------------------- | - | [CanvasPattern](#canvaspattern) | 通过指定图像和重复方式创建图片填充的模板对象。 | +| 类型 | 说明 | +| ------------------------------- | ----------------------- | +| [CanvasPattern](#canvaspattern) | 通过指定图像和重复方式创建图片填充的模板对象。 | **示例:** @@ -1284,14 +1284,14 @@ bezierCurveTo(cp1x: number, cp1y: number, cp2x: number, cp2y: number, x: number, **参数:** - | 参数 | 类型 | 必填 | 默认值 | 描述 | - | ---- | ------ | ---- | ---- | -------------- | - | cp1x | number | 是 | 0 | 第一个贝塞尔参数的x坐标值。 | - | cp1y | number | 是 | 0 | 第一个贝塞尔参数的y坐标值。 | - | cp2x | number | 是 | 0 | 第二个贝塞尔参数的x坐标值。 | - | cp2y | number | 是 | 0 | 第二个贝塞尔参数的y坐标值。 | - | x | number | 是 | 0 | 路径结束时的x坐标值。 | - | y | number | 是 | 0 | 路径结束时的y坐标值。 | +| 参数 | 类型 | 必填 | 默认值 | 描述 | +| ---- | ------ | ---- | ---- | -------------- | +| cp1x | number | 是 | 0 | 第一个贝塞尔参数的x坐标值。 | +| cp1y | number | 是 | 0 | 第一个贝塞尔参数的y坐标值。 | +| cp2x | number | 是 | 0 | 第二个贝塞尔参数的x坐标值。 | +| cp2y | number | 是 | 0 | 第二个贝塞尔参数的y坐标值。 | +| x | number | 是 | 0 | 路径结束时的x坐标值。 | +| y | number | 是 | 0 | 路径结束时的y坐标值。 | **示例:** @@ -1335,12 +1335,12 @@ quadraticCurveTo(cpx: number, cpy: number, x: number, y: number): void **参数:** - | 参数 | 类型 | 必填 | 默认值 | 描述 | - | ---- | ------ | ---- | ---- | ----------- | - | cpx | number | 是 | 0 | 贝塞尔参数的x坐标值。 | - | cpy | number | 是 | 0 | 贝塞尔参数的y坐标值。 | - | x | number | 是 | 0 | 路径结束时的x坐标值。 | - | y | number | 是 | 0 | 路径结束时的y坐标值。 | +| 参数 | 类型 | 必填 | 默认值 | 描述 | +| ---- | ------ | ---- | ---- | ----------- | +| cpx | number | 是 | 0 | 贝塞尔参数的x坐标值。 | +| cpy | number | 是 | 0 | 贝塞尔参数的y坐标值。 | +| x | number | 是 | 0 | 路径结束时的x坐标值。 | +| y | number | 是 | 0 | 路径结束时的y坐标值。 | **示例:** @@ -1384,14 +1384,14 @@ arc(x: number, y: number, radius: number, startAngle: number, endAngle: number, **参数:** - | 参数 | 类型 | 必填 | 默认值 | 描述 | - | ------------- | ------- | ---- | ----- | ---------- | - | x | number | 是 | 0 | 弧线圆心的x坐标值。 | - | y | number | 是 | 0 | 弧线圆心的y坐标值。 | - | radius | number | 是 | 0 | 弧线的圆半径。 | - | startAngle | number | 是 | 0 | 弧线的起始弧度。 | - | endAngle | number | 是 | 0 | 弧线的终止弧度。 | - | counterclockwise | boolean | 否 | false | 是否逆时针绘制圆弧。 | +| 参数 | 类型 | 必填 | 默认值 | 描述 | +| ---------------- | ------- | ---- | ----- | ---------- | +| x | number | 是 | 0 | 弧线圆心的x坐标值。 | +| y | number | 是 | 0 | 弧线圆心的y坐标值。 | +| radius | number | 是 | 0 | 弧线的圆半径。 | +| startAngle | number | 是 | 0 | 弧线的起始弧度。 | +| endAngle | number | 是 | 0 | 弧线的终止弧度。 | +| counterclockwise | boolean | 否 | false | 是否逆时针绘制圆弧。 | **示例:** @@ -1434,13 +1434,13 @@ arcTo(x1: number, y1: number, x2: number, y2: number, radius: number): void **参数:** - | 参数 | 类型 | 必填 | 默认值 | 描述 | - | ------ | ------ | ---- | ---- | --------------- | - | x1 | number | 是 | 0 | 圆弧经过的第一个点的x坐标值。 | - | y1 | number | 是 | 0 | 圆弧经过的第一个点的y坐标值。 | - | x2 | number | 是 | 0 | 圆弧经过的第二个点的x坐标值。 | - | y2 | number | 是 | 0 | 圆弧经过的第二个点的y坐标值。 | - | radius | number | 是 | 0 | 圆弧的圆半径值。 | +| 参数 | 类型 | 必填 | 默认值 | 描述 | +| ------ | ------ | ---- | ---- | --------------- | +| x1 | number | 是 | 0 | 圆弧经过的第一个点的x坐标值。 | +| y1 | number | 是 | 0 | 圆弧经过的第一个点的y坐标值。 | +| x2 | number | 是 | 0 | 圆弧经过的第二个点的x坐标值。 | +| y2 | number | 是 | 0 | 圆弧经过的第二个点的y坐标值。 | +| radius | number | 是 | 0 | 圆弧的圆半径值。 | **示例:** @@ -1483,16 +1483,16 @@ ellipse(x: number, y: number, radiusX: number, radiusY: number, rotation: number **参数:** - | 参数 | 类型 | 必填 | 默认值 | 说明 | - | ------------- | ------- | ---- | ----- | ----------------- | - | x | number | 是 | 0 | 椭圆圆心的x轴坐标。 | - | y | number | 是 | 0 | 椭圆圆心的y轴坐标。 | - | radiusX | number | 是 | 0 | 椭圆x轴的半径长度。 | - | radiusY | number | 是 | 0 | 椭圆y轴的半径长度。 | - | rotation | number | 是 | 0 | 椭圆的旋转角度,单位为弧度。 | - | startAngle | number | 是 | 0 | 椭圆绘制的起始点角度,以弧度表示。 | - | endAngle | number | 是 | 0 | 椭圆绘制的结束点角度,以弧度表示。 | - | counterclockwise | boolean | 否 | false | 是否以逆时针方向绘制椭圆。 | +| 参数 | 类型 | 必填 | 默认值 | 说明 | +| ---------------- | ------- | ---- | ----- | ----------------- | +| x | number | 是 | 0 | 椭圆圆心的x轴坐标。 | +| y | number | 是 | 0 | 椭圆圆心的y轴坐标。 | +| radiusX | number | 是 | 0 | 椭圆x轴的半径长度。 | +| radiusY | number | 是 | 0 | 椭圆y轴的半径长度。 | +| rotation | number | 是 | 0 | 椭圆的旋转角度,单位为弧度。 | +| startAngle | number | 是 | 0 | 椭圆绘制的起始点角度,以弧度表示。 | +| endAngle | number | 是 | 0 | 椭圆绘制的结束点角度,以弧度表示。 | +| counterclockwise | boolean | 否 | false | 是否以逆时针方向绘制椭圆。 | **示例:** @@ -1535,12 +1535,12 @@ rect(x: number, y: number, w: number, h: number): void **参数:** - | 参数 | 类型 | 必填 | 默认值 | 描述 | - | ------ | ------ | ---- | ---- | ------------- | - | x | number | 是 | 0 | 指定矩形的左上角x坐标值。 | - | y | number | 是 | 0 | 指定矩形的左上角y坐标值。 | - | w | number | 是 | 0 | 指定矩形的宽度。 | - | h | number | 是 | 0 | 指定矩形的高度。 | +| 参数 | 类型 | 必填 | 默认值 | 描述 | +| ---- | ------ | ---- | ---- | ------------- | +| x | number | 是 | 0 | 指定矩形的左上角x坐标值。 | +| y | number | 是 | 0 | 指定矩形的左上角y坐标值。 | +| w | number | 是 | 0 | 指定矩形的宽度。 | +| h | number | 是 | 0 | 指定矩形的高度。 | **示例:** @@ -1661,9 +1661,9 @@ rotate(angle: number): void **参数:** - | 参数 | 类型 | 必填 | 默认值 | 描述 | - | ------ | ------ | ---- | ---- | ---------------------------------------- | - | angle | number | 是 | 0 | 设置顺时针旋转的弧度值,可以通过Math.PI / 180将角度转换为弧度值。 | +| 参数 | 类型 | 必填 | 默认值 | 描述 | +| ----- | ------ | ---- | ---- | ---------------------------------------- | +| angle | number | 是 | 0 | 设置顺时针旋转的弧度值,可以通过Math.PI / 180将角度转换为弧度值。 | **示例:** @@ -1705,10 +1705,10 @@ scale(x: number, y: number): void **参数:** - | 参数 | 类型 | 必填 | 默认值 | 描述 | - | ---- | ------ | ---- | ---- | ----------- | - | x | number | 是 | 0 | 设置水平方向的缩放值。 | - | y | number | 是 | 0 | 设置垂直方向的缩放值。 | +| 参数 | 类型 | 必填 | 默认值 | 描述 | +| ---- | ------ | ---- | ---- | ----------- | +| x | number | 是 | 0 | 设置水平方向的缩放值。 | +| y | number | 是 | 0 | 设置垂直方向的缩放值。 | **示例:** @@ -1758,14 +1758,14 @@ transform方法对应一个变换矩阵,想对一个图形进行变化的时 **参数:** - | 参数 | 类型 | 必填 | 默认值 | 描述 | - | ---------- | ------ | ---- | ---- | -------- | - | a | number | 是 | 0 |scaleX: 指定水平缩放值。 | - | b | number | 是 | 0 |skewX: 指定水平倾斜值。 | - | c | number | 是 | 0 |skewY: 指定垂直倾斜值。 | - | d | number | 是 | 0 |scaleY: 指定垂直缩放值。 | - | e | number | 是 | 0 |translateX: 指定水平移动值。 | - | f | number | 是 | 0 |translateY: 指定垂直移动值。 | +| 参数 | 类型 | 必填 | 默认值 | 描述 | +| ---- | ------ | ---- | ---- | -------------------- | +| a | number | 是 | 0 | scaleX: 指定水平缩放值。 | +| b | number | 是 | 0 | skewX: 指定水平倾斜值。 | +| c | number | 是 | 0 | skewY: 指定垂直倾斜值。 | +| d | number | 是 | 0 | scaleY: 指定垂直缩放值。 | +| e | number | 是 | 0 | translateX: 指定水平移动值。 | +| f | number | 是 | 0 | translateY: 指定垂直移动值。 | **示例:** @@ -1809,18 +1809,18 @@ transform方法对应一个变换矩阵,想对一个图形进行变化的时 setTransform(a: number, b: number, c: number, d: number, e: number, f: number): void -setTransfrom方法使用的参数和transform()方法相同,但setTransform()方法会重置现有的变换矩阵并创建新的变换矩阵。 +setTransform方法使用的参数和transform()方法相同,但setTransform()方法会重置现有的变换矩阵并创建新的变换矩阵。 **参数:** - | 参数 | 类型 | 必填 | 默认值 | 描述 | - | ---------- | ------ | ---- | ---- | -------- | - | a | number | 是 | 0 |scaleX: 指定水平缩放值。 | - | b | number | 是 | 0 |skewX: 指定水平倾斜值。 | - | c | number | 是 | 0 |skewY: 指定垂直倾斜值。 | - | d | number | 是 | 0 |scaleY: 指定垂直缩放值。 | - | e | number | 是 | 0 |translateX: 指定水平移动值。 | - | f | number | 是 | 0 |translateY: 指定垂直移动值。 | +| 参数 | 类型 | 必填 | 默认值 | 描述 | +| ---- | ------ | ---- | ---- | -------------------- | +| a | number | 是 | 0 | scaleX: 指定水平缩放值。 | +| b | number | 是 | 0 | skewX: 指定水平倾斜值。 | +| c | number | 是 | 0 | skewY: 指定垂直倾斜值。 | +| d | number | 是 | 0 | scaleY: 指定垂直缩放值。 | +| e | number | 是 | 0 | translateX: 指定水平移动值。 | +| f | number | 是 | 0 | translateY: 指定垂直移动值。 | **示例:** @@ -1865,10 +1865,10 @@ translate(x: number, y: number): void **参数:** - | 参数 | 类型 | 必填 | 默认值 | 描述 | - | ---- | ------ | ---- | ---- | -------- | - | x | number | 是 | 0 | 设置水平平移量。 | - | y | number | 是 | 0 | 设置竖直平移量。 | +| 参数 | 类型 | 必填 | 默认值 | 描述 | +| ---- | ------ | ---- | ---- | -------- | +| x | number | 是 | 0 | 设置水平平移量。 | +| y | number | 是 | 0 | 设置竖直平移量。 | **示例:** @@ -1915,17 +1915,17 @@ drawImage(image: ImageBitmap | PixelMap, sx: number, sy: number, sw: number, sh: **参数:** - | 参数 | 类型 | 必填 | 默认值 | 描述 | - | ------- | ---------------------------------------- | ---- | ---- | -------------------- | - | image | [ImageBitmap](ts-components-canvas-imagebitmap.md) 或[PixelMap](../apis/js-apis-image.md#pixelmap7)| 是 | null | 图片资源,请参考ImageBitmap或PixelMap。 | - | sx | number | 否 | 0 | 裁切源图像时距离源图像左上角的x坐标值。 | - | sy | number | 否 | 0 | 裁切源图像时距离源图像左上角的y坐标值。 | - | sw | number | 否 | 0 | 裁切源图像时需要裁切的宽度。 | - | sh | number | 否 | 0 | 裁切源图像时需要裁切的高度。 | - | dx | number | 是 | 0 | 绘制区域左上角在x轴的位置。 | - | dy | number | 是 | 0 | 绘制区域左上角在y 轴的位置。 | - | dw | number | 否 | 0 | 绘制区域的宽度。 | - | dh | number | 否 | 0 | 绘制区域的高度。 | +| 参数 | 类型 | 必填 | 默认值 | 描述 | +| ----- | ---------------------------------------- | ---- | ---- | ----------------------------- | +| image | [ImageBitmap](ts-components-canvas-imagebitmap.md) 或[PixelMap](../apis/js-apis-image.md#pixelmap7) | 是 | null | 图片资源,请参考ImageBitmap或PixelMap。 | +| sx | number | 否 | 0 | 裁切源图像时距离源图像左上角的x坐标值。 | +| sy | number | 否 | 0 | 裁切源图像时距离源图像左上角的y坐标值。 | +| sw | number | 否 | 0 | 裁切源图像时需要裁切的宽度。 | +| sh | number | 否 | 0 | 裁切源图像时需要裁切的高度。 | +| dx | number | 是 | 0 | 绘制区域左上角在x轴的位置。 | +| dy | number | 是 | 0 | 绘制区域左上角在y 轴的位置。 | +| dw | number | 否 | 0 | 绘制区域的宽度。 | +| dh | number | 否 | 0 | 绘制区域的高度。 | **示例:** @@ -1968,10 +1968,10 @@ createImageData(sw: number, sh: number): ImageData **参数:** - | 参数 | 类型 | 必填 | 默认 | 描述 | - | ------ | ------ | ---- | ---- | ------------- | - | sw | number | 是 | 0 | ImageData的宽度。 | - | sh | number | 是 | 0 | ImageData的高度。 | +| 参数 | 类型 | 必填 | 默认 | 描述 | +| ---- | ------ | ---- | ---- | ------------- | +| sw | number | 是 | 0 | ImageData的宽度。 | +| sh | number | 是 | 0 | ImageData的高度。 | ### createImageData @@ -1982,15 +1982,15 @@ createImageData(imageData: ImageData): ImageData **参数:** - | 参数 | 类型 | 必填 | 默认 | 描述 | - | --------- | ---------------------------------------- | ---- | ---- | ---------------- | - | imagedata | [ImageData](ts-components-canvas-imagebitmap.md) | 是 | null | 被复制的ImageData对象。 | +| 参数 | 类型 | 必填 | 默认 | 描述 | +| --------- | ---------------------------------------- | ---- | ---- | ---------------- | +| imagedata | [ImageData](ts-components-canvas-imagebitmap.md) | 是 | null | 被复制的ImageData对象。 | **返回值:** - | 类型 | 说明 | - | ---------- | ---------------------------------------- | - | [ImageData](ts-components-canvas-imagebitmap.md) | 新的ImageData对象 | +| 类型 | 说明 | +| ---------------------------------------- | ------------- | +| [ImageData](ts-components-canvas-imagebitmap.md) | 新的ImageData对象 | ### getPixelMap @@ -2000,18 +2000,18 @@ getPixelMap(sx: number, sy: number, sw: number, sh: number): PixelMap **参数:** - | 参数 | 类型 | 必填 | 默认值 | 描述 | - | -------- | -------- | -------- | -------- | -------- | - | sx | number | 是 | 0 | 需要输出的区域的左上角x坐标。 | - | sy | number | 是 | 0 | 需要输出的区域的左上角y坐标。 | - | sw | number | 是 | 0 | 需要输出的区域的宽度。 | - | sh | number | 是 | 0 | 需要输出的区域的高度。 | +| 参数 | 类型 | 必填 | 默认值 | 描述 | +| ---- | ------ | ---- | ---- | --------------- | +| sx | number | 是 | 0 | 需要输出的区域的左上角x坐标。 | +| sy | number | 是 | 0 | 需要输出的区域的左上角y坐标。 | +| sw | number | 是 | 0 | 需要输出的区域的宽度。 | +| sh | number | 是 | 0 | 需要输出的区域的高度。 | **返回值:** - | 类型 | 说明 | - | ---------- | ---------------------------------------- | - | [PixelMap](../apis/js-apis-image.md#pixelmap7) | 新的PixelMap对象 | +| 类型 | 说明 | +| ---------------------------------------- | ------------ | +| [PixelMap](../apis/js-apis-image.md#pixelmap7) | 新的PixelMap对象 | ### getImageData @@ -2022,18 +2022,18 @@ getImageData(sx: number, sy: number, sw: number, sh: number): ImageData **参数:** - | 参数 | 类型 | 必填 | 默认值 | 描述 | - | ---- | ------ | ---- | ---- | --------------- | - | sx | number | 是 | 0 | 需要输出的区域的左上角x坐标。 | - | sy | number | 是 | 0 | 需要输出的区域的左上角y坐标。 | - | sw | number | 是 | 0 | 需要输出的区域的宽度。 | - | sh | number | 是 | 0 | 需要输出的区域的高度。 | +| 参数 | 类型 | 必填 | 默认值 | 描述 | +| ---- | ------ | ---- | ---- | --------------- | +| sx | number | 是 | 0 | 需要输出的区域的左上角x坐标。 | +| sy | number | 是 | 0 | 需要输出的区域的左上角y坐标。 | +| sw | number | 是 | 0 | 需要输出的区域的宽度。 | +| sh | number | 是 | 0 | 需要输出的区域的高度。 | **返回值:** - | 类型 | 说明 | - | ---------- | ---------------------------------------- | - | [ImageData](ts-components-canvas-imagebitmap.md) | 新的ImageData对象 | +| 类型 | 说明 | +| ---------------------------------------- | ------------- | +| [ImageData](ts-components-canvas-imagebitmap.md) | 新的ImageData对象 | ### putImageData @@ -2046,15 +2046,15 @@ putImageData(imageData: Object, dx: number, dy: number, dirtyX: number, dirtyY: **参数:** - | 参数 | 类型 | 必填 | 默认值 | 描述 | - | ----------- | ------ | ---- | ------------ | ----------------------------- | - | imagedata | Object | 是 | null | 包含像素值的ImageData对象。 | - | dx | number | 是 | 0 | 填充区域在x轴方向的偏移量。 | - | dy | number | 是 | 0 | 填充区域在y轴方向的偏移量。 | - | dirtyX | number | 否 | 0 | 源图像数据矩形裁切范围左上角距离源图像左上角的x轴偏移量。 | - | dirtyY | number | 否 | 0 | 源图像数据矩形裁切范围左上角距离源图像左上角的y轴偏移量。 | - | dirtyWidth | number | 否 | imagedata的宽度 | 源图像数据矩形裁切范围的宽度。 | - | dirtyHeight | number | 否 | imagedata的高度 | 源图像数据矩形裁切范围的高度。 | +| 参数 | 类型 | 必填 | 默认值 | 描述 | +| ----------- | ------ | ---- | ------------ | ----------------------------- | +| imagedata | Object | 是 | null | 包含像素值的ImageData对象。 | +| dx | number | 是 | 0 | 填充区域在x轴方向的偏移量。 | +| dy | number | 是 | 0 | 填充区域在y轴方向的偏移量。 | +| dirtyX | number | 否 | 0 | 源图像数据矩形裁切范围左上角距离源图像左上角的x轴偏移量。 | +| dirtyY | number | 否 | 0 | 源图像数据矩形裁切范围左上角距离源图像左上角的y轴偏移量。 | +| dirtyWidth | number | 否 | imagedata的宽度 | 源图像数据矩形裁切范围的宽度。 | +| dirtyHeight | number | 否 | imagedata的高度 | 源图像数据矩形裁切范围的高度。 | **示例:** @@ -2101,8 +2101,8 @@ setLineDash(segments: number[]): void **参数:** -| 参数 | 类型 | 描述 | -| -------- | ----- | -------------------- | +| 参数 | 类型 | 描述 | +| -------- | -------- | ------------------- | | segments | number[] | 描述线段如何交替和线段间距长度的数组。 | **示例:** @@ -2145,8 +2145,8 @@ getLineDash(): number[] **返回值:** -| 类型 | 说明 | -| ----- | ------------------------ | +| 类型 | 说明 | +| -------- | ------------------------ | | number[] | 返回数组,该数组用来描述线段如何交替和间距长度。 | **示例:** @@ -2191,8 +2191,8 @@ transferFromImageBitmap(bitmap: ImageBitmap): void **参数:** -| 参数 | 类型 | 描述 | -| ------ | ----------- | ------------------ | +| 参数 | 类型 | 描述 | +| ------ | ---------------------------------------- | ------------------ | | bitmap | [ImageData](ts-components-canvas-imagebitmap.md) | 待显示的ImageBitmap对象。 | **示例:** @@ -2282,7 +2282,7 @@ transferToImageBitmap(): ImageBitmap | 类型 | 说明 | | ---------------------------------------- | --------------- | -| [ImageData](ts-components-canvas-imagebitmap.md)| 存储离屏画布上渲染的像素数据。 | +| [ImageData](ts-components-canvas-imagebitmap.md) | 存储离屏画布上渲染的像素数据。 | **示例:** @@ -2391,12 +2391,12 @@ createLinearGradient(x0: number, y0: number, x1: number, y1: number): void **参数:** - | 参数 | 类型 | 必填 | 默认值 | 描述 | - | ---- | ------ | ---- | ---- | -------- | - | x0 | number | 是 | 0 | 起点的x轴坐标。 | - | y0 | number | 是 | 0 | 起点的y轴坐标。 | - | x1 | number | 是 | 0 | 终点的x轴坐标。 | - | y1 | number | 是 | 0 | 终点的y轴坐标。 | +| 参数 | 类型 | 必填 | 默认值 | 描述 | +| ---- | ------ | ---- | ---- | -------- | +| x0 | number | 是 | 0 | 起点的x轴坐标。 | +| y0 | number | 是 | 0 | 起点的y轴坐标。 | +| x1 | number | 是 | 0 | 终点的x轴坐标。 | +| y1 | number | 是 | 0 | 终点的y轴坐标。 | **示例:** @@ -2443,14 +2443,14 @@ createRadialGradient(x0: number, y0: number, r0: number, x1: number, y1: number, **参数:** - | 参数 | 类型 | 必填 | 默认值 | 描述 | - | ---- | ------ | ---- | ---- | ----------------- | - | x0 | number | 是 | 0 | 起始圆的x轴坐标。 | - | y0 | number | 是 | 0 | 起始圆的y轴坐标。 | - | r0 | number | 是 | 0 | 起始圆的半径。必须是非负且有限的。 | - | x1 | number | 是 | 0 | 终点圆的x轴坐标。 | - | y1 | number | 是 | 0 | 终点圆的y轴坐标。 | - | r1 | number | 是 | 0 | 终点圆的半径。必须为非负且有限的。 | +| 参数 | 类型 | 必填 | 默认值 | 描述 | +| ---- | ------ | ---- | ---- | ----------------- | +| x0 | number | 是 | 0 | 起始圆的x轴坐标。 | +| y0 | number | 是 | 0 | 起始圆的y轴坐标。 | +| r0 | number | 是 | 0 | 起始圆的半径。必须是非负且有限的。 | +| x1 | number | 是 | 0 | 终点圆的x轴坐标。 | +| y1 | number | 是 | 0 | 终点圆的y轴坐标。 | +| r1 | number | 是 | 0 | 终点圆的半径。必须为非负且有限的。 | **示例:** diff --git a/zh-cn/application-dev/reference/native-apis/rawfile.md b/zh-cn/application-dev/reference/native-apis/rawfile.md index 8738297052c4775e2ecf06bb9b52377be6d6b213..c613f611d50323b5efa35294e960cc3796f88c9e 100644 --- a/zh-cn/application-dev/reference/native-apis/rawfile.md +++ b/zh-cn/application-dev/reference/native-apis/rawfile.md @@ -18,47 +18,47 @@ ### 文件 - | 文件名称 | 描述 | -| -------- | -------- | -| [raw_dir.h](raw__dir_8h.md) | 提供rawfile目录相关功能。 | -| [raw_file.h](raw__file_8h.md) | 提供rawfile文件相关功能。 | -| [raw_file_manager.h](raw__file__manager_8h.md) | 提供资源管理rawfile相关功能。 | +| 文件名称 | 描述 | +| ---------------------------------------- | ------------------ | +| [raw_dir.h](raw__dir_8h.md) | 提供rawfile目录相关功能。 | +| [raw_file.h](raw__file_8h.md) | 提供rawfile文件相关功能。 | +| [raw_file_manager.h](raw__file__manager_8h.md) | 提供资源管理rawfile相关功能。 | ### 结构体 - | 结构体名称 | 描述 | -| -------- | -------- | -| [RawFileDescriptor](_raw_file_descriptor.md) | 提供rawfile文件描述符信息。 | +| 结构体名称 | 描述 | +| ---------------------------------------- | ----------------- | +| [RawFileDescriptor](_raw_file_descriptor.md) | 提供rawfile文件描述符信息。 | ### 类型定义 - | 类型定义名称 | 描述 | -| -------- | -------- | -| [RawDir](#rawdir) | 提供对rawfile目录的访问。 | -| [RawFile](#rawfile) | 提供对rawfile的访问功能。 | -| [NativeResourceManager](#nativeresourcemanager) | 代表resource manager。 | +| 类型定义名称 | 描述 | +| ---------------------------------------- | ------------------- | +| [RawDir](#rawdir) | 提供对rawfile目录的访问。 | +| [RawFile](#rawfile) | 提供对rawfile的访问功能。 | +| [NativeResourceManager](#nativeresourcemanager) | 代表resource manager。 | ### 函数 - | 函数名称 | 描述 | -| -------- | -------- | -| [OH_ResourceManager_GetRawFileName](#oh_resourcemanager_getrawfilename) ([RawDir](#rawdir) \*rawDir, int index) | 通过索引获取rawfile文件名称。 | -| [OH_ResourceManager_GetRawFileCount](#oh_resourcemanager_getrawfilecount) ([RawDir](#rawdir) \*rawDir) | 获取[RawDir](#rawdir)中的rawfile数量。 | -| [OH_ResourceManager_CloseRawDir](#oh_resourcemanager_closerawdir) ([RawDir](#rawdir) \*rawDir) | 关闭已打开的[RawDir](#rawdir)并释放所有相关联资源。 | -| [OH_ResourceManager_ReadRawFile](#oh_resourcemanager_readrawfile) (const [RawFile](#rawfile) \*rawFile, void \*buf, size_t length) | 读取rawfile。 | -| [OH_ResourceManager_SeekRawFile](#oh_resourcemanager_seekrawfile) (const [RawFile](#rawfile) \*rawFile, long offset, int whence) | 基于指定的offset,在rawfile文件内搜索读写数据的位置。 | -| [OH_ResourceManager_GetRawFileSize](#oh_resourcemanager_getrawfilesize) ([RawFile](#rawfile) \*rawFile) | 获取rawfile长度,单位为int32_t。 | -| [OH_ResourceManager_CloseRawFile](#oh_resourcemanager_closerawfile) ([RawFile](#rawfile) \*rawFile) | 关闭已打开的[RawFile](#rawfile) 以及释放所有相关联资源。 | -| [OH_ResourceManager_GetRawFileOffset](#oh_resourcemanager_getrawfileoffset) (const [RawFile](#rawfile) \*rawFile) | 获取rawfile当前的offset,单位为int32_t。 | -| [OH_ResourceManager_GetRawFileDescriptor](#oh_resourcemanager_getrawfiledescriptor) (const [RawFile](#rawfile) \*rawFile, [RawFileDescriptor](_raw_file_descriptor.md) &descriptor) | 基于offset(单位为int32_t)和文件长度打开rawfile,并获取rawfile文件描述符。 | -| [OH_ResourceManager_ReleaseRawFileDescriptor](#oh_resourcemanager_releaserawfiledescriptor) (const [RawFileDescriptor](_raw_file_descriptor.md) &descriptor) | 关闭rawfile文件描述符。 | -| [OH_ResourceManager_InitNativeResourceManager](#oh_resourcemanager_initnativeresourcemanager) (napi_env env, napi_value jsResMgr) | 基于JavaScipt resource manager获取native resource manager。 | -| [OH_ResourceManager_ReleaseNativeResourceManager](#oh_resourcemanager_releasenativeresourcemanager) ([NativeResourceManager](#nativeresourcemanager) \*resMgr) | 释放native resource manager。 | -| [OH_ResourceManager_OpenRawDir](#oh_resourcemanager_openrawdir) (const [NativeResourceManager](#nativeresourcemanager) \*mgr, const char \*dirName) | 打开rawfile目录。 | -| [OH_ResourceManager_OpenRawFile](#oh_resourcemanager_openrawfile) (const [NativeResourceManager](#nativeresourcemanager) \*mgr, const char \*fileName) | 打开rawfile文件。 | +| 函数名称 | 描述 | +| ---------------------------------------- | ---------------------------------------- | +| [OH_ResourceManager_GetRawFileName](#oh_resourcemanager_getrawfilename) ([RawDir](#rawdir) \*rawDir, int index) | 通过索引获取rawfile文件名称。 | +| [OH_ResourceManager_GetRawFileCount](#oh_resourcemanager_getrawfilecount) ([RawDir](#rawdir) \*rawDir) | 获取[RawDir](#rawdir)中的rawfile数量。 | +| [OH_ResourceManager_CloseRawDir](#oh_resourcemanager_closerawdir) ([RawDir](#rawdir) \*rawDir) | 关闭已打开的[RawDir](#rawdir)并释放所有相关联资源。 | +| [OH_ResourceManager_ReadRawFile](#oh_resourcemanager_readrawfile) (const [RawFile](#rawfile) \*rawFile, void \*buf, size_t length) | 读取rawfile。 | +| [OH_ResourceManager_SeekRawFile](#oh_resourcemanager_seekrawfile) (const [RawFile](#rawfile) \*rawFile, long offset, int whence) | 基于指定的offset,在rawfile文件内搜索读写数据的位置。 | +| [OH_ResourceManager_GetRawFileSize](#oh_resourcemanager_getrawfilesize) ([RawFile](#rawfile) \*rawFile) | 获取rawfile长度,单位为int32_t。 | +| [OH_ResourceManager_CloseRawFile](#oh_resourcemanager_closerawfile) ([RawFile](#rawfile) \*rawFile) | 关闭已打开的[RawFile](#rawfile) 以及释放所有相关联资源。 | +| [OH_ResourceManager_GetRawFileOffset](#oh_resourcemanager_getrawfileoffset) (const [RawFile](#rawfile) \*rawFile) | 获取rawfile当前的offset,单位为int32_t。 | +| [OH_ResourceManager_GetRawFileDescriptor](#oh_resourcemanager_getrawfiledescriptor) (const [RawFile](#rawfile) \*rawFile, [RawFileDescriptor](_raw_file_descriptor.md) &descriptor) | 基于offset(单位为int32_t)和文件长度打开rawfile,并获取rawfile文件描述符。 | +| [OH_ResourceManager_ReleaseRawFileDescriptor](#oh_resourcemanager_releaserawfiledescriptor) (const [RawFileDescriptor](_raw_file_descriptor.md) &descriptor) | 关闭rawfile文件描述符。 | +| [OH_ResourceManager_InitNativeResourceManager](#oh_resourcemanager_initnativeresourcemanager) (napi_env env, napi_value jsResMgr) | 基于JavaScript resource manager获取native resource manager。 | +| [OH_ResourceManager_ReleaseNativeResourceManager](#oh_resourcemanager_releasenativeresourcemanager) ([NativeResourceManager](#nativeresourcemanager) \*resMgr) | 释放native resource manager。 | +| [OH_ResourceManager_OpenRawDir](#oh_resourcemanager_openrawdir) (const [NativeResourceManager](#nativeresourcemanager) \*mgr, const char \*dirName) | 打开rawfile目录。 | +| [OH_ResourceManager_OpenRawFile](#oh_resourcemanager_openrawfile) (const [NativeResourceManager](#nativeresourcemanager) \*mgr, const char \*fileName) | 打开rawfile文件。 | ## 详细描述 @@ -69,7 +69,7 @@ ### NativeResourceManager - + ``` typedef struct NativeResourceManager NativeResourceManager ``` @@ -87,7 +87,7 @@ typedef struct NativeResourceManager NativeResourceManager ### RawDir - + ``` typedef struct RawDir RawDir ``` @@ -103,7 +103,7 @@ typedef struct RawDir RawDir ### RawFile - + ``` typedef struct RawFile RawFile ``` @@ -122,7 +122,7 @@ typedef struct RawFile RawFile ### OH_ResourceManager_CloseRawDir() - + ``` void OH_ResourceManager_CloseRawDir (RawDir * rawDir) ``` @@ -133,9 +133,9 @@ void OH_ResourceManager_CloseRawDir (RawDir * rawDir) **参数:** - | Name | 描述 | -| -------- | -------- | -| rawDir | 表示指向[RawDir](#rawdir)的指针。 | +| Name | 描述 | +| ------ | ------------------------- | +| rawDir | 表示指向[RawDir](#rawdir)的指针。 | **参见:** @@ -148,7 +148,7 @@ void OH_ResourceManager_CloseRawDir (RawDir * rawDir) ### OH_ResourceManager_CloseRawFile() - + ``` void OH_ResourceManager_CloseRawFile (RawFile * rawFile) ``` @@ -159,9 +159,9 @@ void OH_ResourceManager_CloseRawFile (RawFile * rawFile) **参数:** - | Name | 描述 | -| -------- | -------- | -| rawFile | 表示指向[RawFile](#rawfile)的指针。 | +| Name | 描述 | +| ------- | --------------------------- | +| rawFile | 表示指向[RawFile](#rawfile)的指针。 | **参见:** @@ -174,7 +174,7 @@ void OH_ResourceManager_CloseRawFile (RawFile * rawFile) ### OH_ResourceManager_GetRawFileCount() - + ``` int OH_ResourceManager_GetRawFileCount (RawDir * rawDir) ``` @@ -187,9 +187,9 @@ int OH_ResourceManager_GetRawFileCount (RawDir * rawDir) **参数:** - | Name | 描述 | -| -------- | -------- | -| rawDir | 表示指向[RawDir](#rawdir)的指针。 | +| Name | 描述 | +| ------ | ------------------------- | +| rawDir | 表示指向[RawDir](#rawdir)的指针。 | **参见:** @@ -202,7 +202,7 @@ int OH_ResourceManager_GetRawFileCount (RawDir * rawDir) ### OH_ResourceManager_GetRawFileDescriptor() - + ``` bool OH_ResourceManager_GetRawFileDescriptor (const RawFile * rawFile, RawFileDescriptor & descriptor ) ``` @@ -215,10 +215,10 @@ bool OH_ResourceManager_GetRawFileDescriptor (const RawFile * rawFile, RawFileDe **参数:** - | Name | 描述 | -| -------- | -------- | -| rawFile | 表示指向[RawFile](#rawfile)的指针。 | -| descriptor | 显示rawfile文件描述符,以及在HAP包中的起始位置和长度。 | +| Name | 描述 | +| ---------- | -------------------------------- | +| rawFile | 表示指向[RawFile](#rawfile)的指针。 | +| descriptor | 显示rawfile文件描述符,以及在HAP包中的起始位置和长度。 | **返回:** @@ -231,7 +231,7 @@ bool OH_ResourceManager_GetRawFileDescriptor (const RawFile * rawFile, RawFileDe ### OH_ResourceManager_GetRawFileName() - + ``` const char* OH_ResourceManager_GetRawFileName (RawDir * rawDir, int index ) ``` @@ -244,10 +244,10 @@ const char* OH_ResourceManager_GetRawFileName (RawDir * rawDir, int index ) **参数:** - | Name | 描述 | -| -------- | -------- | -| rawDir | 表示指向[RawDir](#rawdir)的指针。 | -| index | 表示文件在[RawDir](#rawdir)中的索引位置。 | +| Name | 描述 | +| ------ | ----------------------------- | +| rawDir | 表示指向[RawDir](#rawdir)的指针。 | +| index | 表示文件在[RawDir](#rawdir)中的索引位置。 | **返回:** @@ -264,7 +264,7 @@ const char* OH_ResourceManager_GetRawFileName (RawDir * rawDir, int index ) ### OH_ResourceManager_GetRawFileOffset() - + ``` long OH_ResourceManager_GetRawFileOffset (const RawFile * rawFile) ``` @@ -277,9 +277,9 @@ rawfile当前的offset。 **参数:** - | Name | 描述 | -| -------- | -------- | -| rawFile | 表示指向[RawFile](#rawfile)的指针。 | +| Name | 描述 | +| ------- | --------------------------- | +| rawFile | 表示指向[RawFile](#rawfile)的指针。 | **返回:** @@ -292,7 +292,7 @@ rawfile当前的offset。 ### OH_ResourceManager_GetRawFileSize() - + ``` long OH_ResourceManager_GetRawFileSize (RawFile * rawFile) ``` @@ -303,9 +303,9 @@ long OH_ResourceManager_GetRawFileSize (RawFile * rawFile) **参数:** - | Name | 描述 | -| -------- | -------- | -| rawFile | 表示指向[RawFile](#rawfile)的指针。 | +| Name | 描述 | +| ------- | --------------------------- | +| rawFile | 表示指向[RawFile](#rawfile)的指针。 | **返回:** @@ -318,23 +318,23 @@ Returns rawfile整体长度。 ### OH_ResourceManager_InitNativeResourceManager() - + ``` NativeResourceManager* OH_ResourceManager_InitNativeResourceManager (napi_env env, napi_value jsResMgr ) ``` **描述:** -基于JavaScipt resource manager获取native resource manager。 +基于JavaScript resource manager获取native resource manager。 通过获取resource manager来完成rawfile相关功能。 **参数:** - | Name | 描述 | -| -------- | -------- | -| env | 表示JavaScipt Native Interface (napi)环境指针。 | -| jsResMgr | 表示JavaScipt resource manager。 | +| Name | 描述 | +| -------- | ---------------------------------------- | +| env | 表示JavaScript Native Interface (napi)环境指针。 | +| jsResMgr | 表示JavaScript resource manager。 | **返回:** @@ -347,7 +347,7 @@ NativeResourceManager* OH_ResourceManager_InitNativeResourceManager (napi_env en ### OH_ResourceManager_OpenRawDir() - + ``` RawDir* OH_ResourceManager_OpenRawDir (const NativeResourceManager * mgr, const char * dirName ) ``` @@ -360,10 +360,10 @@ RawDir* OH_ResourceManager_OpenRawDir (const NativeResourceManager * mgr, const **参数:** - | Name | 描述 | -| -------- | -------- | -| mgr | 表示指向[NativeResourceManager](#nativeresourcemanager)的指针,此指针是通过调用 [OH_ResourceManager_InitNativeResourceManager](#oh_resourcemanager_initnativeresourcemanager)方法获取的。 | -| dirName | 表示要打开的rawfile目录名称,当传递一个空字符串时表示打开rawfile根目录。 | +| Name | 描述 | +| ------- | ---------------------------------------- | +| mgr | 表示指向[NativeResourceManager](#nativeresourcemanager)的指针,此指针是通过调用 [OH_ResourceManager_InitNativeResourceManager](#oh_resourcemanager_initnativeresourcemanager)方法获取的。 | +| dirName | 表示要打开的rawfile目录名称,当传递一个空字符串时表示打开rawfile根目录。 | **返回:** @@ -382,7 +382,7 @@ RawDir* OH_ResourceManager_OpenRawDir (const NativeResourceManager * mgr, const ### OH_ResourceManager_OpenRawFile() - + ``` RawFile* OH_ResourceManager_OpenRawFile (const NativeResourceManager * mgr, const char * fileName ) ``` @@ -395,10 +395,10 @@ RawFile* OH_ResourceManager_OpenRawFile (const NativeResourceManager * mgr, cons **参数:** - | Name | 描述 | -| -------- | -------- | -| mgr | 表示指向[NativeResourceManager](#nativeresourcemanager)的指针,此指针是通过调用 [OH_ResourceManager_InitNativeResourceManager](#oh_resourcemanager_initnativeresourcemanager)方法获取的。 | -| fileName | 表示基于rawfile根目录的相对路径下的文件名称。 | +| Name | 描述 | +| -------- | ---------------------------------------- | +| mgr | 表示指向[NativeResourceManager](#nativeresourcemanager)的指针,此指针是通过调用 [OH_ResourceManager_InitNativeResourceManager](#oh_resourcemanager_initnativeresourcemanager)方法获取的。 | +| fileName | 表示基于rawfile根目录的相对路径下的文件名称。 | **返回:** @@ -417,7 +417,7 @@ RawFile* OH_ResourceManager_OpenRawFile (const NativeResourceManager * mgr, cons ### OH_ResourceManager_ReadRawFile() - + ``` int OH_ResourceManager_ReadRawFile (const RawFile * rawFile, void * buf, size_t length ) ``` @@ -430,11 +430,11 @@ int OH_ResourceManager_ReadRawFile (const RawFile * rawFile, void * buf, size_t **参数:** - | Name | 描述 | -| -------- | -------- | -| rawFile | 表示指向[RawFile](#rawfile)的指针。 | -| buf | 用于接收读取数据的缓冲区指针。 | -| length | 读取数据的字节长度。 | +| Name | 描述 | +| ------- | --------------------------- | +| rawFile | 表示指向[RawFile](#rawfile)的指针。 | +| buf | 用于接收读取数据的缓冲区指针。 | +| length | 读取数据的字节长度。 | **返回:** @@ -447,7 +447,7 @@ int OH_ResourceManager_ReadRawFile (const RawFile * rawFile, void * buf, size_t ### OH_ResourceManager_ReleaseNativeResourceManager() - + ``` void OH_ResourceManager_ReleaseNativeResourceManager (NativeResourceManager * resMgr) ``` @@ -458,9 +458,9 @@ void OH_ResourceManager_ReleaseNativeResourceManager (NativeResourceManager * re **参数:** - | Name | 描述 | -| -------- | -------- | -| resMgr | 表示[NativeResourceManager](#nativeresourcemanager)指针。 | +| Name | 描述 | +| ------ | ---------------------------------------- | +| resMgr | 表示[NativeResourceManager](#nativeresourcemanager)指针。 | **自从:** @@ -469,7 +469,7 @@ void OH_ResourceManager_ReleaseNativeResourceManager (NativeResourceManager * re ### OH_ResourceManager_ReleaseRawFileDescriptor() - + ``` bool OH_ResourceManager_ReleaseRawFileDescriptor (const RawFileDescriptor & descriptor) ``` @@ -482,9 +482,9 @@ bool OH_ResourceManager_ReleaseRawFileDescriptor (const RawFileDescriptor & desc **参数:** - | Name | 描述 | -| -------- | -------- | -| descriptor | 包含rawfile文件描述符,以及在HAP包中的起始位置和长度。 | +| Name | 描述 | +| ---------- | -------------------------------- | +| descriptor | 包含rawfile文件描述符,以及在HAP包中的起始位置和长度。 | **返回:** @@ -497,7 +497,7 @@ bool OH_ResourceManager_ReleaseRawFileDescriptor (const RawFileDescriptor & desc ### OH_ResourceManager_SeekRawFile() - + ``` int OH_ResourceManager_SeekRawFile (const RawFile * rawFile, long offset, int whence ) ``` @@ -508,11 +508,11 @@ int OH_ResourceManager_SeekRawFile (const RawFile * rawFile, long offset, int wh **参数:** - | Name | 描述 | -| -------- | -------- | -| rawFile | 表示指向[RawFile](#rawfile)的指针。 | -| offset | 表示指定的offset。 | -| whence | 读写位置,有以下场景:**0**: 读写位置为**offset****1**: 读写位置为当前位置加上**offset****2**: 读写位置为文件末尾(EOF)加上**offset**。 | +| Name | 描述 | +| ------- | ---------------------------------------- | +| rawFile | 表示指向[RawFile](#rawfile)的指针。 | +| offset | 表示指定的offset。 | +| whence | 读写位置,有以下场景:**0**: 读写位置为**offset****1**: 读写位置为当前位置加上**offset****2**: 读写位置为文件末尾(EOF)加上**offset**。 | **返回:** diff --git a/zh-cn/application-dev/ui/ui-ts-layout-grid-container.md b/zh-cn/application-dev/ui/ui-ts-layout-grid-container.md index e2cb433592b7c5e3c6240bcce1dbae9d4c6564bf..dc0945724c0725d20d1be7da73790dd602fe71ca 100644 --- a/zh-cn/application-dev/ui/ui-ts-layout-grid-container.md +++ b/zh-cn/application-dev/ui/ui-ts-layout-grid-container.md @@ -82,7 +82,7 @@ ### 栅格容器内子组件的栅格设置 -栅格容器中的组件使用通用属性useSizeType设置不同的设备宽度类型的占用列数和列偏移。其中span表示栅格容器组件占据columns的数量;offest表示列偏移量,指将组件放置在哪一个columns上。 如: +栅格容器中的组件使用通用属性useSizeType设置不同的设备宽度类型的占用列数和列偏移。其中span表示栅格容器组件占据columns的数量;offset表示列偏移量,指将组件放置在哪一个columns上。 如: ```ts GridContainer() {