Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

fix: accessibility docs #3453

Open
wants to merge 2 commits into
base: next
Choose a base branch
from
Open

fix: accessibility docs #3453

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
f06eeb6
fix: accessibility docs
eugene-lazarev Jun 25, 2024
2ebfb2a
fix: accessibility docs
eugene-lazarev Jun 25, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions accessibility.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -52,8 +52,8 @@

4. Если компонент ведёт на другую страницу, используйте элемент `<a>` независимо от его внешнего вида. Если интерактивный компонент оставляет пользователя на странице, используйте элемент `<button>`.

5. Для разметки областей страницы используйте теги `<header>`, `<main>`, `<article>`, `<nav>`, `<section>`, `<footer>`.
В отличии от тега `<h1>` элемент `<header>` можно использовать несколько раз на странице, например, для заголовка модального окна. Так же, несколько раз можно использовать `<footer>`, `<article>`, `<section>`, `<main>`.
5. Для разметки областей страницы используйте теги `<main>`, `<header>`, `<footer>`, `<nav>`, `<aside>`, `<section>`, `<article>`.
Как и ранее рассмотренный тег `<h1>`, тег `<main>` можно использовать только один раз на странице, остальные — несколько раз (например, `<header>` можно использовать для заголовков разных модальных окон).
Copy link
Member

@sashachabin sashachabin Jun 26, 2024 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Предлагаю убрать «как и ранее рассмотренный» — само упоминание неплохое, но лучше не создавать лишнюю связность в тексте

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Предлагаю для точности добавить ссылку на whatwg:

Подобно тегу `<h1>`, тег `<main>` можно использовать на странице только один раз ([кроме исключений](https://html.spec.whatwg.org/multipage/grouping-content.html#the-main-element:~:text=A%20document%20must%20not%20have%20more%20than%20one))


6. Не забывайте использовать редкие теги: `<abbr>` для аббревиатур, `<blockquote>` для цитат, группу тегов `<dl>`, `<dd>`, `<dt>` для определений.

Expand Down Expand Up @@ -84,7 +84,7 @@
}
```

9. Если вы не используете необходимый тэг, но хотите придать элементу семантичное значение, не используйте атрибут `role`. Скринридер прочитает элемент как кнопку, но вам придётся добавлять управление фокусом, обработку нажатий клавиш с клавиатуры. Используйте необходимый тэг вместо этого:
9. Если вы не используете необходимый тег, но хотите придать элементу семантичное значение, не используйте атрибут `role`. Скринридер прочитает элемент как кнопку, но вам придётся добавлять управление фокусом, обработку нажатий клавиш с клавиатуры. Используйте необходимый тег вместо этого:

```html
/** Плохо */
Expand Down