CKTIS / JavaScript
Търсене по ID и фокус: getElementById() и activeElement
`document.getElementById(id)` намира елемент по идентификатор, а `document.activeElement` показва къде е текущият фокус на клавиатурата от гледна точка на документа.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
document.getElementById(id) // call: Element or null
document.activeElement // read-only property: Element or nulldocument.getElementById(id) е метод, който търси стойност на id в дървото на съответния документ. Подай самия идентификатор без префикса #, използван в CSS селекторите. Главните и малките букви се различават. Методът връща Element или null, ако няма съвпадение. Идентификаторите трябва да са уникални в рамките на едно дърво; при повторения методът връща първото съвпадение по реда в дървото.
Търсенето не обхваща възли, отделени от документа, и не навлиза в дървета на Shadow DOM или в документите в елементи iframe. DocumentFragment, а следователно и ShadowRoot, има собствен метод getElementById(); обикновеният Element няма такъв. Преди да използваш резултата, провери дали е null, или използвай ?., ако е допустимо елементът да липсва.
document.activeElement е свойство само за четене, а не метод. То връща Element, който представлява текущия фокус на клавиатурата от гледна точка на документа. Ако фокусът е в дърво на Shadow DOM или във вграден документ, външният документ вижда съответно хост елемента на Shadow DOM или елемента iframe. За да провериш какво е на фокус вътре, прочети activeElement на достъпен ShadowRoot или на документа на рамката, ако е от същия произход. Ако фокусът сочи към самия документ, свойството връща неговия body или, ако той липсва, documentElement, ако съществува. Ако в проверяваното дърво няма подходящ елемент или резервна стойност, резултатът е null.
Фокусът не е маркиране на текст, а търсенето на елемент не му дава фокус. Ако target не е null, document.activeElement === target проверява дали става дума за един и същ възел. След промяна на фокуса прочети свойството отново: запазената стойност не се обновява сама. Това са API на уеб платформата, а не възможности на ECMAScript 2024; среда без браузърен DOM не е длъжна да предоставя document.
Примери
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>ID lookup and focus</title>
</head>
<body>
<script>
{
const other = document.createElement('input');
const target = document.createElement('input');
target.id = 'cktis-target';
document.body.append(other, target);
try {
const found = document.getElementById('cktis-target');
other.focus();
console.log(found === target);
console.log(found === document.activeElement);
found?.focus();
console.log(found === document.activeElement);
console.log(document.getElementById('CKTIS-target') === null);
} finally {
other.remove();
target.remove();
}
}
</script>
</body>
</html>Резултат
true false true true
Запази примера като HTML файл, отвори го в раздел на браузъра на преден план и след това провери конзолата на браузъра. Ако браузърът позволява програмно задаване на фокуса, първите три реда показват, че търсеният елемент е намерен, първоначално не е на фокус, а после получава фокуса. Последният ред потвърждава, че промяната на регистъра на буквите премахва съвпадението.
Свързани уроци
- JavaScript · Урок 18 · Напреднало · Версия: 4