Клавиша / esc

textbox

Роль текстового поля.

Время чтения: меньше 5 мин

Это незавершённая статья. Вы можете помочь её закончить! Почитайте о том, как контрибьютить в Доку.

Кратко

Скопировано

Самостоятельная роль виджета из WAI-ARIA для поля с текстом.

В HTML эта роль по умолчанию есть у <textarea> и <input> с типами text, email, tel и url.

Как пишется

Скопировано

Задайте role="textbox" любому тегу, лучше всего <div> или <span>. В большинстве случаев лучше использовать <textarea> и <input> с типами text, email, tel или url.

Если решили делать кастомный элемент, не забудьте добавить его в порядок фокуса с помощью tabindex. Ещё укажите атрибут contenteditable. Благодаря атрибуту пользователи смогут вводить данные в кастомное поле.

Элементам с ролью textbox также можно задавать все глобальные ARIA-атрибуты, атрибуты связи aria-activedescendant и aria-errormessage, а также несколько атрибутов виджетовaria-autocomplete, aria-haspopup, aria-invalid, aria-multiline, aria-placeholder, aria-readonly и aria-required.