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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.