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

CKTIS / JavaScript

HTMLElement.tabIndex — фокус и ред на навигация

Свойството tabIndex отразява атрибута tabindex и влияе върху възможността за получаване на фокус и реда на навигация с клавиатура.

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

Синтаксис

element.tabIndex;
element.tabIndex = integer;

HTMLElement.tabIndex прочита цяло число; присвояването записва стойност в атрибута tabindex. Ако няма валидна стойност, стойността при прочитане по подразбиране зависи от елемента: 0 за button, но -1 за div.

Стойността 0 указва, че елементът трябва да участва в обичайния ред на навигация с клавиша Tab, но не гарантира, че той е достъпен с този клавиш. Отрицателна стойност обикновено го изключва от този ред, но не пречи на focus() да му даде фокус, ако елементът отговаря на останалите условия за това. Нито една от тези две стойности не позволява да се фокусира инертен елемент, елемент, който не се визуализира, или деактивирана контрола на формуляр. Потребителските предпочитания също могат да влияят на навигацията с Tab. Положителните стойности задават приоритет в рамките на обхват за навигация; предпочитайте 0 и -1.

Прочетената стойност сама по себе си не доказва, че елементът може да получи фокус. Присвояването на -1 не премахва атрибута; използвайте removeAttribute('tabindex').

Примери

const element = document.createElement('div');
const report = () => console.log(JSON.stringify([
  element.tabIndex,
  element.getAttribute('tabindex')
]));

report();
element.tabIndex = 0;
report();
element.tabIndex = -1;
report();
element.removeAttribute('tabindex');
report();

Резултат

[-1,null]
[0,"0"]
[-1,"-1"]
[-1,null]

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

Източници