diff --git a/zh-cn/application-dev/reference/apis/js-apis-inputmethod-engine.md b/zh-cn/application-dev/reference/apis/js-apis-inputmethod-engine.md index 45d8aaee5347066cb3c418ab765b0b7673430cee..19e71eb8a514a307bc33b84c5582acdee70dd6aa 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inputmethod-engine.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inputmethod-engine.md @@ -1,9 +1,8 @@ # 输入法服务 - 本模块的作用是拉通应用和输入法，保证应用可以通过输入法进行文本输入，以及应用与输入法服务的绑定、应用对输入法的显示和隐藏请求、监听输入法当前的状态等等。 +本模块的作用是拉通普通应用和输入法应用，功能包括：普通应用通过输入法应用进行文本输入、普通应用与输入法服务绑定、普通应用对输入法应用进行显示请求和隐藏请求、普通应用对输入法应用当前状态进行监听等等。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** -> 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 +> **说明：**
本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 ## 导入模块 @@ -11,47 +10,47 @@ import inputMethodEngine from '@ohos.inputmethodengine'; ``` -## inputMethodEngine - -常量值。 - -**系统能力**：以下各项对应的系统能力均为SystemCapability.MiscServices.InputMethodFramework - -| 名称 | 参数类型 | 可读 | 可写 | 说明 | -| -------- | -------- | -------- | -------- | -------- | -| ENTER_KEY_TYPE_UNSPECIFIED | number | 是 | 否 | 无功能键。 | -| ENTER_KEY_TYPE_GO | number | 是 | 否 | “前往”功能键。 | -| ENTER_KEY_TYPE_SEARCH | number | 是 | 否 | “搜索”功能键。 | -| ENTER_KEY_TYPE_SEND | number | 是 | 否 | “发送”功能键。 | -| ENTER_KEY_TYPE_NEXT | number | 是 | 否 | “下一个”功能键。 | -| ENTER_KEY_TYPE_DONE | number | 是 | 否 | “回车”功能键。 | -| ENTER_KEY_TYPE_PREVIOUS | number | 是 | 否 | “前一个”功能键。 | -| PATTERN_NULL | number | 是 | 否 | 无特殊性编辑框。 | -| PATTERN_TEXT | number | 是 | 否 | 文本编辑框。 | -| PATTERN_NUMBER | number | 是 | 否 | 数字编辑框。 | -| PATTERN_PHONE | number | 是 | 否 | 电话号码编辑框。 | -| PATTERN_DATETIME | number | 是 | 否 | 日期编辑框。 | -| PATTERN_EMAIL | number | 是 | 否 | 邮件编辑框。 | -| PATTERN_URI | number | 是 | 否 | 超链接编辑框。 | -| PATTERN_PASSWORD | number | 是 | 否 | 密码编辑框。 | -| OPTION_ASCII | number | 是 | 否 | 允许输入ASCII值。 | -| OPTION_NONE | number | 是 | 否 | 不指定编辑框输入属性。 | -| OPTION_AUTO_CAP_CHARACTERS | number | 是 | 否 | 允许输入字符。 | -| OPTION_AUTO_CAP_SENTENCES | number | 是 | 否 | 允许输入句子。 | -| OPTION_AUTO_WORDS | number | 是 | 否 | 允许输入单词。 | -| OPTION_MULTI_LINE | number | 是 | 否 | 允许输入多行。 | -| OPTION_NO_FULLSCREEN | number | 是 | 否 | 半屏样式。 | -| FLAG_SELECTING | number | 是 | 否 | 编辑框处于选择状态。 | -| FLAG_SINGLE_LINE | number | 是 | 否 | 编辑框为单行。 | -| DISPLAY_MODE_PART | number | 是 | 否 | 编辑框显示为半屏。 | -| DISPLAY_MODE_FULL | number | 是 | 否 | 编辑框显示为全屏。 | -| CURSOR_UP9+ | number | 是 | 否 | 光标上移。 | -| CURSOR_DOWN9+ | number | 是 | 否 | 光标下移。 | -| CURSOR_LEFT9+ | number | 是 | 否 | 光标左移。 | -| CURSOR_RIGHT9+ | number | 是 | 否 | 光标右移。 | -| WINDOW_TYPE_INPUT_METHOD_FLOAT9+ | number | 是 | 否 | 输入法应用窗口风格标识。 | - -## inputMethodEngine.getInputMethodAbility9+ +## 常量 + +功能键常量值、编辑框常量值及光标常量值。 + +**系统能力**：SystemCapability.MiscServices.InputMethodFramework + +| 名称 | 参数类型 | 值 | 说明 | +| -------- | -------- | -------- | -------- | +| ENTER_KEY_TYPE_UNSPECIFIED | number | 0 | 无功能键。 | +| ENTER_KEY_TYPE_GO | number | 2 | “前往”功能键。 | +| ENTER_KEY_TYPE_SEARCH | number | 3 | “搜索”功能键。 | +| ENTER_KEY_TYPE_SEND | number | 4 | “发送”功能键。 | +| ENTER_KEY_TYPE_NEXT | number | 5 | “下一个”功能键。 | +| ENTER_KEY_TYPE_DONE | number | 6 | “回车”功能键。 | +| ENTER_KEY_TYPE_PREVIOUS | number | 7 | “前一个”功能键。 | +| PATTERN_NULL | number | -1 | 无特殊性编辑框。 | +| PATTERN_TEXT | number | 0 | 文本编辑框。 | +| PATTERN_NUMBER | number | 2 | 数字编辑框。 | +| PATTERN_PHONE | number | 3 | 电话号码编辑框。 | +| PATTERN_DATETIME | number | 4 | 日期编辑框。 | +| PATTERN_EMAIL | number | 5 | 邮件编辑框。 | +| PATTERN_URI | number | 6 | 超链接编辑框。 | +| PATTERN_PASSWORD | number | 7 | 密码编辑框。 | +| OPTION_ASCII | number | 20 | 允许输入ASCII值。 | +| OPTION_NONE | number | 0 | 不指定编辑框输入属性。 | +| OPTION_AUTO_CAP_CHARACTERS | number | 2 | 允许输入字符。 | +| OPTION_AUTO_CAP_SENTENCES | number | 8 | 允许输入句子。 | +| OPTION_AUTO_WORDS | number | 4 | 允许输入单词。 | +| OPTION_MULTI_LINE | number | 1 | 允许输入多行。 | +| OPTION_NO_FULLSCREEN | number | 10 | 半屏样式。 | +| FLAG_SELECTING | number | 2 | 编辑框处于选择状态。 | +| FLAG_SINGLE_LINE | number | 1 | 编辑框为单行。 | +| DISPLAY_MODE_PART | number | 0 | 编辑框显示为半屏。 | +| DISPLAY_MODE_FULL | number | 1 | 编辑框显示为全屏。 | +| CURSOR_UP9+ | number | 1 | 光标上移。 | +| CURSOR_DOWN9+ | number | 2 | 光标下移。 | +| CURSOR_LEFT9+ | number | 3 | 光标左移。 | +| CURSOR_RIGHT9+ | number | 4 | 光标右移。 | +| WINDOW_TYPE_INPUT_METHOD_FLOAT9+ | number | 2105 | 输入法应用窗口风格标识。 | + +## inputMethodEngine.getInputMethodAbility9+ getInputMethodAbility(): InputMethodAbility @@ -71,7 +70,7 @@ getInputMethodAbility(): InputMethodAbility let InputMethodAbility = inputMethodAbility.getInputMethodAbility(); ``` -## inputMethodEngine.getKeyboardDelegate9+ +## inputMethodEngine.getKeyboardDelegate9+ getKeyboardDelegate(): KeyboardDelegate @@ -83,7 +82,7 @@ getKeyboardDelegate(): KeyboardDelegate | 类型 | 说明 | | ------------------------------------- | ---------------- | -| [KeyboardDelegate](#KeyboardDelegate) | 客户端监听实例。 | +| [KeyboardDelegate](#keyboarddelegate) | 客户端监听实例。 | **示例：** @@ -91,14 +90,13 @@ getKeyboardDelegate(): KeyboardDelegate let KeyboardDelegate = inputMethodAbility.getKeyboardDelegate(); ``` -## inputMethodEngine.getInputMethodEngine(deprecated) +## inputMethodEngine.getInputMethodEngine(deprecated) getInputMethodEngine(): InputMethodEngine 获取服务端实例。 -> **说明：** -> 从API version 8开始支持，API version 9开始废弃, 建议使用[getInputMethodAbility()](#getInputMethodAbility)替代 +> **说明：**
从API version 8开始支持，API version 9开始废弃, 建议使用[getInputMethodAbility()](#inputmethodenginegetinputmethodability9)替代 **系统能力**： SystemCapability.MiscServices.InputMethodFramework @@ -114,14 +112,13 @@ getInputMethodEngine(): InputMethodEngine let InputMethodEngine = inputMethodEngine.getInputMethodEngine(); ``` -## inputMethodEngine.createKeyboardDelegate(deprecated) +## inputMethodEngine.createKeyboardDelegate(deprecated) createKeyboardDelegate(): KeyboardDelegate 获取客户端监听实例。 -> **说明：** -> 从API version 8开始支持，API version 9开始废弃, 建议使用[getKeyboardDelegate()](#getKeyboardDelegate)替代 +> **说明：**
从API version 8开始支持，API version 9开始废弃, 建议使用[getKeyboardDelegate()](#inputmethodenginegetkeyboarddelegate9)替代。 **系统能力**： SystemCapability.MiscServices.InputMethodFramework @@ -137,11 +134,11 @@ createKeyboardDelegate(): KeyboardDelegate let KeyboardDelegate = inputMethodEngine.createKeyboardDelegate(); ``` -## InputMethodEngine +## InputMethodEngine -下列API示例中都需使用[getInputMethodEngine](#getInputMethodEngine)回调获取到InputMethodEngine实例，再通过此实例调用对应方法。 +下列API示例中都需使用[getInputMethodEngine](#inputmethodenginegetinputmethodenginedeprecated)回调获取到InputMethodEngine实例，再通过此实例调用对应方法。 -### on('inputStart') +### on('inputStart') on(type: 'inputStart', callback: (kbController: KeyboardController, textInputClient: TextInputClient) => void): void @@ -334,11 +331,11 @@ inputMethodEngine.getInputMethodEngine().off('keyboardHide', () => { }); ``` -## InputMethodAbility +## InputMethodAbility -下列API示例中都需使用[getInputMethodAbility](#getInputMethodAbility)回调获取到InputMethodAbility实例，再通过此实例调用对应方法。 +下列API示例中都需使用[getInputMethodAbility](#inputmethodenginegetinputmethodability9)回调获取到InputMethodAbility实例，再通过此实例调用对应方法。 -### on('inputStart')9+ +### on('inputStart')9+ on(type: 'inputStart', callback: (kbController: KeyboardController, inputClient: InputClient) => void): void @@ -351,7 +348,7 @@ on(type: 'inputStart', callback: (kbController: KeyboardController, inputClient: | 参数名 | 类型 | 必填 | 说明 | | -------- | ------------------------------- | ---- | ------------------------------------------------------------ | | type | string | 是 | 设置监听类型。
-type为‘inputStart’时表示订阅输入法绑定。 | -| callback | [KeyboardController](#keyboardcontroller), [InputClient](#inputclient-9) | 是 | 回调函数，返回输入法操作相关实例。 | +| callback | [KeyboardController](#keyboardcontroller), [InputClient](#inputclient9) | 是 | 回调函数，返回输入法操作相关实例。 | **示例：** @@ -375,7 +372,7 @@ off(type: 'inputStart', callback?: (kbController: KeyboardController, inputClien | 参数名 | 类型 | 必填 | 说明 | | -------- | -------------------- | ---- | ------------------------ | | type | string | 是 | 设置监听类型。
-type为‘inputStart’时表示订阅输入法绑定。 | -| callback | [KeyboardController](#keyboardcontroller), [InputClient](#inputclient) | 否 | 回调函数，返回输入法操作相关实例。 | +| callback | [KeyboardController](#keyboardcontroller), [InputClient](#inputclient9) | 否 | 回调函数，返回输入法操作相关实例。 | **示例：** @@ -575,9 +572,9 @@ inputMethodEngine.getInputMethodAbility().off('setSubtype', () => { }); ``` -## KeyboardDelegate +## KeyboardDelegate -下列API示例中都需使用[getKeyboardDelegate](#getKeyboardDelegate)回调获取到KeyboardDelegate实例，再通过此实例调用对应方法。 +下列API示例中都需使用[getKeyboardDelegate](#inputmethodenginegetkeyboarddelegate9)回调获取到KeyboardDelegate实例，再通过此实例调用对应方法。 ### on('keyDown'|'keyUp') @@ -783,9 +780,9 @@ inputMethodEngine.getKeyboardDelegate().off('textChange', (text) => { }); ``` -## KeyboardController +## KeyboardController -下列API示例中都需使用[inputStart](#inputStart9)回调获取到KeyboardController实例，再通过此实例调用对应方法。 +下列API示例中都需使用[inputStart](#oninputstart9)回调获取到KeyboardController实例，再通过此实例调用对应方法。 ### hide9+ @@ -799,7 +796,7 @@ hide(callback: AsyncCallback<void>): void | 参数名 | 类型 | 必填 | 说明 | | -------- | ---------------------- | ---- | -------- | -| callback | AsyncCallback<void> | 否 | 回调函数。当输入法隐藏成功，err为undefined，否则为错误对象 | +| callback | AsyncCallback<void> | 否 | 回调函数。当输入法隐藏成功，err为undefined，否则为错误对象。 | **错误码：** @@ -833,7 +830,7 @@ hide(): Promise<void> | 类型 | 说明 | | ---------------- | ------------------------- | -| Promise<void> | Promise对象。无返回结果的Promise对象。 | +| Promise<void> | 无返回结果的Promise对象。 | **错误码：** @@ -861,7 +858,7 @@ hideKeyboard(callback: AsyncCallback<void>): void 隐藏输入法。使用callback异步回调。 -> **说明：** +> **说明：**
> 从API version 8开始支持，API version 9开始废弃, 建议使用[hide](#hide9)替代。 **系统能力**： SystemCapability.MiscServices.InputMethodFramework @@ -890,7 +887,7 @@ hideKeyboard(): Promise<void> 隐藏输入法。使用promise异步回调。 -> **说明：** +> **说明：**
> 从API version 8开始支持，API version 9开始废弃, 建议使用[hide](#hide9-1)替代。 **系统能力**： SystemCapability.MiscServices.InputMethodFramework @@ -899,7 +896,7 @@ hideKeyboard(): Promise<void> | 类型 | 说明 | | ---------------- | ------------------------- | -| Promise<void> | Promise对象。无返回结果的Promise对象。 | +| Promise<void> | 无返回结果的Promise对象。 | **示例：** @@ -913,9 +910,9 @@ async function InputMethodEngine() { } ``` -## InputClient9+ +## InputClient9+ -下列API示例中都需使用[inputStart](#inputStart9)回调获取到InputClient实例，再通过此实例调用对应方法。 +下列API示例中都需使用[inputStart](#oninputstart9)回调获取到InputClient实例，再通过此实例调用对应方法。 ### sendKeyFunction9+ @@ -1283,7 +1280,7 @@ deleteBackward(length:number, callback: AsyncCallback<boolean>): void **系统能力**： SystemCapability.MiscServices.InputMethodFramework - **参数：** +**参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | ---------------------------- | ---- | -------------- | @@ -1582,7 +1579,7 @@ moveCursor(direction: number): Promise<void> | 类型 | 说明 | | ------------------- | ------------------------- | -| Promise<void> | Promise对象。无返回结果的Promise对象。 | +| Promise<void> | 无返回结果的Promise对象。 | **错误码：** @@ -1612,31 +1609,31 @@ async function InputMethodAbility() { } ``` -## EditorAttribute +## EditorAttribute 编辑框属性值。 -**系统能力**：以下各项对应的系统能力均为SystemCapability.MiscServices.InputMethodFramework +**系统能力**：SystemCapability.MiscServices.InputMethodFramework | 名称 | 参数类型 | 可读 | 可写 | 说明 | | ------------ | -------- | ---- | ---- | ------------------ | | enterKeyType | number | 是 | 否 | 编辑框的功能属性。 | | inputPattern | number | 是 | 否 | 编辑框的文本属性。 | -## KeyEvent +## KeyEvent 按键属性值。 -**系统能力**：以下各项对应的系统能力均为SystemCapability.MiscServices.InputMethodFramework +**系统能力**：SystemCapability.MiscServices.InputMethodFramework | 名称 | 参数类型 | 可读 | 可写 | 说明 | | --------- | -------- | ---- | ---- | ------------ | | keyCode | number | 是 | 否 | 按键的键值。 | | keyAction | number | 是 | 否 | 按键的状态。 | -## TextInputClient +## TextInputClient -下列API示例中都需使用[inputStart](#inputStart)回调获取到TextInputClient实例，再通过此实例调用对应方法。 +下列API示例中都需使用[inputStart](#oninputstart)回调获取到TextInputClient实例，再通过此实例调用对应方法。 ### getForward(deprecated) @@ -1644,7 +1641,7 @@ getForward(length:number, callback: AsyncCallback<string>): void 获取光标前固定长度的文本。使用callback异步回调。 -> **说明：** +> **说明：**
> 从API version 8开始支持，API version 9开始废弃, 建议使用[getForward](#getforward9)替代。 **系统能力**： SystemCapability.MiscServices.InputMethodFramework @@ -1675,7 +1672,7 @@ getForward(length:number): Promise<string> 获取光标前固定长度的文本。使用promise异步回调。 -> **说明：** +> **说明：**
> 从API version 8开始支持，API version 9开始废弃, 建议使用[getForward](#getforward9)替代 **系统能力**： SystemCapability.MiscServices.InputMethodFramework @@ -1711,7 +1708,7 @@ getBackward(length:number, callback: AsyncCallback<string>): void 获取光标后固定长度的文本。使用callback异步回调。 -> **说明：** +> **说明：**
> 从API version 8开始支持，API version 9开始废弃, 建议使用[getBackward](#getbackward9)替代 **系统能力**： SystemCapability.MiscServices.InputMethodFramework @@ -1742,7 +1739,7 @@ getBackward(length:number): Promise<string> 获取光标后固定长度的文本。使用promise异步回调。 -> **说明：** +> **说明：**
> 从API version 8开始支持，API version 9开始废弃, 建议使用[getBackward](#getbackward9)替代 **系统能力**： SystemCapability.MiscServices.InputMethodFramework @@ -1778,7 +1775,7 @@ deleteForward(length:number, callback: AsyncCallback<boolean>): void 删除光标前固定长度的文本。使用callback异步回调。 -> **说明：** +> **说明：**
> 从API version 8开始支持，API version 9开始废弃, 建议使用[deleteForward](#deleteforward9)替代 **系统能力**： SystemCapability.MiscServices.InputMethodFramework @@ -1813,7 +1810,7 @@ deleteForward(length:number): Promise<boolean> 删除光标前固定长度的文本。使用promise异步回调。 -> **说明：** +> **说明：**
> 从API version 8开始支持，API version 9开始废弃, 建议使用[deleteForward](#deleteforward9)替代 **系统能力**： SystemCapability.MiscServices.InputMethodFramework @@ -1853,7 +1850,7 @@ deleteBackward(length:number, callback: AsyncCallback<boolean>): void 删除光标后固定长度的文本。使用callback异步回调。 -> **说明：** +> **说明：**
> 从API version 8开始支持，API version 9开始废弃, 建议使用[deleteBackward](#deletebackward9)替代 **系统能力**： SystemCapability.MiscServices.InputMethodFramework @@ -1888,7 +1885,7 @@ deleteBackward(length:number): Promise<boolean> 删除光标后固定长度的文本。使用callback异步回调。 -> **说明：** +> **说明：**
> 从API version 8开始支持，API version 9开始废弃, 建议使用[deleteBackward](#deletebackward9)替代 **系统能力**： SystemCapability.MiscServices.InputMethodFramework @@ -1927,7 +1924,7 @@ sendKeyFunction(action:number, callback: AsyncCallback<boolean>): void 发送功能键。使用callback异步回调。 -> **说明：** +> **说明：**
> 从API version 8开始支持，API version 9开始废弃, 建议使用[sendKeyFunction](#sendkeyfunction9)替代 **系统能力**： SystemCapability.MiscServices.InputMethodFramework @@ -1961,7 +1958,7 @@ sendKeyFunction(action:number): Promise<boolean> 发送功能键。使用promise异步回调。 -> **说明：** +> **说明：**
> 从API version 8开始支持，API version 9开始废弃, 建议使用[sendKeyFunction](#sendkeyfunction9)替代 **系统能力**： SystemCapability.MiscServices.InputMethodFramework @@ -2000,7 +1997,7 @@ insertText(text:string, callback: AsyncCallback<boolean>): void 插入文本。使用callback异步回调。 -> **说明：** +> **说明：**
> 从API version 8开始支持，API version 9开始废弃, 建议使用[insertText](#inserttext9)替代 **系统能力**： SystemCapability.MiscServices.InputMethodFramework @@ -2034,7 +2031,7 @@ insertText(text:string): Promise<boolean> 插入文本。使用promise异步回调。 -> **说明：** +> **说明：**
> 从API version 8开始支持，API version 9开始废弃, 建议使用[insertText](#inserttext9)替代 **系统能力**： SystemCapability.MiscServices.InputMethodFramework @@ -2073,7 +2070,7 @@ getEditorAttribute(callback: AsyncCallback<EditorAttribute>): void 获取编辑框属性值。使用callback异步回调。 -> **说明：** +> **说明：**
> 从API version 8开始支持，API version 9开始废弃, 建议使用[getEditorAttribute](#geteditorattribute9)替代 **系统能力**： SystemCapability.MiscServices.InputMethodFramework @@ -2103,7 +2100,7 @@ getEditorAttribute(): Promise<EditorAttribute> 获取编辑框属性值。使用promise异步回调。 -> **说明：** +> **说明：**
> 从API version 8开始支持，API version 9开始废弃, 建议使用[getEditorAttribute](#geteditorattribute9)替代 **系统能力**： SystemCapability.MiscServices.InputMethodFramework diff --git a/zh-cn/application-dev/reference/apis/js-apis-inputmethod-extension-ability.md b/zh-cn/application-dev/reference/apis/js-apis-inputmethod-extension-ability.md index af6975561b9dfcd1ff82e4721cde48f9ec5bdce7..dba06e3e409b205a61c8d450dc1602b6bc8c0213 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inputmethod-extension-ability.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inputmethod-extension-ability.md @@ -1,10 +1,8 @@ # InputMethodExtensionAbility -InputMethodExtensionAbility模块，提供生态输入法应用开发者通过InputMethodExtensionAbility、InputMethodExtensionContext接口创作输入法应用，并管理输入法应用生命周期。 +开发者可通过继承本模块开发自己的输入法应用并管理输入法应用生命周期。 -> **说明：** -> -> - 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 +> **说明：**
本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 ## 导入模块 @@ -37,7 +35,7 @@ Extension生命周期回调，在拉起Extension输入法应用时调用，执 **示例：** -```ts +```js class InputMethodExt extends InputMethodExtensionAbility { onCreate(want) { console.log('onCreate, want:' + want.abilityName); @@ -56,7 +54,7 @@ Extension生命周期回调，在销毁输入法应用时回调，执行资源 **示例：** -```ts +```js class InputMethodExt extends InputMethodExtensionAbility { onDestroy() { console.log('onDestroy'); diff --git a/zh-cn/application-dev/reference/apis/js-apis-inputmethod-extension-context.md b/zh-cn/application-dev/reference/apis/js-apis-inputmethod-extension-context.md index ca7f615bcb7de4a2ced893973e14d9d4d6e340a1..0b225e801db95d1c11fa5b5df9354aadf11a109a 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inputmethod-extension-context.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inputmethod-extension-context.md @@ -4,9 +4,7 @@ InputMethodExtensionContext模块是InputMethodExtensionAbility的上下文环 InputMethodExtensionContext模块提供InputMethodExtensionAbility具有的能力和接口，包括启动、停止、绑定、解绑Ability。 -> **说明：** -> -> - 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 +> **说明：**
本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 ## 导入模块 @@ -18,7 +16,7 @@ import InputMethodExtensionContext from '@ohos.inputmethodextensioncontext'; 在使用InputMethodExtensionContext的功能前，需要通过InputMethodExtensionAbility子类实例获取。 -```ts +```js import InputMethodExtensionAbility from '@ohos.inputmethodextensionability'; class MainAbility extends InputMethodExtensionAbility { onCreate() { @@ -27,7 +25,7 @@ class MainAbility extends InputMethodExtensionAbility { } ``` -## InputMethodExtensionContext.destroy9+ +## InputMethodExtensionContext.destroy destroy(callback: AsyncCallback\): void @@ -39,21 +37,21 @@ destroy(callback: AsyncCallback\): void | 参数名 | 类型 | 必填 | 说明 | | -------- | -------------------- | ---- | ------------------------------------------------------------ | -| callback | AsyncCallback\ | 是 | 回调函数。当启动Ability成功，err为undefined；否则为错误对象。 | +| callback | AsyncCallback\ | 是 | 回调函数。当停止输入法应用自身成功时，err为undefined；否则为错误对象。 | **示例：** -```ts +```js this.context.destroy((err) => { console.log('destroy result:' + JSON.stringify(err)); }); ``` -## InputMethodExtensionContext.destroy9+ +## InputMethodExtensionContext.destroy destroy(): Promise { console.log('success:' + JSON.stringify(data)); }).catch((error) => { diff --git a/zh-cn/application-dev/reference/apis/js-apis-inputmethod-subtype.md b/zh-cn/application-dev/reference/apis/js-apis-inputmethod-subtype.md index 4dec3aa71e62f271b70ce42b41292763b6586fb2..df2bcf2b8d8072a197ceacd17f5abeac9422ff94 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inputmethod-subtype.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inputmethod-subtype.md @@ -1,10 +1,8 @@ # 输入法子类型 -本模块提供对输入法子类型的属性管理 +本模块提供对输入法子类型的属性管理。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** -> -> 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 +> **说明：**
本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 ## 导入模块 @@ -12,11 +10,11 @@ import inputMethodEngine from '@ohos.inputMethodSubtype'; ``` -## InputMethodSubtype +## 属性 属性值。 -**系统能力**：以下各项对应的系统能力均为SystemCapability.MiscServices.InputMethodFramework +**系统能力**：SystemCapability.MiscServices.InputMethodFramework | 名称 | 参数类型 | 可读 | 可写 | 必选 | 说明 | | -------- | -------- | -------- | -------- | -------- | -------- | @@ -24,7 +22,7 @@ import inputMethodEngine from '@ohos.inputMethodSubtype'; | name | string | 是 | 否 | 是 | 输入法子类型的名字。 | | id | string | 是 | 否 | 是 | 输入法子类型的id。 | | mode | string | 是 | 否 | 否 | 输入法子类型的模式，包括upper（大写）和lower（小写）。 | -| locale | string | 是 | 否 | 是 | 输入法子类型的locale。 | +| locale | string | 是 | 否 | 是 | 输入法子类型的方言版本。 | | language | string | 是 | 否 | 是 | 输入法子类型的语言。 | | icon | string | 是 | 否 | 否 | 输入法子类型的图标。 | | iconId | number | 是 | 否 | 否 | 输入法子类型的图标id。 | diff --git a/zh-cn/application-dev/reference/apis/js-apis-inputmethod.md b/zh-cn/application-dev/reference/apis/js-apis-inputmethod.md index 14fd56452b6db5e80cb86828b6d80a764ceca9d8..777e4aaa405cd781f4a651bef45af1899f343604 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inputmethod.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inputmethod.md @@ -2,9 +2,7 @@ 本模块提供对输入法框架的管理，包括隐藏输入法、查询已安装的输入法列表和显示输入法选择对话框。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** -> -> 本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 +> **说明：**
本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 ## 导入模块 @@ -13,44 +11,44 @@ import inputMethod from '@ohos.inputmethod'; ``` -## inputMethod8+ +## 常量8+ 常量值。 -**系统能力**：以下各项对应的系统能力均为SystemCapability.MiscServices.InputMethodFramework +**系统能力**：SystemCapability.MiscServices.InputMethodFramework -| 名称 | 参数类型 | 可读 | 可写 | 说明 | -| -------- | -------- | -------- | -------- | -------- | -| MAX_TYPE_NUM | number | 是 | 否 | 可支持的最大输入法个数。 | -| EXCEPTION_PERMISSION9+ | number | 是 | 否 | 错误码。详见[输入法框架错误码](../errorcodes/errcode-inputmethod-framework.md)，下同 | -| EXCEPTION_PARAMCHECK9+ | number | 是 | 否 | 错误码。 | -| EXCEPTION_UNSUPPORTED9+ | number | 是 | 否 | 错误码。 | -| EXCEPTION_PACKAGEMANAGER9+ | number | 是 | 否 | 错误码。 | -| EXCEPTION_IMENGINE9+ | number | 是 | 否 | 错误码。 | -| EXCEPTION_IMCLIENT9+ | number | 是 | 否 | 错误码。 | -| EXCEPTION_KEYEVENT9+ | number | 是 | 否 | 错误码。 | -| EXCEPTION_CONFPERSIST9+ | number | 是 | 否 | 错误码。 | -| EXCEPTION_CONTROLLER9+ | number | 是 | 否 | 错误码。 | -| EXCEPTION_SETTINGS9+ | number | 是 | 否 | 错误码。 | -| EXCEPTION_IMMS9+ | number | 是 | 否 | 错误码。 | -| EXCEPTION_OTHERS9+ | number | 是 | 否 | 错误码。 | +| 参数名 | 参数类型 | 常量值 | 说明 | +| -------- | -------- | -------- | -------- | +| MAX_TYPE_NUM | number | 128 | 可支持的最大输入法个数。 | +| EXCEPTION_PERMISSION9+ | number | 201 | 错误码类型。详见[输入法框架错误码](../errorcodes/errcode-inputmethod-framework.md)，下同 | +| EXCEPTION_PARAMCHECK9+ | number | 401 | 错误码类型 | +| EXCEPTION_UNSUPPORTED9+ | number | 801 | 错误码类型 | +| EXCEPTION_PACKAGEMANAGER9+ | number | 12800001 | 错误码类型 | +| EXCEPTION_IMENGINE9+ | number | 12800002 | 错误码类型 | +| EXCEPTION_IMCLIENT9+ | number | 12800003 | 错误码类型 | +| EXCEPTION_KEYEVENT9+ | number | 12800004 | 错误码类型 | +| EXCEPTION_CONFPERSIST9+ | number | 12800005 | 错误码类型 | +| EXCEPTION_CONTROLLER9+ | number | 12800006 | 错误码类型 | +| EXCEPTION_SETTINGS9+ | number | 12800007 | 错误码类型 | +| EXCEPTION_IMMS9+ | number | 12800008 | 错误码类型 | +| EXCEPTION_OTHERS9+ | number | 12899999 | 错误码类型 | ## InputMethodProperty8+ 输入法应用属性。 -**系统能力**：以下各项对应的系统能力均为SystemCapability.MiscServices.InputMethodFramework +**系统能力**：SystemCapability.MiscServices.InputMethodFramework | 名称 | 参数类型 | 可读 | 可写 | 说明 | | -------- | -------- | -------- | -------- | -------- | -| packageName(deprecated) | string | 是 | 否 | 包名。从API8开始支持，从API9开始废弃，建议使用name替代 | -| methodId(deprecated) | string | 是 | 否 | Ability名。从API8开始支持，从API9开始废弃，建议使用id替代 | -| name9+ | string | 是 | 否 | 包名。 | -| id9+ | string | 是 | 否 | Ability名。 | -| label9+ | string | 是 | 否 | 输入法标签，非必填项。| -| icon9+ | string | 是 | 否 | 输入法图标，非必填项。 | -| iconId9+ | number | 是 | 否 | 输入法图标id，非必填项。 | -| extra9+ | object | 是 | 否 | 输入法其他信息。 | +| packageName(deprecated) | string | 是 | 否 | 输入法包名。
**说明：**从API8开始支持，从API9开始废弃，建议使用name替代。 | +| methodId(deprecated) | string | 是 | 否 | 输入法唯一标识。
**说明：**从API8开始支持，从API9开始废弃，建议使用id替代。 | +| name9+ | string | 是 | 否 | 输入法内部名称。 | +| id9+ | string | 是 | 否 | 输入法唯一标识。 | +| label9+ | string | 是 | 否 | 输入法对外显示名称。 | +| icon9+ | string | 是 | 否 | 输入法图标数据。 | +| iconId9+ | number | 是 | 否 | 输入法图标资源号。 | +| extra9+ | object | 是 | 否 | 输入法扩展信息。 | ## inputMethod.getController9+ @@ -467,7 +465,7 @@ getInputMethodController(): InputMethodController 获取客户端实例[InputMethodController](#inputmethodcontroller)。 -> **说明：** +> **说明：**
> 从API version 6开始支持，从API version 9开始废弃, 建议使用[getController()](#inputmethodgetcontroller9)替代 **系统能力**：SystemCapability.MiscServices.InputMethodFramework @@ -490,8 +488,7 @@ getInputMethodSetting(): InputMethodSetting 获取客户端设置实例[InputMethodSetting](#inputmethodsetting8)。 -> **说明：** -> 从API version 6开始支持，从API version 9开始废弃, 建议使用[getSetting()](#inputmethodgetsetting9)替代 +> **说明：**
从API version 6开始支持，从API version 9开始废弃, 建议使用[getSetting()](#inputmethodgetsetting9)替代。 **系统能力**： SystemCapability.MiscServices.InputMethodFramework @@ -646,7 +643,7 @@ showSoftKeyboard(): Promise<void> | 类型 | 说明 | | ------------------- | ------------------------- | -| Promise<void> | Promise对象。无返回结果的Promise对象。 | +| Promise<void> | 无返回结果的Promise对象。 | **错误码：** @@ -718,7 +715,7 @@ hideSoftKeyboard(): Promise<void> | 类型 | 说明 | | ------------------- | ------------------------- | -| Promise<void> | Promise对象。无返回结果的Promise对象。 | +| Promise<void> | 无返回结果的Promise对象。 | **错误码：** @@ -745,7 +742,7 @@ stopInput(callback: AsyncCallback<boolean>): void 隐藏输入法。使用callback异步回调。 -> **说明：** +> **说明：**
> 从API version 6开始支持，从API version 9开始废弃, 建议使用[stopInputSession()](#stopinputsession9)替代 **系统能力**：SystemCapability.MiscServices.InputMethodFramework @@ -778,7 +775,7 @@ stopInput(): Promise<boolean> 隐藏输入法。使用promise异步回调。 -> **说明：** +> **说明：**
> 从API version 6开始支持，从API version 9开始废弃, 建议使用[stopInputSession()](#stopinputsession9)替代 **系统能力**： SystemCapability.MiscServices.InputMethodFramework @@ -807,7 +804,7 @@ InputMethodController.stopInput().then((result) => { 下列API示例中都需使用[getSetting](#inputmethodgetsetting9)回调获取到InputMethodSetting实例，再通过此实例调用对应方法。 -### on('imeChange')9+ +### on('imeChange')9+ on(type: 'imeChange', callback: (inputMethodProperty: InputMethodProperty, inputMethodSubtype: InputMethodSubtype) => void): void @@ -1184,7 +1181,7 @@ listInputMethod(callback: AsyncCallback<Array<InputMethodProperty>>) 查询已安装的输入法列表。使用callback异步回调。 -> **说明：** +> **说明：**
> 从API version 8开始支持，从API version 9开始废弃, 建议使用[getInputMethods](#getinputmethods9)替代 **系统能力**： SystemCapability.MiscServices.InputMethodFramework @@ -1213,7 +1210,7 @@ listInputMethod(): Promise<Array<InputMethodProperty>> 查询已安装的输入法列表。使用promise异步回调。 -> **说明：** +> **说明：**
> 从API version 8开始支持，从API version 9开始废弃, 建议使用[getInputMethods](#getinputmethods9-1)替代 **系统能力**： SystemCapability.MiscServices.InputMethodFramework @@ -1240,7 +1237,7 @@ displayOptionalInputMethod(callback: AsyncCallback<void>): void 显示输入法选择对话框。使用callback异步回调。 -> **说明：** +> **说明：**
> 从API version 8开始支持，从API version 9开始废弃, 建议使用[showOptionalInputMethods()](#showoptionalinputmethods9)替代 **系统能力**： SystemCapability.MiscServices.InputMethodFramework @@ -1269,7 +1266,7 @@ displayOptionalInputMethod(): Promise<void> 显示输入法选择对话框。使用promise异步回调。 -> **说明：** +> **说明：**
> 从API version 8开始支持，API version 9开始废弃, 建议使用[showOptionalInputMethods()](#showoptionalinputmethods9-1)替代 **系统能力**： SystemCapability.MiscServices.InputMethodFramework @@ -1278,7 +1275,7 @@ displayOptionalInputMethod(): Promise<void> | 类型 | 说明 | | -------- | -------- | -| Promise<void> | Promise对象。无返回结果的Promise对象。 | +| Promise<void> | 无返回结果的Promise对象。 | **示例：** diff --git a/zh-cn/application-dev/reference/errorcodes/errcode-inputmethod-framework.md b/zh-cn/application-dev/reference/errorcodes/errcode-inputmethod-framework.md index 781c459b42565a3d59d46c39d472d5764295d228..6950575757a84180f1178a7ada2c37e3b3786e71 100644 --- a/zh-cn/application-dev/reference/errorcodes/errcode-inputmethod-framework.md +++ b/zh-cn/application-dev/reference/errorcodes/errcode-inputmethod-framework.md @@ -2,168 +2,164 @@ ## 12800001 包管理服务异常 -**错误信息** +**错误信息**
Package manager error. -**错误描述** +**错误描述**
当依赖包管理接口来获取一些信息失败时，系统会报此错误码。 -**可能原因** +**可能原因**
-在获取输入法及子类型的时候，由于依赖包管理接口而导致异常时会报错。 +在调用getInputMethods、listCurrentInputMethodSubtype等接口获取输入法及子类型的时候，由于依赖包管理QueryExtensionAbilityInfos接口而导致异常时会报错。 -**处理步骤** +**处理步骤**
-1. 确认包管理服务是否正常。 -2. 确认查询包信息接口是否正常。 +1. 确认包管理服务是否正常。在日志中搜索401查看是否存在打印found service : 401。 +2. 确认查询包信息接口是否正常。在日志中搜索“QueryExtensionAbilityInfos”，查看相关打印中是否存在失败字样。 +3. 解决方法：无。 ## 12800002 输入法应用异常 -**错误信息** +**错误信息**
Input method engine error. -**错误描述** +**错误描述**
用户调用输入法应用接口失败时，系统会报此错误码。 -**可能原因** +**可能原因**
-在执行显示键盘、隐藏键盘等操作时，由于输入法应用进程死亡导致操作失败时会报错 +在执行显示键盘、隐藏键盘等操作时，由于输入法应用进程死亡导致操作失败时会报错。 -**处理步骤** +**处理步骤**
-确认输入法应用进程正常。 +查看输入法应用进程是否正常。例如再次在普通应用（微信、联系人等第三方应用）中点击对话框看键盘能否被正常拉起。 ## 12800003 客户端应用异常 -**错误信息** +**错误信息**
Input method client error. -**错误描述** +**错误描述**
-当客户端应用（编辑控件）调用失败时，系统会报此错误码。 +当三方应用（微信、设置、联系人等）的对话框等编辑控件调用显示键盘、隐藏键盘失败时，系统会报此错误码。 -**可能原因** +**可能原因**
-执行显示键盘或者隐藏键盘等操作时，找不到客户端的情况下会报错。 +当三方应用通过点击对话框去调用显示键盘、隐藏键盘功能失败时会报错。 -**处理步骤** +**处理步骤**
-确认客户端应用进程正常。 +将三方应用后台进程杀死，重新启动三方应用，通过点击对话框等方式触发输入法应用的键盘的显示，若键盘正常显示，则问题解决。 ## 12800004 按键事件处理异常 -**错误信息** +**错误信息**
Key event processing error. -**错误描述** +**错误描述**
当按键事件异常时，系统会报此错误码。 -**可能原因** +**可能原因**
按键事件分发、消费、监听异常时会报错。 -**处理步骤** +**处理步骤**
-确认窗口按键事件正常消费。 +无 ## 12800005 配置固化失败 -**错误信息** +**错误信息**
Configuration persisting error. -**错误描述** +**错误描述**
当保存配置失败时，系统会报此错误码。 -**可能原因** +**可能原因**
当保存输入法及子类型的设置的调用发生异常时会报错。 -**处理步骤** +**处理步骤**
-确认输入法系统参数配置文件存在且权限正常（root: root, 644）。 +执行hdc命令setenforce 0关闭SELinux之后，重新执行接口调用，查看功能是否正常。若关闭SELinux之后功能正常，则确认输入法应用是否配置在系统参数配置文件中，详见[系统参数配置指导](https://gitee.com/openharmony/docs/blob/master/zh-cn/device-dev/subsystems/subsys-boot-init-sysparam.md)。 ## 12800006 输入法控制器异常 -**错误信息** +**错误信息**
Input method controller error. -**错误描述** +**错误描述**
-当获取到输入法控制器，并基于此进行一些操作发生错误时，系统会报此错误码。 +当获取到输入法控制器失败时，系统会报此错误码。 -**可能原因** +**可能原因**
-进行软键盘的显示、隐藏、输入会话的停止等操作发生异常时会报错。 +在调用getCotroller接口获取输入法控制器InputMethodController时发生异常时会报错。 -**处理步骤** -1. 确认输入法管理服务进程正常。 -2. 确认获取输入法控制器接口调用正常。 -3. 确认输入法应用进程正常。 -4. 确认显示隐藏接口调用正常。 +**处理步骤**
+ +无。 ## 12800007 输入法设置器异常 -**错误信息** +**错误信息**
Input method settings extension error. -**错误描述** +**错误描述**
-当获取到输入法设置器，并基于此进行一些操作发生错误时，系统会报此错误码。 +当获取到输入法设置器发生错误时，系统会报此错误码。 -**可能原因** +**可能原因**
-列出输入法应用、列出子类型、列出当前输入法应用等发生异常时会报错。 +在调用getSetting接口获取输入法设置器InputMethodSetting时发生异常时会报错。 -**处理步骤** +**处理步骤**
-1. 确认输入法管理服务进程正常。 -2. 确认输入法应用进程正常。 -3. 确认切换输入法接口调用正常。 +无。 ## 12800008 输入法管理服务异常 -**错误信息** +**错误信息**
Input method manager service error. -**错误描述** +**错误描述**
获取输入法管理服务异常时，系统会报此错误码。 -**可能原因** +**可能原因**
-由于SA异常导致的调用InputMethodSystemAbility接口异常时会报错。 +当调用[输入法框架](../apis/js-apis-inputmethod.md)中的任何接口都有可能由于依赖输入法管理服务，而服务找不到时发生此异常。 -**处理步骤** +**处理步骤**
-1. 确认输入法管理服务进程正常。 -2. 尝试重启输入法管理服务。 +无。 ## 12899999 其他异常 -**错误信息** +**错误信息**
Others error. -**错误描述** +**错误描述**
发生除以上几种类型的错误之外的其他类型错误时，系统会报此错误码。 -**可能原因** +**可能原因**
发生了除了上述异常之外的未定义异常时会报错。 -**处理步骤** +**处理步骤**
无。 \ No newline at end of file