快捷键 HotKey

快捷键 HotKey

充分考虑了多系统和跨平台操作逻辑的一致性的。也就是说 Ctrl、Shift、Alt 这三个键在 Windows、Mac、Linux 不同系统上，还有不同软件上的操作逻辑是相同的。
注意！！本例中涉及到了表单，表格，按钮，弹窗类的一些api, 因此在阅读此文档之前需要对表单，表格，按钮的方法有所了解

1. 如何使用说明

设计键位时应该充分考虑到： 1.尽量少覆盖修改系统快捷键，这样可以有更好的逻辑性和系统一致性； 2.尽量不改动原始热键功能的情况下去作修改。Alt键作了充分设置，也有达到类似ctrl的组合功能； 3.尽量避免减轻记忆负担，功能互斥按钮，主键字母一样，用Ctrl和Alt区分； 4.尽量单手操作，两个个键位组合，键位选取 “T、G、B” 左侧字母。

2. 能力特性

3. API

3.1 参数

createButtonApp(id, {config}) 时传入的参数

参数	说明	类型	默认值
id	模板id	String	必填
config	按钮区的参数字典	Object	必填

createButtonApp 与快捷键相关的 config 参数说明

参数	说明	类型	默认值	备注
ignoreHotkeyCode	按钮的快捷键相同时不需要触发快捷键的按钮的key	array	[]	无
notInterruptCode	由按钮的key组成，快捷键不触发当前活跃元素的失焦事件	array	[]	无
tabindex	按钮是否可聚焦	number	-1(不可聚焦)	无
modalRelation	当页面中按钮的快捷键与弹窗里按钮的快捷键相同时需要传入创建弹窗的ID	string	‘’	无
hotKeysEnabled	开关，是否启用快捷键	boolean	true	无
tipKeybodard	快捷键提示模式(underline/none)	string	‘none’	无

3.2

createPage(config)(ReactComponent)时需要传入的参数

参数	说明	类型	默认值
config	参数字典	object	{}
ReactComponent	React 组件	ReactNode	必填

createPage 与快捷键相关的 config 参数说明

参数	说明	类型	默认值	备注
orderOfHotKey	页面区域展示顺序,由区域ID组成	array	[]	无
appAutoFocus	默认聚焦到document.body上	boolean	true	无

3.3 页面级快捷键api

3.3.1 controlAutoFocus

调用样例 : controlAutoFocus(flag)
说明 : 控制页面首项聚焦
参数说明:

参数	说明	类型	默认值	备注
flag	控制页面是否自动聚焦到第一个可编辑项	boolean	true	无

返回值说明： 返回undefined

3.3.2 executeAutoFocus

调用样例 : executeAutoFocus()
说明 : 执行页面首项聚焦方法
返回值说明： 返回undefined

3.3.3 findFocusModuleId

调用样例 : findFocusModuleId()
说明 : 返回当前焦点属于哪个区域
备注 : 此方法需要在createPage时配置orderOfHotKey才可正常使用
返回值说明： 返回当前焦点所属的区域ID 类型为string，如果没有找到返回null

4 模板结构

按钮类

属性	说明	类型	备注
keyboard	需要配置的快捷键	string	无
pageareacode	如果在页面的多个区域中注册了相同的快捷键，比如在表格区域按钮注册了’alt+s’键，表单区域也注册了’alt+s’，此时需要配置区域ID,当焦点属于该区域时才会触发按钮事件（提示：此属性需要与createPage的orderOfHotKey配合使用）	string	无

5 快捷键键位规则

规范网站拆分成3组快捷键附件链接：地址

5.1 平台快捷键

	A	B	C	D
