События пользовательского интерфейса Значения кода KeyboardEvent

1. Введение

В этом документе представлен обзор различных раскладок клавиатуры и указаны файлы . значения, которые следует использовать для каждого из ключей. В отличие от значений, описанных в [UIEvents-key] , значения основаны только на физическом расположении клавиши на клавиатуре и не зависят от текущей локали пользователя.KeyboardEventcodekeycode

Эта спецификация ранее называлась DOM Level 3 KeyboardEvent code Values .

1.1. Стилистические условности

В этой спецификации используются следующие соглашения:

• 
  Колпачок ключа или этикетка, напечатанная на ключе, обозначаются как , или . Это используется для ссылки на ключ с точки зрения пользователя без учета значений и в сгенерированном файле .↓=QkeycodeKeyboardEvent

• 
  Глифы, представляющие символ, показаны как: ."𣧂"

• 
  Кодировки символов Юникода показаны как: .U+003d

• 
  Допустимые значения ключевых атрибутов (т. е. значение .) отображаются как: , или .KeyboardEventkey"ArrowDown""=""q""Q"

• 
  Допустимые значения атрибута кода ключа (т. е. значение .) отображаются как: , или .KeyboardEventcode"ArrowDown""Equal""KeyQ"

2. Раскладка клавиатуры

Этот раздел не является нормативным.

Буквенно-цифровые клавиатуры — наиболее распространенный способ генерации событий клавиатуры. В этом разделе представлен обзор стандартных клавиатур и их физических раскладок.

2.1. Стандартные раскладки клавиатуры

В этом разделе описаны физические раскладки общедоступных клавиатур.

2.1.1. Разделы клавиатуры

При обсуждении раскладок клавиатуры удобно разделить стандартную клавиатуру на отдельные разделы и пометить каждую строку.

Эти разделы клавиатуры:

• 
  Буквенно-цифровая часть является основной частью клавиатуры, и именно здесь встречается большая часть вариаций клавиатуры. Когда пользователь выбирает раскладку клавиатуры, больше всего страдают клавиши в этих разделах.

• 
  Разделы панели управления и клавиатуры со стрелками содержат клавиши со стрелками и другие клавиши редактирования.

• 
  Цифровая клавиатура (также известная как «цифровая клавиатура» или «цифровая клавиатура») содержит цифровые и математические клавиши, упрощающие ввод числовых данных.

• 
  И, наконец, раздел функций содержит различные функциональные клавиши и специальные клавиши, такие как .Escape

Чтобы облегчить идентификацию клавиш, строки на клавиатуре имеют названия, начиная с «A» для нижней строки и до «E» для верхней строки. Ряд клавиш функционального раздела считается строкой «К». Эти имена строк соответствуют именам, указанным в [ISO9995-1] .

Обратите внимание, что многие клавиатуры (как современные, так и устаревшие) имеют дополнительные клавиши, которые не вписываются в приведенные выше разделы. Некоторые из этих ключей описаны в §3.1.6 «Ключи мультимедиа» .

2.1.2. Стандартная раскладка клавиатуры «101»

Стандартная клавиатура «101» (обычно называемая «раскладкой США») — единственная раскладка, в которой клавиша (с меткой ) находится над однорядной клавишей. Во всех остальных макетах этот ключ отсутствует и он расширяется, занимая две строки. " Backslash " \| Enter Enter

Современные стандартные клавиатуры с раскладкой «101» фактически содержат 104 клавиши: 61 клавиша в буквенно-цифровой секции и 43 клавиши в цифровой клавиатуре , панели управления , клавиатуре со стрелками и функциональной секции . Название «101» для этой раскладки клавиатуры относится к тому времени, когда эта стандартная клавиатура действительно содержала 101 клавишу. Два ключа (обычно имеют метку, специфичную для ОС), и ключ были добавлены позже, в результате чего общее количество ключей достигло 104. Meta Menu

2.1.3. Альтернативная раскладка клавиатуры «101»

Альтернативная клавиатура «101» имеет большую клавишу и сжимает ее, чтобы освободить место для клавиши (которая заменяет клавишу в стандартной раскладке 101). Название происходит от японской раскладки, где это клавиша ( иена ). В русской раскладке, показанной ниже, эта клавиша соответствует букве . Enter Backspace " IntlYen " " Backslash " " IntlYen " ¥ \/

