<!-- 譯者:Github@wizadforcel -->
# 深入鍵表(keymap) #
鍵表文件是以JSON或者CSON編碼的文件,其中含有嵌套的哈希表。它們的工作方式像是樣式表,但是它們指定匹配選擇器的元素的快捷鍵的作用,而不是應用樣式屬性。下面是一些快捷鍵的例子,它們在`atom-text-editor`元素上按下時生效:
```
'atom-text-editor':
'cmd-delete': 'editor:delete-to-beginning-of-line'
'alt-backspace': 'editor:delete-to-beginning-of-word'
'ctrl-A': 'editor:select-to-first-character-of-line'
'ctrl-shift-e': 'editor:select-to-end-of-line'
'cmd-left': 'editor:move-to-first-character-of-line'
'atom-text-editor:not([mini])':
'cmd-alt-[': 'editor:fold-current-row'
'cmd-alt-]': 'editor:unfold-current-row'
```
在第一個選擇器底下綁定了一些快捷鍵,將特定的鍵位通配符映射到命令上面。當一個`atom-text-editor`元素獲得焦點,并且`cmd-delete`被按下,一個叫做`editor:delete-to-beginning-of-line`的自定義DOM事件會在`atom-text-editor`元素上面觸發。
第二個選擇器分組也指向了編輯器,但是只是沒有`mini`屬性的編輯器。在這個例子中,代碼折疊的命令在迷你編輯器中毫無意義,所以選擇器將它們限制于普通的編輯器中。
### 鍵位通配符(keystroke pattern) ###
鍵位通配符表示一個或者多個鍵位,帶有可選的輔助鍵(modifier key)。例如`ctrl-w v`和`cmd-shift-up`。鍵位由下面的符號組成,以`-`分隔。一個多種鍵位的通配符可以表示為以空格分割的鍵位通配符。
類型 | 例子
- | -
字符的字面值 | `a` `4` `$`
輔助鍵 | `cmd` `ctrl` `alt` `shift`
特殊鍵 | `enter` `escape` `backspace` `delete` `tab` `home` `end` `pageup` `pagedown` `left` `right` `up` `down`
### 命令 ###
命令是自定義的DOM事件,當一個鍵位匹配到綁定的快捷鍵時觸發。這可以讓UI代碼來監聽具名的命令,而不需要指定觸發它的特定的快捷鍵。例如,下面的代碼創建了一個命令來向編輯器插入當前日期:
```
atom.commands.add 'atom-text-editor',
'user:insert-date': (event) ->
editor = @getModel()
editor.insertText(new Date().toLocaleString())
```
`atom.commands`指向全局`{CommandRegistry}`的實例,所有命令在它里面設置,并且可以通過命令面板來獲取。
當你想要綁定新的快捷鍵時,使用命令面板(`ctrl-shift-p`)來看一看在一個具有焦點的上下文中,什么命令正在被監聽,是十分有用的。遵循一個簡單的算法使得命令會很“人性化”,所以`editor:fold-current-row`命令會顯示為“Editor: Fold Current Row”。
### “組合”命令 ###
一個很常見的問題是,“我如何使用一個快捷鍵來執行兩個或者更多命令?”Atom并不直接支持這一需求,但是我們可以通過創建一個自定義命令,它執行你想要的多個操作,并且為這個命令創建一個快捷鍵來解決。例如,假設我想創建一個“組合”命令,選取并剪切一行。你可以在`init.coffee`中添加一下代碼:
```
atom.commands.add 'atom-text-editor', 'custom:cut-line', ->
editor = atom.workspace.getActiveTextEditor()
editor.selectLinesContainingCursors()
editor.cutSelectedText()
```
然后我們想要把這個命令關聯到`alt-ctrl-z`上去,你應該添加以下內容到鍵表中:
```
'atom-text-editor':
'alt-ctrl-z': 'custom:cut-line'
```
### 特異性(優先級)和層級順序 ###
就像這個應用了CSS樣式的例子,當很多快捷鍵的綁定匹配到一個元素的時候,沖突通過選擇最特別的選擇器來解決。如果兩個匹配到的選擇器具有相同的特異性,在層級中出現順序靠后的選擇器的快捷鍵會優先執行。
當前,沒有任何方法在一個單獨的鍵表中指定快捷鍵的順序,因為JSON的對象是無序的。我們最終打算為鍵表引入一個自定義類似CSS的文件格式來允許在單個文件中排序。到目前為止,我們可以選擇性解決一些情況,其中選擇器的順序由把鍵表分開放到兩個文件中來嚴格規定。就像`snippets-1.cson`和`snippets-2.cson`。
## 移除快捷鍵 ##
當鍵表系統遇到了以`unset!`作為快捷鍵的命令,它就會像沒有綁定匹配到當前鍵位序列一樣,繼續從它的父節點中尋找。如果你想移除一個你不再用到的快捷鍵,例如Atom核心中的或者包中的快捷鍵,應該直接使用`unset!`。
例如,下面的代碼移除了樹視圖上`a`的快捷鍵,它一般會觸發`tree-view:add-file`命令:
```
'.tree-view':
'a': 'unset!'
```

## 強制Chrome處理本地快捷鍵 ##
如果你想要在一個提供的快捷鍵上強制執行本地瀏覽器的行為,直接使用`native!`作為綁定的命令。這會在啟動本地輸入元素的正確行為時比較有用。例如,如果你在一個元素上面應用了`.native-key-bindings` class,所有由瀏覽器處理的快捷鍵都會綁定為`native!`。
## 重載快捷鍵 ##
一些情況下需要把多個動作依次放到同一個快捷鍵下面。一個例子就是代碼段的包,代碼段由輸入一個類似`for`的前綴之后按下`tab`來插入。每次`tab`按下的時候,如果光標前面的文字存在對應的代碼段,我們想要執行代碼來展開代碼段。如果代碼段并不存在,我們希望`tab`插入空白字符。
要實現成這樣,代碼段的包利用了代表`snippets:expand`命令的事件對象的`.abortKeyBinding()`方法。
```
# pseudo-code
editor.command 'snippets:expand', (e) =>
if @cursorFollowsValidPrefix()
@expandSnippet()
else
e.abortKeyBinding()
```
當事件處理器觀察到光標前面并沒有一個有效的前綴時,會調用`e.abortKeyBinding()來告訴鍵表系統繼續尋找另一個匹配到的綁定。
## 詳細步驟:按鍵事件如何映射到命令 ##
+ 按鍵事件出現在獲得焦點的元素上面。
+ 由獲取焦點的元素開始,鍵表會向上搜索,直到文檔的根元素,尋找最具特異性的CSS選擇器,它匹配當前DOM元素并且含有匹配按鍵事件的快捷鍵通配符。
+ 找到匹配的快捷鍵通配符之后,搜索就結束了,并且與通配符綁定的命令會在當前元素上觸發。
+ 如果在觸發的事件對象上調用了`.abortKeyBinding()`,會恢復搜索,在相同元素上觸發下一個最具特異性的CSS選擇器上綁定的事件,或者繼續向上搜索。
+ 如果找不到任何快捷鍵,事件通常就會由Chrome來處理。