1
2	按键	功能	说明	场景
3	一、表单、表格中控件的前后切换，4种类型控件的具体按键操作：
4	Tab	焦点在不同控件间正向移动（从左至右，从上至下）	焦点在上一区域最后一个控件上时，默认跳到下一区域的第一个可编辑或可选择控件上	1表头最后一个可编辑字段，跳到表体第一个可编辑字段； 2分组/子表收起时，Teb跳过分组内字段，直接到下一个展开的分组/子表； 3整表编辑表格的连续新增录入，横向跳转到屏幕外，滚动条随光标翻动； 4编辑态子表，焦点在表体最后一行时自动增行。
5			跳转到折叠区域标题，按空格打开，不空格继续按tab，继续往下跳
6		录入时，焦点在表格单元格间正向移动	焦点在表体最后一行时，自动增行
7	Shift+Tab	焦点在不同控件间逆向移动（从左至右，从上至下）	焦点在下一区域最第一个控件上时，默认跳到上一区域的最后一个可编辑或可选择控件上	同上，但跳转顺序相反
8		录入时，焦点在表格单元格的逆向移动	同上
9	Esc	取消、退出	下拉菜单操作时退出当前菜单操作，返回上一层	下拉选项、参照控件的历史记录/已选内容。
10			右上提示消息：成功、预警、报错的快速隐藏
11			在对话框界面表示什么也不做，相当于取消当前操作，关闭对话框
12	←	焦点变光标时，在控件中左移	文本型录入框，光标的控制	1文本录入中，光标的上下左右控制； 2下拉菜单中，上下切换待选内容。
13	→	焦点变光标时，在控件中右移	文本型录入框，光标的控制
14	↑	在多行文本中光标上移	文本型录入框，光标的控制
15		焦点在子菜单、下拉列表、表格单元格中上移	下拉菜单中选中项向上移动
16	↓	在多行文本中光标下移	文本型录入框，光标的控制
17		焦点在子菜单、下拉列表、表格单元格中下移	下拉菜单中选中项向下移动
18	F1	打开快捷键帮助文档
19	F2	打开光标所在日期控件面板	打开参照/日期面板	参照、日期、公式计算
20		打开光标所在位置的参照对话框
21	空格键	展开/收起	展开状态执行收起，收起状态执行展开	控制单据分组信息的展开或收起；
22	Enter	确认	对话框或信息框确定焦点所在按钮	1下拉菜单的确定选中和切换下一个； 2对话框的确定类操作； 3确认选中并跳到下一个。
23
24
25		页面切换	浏览态，从列表界面切换到卡片界面	进入已选列表的详情
26	Del	删除键	删除光标后一个字符	文本、数值录入框
27			移除当前选中的输入项目	参照、多选参照的已选内容
28	Pageup	向上整页滚动	页面整屏向上翻动一页	1内容超过当前页面； 2单据子表内容翻页； 3参照树、内容。。。。。。
29			参照
30	Pagedown	向下整页滚动	页面整屏向下翻动一页
31			参照
32	Alt+←	向左整页滚动	列表浏览态向左翻动一页	1参照待选列表； 2参照树结构。。。。。。
33	Alt+→	向右整页滚动	列表浏览态向左翻动一页
34	Alt+↑	向上整页滚动	列表浏览态向左翻动一页
35	Alt+↓	向下整页滚动	列表浏览态向左翻动一页
36	二、NCC 采用外部页签，如下快捷键非常实用，浏览器和系统快捷键不要受干扰：
37	Ctrl+Tab	切换到下一个标签页。	NC Cloud采用外部页签管理内容，需要快捷操作控制浏览器页签	1通用快捷键，Chrome、IE、Linux均能使用； 2快捷切换、开启/关闭外部页签，方便管理； 3定位页面内容，顶部、底部、逐页翻页。
38	Ctrl+Shift+Tab	切换到上一个标签页。
39	Ctrl+W	关闭当前标签页或弹出窗口。
40	Ctrl+R	重新载入当前网页。
41	~~空格键~~	~~向下滚动网页(删除)~~	大量数据例如维护单，快速定位到顶/底部和向下翻页
42	Home	转至网页顶部。
43	End	转至网页底部。
44	Ctrl++	放大网页上的所有内容。	视觉设计师推荐快速放大/缩小网页内容，便于阅读
45	Ctrl+-	缩小网页上的所有内容。
46	Ctrl+0	将网页上内容都恢复到正常大小。
47	Ctrl+F	打开查找栏。	快速定位查找的内容
48	Ctrl+←	浏览记录后退
49	Ctrl+→	浏览记录前进
50	三、NCC时间控件快捷键
51	→	焦点从开始日期跳到结束日期。焦点在日期数字区域或函数区域按天正向移动。	光标如果在起始日期数字末尾，“右”可跳到结束时间录入区。	含时间控件的场景
52	←	焦点从结束日期跳到开始日期。焦点在日期数字区域或函数区域按天反向移动。	光标如果在结束日期数字首位，“左”可跳到开始时间录入区。
53	↑	焦点在日期数字区域或函数区域按行向上移动。
54	↓	a 焦点在日期控件录入框内时，按“下”触发面板，焦点落在开始时间区域。 b 焦点在日期数字区域或函数区域按行向下移动。
55	Tab	a 上一个控件tab到日期控件内，不触发时间面板 b 焦点在录入区域、日期数字区域、函数区域循环移动。
56	Enter	选中开始日期，选中结束日期并收起。	a 区间：选中结束日期并收起面板，焦点落在下一个可录入控件内。 b 单选日期：选中并收起面板，焦点落在下一个可录入空间内。
57	Esc	收起时间面板。焦点落在当前控件内。
58	四、查询区快捷键
59	Enter	执行查询
60	F3	展开高级面板
61	Alt+Del	清空查询条件

