SVGElement: метод focus()
Базовая поддержка Широко доступно
Эта функция хорошо отработана и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с января 2020 года.
Метод SVGElement.focus() устанавливает фокус на указанный SVG-элемент, если это возможно. Элемент с фокусом — это элемент, который по умолчанию получит события клавиатуры и аналогичные события.
По умолчанию браузер прокрутит элемент в область видимости после установки фокуса, и он также может отобразить визуальное указание на фокусированный элемент (обычно, путем отображения «фокусной рамки» вокруг элемента). Для отключения стандартной прокрутки и принудительного отображения визуального указания на элементах доступны параметры.
Синтаксис
focus() focus(options)
Параметры
optionsНеобязательно-
Необязательный объект для управления аспектами процесса установки фокуса. Этот объект может содержать следующие свойства:
preventScrollНеобязательно-
Булево значение, указывающее, следует ли браузеру прокручивать документ, чтобы поместить недавно фокусированный элемент в область видимости. Значение
falseдляpreventScroll(по умолчанию) означает, что браузер прокрутит элемент в область видимости после установки фокуса. ЕслиpreventScrollустановлено в значениеtrue, прокрутка не будет выполняться.
Возвращаемое значение
None (undefined).
Примеры
Фокусировка SVG-элемента
В этом примере используется кнопка для установки фокуса на элемент SVG типа circle.
HTML
<svg xmlns="http://www.w3.org/2000/svg" width="200" height="200"> <circle id="myCircle" cx="100" cy="100" r="50" tabindex="0" fill="blue" /> <button id="focusButton">Focus the circle</button> </svg>
JavaScript
document.getElementById("focusButton").addEventListener("click", () => {
const circle = document.getElementById("myCircle");
circle.focus();
});
Спецификации
| Спецификация |
|---|
| HTML # dom-focus-dev |
Примечания
- Если вы вызываете
SVGElement.focus()из обработчика события mousedown, необходимо вызватьevent.preventDefault()для предотвращения ухода фокуса сSVGElement
Совместимость с браузерами
| Рабочие столы | Мобильные устройства | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox для Android | Opera Android | Safari на iOS | Samsung Internet | WebView Android | |
focus |
1 | 17 | 51 | 15 | 3 | 18 | 51 | 14 | 1 | 1.0 | ≤37 |
options_preventScroll_parameter |
78 | ≤79 | 68 | 65 | 15 | 78 | 68 | 56 | 15.5 | 12.0 | 78 |
См. также
-
SVGElement.blurдля снятия фокуса с элемента. -
HTMLElement.focusаналогичный метод для HTML-элементов.
© 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/SVGElement/focus