Современные альтернативные клавиатуры с раскладкой «101» содержат 104 клавиши: 61 клавиша в буквенно-цифровой секции и 43 клавиши в цифровой клавиатуре , панели управления , клавиатуре со стрелками и функциональной секции .

2.1.4. Стандартная раскладка клавиатуры «102»

Стандартная клавиатура «102» распространена по всей Европе и добавляет клавишу, которой нет в раскладках «101»: клавиша (обозначенная на клавиатуре Великобритании) рядом с левой клавишей Shift."IntlBackslash"\|

Также добавлен второй ключ (помеченный как британская клавиатура), который частично заправлен под контроль. Эта клавиша закодирована с использованием того же кода, что и клавиши на раскладке клавиатуры «101». По данным [USB-HID], США и Великобритания на самом деле используют две клавиши (названные «Keyboard \ and |» и «Keyboard» на самом деле неамериканские # и ~»), но поскольку эти два переключателя никогда не встречаются одновременно на одном и том же самом клавиатура, большинство платформ " Backslash " один и тот Enter \| -код #~ клавиш \| " Backslash " затрудняет их #~ .

Современные клавиатуры с раскладкой «102» содержат 105 клавиш: 62 клавиши в буквенно-цифровой секции и 43 клавиши в цифровой клавиатуре , панели управления , клавиатуре со стрелками и функциональной секции .

2.1.5. Корейская раскладка клавиатуры «103»

Корейская клавиатура «103» основана на альтернативной раскладке 101 и добавлена ​​две дополнительные клавиши (по одной с каждой стороны пробела) в режимы обработки ввода, специфичные для корейского языка. Эти ключи («Hanja», обозначается как hanja ) и («HangulMode», помеченный как han/yeong ). " Lang2 " 한자 " Lang1 " 한/영

Современные клавиатуры с раскладкой «103» содержат 106 клавиш: 63 клавиши в буквенно-цифровой секции и 43 клавиши в цифровой клавиатуре , панели управления , клавиатуре со стрелками и функциональной секции .

2.1.6. Бразильская раскладка клавиатуры «104»

Раскладка «104», используемая в Бразилии, добавляет 4 новые клавиши: две клавиши из раскладки «102» ( и ), плюс клавишу (рядом с правой клавишей Shift) и дополнительную клавишу на цифровой клавиатуре . Эта новая клавиша цифровой клавиатуры называется потому, что она представляет собой разделитель тысяч. На бразильской раскладке клавиш эта клавиша помечена, а сама клавиша помечена ."Backslash""IntlBackslash""IntlRo""NumpadComma"."NumpadDecimal",

Современные клавиатуры с раскладкой «104» содержат 107 клавиш: 63 клавиши в буквенно-цифровой секции и 44 клавиши в цифровой клавиатуре , панели управления , клавиатуре со стрелками и функциональной секции . На некоторых бразильских клавиатурах отсутствует дополнительная клавиша цифровой клавиатуры , и они имеют только 106 клавиш.

2.1.7. Японская раскладка клавиатуры «106»

В японской раскладке клавиатуры «106» добавлены 3 новые клавиши: (с надписью ), (с надписью ) и (с надписью ). Он также уменьшает клавишу пробела, чтобы освободить место для трех клавиш режима ввода: (с меткой мухэнкан ), (с меткой хэнкан ) и (с меткой катакана/хирагана/ромаджи )."IntlYen"¥_"Backslash"]む"IntlRo"\ろ"NonConvert"無変換"Convert"変換"KanaMode"カタカナ/ひらがな/ローマ字

Современные клавиатуры с раскладкой «106» содержат 109 клавиш: 66 клавиш в буквенно-цифровой секции и 43 клавиши в цифровой клавиатуре , панели управления , клавиатуре со стрелками и функциональной секции .

2.1.8. Раскладка клавиатуры Apple

В целом клавиатуры Apple имеют ту же раскладку, что и клавиатуры ПК, но есть некоторые различия, как показано на следующем рисунке.

На этом рисунке зеленые клавиши — это те, которые были перемещены в новое место, а синие клавиши обозначают добавленные клавиши.

2.1.9. Раскладки клавиатуры ноутбука