5.2 公共快捷键

	A	B	C	D	E
1	平台已经给各领域留好注册接口，例如：供应链入库单“货位序列号”、存量查检“采购询价”按钮，产品组各自添加注册，但是要从UE处输出。按键组合基于以下： 1.Ctrl 是 Control 的缩写，意思是“控制”。Ctrl 键用来执行命令的，大部分的快捷键都与它相关。 2.Alt 是 Alter 的缩写，是“改变”的意思。Alt 键与菜单相关，更进一步说，Alt 键与图形用户界面（GUI）相关，也就是与窗口相关。 3.Shift 的意思是“切换”。所以Shift 键就是对原有功能的切换，比如按住 Shift 键切换到大写。 4.F1-12 是 Function.即功能键。在DOS时代是功能键，比如重复刚使用过的命令行，启动BIOS之类的。
2	备注：Del、Ins需要简写
3	区域	操作	快捷键	说明	来源
4	一、表单、表格中控件的前后切换，4种类型控件的具体按键操作：
5	单据编辑态	快捷键帮助	F3	查看快捷键帮助文档
6		保存	Ctrl+S	与浏览器键位冲突。不是常用快捷键，功能可以被右键替代
7		保存并新增	Alt+S
8		保存并提交	Alt+T
9		取消	Alt+Q
10		暂存	Ctrl+Alt+S
11		向左跳动	Shift+←	单据子表页签，左右切换
12		向右跳动	Shift+→
13		向上跳动	Shift+↑	单据分组、子表，上下切换
14		向下跳动	Shift+↓
15	单据编辑态-子表	增行	Alt+N	应用在子表肩部按钮
16		删行	Alt+Backspace Alt+Del	应用在子表行按钮
17		插行	Alt+I
18		复制行	Alt+C
19		粘贴行	Alt+V
20		粘贴到末行	Ctrl+Alt+V
21		展开/收起侧边弹窗	F4
22		批改	Alt+P
23		重排序号/行号	Alt+R
24	单据浏览态或列表基础按钮	新增	Ctrl+/
25		自制	Ctrl+/
26		修改	Alt+P
27		删除	Ctrl+Backspace Ctrl+Del
28		复制	Alt+C
29		提交	Alt+B
30		收回	Ctrl+B
31		变更	Alt+R
32		返回	Shift+Esc
33		前一页	Alt+Pageup
34		后一页	Alt+Pagedown
35		刷新	F5
36	列表肩部按钮	签字	Ctrl+I
37		取消签字	Alt+I
38		审批	Ctrl+U
39		取消审批	Alt+U
40		作废	Ctrl+G
41		取消作废	Alt+G
42		冻结	Ctrl+J
43		取消冻结	Alt+J
44		结账	Ctrl+J
45		取消结账	Alt+J
46		导入	Ctrl+Alt+E
47		导出	Ctrl+Alt+C
48		打印	Ctrl+P	与浏览器键位冲突。不是常用快捷键，功能可以被右键替代
49		联查-联查单据	Ctrl+K
50		联查-审批流程	Ctrl+O	流程审批，Ctrl+O。打开流程审批一级菜单。
51		收款	Alt+O
52		附件管理	Alt+D	与浏览器键位冲突。不是常用快捷键，功能可以被右键替代
53		记账、纠错	Alt+L
54	判断弹窗或提示信息	确定并关闭弹窗	Alt+Y
55		取消并关闭弹窗	Alt+N
56		确定并关闭弹窗、

