Spec-Zone.ru › Web APIs

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

Spec-Zone.ru

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