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

CKTIS / HTML

aria-controls — указване на управлявани елементи

`aria-controls` свързва контрола с елементи, чието съдържание или видимост тя управлява.

Версия: WAI-ARIA 1.2

Синтаксис

<button aria-controls="results count">Add result</button>

Стойността е списък от идентификатори на елементи, разделени с интервали. Всеки трябва да сочи към правилния уникален елемент в документа. Няколко цели са допустими, когато една контрола действително ги управлява.

Това е връзка за помощните технологии: не премества елементи, не задава принадлежност и не добавя обработчици на събития. Не променя автоматично фокуса или видимостта. Предвидената функция трябва да работи с обикновена клавиатура.

Бутонът в примера управлява списъка с резултати и броя им. Обработчикът добавя CSS и обновява броя. Тестът проверява двата променени елемента и двете разрешени връзки в дървото за достъпност; не предполага специална клавишна комбинация във всеки четец.

Примери

<!doctype html><meta charset="utf-8">
<button id="add" aria-controls="results count">Add result</button>
<ul id="results"><li>HTML</li></ul><p id="count">1 result</p>
<output id="result"></output>
<script>
document.querySelector('#add').addEventListener('click', () => {
  const item = document.createElement('li'); item.textContent = 'CSS';
  document.querySelector('#results').append(item);
  document.querySelector('#count').textContent = document.querySelector('#results').children.length + ' results';
});
document.querySelector('#add').click();
document.querySelector('#result').textContent = 'items=' + document.querySelector('#results').children.length + '; count=' + document.querySelector('#count').textContent;
</script>

Резултат

items=2; count=2 results

Проверени са реалните промени на списъка и броя заедно с правилно разрешените управляващи връзки.

Източници