5.3 参照快捷键

	A	B	C	D
1
2	按键	功能	说明	场景
3
4	tab	tab到参照框中（显示边框色），自动获取焦点、展开最近历史记录	默认未选择字段时	单选/多选参照框，默认未选择字段时
5	↓	向下选择数据	从第一个开始，移动在下拉面板时，数据上有底色
6	↑	向上选择数据	配合↓键使用
7	enter	确定选择	面板收起，参照框中赋值，且跳到下一个可编辑的录入组件
8	←	字符间距向左移动	录入关键字后，左移一个字符
9	→	字符间距向右移动	录入关键字后，右移一个字符
10	空格	选中/反选		多选参照框，默认未选择字段时
11	delete	清空	清空所有已选项	单选/多选参照框，默认存在已选字段时
12		单个删除	下拉面板展开后，移动到已选数据时点击del即可删除（把最后一个删除时，参照框获取焦点，下拉面板展示历史记录）
13	↓	展开已选面板	选中已选参照框时，点击↓显示已选面板（参照框有边框色）
14		向下选择数据	下拉面板展开后，从第一个开始，移动在下拉面板时，数据上有底色
15	↑	向上选择数据	下拉面板展开后，向上移动，直至移动到参照框
16			另：若单选参照，后期已选后获取焦点， 1.tab到已选项时，所选项标蓝色，焦点在最后 2.按←、→键所选颜色消失，光标定位最后。
17
18	F2	打开光标所在位置的参照对话框	打开面板	参照面板公共按键
19	alt+Y	确定并关闭参照弹窗
20	alt+N	取消并关闭参照弹窗
21	esc	关闭
22	tab	组件、区域顺序跳转	默认在表的第一条数据，跳转顺序：表的第一条数据（第二次循环时，选中的第一个）、组件（与确定、取消同行的复选框或其他按钮；确定、取消不跳）、业务单元、搜索、搜索右侧的组件、循环默认在表的第一条数据，跳转顺序：表的第一条数据（第二次循环时，选中的第一个）、搜索右侧的组件、组件（与确定、取消同行的复选框或其他按钮；确定、取消不跳）、业务单元、搜索、循环	单选表参照面板
23	shift+tab	组件、区域反向顺序跳转	同上，顺序相反
24	↓	表中向下移动光标	1.只在数据区域内移动 2.配合确定完成选择（整表编辑时：点击“确定”即赋光标所在行的值至参照框，且光标定位到下一个参照框）
25	↑	表中向上移动光标	同上
26	空格	选中/反向选	复选框（搜索框右侧，如显示停用）
27	tab	组件、区域顺序跳转	默认在表的第一条数据，跳转顺序：表的第一条数据（第二次循环时，跳至最后一次选择的那条数据）、组件（与确定、取消同行的复选框或其他按钮；已选、确定、取消不跳）、业务单元、搜索、搜索右侧的组件、循环默认在表的第一条数据，跳转顺序：表的第一条数据（第二次循环时，跳至最后一次选择的那条数据）、搜索右侧的组件、组件（与确定、取消同行的复选框或其他按钮；已选、确定、取消不跳）、业务单元、搜索、循环	多选表参照面板
28	shift+tab	组件、区域反向顺序跳转
29	↓	表中向下移动光标	1.在数据区域内与表头移动 2.配合确定完成选择（整表编辑时：点击“确定”即赋光标所在行的值至参照框，且光标定位到下一个参照框）
30	↑	表中向上移动光标
31	空格	选中/反向选	选中行上/表头后，点击空格选中/反向选
32	enter	选择并确定	配合↑↓键使用，移动时，点击“enter”， 1.“勾选当前选项确定”并关闭弹窗 2.“勾选当前选项确定+之前已选的选项”并关闭弹窗
33	F4	已选展开、已选收起		多选参照已选面板
34	tab	组件、区域顺序跳转	默认在树第一级第一个，跳转顺序：树第一级第一个（第二次循环时，选中的第一个）、组件（与确定、取消同行的复选框或其他按钮；确定、取消不跳）、业务单元、搜索、搜索右侧的组件、循环默认在树第一级第一个，跳转顺序：树第一级第一个（第二次循环时，选中的第一个）、搜索右侧的组件、组件（与确定、取消同行的复选框或其他按钮；确定、取消不跳）、业务单元、搜索、循环	树单选参照面板
35	shift+tab	组件、区域反向顺序跳转	同上，顺序相反
36	↓	树中向下移动光标	1.只在树内移动 2.配合确定完成选择（整表编辑时：点击“确定”即赋光标所在节点的值至参照框，且光标定位到下一个组件）
37		展开下拉按钮（如“更多”）
38		下拉按钮面板向下移动
39	↑	树中向上移动光标
40		下拉按钮面板向上移动
41	→	树展开
42		展开下拉按钮的下一级