Ограниченное пространство на клавиатуре ноутбука часто означает, что физическое расположение клавиш необходимо настроить так, чтобы оно соответствовало всем необходимым клавишам. Клавиши системы письма в буквенно-цифровой секции, как правило, остаются нетронутыми, но другие секции клавиатуры обычно объединяются с другими клавишами или вообще удаляются.

В этой клавиатуре ноутбука Apple правая клавиша управления была удалена, чтобы освободить место для клавиш со стрелками половинной высоты, а слева добавлена ​​клавиша. Fn

Клавиатуры ноутбуков ПК значительно различаются, но этот образец клавиатуры демонстрирует некоторые часто встречающиеся аспекты. Клавиши панели управления добавлены с правой стороны, а клавиши со стрелками спрятаны внизу. Правую клавишу часто уменьшают, чтобы освободить место для клавиши со стрелкой вверх, а правую клавишу обычно вообще удаляют. Shift Meta

2.2. Мобильные клавиатуры

В случае, если автор контента желает полагаться на механическую раскладку мобильной клавиатуры, эта спецификация предлагает конфигурацию клавиатуры, указанную в [ISO9995-8] , которая определяет раскладку цифровой клавиатуры и вторичное назначение символов Юникода в диапазоне .. . (-) к цифровым клавишам через , как общепринятая раскладка, подходящая для некоторых международных применений. U+0061 U+007A "a" "z" 2 9

Эта раскладка клавиатуры и, в частности, распределение букв предназначены для английских устройств и не будут соответствовать клавиатурам или конфигурациям многих пользователей. Авторы контента не могут полагаться на какую-либо конкретную конфигурацию и должны создавать контент интернационализированным и локализуемым образом.

2.3. Пульты дистанционного управления мультимедиа

Многие клавиатуры содержат специальные клавиши для управления мультимедийными функциями. Все чаще многие мультимедийные устройства, особенно телевизоры, имеют доступ к Интернету. Гибридные устройства с клавиатурой и дистанционным управлением становятся все более распространенными. Чтобы удовлетворить потребности этих гибридных веб-/медиа-устройств, в данной спецификации определены клавиши, которые являются общими для кнопок пульта дистанционного управления, в дополнение к традиционным клавишам клавиатуры.

Из-за меньшего форм-фактора клавиши (или кнопки) на пульте дистанционного управления часто бывают модальными: одна клавиша выполняет различные функции в зависимости от контекста содержимого на экране. Кроме того, многие клавиши служат переключателями для переключения между двумя или более состояниями (см. Клавиши переключения). Эти кнопки пульта дистанционного управления обычно не имеют состояний-модификаторов, поэтому каждой кнопке назначается одна функция (например, , , или ). Play Pause Menu Exit Up

2.4. Виртуальные клавиатуры и аккордовые клавиатуры

Виртуальные клавиатуры представляют собой программные наборы клавиш различного расположения, обычно встречающиеся на устройствах с сенсорным экраном. Они часто являются модальными, с возможностью переключения между различными динамическими наборами клавиш, такими как буквенные, цифровые или символические клавиши. Из-за отсутствия физических ограничений эти клавиатуры МОГУТ отображать самый широкий набор символов, включая смайлики и другие символы. Однако везде, где это возможно, виртуальные клавиатуры ДОЛЖНЫ генерировать обычный диапазон событий и значений клавиатуры для простоты разработки и совместимости с существующим контентом.

Аккордовые клавиатуры, также известные как аккордовые клавиатуры или аккордовые клавиатуры, представляют собой ключевые устройства ввода, которые выдают значения путем нажатия нескольких клавиш в комбинации или последовательности, обычно для имитации полного набора символов или команд на сокращенном наборе клавиш, часто для работы одной рукой. использовать. Клавиатура с аккордами МОЖЕТ иметь дополнительные клавиши режима для переключения между значениями клавиш, а количество и тип клавиш, нажимаемых для получения значения клавиши, будут различаться, но окончательные значения клавиш, создаваемые такими клавиатурами, ДОЛЖНЫ соответствовать диапазону значений клавиш, описанному в этой спецификации. .

Для этих и других альтернативных модальных клавиатур РЕКОМЕНДУЮТСЯ значения , , и для клавиш, которые переключаются между различными режимами. key " Alphanumeric " " CapsLock " " NumLock " " SymbolLock "

3. Таблицы значений code событий клавиатуры

