自定义键盘

介绍

本示例介绍自定义键盘的实现，包括原生键盘和自定义键盘切换、自定义键盘光标处理、自定义键盘布局避让等场景。

自定义键盘绑定与使用指南

1. 绑定自定义键盘：

- 打开应用程序，导航至首页。
- 找到并点击“绑定自定义键盘”输入框。这将触发自定义键盘的显示。
- 当自定义键盘出现时，您会注意到输入框上方的布局会自动向上避让，为键盘腾出空间。

2. 切换键盘布局：

- 在自定义键盘上，您会看到不同的标签页，通常标记为“123”、“ABC”和“中文”。
- 点击“123”标签页以切换至数字键盘，适用于输入数字和符号。
- 点击“ABC”标签页以切换至英文键盘，适用于输入英文字符。
- 点击“中文”标签页以切换至系统键盘，适用于输入中文字符和其他系统键盘功能。

3. 键盘通用操作：

- 内容输入：直接在相应的键盘布局上输入所需的字符。
- 光标设置： 使用键盘上的光标控制键移动光标位置。
- 大小写切换：在英文键盘布局下，使用大小写切换键（通常为“Caps Lock”或“Shift”键）来改变字母的大小写。
- 复制与粘贴： 使用键盘快捷键（如“Ctrl+C”复制，“Ctrl+V”粘贴）或键盘上提供的复制粘贴按钮来操作。
- 删除：使用退格键（Backspace）或删除键（Delete）来删除输入错误或不需要的字符。

4. 其他功能：

- 剪切：若需要移动文本，可以使用剪切功能（通常为“Ctrl+X”）。
-撤销与重做：*通过键盘快捷键（如“Ctrl+Z”撤销，“Ctrl+Y”重做）来执行这些操作。
- 特殊字符输入：*在某些键盘布局中，长按某些键可以访问特殊字符或符号。

5. 退出自定义键盘：

- 输入完成后，您可以通过点击键盘上的“完成”或“关闭”按钮来退出自定义键盘。
- 或者，您也可以通过点击屏幕上的任意空白区域来隐藏键盘。

注意事项：

- 确保您的设备支持自定义键盘功能。
- 在使用过程中，如果遇到任何问题，可以查看应用程序的帮助文档或联系技术支持。

工程目录

解释

├──entry/src/main/ets	                 // 代码区
│  ├──constants
│  │  └──Constants.ets                   // 公共常量类
│  ├──entryability
│  │  └──EntryAbility.ets                // 程序入口类
│  ├──model
│  │  └──KeyboardController.ets          // 自定义键盘控制类
│  ├──pages
│  │  └──MainPage.ets                    // 主页面
│  ├──view
│  │  ├──CustomKeyboard.ets              // 自定义键盘入口
│  │  ├──EnglishKeyboard.ets             // 英文键盘组件
│  │  ├──NumberKeyboard.ets              // 数字键盘组件
│  │  ├──TabButton.ets                   // 键盘上方Tab组件Button按钮
│  │  ├──TabView.ets                     // 键盘上方Tab组件
│  │  └──TextInputComponent.ets          // 绑定自定义键盘的TextInput类
│  └──viewmodel
│     └──MenuModel.ets                   // 键盘按钮数据
└──entry/src/main/resources              // 资应用资源目录

具体实现

1. TextInput组件customKeyboard属性绑定builder，实现自定义键盘。
2. TextInput组件customKeyboard属性传值null，绑定系统键盘，实现自定义键盘和系统键盘的切换。
3. 监听TextInput组件onTextSelectionChange、onChange事件，实现光标位置设置。
4. 监听TextInput组件onPaste、onCut事件，实现复制粘贴功能。
5. 通过window的keyboardHeightChange事件获取系统键盘高度，通过onAreaChange获取自定义键盘高度，设置布局避让。

相关权限

不涉及。

依赖

不涉及。