下拉按钮面板中，焦点落在有下级的按钮上，点击→展开下一级，同时光标也存在下一级第一个按钮（这是再次点击上下键在下一级的按钮上下移动）
1.光标定位 2.点击→ 3.点击↓ | | | 43 | ← | 树收起 | | | | 44 | | 收起下拉按钮的下一级 |

下拉按钮面板中，焦点落在有上级的按钮上，点击←即可收起，恢复至上一级的样式
1.默认情况 2.点击← | | | 45 | 空格 | 选中/反向选 | 复选框组件选中/反向选 | | | 46 | tab | 组件、区域顺序跳转 | 默认在树第一级第一个，跳转顺序：树第一级第一个（第二次循环时，选中的第一个）、组件（与确定、取消同行的复选框或其他按钮；已选、确定、取消不跳）、业务单元、搜索、搜索右侧的组件、循环
默认在树第一级第一个，跳转顺序：树第一级第一个（第二次循环时，选中的第一个）、搜索右侧的组件、组件（与确定、取消同行的复选框或其他按钮；已选、确定、取消不跳）、业务单元、搜索、循环 | 树多选参照面板 | | 47 | shift+tab | 组件、区域反向顺序跳转 | 同上，顺序相反 | | | 48 | ↓ | 树中向下移动光标 | 1.只在树内移动
2.配合确定完成选择（整表编辑时：点击“确定”即赋光标所在节点的值至参照框，且光标定位到下一个参照框） | | | 49 | | 展开下拉按钮（如“更多”） | | | | 50 | | 下拉按钮面板向下移动 | | | | 51 | ↑ | 树中向上移动光标 | | | | 52 | | 下拉按钮面板向上移动 | | | | 53 | → | 树展开 | | | | 54 | | 展开下拉按钮的下一级 |

下拉按钮面板中，焦点落在有下级的按钮上，点击→展开下一级，同时光标也存在下一级第一个按钮（这是再次点击上下键在下一级的按钮上下移动）
1.光标定位 2.点击→ 3.点击↓ | | | 55 | ← | 树收起 | | | | 56 | | 收起下拉按钮的下一级 |

| | | 62 | | 表中向下移动光标 | 1.只在表内移动
2.配合确定完成选择（整表编辑时：点击“确定”即赋光标所在行的值至参照框，且光标定位到下一个参照框） | | | 63 | | 展开下拉按钮（如“更多”） | | | | 64 | | 下拉按钮面板向下移动 | | | | 65 | ↑ | 树中向上移动光标，并选择 | 同上 | | | 66 | | 表中向上移动光标 | 同上 | | | 67 | | 下拉按钮面板向上移动 | | | | 68 | → | 树展开 | | | | 69 | | 展开下拉按钮的下一级 |