Значением атрибута кода ключа является любое из значений, указанных в столбце =KeyboardEvent.code= любой из таблиц в этом разделе спецификации.

Соответствующая реализация интерфейса ДОЛЖНА поддерживать этот набор значений для использования в атрибутах, хотя не все значения МОГУТ быть доступны на всех платформах или устройствах. code KeyboardEvent

В этом разделе определяется список значений, которые ДОЛЖНЫ поддерживаться реализациями. code

Будущие версии этой спецификации МОГУТ включать значения, не включенные сюда, которые стали обычными с момента публикации этой спецификации. code

Примечание. Несмотря на то, что были предприняты все попытки сделать этот список значений как можно более полным, периодически необходимо будет определять новые значения по мере появления новых устройств ввода. Вместо того, чтобы позволять пользовательским агентам определять свои собственные значения атрибутов кода ключа (которые вряд ли будут одинаковыми для нескольких пользовательских агентов), СЛЕДУЕТ регистрировать ошибки, чтобы эту спецификацию можно было обновить.

3.1. Коды клавиш для стандартных клавиатур

В этом разделе более подробно описаны различные разделы клавиатуры и определены значения, которые следует использовать для каждой клавиши.code

3.1.1. Буквенно-цифровой раздел

Буквенно-цифровой раздел является основным разделом клавиатуры. Он содержит клавиши, которые делятся на две общие категории: клавиши системы письма , значение которых меняется в зависимости от текущей раскладки клавиатуры, и функциональные клавиши , которые (в основном) одинаковы для всех раскладок.

3.1.1.1. Запись системных ключей

Клавиши системы письма — это те, которые меняют значение (т. е. создают разные значения) в зависимости от текущей локали и раскладки клавиатуры.key

На этом рисунке показана гипотетическая клавиатура, сочетающая в себе все клавиши системы письма (показаны синим и зеленым цветом), имеющиеся на различных клавиатурах. Синие клавиши присутствуют на всех стандартных клавиатурах, а зеленые клавиши доступны только на некоторых клавиатурах.

Имя, отображаемое на каждой клавише, присвоено этой клавише. Везде, где это возможно, имена основаны на названии клавиши США в этой позиции (т. е. они основаны на раскладке клавиатуры США). Для клавиш, которых нет на клавиатуре США, вместо них используются названия из британской или японской раскладки.codecode

Обратите внимание, что на этом рисунке есть две клавиши: большая в конце ряда D в раскладке из 101 клавиши и меньшая между строкой C в раскладках из 102, 104 и 106 клавиш. На раскладке клавиатуры может присутствовать только одна клавиша."Backslash""Quote""Enter""Backslash"

3.1.1.2. Функциональные клавиши

Функциональные клавиши ( не путать с функциональными клавишами , описанными ниже ) — это клавиши в буквенно-цифровом разделе , которые предоставляют общие функции редактирования, общие для всех локалей (например, , и ). За некоторыми исключениями, эти клавиши не меняют значения в зависимости от текущей раскладки клавиатуры. Shift Tab Enter Backspace

Ключ (выделен зеленым) — единственный функциональный ключ , который не генерирует одно и то же значение для каждой локали. В некоторых регионах он производит, а в других — . key « " AltRight " " Alt " " AltGraph "

На некоторых клавиатурах (особенно японской и корейской) размер клавиши пробела уменьшен, чтобы освободить место для дополнительных клавиш в нижнем ряду (строка A). Эти клавиши обычно позволяют пользователям изменять текущий режим ввода. Обратите внимание: хотя некоторые из этих японских и корейских клавиш занимают одно и то же физическое место на клавиатуре, они используют разные значения.code

На клавиатурах Apple некоторые клавиши в нижнем ряду опущены, а другие расположены в другом порядке.

3.1.2. Раздел панели управления

Панель управления клавиатуры представляет собой набор (обычно 6) клавиш, выполняющих операции навигации и редактирования, например , и .HomePageUpInsert

Клавиша for (находится на некоторых клавиатурах Apple) определена ниже в разделе функций . code Fn

3.1.3. Раздел «Стрелка»

Панель со стрелками содержит 4 клавиши со стрелками. Клавиши обычно расположены в форме перевернутой буквы Т.

3.1.4. Раздел цифровой клавиатуры

