База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

HTMLElement.focus — програмно задаване на фокус

Методът focus() премества фокуса към елемент, който може да го получи. Научи по какво фокусът се различава от щракването, как работят опциите за превъртане и индикация на фокуса и как да провериш резултата.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

element.focus();
element.focus({ preventScroll: true });
element.focus({ preventScroll: true, focusVisible: true });

HTMLElement.focus задава фокус на елемент, ако той може да го получи; не извършва щракване. Връща undefined, а не индикатор за успех. В обикновен документ провери резултата с document.activeElement === element.

Елементът трябва да може да получи фокус. tabindex="-1" позволява програмно фокусиране на обикновен елемент, без той да се добавя към последователната навигация с Tab. focus() не заобикаля ограниченията за деактивирани елементи, елементи, направени неактивни чрез inert, или елементи, които не се визуализират заради display: none.

По подразбиране методът превърта страницата, така че елементът да стане видим; preventScroll: true предотвратява това превъртане. Обикновено браузърът решава дали да покаже индикатор за фокус. focusVisible: true изисква показването му. Не премахвай видимия индикатор, без да осигуриш алтернатива.

Това е API от стандарта HTML, а не от ECMAScript. Основният focus() се поддържа от съвременните браузърни машини; провери отделно поддръжката на опциите в целевите браузъри. Node 24 не доказва поддръжка на браузърното API. Примерът умишлено извиква метода след действие на потребителя.

Примери

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Focus example</title>
<button id="move" type="button">Focus target</button>
<p id="target" tabindex="-1">Target</p>
<pre id="result"></pre>
<script>
  const move = document.getElementById('move');
  const target = document.getElementById('target');
  const result = document.getElementById('result');

  move.addEventListener('click', () => {
    target.focus({ preventScroll: true });
    result.textContent = String(document.activeElement === target);
  });
</script>
</html>

Резултат

true

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници