Spec-Zone.ru › Web APIs

Виртуальная клавиатура

Ограниченная доступность

Эта функция не относится к Baseline, так как она не работает во многих распространённых браузерах.

  • Подробнее
  • Полная совместимость
  • Отправить отзыв

Экспериментально: Это экспериментальная технология
Перед использованием в продакшене тщательно ознакомьтесь со таблицей совместимости с браузерами.

Безопасный контекст: Эта функция доступна только в безопасных контекстах (HTTPS) в некоторых или во всех поддерживающих браузерах.

Интерфейс VirtualKeyboard API Виртуальной клавиатуры полезен на устройствах с виртуальной клавиатурой, таких как планшеты, мобильные телефоны или другие устройства, где физическая клавиатура может отсутствовать.

Интерфейс VirtualKeyboard позволяет отказаться от автоматического управления виртуальной клавиатурой браузером, уменьшив высоту области просмотра, чтобы освободить место для неё. Вы можете предотвратить изменение размера области просмотра браузером, определить положение и размер виртуальной клавиатуры — для последующей адаптации макета вашей веб-страницы — и программно отображать или скрывать виртуальную клавиатуру.

Вы получаете доступ к интерфейсу VirtualKeyboard с помощью navigator.virtualKeyboard.

EventTarget VirtualKeyboard

Свойства экземпляра

Интерфейс VirtualKeyboard наследует свойства от своего родительского интерфейса EventTarget.

VirtualKeyboard.boundingRect Только для чтения Экспериментально

Объект DOMRect, описывающий геометрию виртуальной клавиатуры.

VirtualKeyboard.overlaysContent Экспериментально

Значение Boolean, определяющее, следует ли браузеру прекратить обработку виртуальной клавиатуры.

Методы экземпляра

Интерфейс VirtualKeyboard наследует методы от своего родительского интерфейса EventTarget.

VirtualKeyboard.show() Экспериментально

Отобразить виртуальную клавиатуру.

VirtualKeyboard.hide() Экспериментально

Скрыть виртуальную клавиатуру.

События

geometrychange Экспериментально

Срабатывает при изменении геометрии виртуальной клавиатуры, что происходит при её появлении или исчезновении.

Пример

Следующий пример демонстрирует, как отказаться от автоматического поведения виртуальной клавиатуры и определить её геометрию на веб-странице:

if ("virtualKeyboard" in navigator) {
  navigator.virtualKeyboard.overlaysContent = true;

  navigator.virtualKeyboard.addEventListener("geometrychange", (event) => {
    const { x, y, width, height } = event.target.boundingRect;
  });
}

Спецификации

Спецификация
API виртуальной клавиатуры
# the-virtualkeyboard-interface

Совместимость с браузерами

Рабочие столы Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на iOS Samsung Internet WebView Android
VirtualKeyboard 94 94 Нет 80 Нет 94 Нет 66 Нет 17.0 94
boundingRect 94 94 Нет 80 Нет 94 Нет 66 Нет 17.0 94
geometrychange_event 94 94 Нет 80 Нет 94 Нет 66 Нет 17.0 94
hide 94 94 Нет 80 Нет 94 Нет 66 Нет 17.0 94
overlaysContent 94 94 Нет 80 Нет 94 Нет 66 Нет 17.0 94
show 94 94 Нет 80 Нет 94 Нет 66 Нет 17.0 94

См. также

  • API виртуальной клавиатуры
  • Полный контроль с помощью API виртуальной клавиатуры

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/VirtualKeyboard

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API