Раздел цифровой клавиатуры представляет собой набор клавиш на клавиатуре, расположенных в виде сетки, как на калькуляторе или мобильном телефоне. Этот раздел содержит цифровые и математические клавиши операторов. Часто этот раздел содержит клавишу, которая позволяет клавишам переключаться между стандартными числовыми функциями и имитировать клавиши панели управления и клавиши со стрелками . В портативных компьютерах и компактных клавиатурах эти клавиши обычно отсутствуют для экономии места. NumLock

 Клавиатура
это альтернативный термин для цифровой клавиатуры .

Значения в этом разделе также следует использовать для клавиатур телефонов и устройств дистанционного управления, в которых цифровые клавиши расположены в виде сетки.code

Стандартная цифровая клавиатура иногда дополняется дополнительными клавишами для скобок, операторов, шестнадцатеричных символов или функций калькулятора (например, ). Некоторые из часто добавляемых ключей перечислены в таблице ниже.Backspace

Для цифровых клавиатур , которые предоставляют ключи, не перечисленные здесь, необходимо создать строку значений, начиная с «Numpad» и добавляя соответствующее описание клавиши. code

3.1.5. Функциональный раздел

Функциональный раздел расположен в верхней части клавиатуры (над буквенно-цифровым разделом ) и содержит функциональные клавиши и несколько дополнительных специальных клавиш (например, и ).EscPrint Screen

Функциональная клавиша — это любая из клавиш с надписью «...», которую приложение или операционная система может связать с настраиваемой функцией или действием.F1F12

На некоторых клавиатурах (особенно на ноутбуках или других портативных компьютерах) функциональные клавиши (...) предназначены для выполнения других основных функций (например, управления яркостью дисплея или громкостью звука), и для их включения требуется нажатие отдельной клавиши. действовать как функциональные клавиши. К сожалению, основные функции, назначенные этим клавишам, сильно различаются от одного производителя к другому. По этой причине всегда устанавливается имя функциональной клавиши .F1F12Fncode

Для клавиатур, имеющих более 12 функциональных клавиш , значение соответствует шаблону, показанному выше: буква «F» сопровождается номером функциональной клавиши — , , и т. д. code "F13" "F14" "F15"

На клавиатурах Apple в функциональном разделе могут быть клавиши или . Значения этих ключей определены в §3.1.6 «Ключи мультимедиа» . Eject code Power

3.1.6. Медиа-ключи

Мультимедийные клавиши — это дополнительные клавиши, добавленные к клавиатуре, которые обеспечивают функции, связанные с мультимедиа, такие как воспроизведение, пауза или регулировка громкости. Эти клавиши не имеют стандартного расположения на клавиатуре, поэтому клавиатуры разных производителей могут иметь разное расположение клавиш или совершенно разные наборы клавиш.

Мультимедийные клавиши часто отличаются по внешнему виду от обычных клавиш набора текста и могут быть утоплены в клавиатуре.

На клавиатурах ноутбуков эти клавиши часто объединяются с функциональными клавишами , при этом интерпретация мультимедийных клавиш является основной функцией клавиши, а интерпретация функциональных клавиш требует одновременного нажатия клавиши. В этой конфигурации должно быть установлено соответствие функциональной клавише (...). При таком объединении клавиш значения берутся из значения функциональной клавиши , поскольку значение мультимедийной клавиши не одинаково на разных клавиатурах. code Fn code " F1 " " F12 "

3.1.7. Устаревшие, нестандартные и специальные ключи

Этих клавиш нет на современных стандартных клавиатурах. Они перечислены здесь для справочных целей.

Следующие клавиши можно найти на нестандартных международных клавиатурах.

И, наконец, следующее значение следует использовать только в том случае, если соответствующий ключ не соответствует ни одному из значений, приведенных в других местах этой спецификации. Это значение подходит для использования с виртуальными клавиатурами, клавиши которых не расположены так, как на физической клавиатуре. code code

Соответствующие реализации ДОЛЖНЫ использоваться в качестве кода ключа только в том случае, если реализация не имеет возможности определить код ключа. Предоставление только этого значения НЕ ДОЛЖНО указывать на соответствующую реализацию. " Unidentified "

4. Благодарности

Особую благодарность выражаем следующим участникам рабочей группы по веб-приложениям за значительный материальный вклад в процесс разработки этой спецификации.

Гэри Качмарчик (Google), Масаюки Накано (Mozilla)