Repository navigation
kitty keyboard protocol
Оригинал документации на протокол китти
Ответы на вопросы про непонятные места в протоколе
Ниже русский перевод спецификации.
В современных терминалах есть множество проблем, связанных с обработкой клавиатуры. Основные из них:
- Нельзя использовать модификаторы, кроме
ctrlиalt. - Нет надежного способа использовать комбинации из нескольких модификаторов, за исключением
shift+altиctrl+alt. - Многие escape-последовательности, кодирующие события клавиатуры, неоднозначны: разные нажатия могут кодироваться одинаково.
- Нет способа различать типы событий: нажатие, отпускание, повторение.
- Нет надёжного способа отличить одиночное нажатие
Escот начала escape-последовательности. Программы используют для этого хаки, основанные на замерах времени, что приводит к ошибкам (например, https://github.com/neovim/neovim/issues/2035).
Чтобы решить эти и другие проблемы, для kitty разработан новый протокол клавиатуры, обратно совместимый, но позволяющий приложениям использовать расширенные возможности. Протокол основан на уже имеющейся работе в этом направлении, начатой в статье fixterms (http://www.leonerd.org.uk/hacks/fixterms/), но исправляет в ней ряд ошибок (см. конец документа). Обсуждение спецификации — https://github.com/kovidgoyal/kitty/issues/3248.
Посмотреть протокол в действии (со всеми улучшениями) можно, запустив в kitty:
kitten show-key -m kittyКроме kitty, этот протокол реализован в:
- foot (https://codeberg.org/dnkl/foot/issues/319)
- WezTerm (https://wezfurlong.org/wezterm/config/lua/config/enable_kitty_keyboard.html)
- alacritty (https://github.com/alacritty/alacritty/pull/7125)
- rio (https://github.com/raphamorim/rio/commit/cd463ca37677a0fc48daa8795ea46dadc92b1e95)
- iTerm2 (https://gitlab.com/gnachman/iterm2/-/issues/10017)
Библиотеки, реализующие протокол:
- notcurses (https://github.com/dankamongmen/notcurses/issues/2131)
- crossterm (https://github.com/crossterm-rs/crossterm/pull/688)
- textual (https://github.com/Textualize/textual/pull/4631)
- vaxis (go: https://sr.ht/~rockorager/vaxis/, zig: https://github.com/rockorager/libvaxis/)
Программы, реализующие протокол:
- Vim (https://github.com/vim/vim/commit/63a2e360cca2c70ab0a85d14771d3259d4b3aafa)
- Emacs (через пакет kkp: https://github.com/benjaminor/kkp)
- Neovim (https://github.com/neovim/neovim/pull/18181)
- kakoune (https://github.com/mawww/kakoune/issues/4103)
- dte (https://gitlab.com/craigbarnes/dte/-/issues/138)
- Helix (https://github.com/helix-editor/helix/pull/4939)
- far2l (https://github.com/elfmz/far2l/commit/e1f2ee0ef2b8332e5fa3ad7f2e4afefe7c96fc3b)
- Yazi (https://github.com/sxyazi/yazi)
- awrit (https://github.com/chase/awrit)
- Turbo Vision/Free Vision (https://github.com/magiblot/tvision/commit/6e5a7b46c6634079feb2ac98f0b890bbed59f1ba, https://gitlab.com/freepascal.org/fpc/source/-/issues/40673#note_2061428120)
- aerc (https://git.sr.ht/~rjarry/aerc/commit/d73cf33c2c6c3e564ce8aff04acc329a06eafc54)
Оболочки, реализующие протокол:
- nushell (https://github.com/nushell/nushell/pull/10540)
- fish (https://github.com/fish-shell/fish-shell/commit/8bf8b10f685d964101f491b9cc3da04117a308b4)
Добавлено в версии 0.20.0.
Если вы разрабатываете приложение или библиотеку и хотите просто использовать этот протокол для более удобной и надёжной обработки клавиатуры, без особых изменений, сделайте следующее:
- Отправьте escape-последовательность
CSI > 1 uпри запуске приложения (если используется основной экран) или при переходе в альтернативный экран. - Все события клавиатуры будут отправляться в нескольких легко разбираемых форматах.
- Отправьте escape-последовательность
CSI < uпри выходе из приложения (если используется основной экран) или перед выходом из альтернативного экрана, чтобы восстановить предыдущий режим клавиатуры.
События будут передаваться либо как обычный UTF-8 текст, либо в виде escape-последовательностей (CSI — это байты 0x1b 0x5b):
CSI число ; модификаторы [u~]
CSI 1 ; модификаторы [ABCDEFHPQS]
0x0d - для Enter
0x7f или 0x08 - для Backspace
0x09 - для Tab
число в первом формате — это либо Unicode-код клавиши (например, 97 для a), либо одно из чисел из таблицы функциональных клавиш (см. ниже). Необязательный параметр модификаторы кодирует активные модификаторы.
Второй формат используется для некоторых функциональных клавиш (Home, End, стрелки, F1-F4). Если модификаторов нет, параметры опускаются: CSI [ABCDEFHPQS].
Для расширенных возможностей (повторы, отпускания клавиш и т.д.) используйте механизм прогрессивного улучшения, описанный далее.
События клавиатуры делятся на два типа: печатающие и непечатающие. Печатающие события отправляются как UTF-8 текст. Это безопасно, так как UTF-8 не содержит управляющих кодов C0. Непечатающие события кодируются escape-последовательностями. В режиме совместимости (по умолчанию) используются старые escape-коды, чтобы старые приложения продолжали работать. Для расширенных функций (отпускание/повтор) приложения могут запросить у терминала дополнительную информацию.
Основная escape-последовательность:
CSI код-клавиши-unicode:альтернативные-коды-клавиш ; модификаторы:тип-события ; текст-в-виде-кодов u
Пробелы добавлены для ясности. Параметры — десятичные числа. Поля разделяются точкой с запятой, подполя — двоеточием. Обязательно только поле код-клавиши-unicode. Последовательность заканчивается символом u (байт 0x75).
код-клавиши-unicode — это Unicode-код клавиши в десятичном представлении. Например, клавиша A представляется как 97 (код строчной a). Всегда используется код строчной версии клавиши. Например, ctrl+shift+a кодируется как CSI 97;модификаторы u, а не CSI 65;модификаторы u.
Если приложение запрашивает альтернативные коды, терминал может отправить ещё два Unicode-кода: код клавиши со сдвигом и код клавиши в базовой раскладке, разделённые двоеточиями. Код со сдвигом — это просто код заглавной версии символа (если сдвиг активен). Например, a становится A. Это нужно для корректной обработки сочетаний клавиш вроде ctrl+плюс, которое может быть ctrl+shift+равно или ctrl+плюс в зависимости от клавиатуры. Код со сдвигом отправляется только если в модификаторах есть shift.
Код в базовой раскладке — это код соответствующей клавиши в стандартной раскладке PC-101. Например, если пользователь использует кириллическую клавиатуру, нажатие ctrl+С будет соответствовать ctrl+c в стандартной раскладке. Терминал отправит базовый код 99, соответствующий клавише c.
Если указан только один альтернативный код, то это код со сдвигом. Если нужно отправить только базовый код, поле кода со сдвигом оставляется пустым:
CSI код-клавиши-unicode::базовый-код
Протокол поддерживает восемь модификаторов: shift, alt, ctrl, super, hyper, meta, num_lock и caps_lock. super — это клавиша Windows/Linux или Command на Mac. alt — это Option на Mac. hyper и meta обычно есть только в X11/Wayland с особыми правилами XKB.
Модификаторы кодируются битовой маской:
shift 0b1 (1)
alt 0b10 (2)
ctrl 0b100 (4)
super 0b1000 (8)
hyper 0b10000 (16)
meta 0b100000 (32)
caps_lock 0b1000000 (64)
num_lock 0b10000000 (128)
В escape-последовательности значение модификатора кодируется как десятичное число 1 + фактические модификаторы. Например, только shift — это 1 + 1 = 2, ctrl+shift — это 1 + 0b101 = 6. Если поле модификаторов отсутствует, значение по умолчанию — 1 (нет модификаторов). Если модификатор активен (клавиша нажата или включен lock), бит этого модификатора должен быть установлен.
Когда событие связано с клавишей-модификатором, бит соответствующего модификатора должен быть установлен в соответствии с состоянием модификатора, включая эффект текущего события. Например, при нажатии LEFT_CONTROL бит ctrl должен быть установлен, а при отпускании — сброшен. Когда нажаты обе клавиши Ctrl, и одна отпускается, событие отпускания должно иметь бит ctrl установленным. Подробнее: https://github.com/kovidgoyal/kitty/issues/6913.
Есть три типа событий: press (нажатие), repeat (повтор) и release (отпускание). Они кодируются (если запрошены флагом 0b10) как подполе поля модификаторов, разделённое двоеточием. Если модификаторов нет, поле модификаторов должно иметь значение 1, а подполе типа события — тип события. press имеет значение 1 и используется по умолчанию. repeat — это 2, release — это 3. Примеры:
CSI код-клавиши # press
CSI код-клавиши;модификатор # press
CSI код-клавиши;модификатор:1 # press
CSI код-клавиши;модификатор:2 # repeat
CSI код-клавиши;модификатор:3 # release
Замечание: Для печатающих событий типы событий не поддерживаются, если приложение не запрашивает режим отчёта о клавишах (см. ниже).
Терминал может отправлять текст, связанный с событием, как последовательность Unicode-кодов. Это включается механизмом прогрессивного улучшения. Примеры:
shift+a -> CSI 97 ; 2 ; 65 u # Текст 'A' кодируется как 65
option+a -> CSI 97 ; ; 229 u # Текст 'å' кодируется как 229
Несколько кодов разделяются двоеточиями. Если текст не связан ни с одной клавишей, используется код 0. Текст не должен содержать управляющих кодов (коды меньше U+0020 и коды из блоков C0 и C1).
Многие клавиши не соответствуют буквам (функциональные клавиши: Escape, Play, Pause, F1, Home и т.д.). Они кодируются с помощью кодов из Private Use Area (57344 - 63743). Соответствие имён клавиш кодам приведено в таблице функциональных клавиш ниже.
Хотя теоретически каждое событие можно представить этим протоколом, существует множество старых терминальных программ, ожидающих старые управляющие коды. Чтобы их поддержать, по умолчанию терминал отправляет старые коды для совместимости. Если программе нужна более надёжная обработка, она может запросить её у терминала. Каждое улучшение описано ниже. Escape-последовательность для запроса улучшений:
CSI = флаги ; режим u
флаги — десятичное число, кодирующее набор битовых флагов. Необязательный параметр режим (по умолчанию 1) указывает, как применяются флаги:
-
1: все установленные биты устанавливаются, сброшенные — сбрасываются. -
2: все установленные биты устанавливаются, сброшенные — не меняются. -
3: все установленные биты сбрасываются, сброшенные — не меняются.
| Бит | Значение |
|---|---|
| 0b1 (1) | Различать escape-последовательности |
| 0b10 (2) | Сообщать о типах событий |
| 0b100 (4) | Сообщать об альтернативных клавишах |
| 0b1000 (8) | Сообщать обо всех клавишах как escape-кодах |
| 0b10000 (16) | Сообщать о связанном тексте |
Программа может запросить текущие значения флагов:
CSI ? u
Терминал ответит:
CSI ? флаги u
Программа может поместить/извлечь текущие флаги в стек терминала:
CSI > флаги u # поместить в стек (по умолчанию ноль, если флаги опущены)
CSI < число u # извлечь число записей из стека (по умолчанию 1)
Терминалы должны ограничивать размер стека для предотвращения DoS-атак. Стек должен быть отдельный для основного и альтернативного экранов. Если запрос на извлечение из стека опустошает его, все флаги сбрасываются. Если стек полон при запросе на добавление, самая старая запись должна быть удалена.
Замечание: Основной и альтернативный экраны должны иметь независимые стеки режимов клавиатуры. Это позволяет программе, использующей альтернативный экран (например, редактору), менять режим клавиатуры, не затрагивая основной экран. Без этого редактору пришлось бы каким-то образом узнавать режим основного экрана и восстанавливать его при выходе.
Это улучшение (0b1) решает проблему пересечения кодов некоторых клавиш с другими управляющими кодами. Например, нажатие Esc генерирует байт 0x1b, который также используется для начала escape-последовательностей. alt+[ генерирует байты, используемые для CSI.
Включение этого флага заставит терминал сообщать о Esc, alt+клавиша, ctrl+клавиша, ctrl+alt+клавиша, shift+alt+клавиша с помощью последовательностей CSI u вместо старых. Здесь клавиша — любая ASCII-клавиша. Непечатающие события клавиш цифрового блока также будут кодироваться с помощью CSI u, используя специальные коды из таблицы ниже.
С этим флагом все непечатающие события представляются в одном из двух форматов:
CSI число;модификатор u
CSI 1;модификатор[~ABCDEFHPQS]
Это упрощает разбор событий. ctrl+c больше не будет генерировать сигнал SIGINT, а будет доставлено как escape-код CSI u. Исключения: Enter, Tab и Backspace — они генерируют те же байты, что и раньше, чтобы пользователь мог ввести и выполнить команду вроде reset, если программа, установившая этот режим, завершилась аварийно, не сбросив его. Модификаторы-блокировки (Lock) не сообщаются для печатающих клавиш, чтобы сохранить их работоспособность в старых программах. Чтобы получать lock-модификаторы для всех клавиш, используйте улучшение "Сообщать обо всех клавишах как escape-кодах".
Это улучшение (0b10) заставляет терминал сообщать о повторах и отпусканиях клавиш. Обычно отправляются только нажатия, а повторы обрабатываются как нажатия.
Замечание:
Enter,TabиBackspaceне будут иметь событий отпускания, если не установлено также "Сообщать обо всех клавишах как escape-кодах".
Это улучшение (0b100) заставляет терминал сообщать об альтернативных кодах клавиш в дополнение к основному, что помогает в обработке сочетаний клавиш. Обратите внимание, что этот флаг только дополняет escape-коды, используемые для представления событий клавиатуры. Поэтому это усовершенствование затронет только события клавиатуры, уже представленные в виде escape-кодов из-за других действующих улучшений.
Печатающие события (например, обычные нажатия без модификаторов) в старом протоколе отправляют только текст. Нет способа узнать о повторах/отпусканиях. Это нужно, например, в играх (перемещение с помощью WASD).
Это улучшение (0b1000) включает отправку событий для всех клавиш, включая печатающие. Текст при этом не отправляется. Если нужен и текст, используйте совместно с улучшением "Сообщать о связанном тексте".
Кроме того, в этом режиме сообщается о нажатиях клавиш-модификаторов. Все клавиши, включая Enter, Tab, Backspace, сообщаются как escape-коды.
Это улучшение (0b10000) указывает терминалу при событиях, связанных с печатающими текст клавишами, добавлять соответствующий текст внутрь escape-кодов CSI u. Обратите внимание, что этот флаг является улучшением режима «отправлять все нажатия клавиш как escape последовательности» и отдельно от него не работает (поведение в этом случае строго не определено).
Приложение может проверить поддержку протокола, запросив текущий статус прогрессивного улучшения, а затем запросив основные атрибуты устройства. Если ответ на запрос атрибутов получен без ответа на запрос статуса улучшения, терминал не поддерживает этот протокол.
По умолчанию терминал использует старую кодировку. В ней отправляются только нажатия и повторы, и нет способа их различить. Текст отправляется как UTF-8.
Все события, не описанные в этом разделе, отправляются с помощью стандартной кодировки CSI u. Это включает клавиши, не кодируемые в старой кодировке, что расширяет возможности даже без прогрессивного улучшения.
Эти клавиши кодируются тремя способами:
CSI число ; модификатор ~
CSI 1 ; модификатор {ABCDEFHPQS}
SS3 {ABCDEFHPQRS}
Если модификаторов нет, параметр модификатор опускается. Во втором формате число всегда 1 и опускается, если нет модификаторов. Третий формат преобразуется во второй, если есть модификаторы (SS3 — это байты 0x1b 0x4f).
Эти последовательности должны соответствовать записям в базе данных terminfo. В таблице ниже перечислены клавиша, её имя в terminfo и escape-код, используемый kitty. Другой терминал будет использовать код из своей базы terminfo.
Некоторые клавиши имеют альтернативное представление в режиме клавиш курсора (terminfo: smkx/rmkx). Эта форма используется только в режиме клавиш курсора и только без модификаторов.
| Название | Имя в terminfo | Escape-код |
|---|---|---|
| INSERT | kich1 | CSI 2 ~ |
| DELETE | kdch1 | CSI 3 ~ |
| PAGE_UP | kpp | CSI 5 ~ |
| PAGE_DOWN | knp | CSI 6 ~ |
| UP | cuu1,kcuu1 | CSI A, SS3 A |
| DOWN | cud1,kcud1 | CSI B, SS3 B |
| RIGHT | cuf1,kcuf1 | CSI C, SS3 C |
| LEFT | cub1,kcub1 | CSI D, SS3 D |
| HOME | home,khome | CSI H, SS3 H |
| END | -,kend | CSI F, SS3 F |
| F1 | kf1 | SS3 P |
| F2 | kf2 | SS3 Q |
| F3 | kf3 | SS3 R |
| F4 | kf4 | SS3 S |
| F5 | kf5 | CSI 15 ~ |
| F6 | kf6 | CSI 17 ~ |
| F7 | kf7 | CSI 18 ~ |
| F8 | kf8 | CSI 19 ~ |
| F9 | kf9 | CSI 20 ~ |
| F10 | kf10 | CSI 21 ~ |
| F11 | kf11 | CSI 23 ~ |
| F12 | kf12 | CSI 24 ~ |
| MENU | kf16 | CSI 29 ~ |
Ещё несколько функциональных клавиш имеют особые старые кодировки, так как они часто используются, и старые приложения могут путаться, видя CSI u:
| Клавиша | Без мод. | Ctrl | Alt | Shift | Ctrl+Shift | Alt+Shift | Ctrl+Alt |
|---|---|---|---|---|---|---|---|
| Enter | 0xd | 0xd | 0x1b 0xd | 0xd | 0xd | 0x1b 0xd | 0x1b 0xd |
| Escape | 0x1b | 0x1b | 0x1b 0x1b | 0x1b | 0x1b | 0x1b 0x1b | 0x1b 0x1b |
| Backspace | 0x7f | 0x8 | 0x1b 0x7f | 0x7f | 0x8 | 0x1b 0x7f | 0x1b 0x8 |
| Tab | 0x9 | 0x9 | 0x1b 0x9 | CSI Z | CSI Z | 0x1b CSI Z | 0x1b 0x9 |
| Space | 0x20 | 0x0 | 0x1b 0x20 | 0x20 | 0x0 | 0x1b 0x20 | 0x1b 0x0 |
Backspace и ctrl+Backspace в некоторых терминалах перепутаны. Это можно определить по свойству terminfo kbs, которое должно соответствовать Backspace.
Все клавиши цифрового блока кодируются как их не-keypad эквиваленты. Чтобы различать их, используйте флаг disambiguate.
Терминалы могут по-разному обрабатывать функциональные клавиши без старой кодировки. kitty кодирует их с помощью CSI u даже в старом режиме, чтобы их можно было использовать даже в программах, не поддерживающих протокол kitty. Другие терминалы могут игнорировать такие клавиши в старом режиме или иметь опцию для управления этим поведением.
Для совместимости клавиши a-z, 0-9, `, -, =, [, ], \, ;, ', ,, ., / с модификаторами shift, alt, ctrl, shift+alt, ctrl+alt выводятся по следующему алгоритму:
- Если нажат
alt, вывести байтESC (0x1b). - Если нажат
ctrl, преобразовать клавишу по таблице в разделе "Старое преобразование ASCII-клавиш с Ctrl". - Иначе, если нажат
shift, вывести код клавиши со сдвигом (например,Aдляa,$для4). - Иначе вывести код клавиши без изменений.
ctrl+space выводится как NULL-байт (0x0).
Любые другие комбинации модификаторов с этими клавишами выводятся как escape-коды CSI u.
| Клавиша | Обычная | shift | alt | ctrl | shift+alt | alt+ctrl | ctrl+shift |
|---|---|---|---|---|---|---|---|
| i | i (105) | I (73) | ESC i | ) (41) | ESC I | ESC ) | CSI 105; 6 u |
| 3 | 3 (51) | # (35) | ESC 3 | 3 (51) | ESC # | ESC 3 | CSI 51; 6 u |
| ; | ; (59) | : (58) | ESC ; | ; (59) | ESC : | ESC ; | CSI 59; 6 u |
Замечание: Многие старые escape-коды неоднозначны: разные нажатия дают одинаковые коды (например,
ctrl+i— то же, что иtab,ctrl+m— то же, что иEnter,ctrl+r— то же, что иctrl+shift+r). Чтобы решить это, используйте улучшениеdisambiguate.
Все числа находятся в Private Use Area (57344 - 63743), кроме нескольких клавиш, использующих числа меньше 32 и 127 (управляющие коды C0) для совместимости.
| Название | CSI | Название | CSI |
|---|---|---|---|
| ESCAPE | 27 u |
ENTER | 13 u |
| TAB | 9 u |
BACKSPACE | 127 u |
| INSERT | 2 ~ |
DELETE | 3 ~ |
| LEFT | 1 D |
RIGHT | 1 C |
| UP | 1 A |
DOWN | 1 B |
| PAGE_UP | 5 ~ |
PAGE_DOWN | 6 ~ |
| HOME |
1 H или 7 ~
|
END |
1 F или 8 ~
|
| CAPS_LOCK | 57358 u |
SCROLL_LOCK | 57359 u |
| NUM_LOCK | 57360 u |
PRINT_SCREEN | 57361 u |
| PAUSE | 57362 u |
MENU | 57363 u |
| F1 |
1 P или 11 ~
|
F2 |
1 Q или 12 ~
|
| F3 | 13 ~ |
F4 |
1 S или 14 ~
|
| F5 | 15 ~ |
F6 | 17 ~ |
| F7 | 18 ~ |
F8 | 19 ~ |
| F9 | 20 ~ |
F10 | 21 ~ |
| F11 | 23 ~ |
F12 | 24 ~ |
| F13 | 57376 u |
F14 | 57377 u |
| F15 | 57378 u |
F16 | 57379 u |
| F17 | 57380 u |
F18 | 57381 u |
| F19 | 57382 u |
F20 | 57383 u |
| F21 | 57384 u |
F22 | 57385 u |
| F23 | 57386 u |
F24 | 57387 u |
| F25 | 57388 u |
F26 | 57389 u |
| F27 | 57390 u |
F28 | 57391 u |
| F29 | 57392 u |
F30 | 57393 u |
| F31 | 57394 u |
F32 | 57395 u |
| F33 | 57396 u |
F34 | 57397 u |
| F35 | 57398 u |
KP_0 | 57399 u |
| KP_1 | 57400 u |
KP_2 | 57401 u |
| KP_3 | 57402 u |
KP_4 | 57403 u |
| KP_5 | 57404 u |
KP_6 | 57405 u |
| KP_7 | 57406 u |
KP_8 | 57407 u |
| KP_9 | 57408 u |
KP_DECIMAL | 57409 u |
| KP_DIVIDE | 57410 u |
KP_MULTIPLY | 57411 u |
| KP_SUBTRACT | 57412 u |
KP_ADD | 57413 u |
| KP_ENTER | 57414 u |
KP_EQUAL | 57415 u |
| KP_SEPARATOR | 57416 u |
KP_LEFT | 57417 u |
| KP_RIGHT | 57418 u |
KP_UP | 57419 u |
| KP_DOWN | 57420 u |
KP_PAGE_UP | 57421 u |
| KP_PAGE_DOWN | 57422 u |
KP_HOME | 57423 u |
| KP_END | 57424 u |
KP_INSERT | 57425 u |
| KP_DELETE | 57426 u |
KP_BEGIN |
1 E или 57427 ~
|
| MEDIA_PLAY | 57428 u |
MEDIA_PAUSE | 57429 u |
| MEDIA_PLAY_PAUSE | 57430 u |
MEDIA_REVERSE | 57431 u |
| MEDIA_STOP | 57432 u |
MEDIA_FAST_FORWARD | 57433 u |
| MEDIA_REWIND | 57434 u |
MEDIA_TRACK_NEXT | 57435 u |
| MEDIA_TRACK_PREVIOUS | 57436 u |
MEDIA_RECORD | 57437 u |
| LOWER_VOLUME | 57438 u |
RAISE_VOLUME | 57439 u |
| MUTE_VOLUME | 57440 u |
LEFT_SHIFT | 57441 u |
| LEFT_CONTROL | 57442 u |
LEFT_ALT | 57443 u |
| LEFT_SUPER | 57444 u |
LEFT_HYPER | 57445 u |
| LEFT_META | 57446 u |
RIGHT_SHIFT | 57447 u |
| RIGHT_CONTROL | 57448 u |
RIGHT_ALT | 57449 u |
| RIGHT_SUPER | 57450 u |
RIGHT_HYPER | 57451 u |
| RIGHT_META | 57452 u |
ISO_LEVEL3_SHIFT | 57453 u |
| ISO_LEVEL5_SHIFT | 57454 u |
Замечание: Escape-коды вида
CSI 1 буквабудут без1, если нет модификаторов, так как1— значение по умолчанию.Замечание: В изначальной версии спецификации F3 кодировалась как CSI R и CSI ~. Однако CSI R конфликтует с отчётом о позиции курсора, поэтому был удалён.
Когда нажаты ctrl и другая клавиша, терминалы для некоторых клавиш преобразуют результат в управляющий код C0 (значение от 0 до 31). Это преобразование исторически зависело от раскладки аппаратных терминалов и нигде полностью не специфицировано. Лучший источник — Таблица 3-5 в документации VT-100.
Таблица ниже предоставляет распространённое надмножество этой таблицы. ASCII-клавиши, которых нет в таблице, ctrl не должен изменять.
| Клавиша | Байт | Клавиша | Байт | Клавиша | Байт |
|---|---|---|---|---|---|
| SPC | 0 | / | 31 | 0 | 48 |
| 1 | 49 | 2 | 0 | 3 | 27 |
| 4 | 28 | 5 | 29 | 6 | 30 |
| 7 | 31 | 8 | 127 | 9 | 57 |
| ? | 127 | @ | 0 | [ | 27 |
| \ | 28 | ] | 29 | ^ | 30 |
| _ | 31 | a | 1 | b | 2 |
| c | 3 | d | 4 | e | 5 |
| f | 6 | g | 7 | h | 8 |
| i | 9 | j | 10 | k | 11 |
| l | 12 | m | 13 | n | 14 |
| o | 15 | p | 16 | q | 17 |
| r | 18 | s | 19 | t | 20 |
| u | 21 | v | 22 | w | 23 |
| x | 24 | y | 25 | z | 26 |
| ~ | 30 |
Здесь перечислены ошибки в оригинальном предложении fixterms, исправленные в этой спецификации:
- Нет способа отличить нажатие
Esc, кроме использования 8-битных управляющих кодов, что нежелательно. - Неверно утверждается, что специальные клавиши иногда кодируются как
CSI буква, хотя на самом деле этоSS3 букваво всех терминалах новее VT-52. -
ctrl+shift+tabдолжен бытьCSI 9 ; 6 u, а неCSI 1 ; 5 Z(shift+tab— не отдельная клавиша). - Нет поддержки модификатора
super. - Не упоминается режим клавиш курсора и как он меняет кодировки.
- Неверное кодирование клавиш со сдвигом: например,
ctrl+shift+iкодируется какctrl+I. - Нет способа задать неконфликтующие escape-коды для
alt+буква,ctrl+буква,ctrl+alt+буква. - Нет способа указать и сдвинутую, и несдвинутую клавишу для надёжного сопоставления сочетаний (например,
ctrl+shift+равноиctrl+плюс). - Нет способа указать клавишу в альтернативной раскладке (полезно для кириллицы, чтобы
ctrl+cработал при нажатииctrl+С). - Нет способа сообщать о повторах и отпусканиях клавиш, только о нажатиях.
- Нет способа сообщать о событиях для печатающих клавиш (полезно для игр).
- Числа назначены только небольшому подмножеству функциональных клавиш.
- Утверждается, что
CSI uне имеет фиксированного значения, хотя он десятилетиями использовался какSCORC(xterm, ansi.sys) иDECSMBV(VT-510). Это неважно, так как эти коды используются для связи с терминалом, а не от него. - Упрощённо говорится, что
ctrlобычно маскирует с0x1f. На самом деле это происходит только для некоторых клавиш. Действиеctrlне специфицировано и различается между терминалами из-за разных раскладок клавиатуры.
- Нет поддержки событий отпускания.
- Не решает проблему неразличимости
Escот escape-кодов. - Не решает проблему одинаковых кодов для разных нажатий.
- Нет надёжного способа запросить состояние или управлять им из программы.
- Нет поддержки сдвинутых клавиш.
- Нет поддержки альтернативных раскладок.
- Нет поддержки модификаторов, кроме основных четырёх.
- Нет поддержки клавиш-блокировок (Num Lock, Caps Lock).
- Полностью не специфицировано. Лучшее описание — здесь. Оно не содержит спецификации, какие числа назначать функциональным клавишам, кроме запуска скрипта на Perl в X11!