未验证 提交 269f22c7 编写于 作者: O openharmony_ci 提交者: Gitee

!5486 sensor整改+语言标记+示例代码修改

Merge pull request !5486 from LiAn/master
...@@ -36,7 +36,7 @@ on(type: “change”, listener: Callback<DeviceListener>): void ...@@ -36,7 +36,7 @@ on(type: “change”, listener: Callback<DeviceListener>): void
let isPhysicalKeyboardExist = true; let isPhysicalKeyboardExist = true;
inputDevice.on("change", (data) => { inputDevice.on("change", (data) => {
console.log("type: " + data.type + ", deviceId: " + data.deviceId); console.log("type: " + data.type + ", deviceId: " + data.deviceId);
inputDevice.getKeyboardType(data.deviceId, (ret) => { inputDevice.getKeyboardType(data.deviceId, (err, ret) => {
console.log("The keyboard type of the device is: " + ret); console.log("The keyboard type of the device is: " + ret);
if (ret == inputDevice.KeyboardType.ALPHABETIC_KEYBOARD && data.type == 'add') { if (ret == inputDevice.KeyboardType.ALPHABETIC_KEYBOARD && data.type == 'add') {
// 监听物理键盘已连接。 // 监听物理键盘已连接。
...@@ -68,12 +68,12 @@ off(type: “change”, listener?: Callback<DeviceListener>): void ...@@ -68,12 +68,12 @@ off(type: “change”, listener?: Callback<DeviceListener>): void
**示例** **示例**
```js ```js
listener: function(data) { function listener(data) {
console.log("type: " + data.type + ", deviceId: " + data.deviceId); console.log("type: " + data.type + ", deviceId: " + data.deviceId);
} }
// 单独取消listener的监听。 // 单独取消listener的监听。
inputDevice.off("change", this.listener); inputDevice.off("change", listener);
// 取消所有监听。 // 取消所有监听。
inputDevice.off("change"); inputDevice.off("change");
...@@ -90,7 +90,7 @@ getDeviceIds(callback: AsyncCallback<Array<number>>): void ...@@ -90,7 +90,7 @@ getDeviceIds(callback: AsyncCallback<Array<number>>): void
**参数** **参数**
| 参数 | 类型 | 必填 | 说明 | | 参数 | 类型 | 必填 | 说明 |
| -------- | ---------------------------------------- | ---- | ----- | | -------- | ---------------------------------------- | ---- | ----- |
| callback | AsyncCallback<Array<number>> | 是 | 回调函数。 | | callback | AsyncCallback<Array<number>> | 是 | 回调函数。 |
...@@ -134,9 +134,9 @@ getDevice(deviceId: number, callback: AsyncCallback<InputDeviceData>): voi ...@@ -134,9 +134,9 @@ getDevice(deviceId: number, callback: AsyncCallback<InputDeviceData>): voi
**参数** **参数**
| 参数 | 类型 | 必填 | 说明 | | 参数 | 类型 | 必填 | 说明 |
| -------- | ---------------------------------------- | ---- | --------------------------- | | -------- | ---------------------------------------- | ---- | --------------------------- |
| deviceId | number | 是 | 需要获取信息的设备id。 | | deviceId | number | 是 | 需要获取信息的设备id。 |
| callback | AsyncCallback<[InputDeviceData](#inputdevicedata)> | 是 | 回调函数,异步返回InputDeviceData对象。 | | callback | AsyncCallback<[InputDeviceData](#inputdevicedata)> | 是 | 回调函数,异步返回InputDeviceData对象。 |
**示例** **示例**
...@@ -333,15 +333,15 @@ inputDevice.getKeyboardType(1).then((ret)=>{ ...@@ -333,15 +333,15 @@ inputDevice.getKeyboardType(1).then((ret)=>{
**系统能力**: 以下各项对应的系统能力均为SystemCapability.MultimodalInput.Input.InputDevice **系统能力**: 以下各项对应的系统能力均为SystemCapability.MultimodalInput.Input.InputDevice
| 名称 | 参数类型 | 说明 | | 名称 | 参数类型 | 说明 |
| ----------------------- | ------------------------- | ---------------- | | ----------------------- | ------------------------- | -------- |
| source | [SourceType](#sourcetype) | 轴的输入源类型。 | | source | [SourceType](#sourcetype) | 轴的输入源类型。 |
| axis | [AxisType](#axistype) | 轴的类型。 | | axis | [AxisType](#axistype) | 轴的类型。 |
| max | number | 轴的最大值。 | | max | number | 轴的最大值。 |
| min | number | 轴的最小值。 | | min | number | 轴的最小值。 |
| fuzz<sup>9+</sup> | number | 轴的模糊值。 | | fuzz<sup>9+</sup> | number | 轴的模糊值。 |
| flat<sup>9+</sup> | number | 轴的基准值。 | | flat<sup>9+</sup> | number | 轴的基准值。 |
| resolution<sup>9+</sup> | number | 轴的分辨率。 | | resolution<sup>9+</sup> | number | 轴的分辨率。 |
## SourceType ## SourceType
......
# 媒体查询 # 媒体查询
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:** > **说明:**
> 从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。 > 从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
## 导入模块 ## 导入模块
``` ```js
import mediaquery from '@ohos.mediaquery' import mediaquery from '@ohos.mediaquery'
``` ```
...@@ -22,19 +22,19 @@ matchMediaSync(condition: string): MediaQueryListener ...@@ -22,19 +22,19 @@ matchMediaSync(condition: string): MediaQueryListener
设置媒体查询的查询条件,并返回对应的监听句柄。 设置媒体查询的查询条件,并返回对应的监听句柄。
- 参数 **参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | --------- | ------ | ---- | ---------- |
| condition | string | 是 | 媒体事件的匹配条件。 | | condition | string | 是 | 媒体事件的匹配条件。 |
- 返回值 **返回值:**
| 类型 | 说明 | | 类型 | 说明 |
| -------- | -------- | | ------------------ | ---------------------- |
| MediaQueryListener | 媒体事件监听句柄,用于注册和去注册监听回调。 | | MediaQueryListener | 媒体事件监听句柄,用于注册和去注册监听回调。 |
- 示例 **示例:**
``` ```js
listener = mediaquery.matchMediaSync('(orientation: landscape)'); //监听横屏事件 let listener = mediaquery.matchMediaSync('(orientation: landscape)'); //监听横屏事件
``` ```
...@@ -45,10 +45,10 @@ matchMediaSync(condition: string): MediaQueryListener ...@@ -45,10 +45,10 @@ matchMediaSync(condition: string): MediaQueryListener
### 属性 ### 属性
| 名称 | 参数类型 | 可读 | 可写 | 说明 | | 名称 | 参数类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- | | ------- | ------- | ---- | ---- | ---------- |
| matches | boolean | 是 | 否 | 是否符合匹配条件。 | | matches | boolean | 是 | 否 | 是否符合匹配条件。 |
| media | string | 是 | 否 | 媒体事件的匹配条件。 | | media | string | 是 | 否 | 媒体事件的匹配条件。 |
### on ### on
...@@ -57,13 +57,13 @@ on(type: 'change', callback: Callback&lt;MediaQueryResult&gt;): void ...@@ -57,13 +57,13 @@ on(type: 'change', callback: Callback&lt;MediaQueryResult&gt;): void
通过句柄向对应的查询条件注册回调,当媒体属性发生变更时会触发该回调。 通过句柄向对应的查询条件注册回调,当媒体属性发生变更时会触发该回调。
- 参数 **参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------------------------------- | ---- | ---------------- |
| type | string | 是 | 必须填写字符串'change'。 | | type | string | 是 | 必须填写字符串'change'。 |
| callback | Callback&lt;MediaQueryResult&gt; | 是 | 向媒体查询注册的回调 | | callback | Callback&lt;MediaQueryResult&gt; | 是 | 向媒体查询注册的回调 |
- 示例 **示例:**
详见[off示例](#off) 详见[off示例](#off)
...@@ -72,14 +72,14 @@ on(type: 'change', callback: Callback&lt;MediaQueryResult&gt;): void ...@@ -72,14 +72,14 @@ on(type: 'change', callback: Callback&lt;MediaQueryResult&gt;): void
off(type: 'change', callback?: Callback&lt;MediaQueryResult&gt;): void off(type: 'change', callback?: Callback&lt;MediaQueryResult&gt;): void
通过句柄向对应的查询条件去注册回调,当媒体属性发生变更时不在触发指定的回调。 通过句柄向对应的查询条件去注册回调,当媒体属性发生变更时不在触发指定的回调。
- 参数 **参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------------------------------- | ---- | ----------------------------- |
| type | boolean | 是 | 必须填写字符串'change'。 | | type | boolean | 是 | 必须填写字符串'change'。 |
| callback | Callback&lt;MediaQueryResult&gt; | 否 | 需要去注册的回调,如果参数缺省则去注册该句柄下所有的回调。 | | callback | Callback&lt;MediaQueryResult&gt; | 否 | 需要去注册的回调,如果参数缺省则去注册该句柄下所有的回调。 |
- 示例 **示例:**
``` ```js
import mediaquery from '@ohos.mediaquery' import mediaquery from '@ohos.mediaquery'
let listener = mediaquery.matchMediaSync('(orientation: landscape)'); //监听横屏事件 let listener = mediaquery.matchMediaSync('(orientation: landscape)'); //监听横屏事件
...@@ -90,8 +90,8 @@ off(type: 'change', callback?: Callback&lt;MediaQueryResult&gt;): void ...@@ -90,8 +90,8 @@ off(type: 'change', callback?: Callback&lt;MediaQueryResult&gt;): void
// do something here // do something here
} }
} }
this.listener.on('change', this.onPortrait) // 注册回调 listener.on('change', onPortrait) // 注册回调
this.listener.off('change', this.onPortrait) // 去注册回调 listener.off('change', onPortrait) // 去注册回调
``` ```
...@@ -100,15 +100,15 @@ off(type: 'change', callback?: Callback&lt;MediaQueryResult&gt;): void ...@@ -100,15 +100,15 @@ off(type: 'change', callback?: Callback&lt;MediaQueryResult&gt;): void
### 属性 ### 属性
| 名称 | 参数类型 | 可读 | 可写 | 说明 | | 名称 | 参数类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- | | ------- | ------- | ---- | ---- | ---------- |
| matches | boolean | 是 | 否 | 是否符合匹配条件。 | | matches | boolean | 是 | 否 | 是否符合匹配条件。 |
| media | string | 是 | 否 | 媒体事件的匹配条件。 | | media | string | 是 | 否 | 媒体事件的匹配条件。 |
### 示例 ### 示例
``` ```js
import mediaquery from '@ohos.mediaquery' import mediaquery from '@ohos.mediaquery'
let portraitFunc = null let portraitFunc = null
......
...@@ -11,7 +11,7 @@ ...@@ -11,7 +11,7 @@
## 导入模块 ## 导入模块
``` ```js
import prompt from '@system.prompt'; import prompt from '@system.prompt';
``` ```
...@@ -31,7 +31,7 @@ showToast(options: ShowToastOptions): void ...@@ -31,7 +31,7 @@ showToast(options: ShowToastOptions): void
**示例:** **示例:**
``` ```js
export default { export default {
showToast() { showToast() {
prompt.showToast({ prompt.showToast({
...@@ -60,7 +60,7 @@ showDialog(options: ShowDialogOptions): void ...@@ -60,7 +60,7 @@ showDialog(options: ShowDialogOptions): void
**示例:** **示例:**
``` ```js
export default { export default {
showDialog() { showDialog() {
prompt.showDialog({ prompt.showDialog({
...@@ -100,7 +100,7 @@ showActionMenu(options: ShowActionMenuOptions): void ...@@ -100,7 +100,7 @@ showActionMenu(options: ShowActionMenuOptions): void
**示例:** **示例:**
``` ```js
export default { export default {
showActionMenu() { showActionMenu() {
prompt.showActionMenu({ prompt.showActionMenu({
...@@ -115,11 +115,11 @@ export default { ...@@ -115,11 +115,11 @@ export default {
color: '#000000', color: '#000000',
}, },
], ],
success: function(data) { success: function(tapIndex) {
console.log('dialog success callback,click button : ' + data.tapIndex); console.log('dialog success callback,click button : ' + tapIndex);
}, },
fail: function(data) { fail: function(errMsg) {
console.log('dialog fail callback' + data.errMsg); console.log('dialog fail callback' + errMsg);
}, },
}); });
} }
......
# 页面路由 # 页面路由
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:** > **说明:**
> >
> - 从API Version 8 开始,该接口不再维护,推荐使用新接口[`@ohos.router`](js-apis-router.md)。 > - 从API Version 8 开始,该接口不再维护,推荐使用新接口[`@ohos.router`](js-apis-router.md)。
> >
...@@ -11,7 +11,7 @@ ...@@ -11,7 +11,7 @@
## 导入模块 ## 导入模块
``` ```js
import router from '@system.router'; import router from '@system.router';
``` ```
...@@ -31,7 +31,7 @@ push(options: RouterOptions): void ...@@ -31,7 +31,7 @@ push(options: RouterOptions): void
**示例:** **示例:**
``` ```js
// 在当前页面中 // 在当前页面中
export default { export default {
pushPage() { pushPage() {
...@@ -49,7 +49,7 @@ export default { ...@@ -49,7 +49,7 @@ export default {
``` ```
``` ```js
// 在routerpage2页面中 // 在routerpage2页面中
export default { export default {
data: { data: {
...@@ -85,7 +85,7 @@ replace(options: RouterOptions): void ...@@ -85,7 +85,7 @@ replace(options: RouterOptions): void
**示例:** **示例:**
``` ```js
// 在当前页面中 // 在当前页面中
export default { export default {
replacePage() { replacePage() {
...@@ -100,7 +100,7 @@ export default { ...@@ -100,7 +100,7 @@ export default {
``` ```
``` ```js
// 在detail页面中 // 在detail页面中
export default { export default {
data: { data: {
...@@ -128,7 +128,7 @@ back(options?: BackRouterOptions): void ...@@ -128,7 +128,7 @@ back(options?: BackRouterOptions): void
**示例:** **示例:**
``` ```js
// index页面 // index页面
export default { export default {
indexPushPage() { indexPushPage() {
...@@ -140,7 +140,7 @@ export default { ...@@ -140,7 +140,7 @@ export default {
``` ```
``` ```js
// detail页面 // detail页面
export default { export default {
detailPushPage() { detailPushPage() {
...@@ -152,7 +152,7 @@ export default { ...@@ -152,7 +152,7 @@ export default {
``` ```
``` ```js
// mall页面通过back,将返回detail页面 // mall页面通过back,将返回detail页面
export default { export default {
mallBackPage() { mallBackPage() {
...@@ -162,7 +162,7 @@ export default { ...@@ -162,7 +162,7 @@ export default {
``` ```
``` ```js
// detail页面通过back,将返回index页面 // detail页面通过back,将返回index页面
export default { export default {
defaultBack() { defaultBack() {
...@@ -172,7 +172,7 @@ export default { ...@@ -172,7 +172,7 @@ export default {
``` ```
``` ```js
// 通过back,返回到detail页面 // 通过back,返回到detail页面
export default { export default {
backToDetail() { backToDetail() {
...@@ -208,7 +208,7 @@ clear(): void ...@@ -208,7 +208,7 @@ clear(): void
**示例:** **示例:**
``` ```js
export default { export default {
clearPage() { clearPage() {
router.clear(); router.clear();
...@@ -232,7 +232,7 @@ getLength(): string ...@@ -232,7 +232,7 @@ getLength(): string
**示例:** **示例:**
``` ```js
export default { export default {
getLength() { getLength() {
var size = router.getLength(); var size = router.getLength();
...@@ -257,7 +257,7 @@ getState(): RouterState ...@@ -257,7 +257,7 @@ getState(): RouterState
**示例:** **示例:**
``` ```js
export default { export default {
getState() { getState() {
var page = router.getState(); var page = router.getState();
...@@ -284,7 +284,7 @@ enableAlertBeforeBackPage(options: EnableAlertBeforeBackPageOptions): void ...@@ -284,7 +284,7 @@ enableAlertBeforeBackPage(options: EnableAlertBeforeBackPageOptions): void
**示例:** **示例:**
``` ```js
export default { export default {
enableAlertBeforeBackPage() { enableAlertBeforeBackPage() {
router.enableAlertBeforeBackPage({ router.enableAlertBeforeBackPage({
...@@ -292,8 +292,8 @@ export default { ...@@ -292,8 +292,8 @@ export default {
success: function() { success: function() {
console.log('success'); console.log('success');
}, },
fail: function() { cancel: function() {
console.log('fail'); console.log('cancel');
}, },
}); });
} }
...@@ -316,15 +316,15 @@ disableAlertBeforeBackPage(options?: DisableAlertBeforeBackPageOptions): void ...@@ -316,15 +316,15 @@ disableAlertBeforeBackPage(options?: DisableAlertBeforeBackPageOptions): void
**示例:** **示例:**
``` ```js
export default { export default {
disableAlertBeforeBackPage() { disableAlertBeforeBackPage() {
router.disableAlertBeforeBackPage({ router.disableAlertBeforeBackPage({
success: function() { success: function() {
console.log('success'); console.log('success');
}, },
fail: function() { cancel: function() {
console.log('fail'); console.log('cancel');
}, },
}); });
} }
......
...@@ -6,7 +6,7 @@ ...@@ -6,7 +6,7 @@
## 导入模块 ## 导入模块
``` ```js
import curves from '@ohos.curves' import curves from '@ohos.curves'
``` ```
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册