Виртуальная клавиатура
Ограниченная доступность
Эта функция не относится к Baseline, так как она не работает во многих распространённых браузерах.
Экспериментально: Это экспериментальная технология
Перед использованием в продакшене тщательно ознакомьтесь со таблицей совместимости с браузерами.
Безопасный контекст: Эта функция доступна только в безопасных контекстах (HTTPS) в некоторых или во всех поддерживающих браузерах.
Интерфейс VirtualKeyboard API Виртуальной клавиатуры полезен на устройствах с виртуальной клавиатурой, таких как планшеты, мобильные телефоны или другие устройства, где физическая клавиатура может отсутствовать.
Интерфейс VirtualKeyboard позволяет отказаться от автоматического управления виртуальной клавиатурой браузером, уменьшив высоту области просмотра, чтобы освободить место для неё. Вы можете предотвратить изменение размера области просмотра браузером, определить положение и размер виртуальной клавиатуры — для последующей адаптации макета вашей веб-страницы — и программно отображать или скрывать виртуальную клавиатуру.
Вы получаете доступ к интерфейсу VirtualKeyboard с помощью navigator.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;
});
}
Спецификации
Совместимость с браузерами
| Рабочие столы | Мобильные устройства | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| 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 |
См. также
© 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