下拉按钮面板中，焦点落在有下级的按钮上，点击→展开下一级，同时光标也存在下一级第一个按钮（这是再次点击上下键在下一级的按钮上下移动）
1.光标定位 2.点击→ 3.点击↓ | | | 70 | shift+→ | 页签向右切换 | 用快捷键直接向右切换，焦点定位默认或上一次选中的组件/树/表（若常用中无内容，定位搜索） | | | 71 | ← | 树收起 | 树型结构 | | | 72 | | 收起下拉按钮的下一级 | 下拉按钮面板中，焦点落在有上级的按钮上，点击←即可收起，恢复至上一级的样式
1.默认情况 2.点击← | | | 73 | shift+← | 页签向左切换 | 用快捷键直接向左切换，焦点定位默认或上一次选中的组件/树/表（若常用中无内容，定位搜索） | | | 74 | 空格 | 选中/反向选 | 复选框组件选中/反向选 | | | 75 | tab | 组件、区域顺序跳转 | 常用页签优先，常用中无数据显示全部数据
常用：默认在表的第一条数据且选中，顺序：表的第一条数据（第二次循环时，选中的第一个）、组件（与确定、取消同行的复选框或其他按钮；确定、取消不跳）、业务单元、搜索、组件（搜索右侧的组件；列设置、清空常用不跳）、循环
全部数据：默认在树第一级第一个，跳转顺序：树第一级第一个（第二次循环时，选中的第一个）、表搜索、组件（搜索右侧的组件；列设置、设为常用不跳）、表（循环时，若切换树节点表跳第一条数据，若树无切换时表跳退后一次选择的数据）、组件（与确定、取消同行的复选框或其他按钮；已选、确定、取消不跳）、业务单元、页签、树搜索、循环
常用：默认在表的第一条数据且选中，顺序：表的第一条数据（第二次循环时，选中的第一个）、组件（搜索右侧的组件；列设置、清空常用不跳）、组件（与确定、取消同行的复选框或其他按钮；确定、取消不跳）、业务单元、搜索、循环
全部数据：默认在树第一级第一个，跳转顺序：树第一级第一个（第二次循环时，选中的第一个）、表搜索、表（循环时，若切换树节点表跳第一条数据，若树无切换时表跳退后一次选择的数据）、组件（搜索右侧的组件；列设置、设为常用不跳）、组件（与确定、取消同行的复选框或其他按钮；已选、确定、取消不跳）、业务单元、页签、树搜索、循环 | 树表多选参照 | | 76 | shift+tab | 组件、区域反向顺序跳转 | 同上，顺序相反 | | | 77 | ↓ | 树中向下移动光标，并选择 | 只在树内移动 | | | 78 | | 表中向下移动光标 | 1.只在表内移动（包含表头）
2.配合确定完成选择（整表编辑时：点击“确定”即赋光标所在行的值至参照框，且光标定位到下一个参照框） | | | 79 | | 展开下拉按钮（如“更多”） | | | | 80 | | 下拉按钮面板向下移动 | | | | 81 | ↑ | 树中向上移动光标，并选择 | 同上 | | | 82 | | 表中向上移动光标 | 同上 | | | 83 | | 下拉按钮面板向上移动 | | | | 84 | → | 树展开 | 1.点击“→”展开下级节点，此时点击“→”或“↓”都可以跳至下一级上 | | | 85 | | 展开下拉按钮的下一级 | 下拉按钮面板中，焦点落在有下级的按钮上，点击→展开下一级，同时光标也存在下一级第一个按钮（这是再次点击上下键在下一级的按钮上下移动）
1.光标定位 2.点击→ 3.点击↓ | | | 86 | shift+→ | 页签向左切换 | 用快捷键直接向左切换，焦点定位默认或上一次选中的组件/树/表（若常用中无内容，定位搜索） | | | 87 | ← | 树收起 | 树型结构 | | | 88 | | 收起下拉按钮的下一级 | 下拉按钮面板中，焦点落在有上级的按钮上，点击←即可收起，恢复至上一级的样式
1.默认情况 2.点击← | | | 89 | shift+← | 页签向左切换 | 用快捷键直接向左切换，焦点定位默认或上一次选中的组件/树/表（若常用中无内容，定位搜索） | | | 90 | 空格 | 选中/反向选 | 1.选可选的节点/根节点，点击空格选中/反向选
2.复选框组件选中/反向选 | | | 91 | enter | 选择并确定 | 配合↑↓键使用，移动时，点击“enter”，
1.“勾选当前选项确定”并关闭弹窗
2.“勾选当前选项确定+之前已选的选项”并关闭弹窗 | |