Значение
Ключевое слово разметки, заключенное в угловые скобки, которое сообщает браузеру, какой тип элемента создать.
Как указать
Используйте имя тега, когда целевой элемент является общим типом элемента, например, каждая кнопка или каждая ссылка.
Разметка
<header>...</header>Пример запроса
Измените стиль всех тегов button, расположенных в заголовке.
Значение
Полный фрагмент HTML, обычно состоящий из открывающего тега, содержимого и закрывающего тега.
Как указать
Используйте слово "элемент", когда имеете в виду одну видимую часть страницы, например, заголовок, карточку или кнопку.
Разметка
<button>Menu</button>Пример запроса
Переместите элемент переключателя языка рядом с кнопкой меню.
Значение
Дополнительная информация, записанная внутри тега открытия, такая как href, class, id, src или aria-label.
Как указать
Атрибуты полезны, когда один и тот же тег встречается многократно, но только один из них имеет определенный класс, id или метку.
Разметка
<a href="/ko">Home</a>Пример запроса
Добавить атрибут aria-label к кнопке меню, содержащей только иконку.
Основы
Открывающий и закрывающий тег.
Opening and closing tag
<section>Content</section>
Значение
Многие элементы начинаются с открывающего тега и заканчиваются соответствующим закрывающим тегом.
Как указать
Это помогает объяснить, где начинается и заканчивается раздел в разметке.
Важно
Отсутствующий закрывающий тег может привести к тому, что браузер будет рассматривать последующий контент как часть неправильного элемента.
Разметка
<section>Content</section>Пример запроса
Проверьте, что раздел карточек содержит соответствующие открывающие и закрывающие теги.
Значение
Объявление, которое указывает браузеру отображать документ как современный HTML.
Как указать
Обычно это обрабатывается фреймворком и редко редактируется во время работы с компонентами.
Разметка
<!doctype html>Пример запроса
Не изменяйте тип документа; редактируйте только компонент страницы.
<html lang="ko">...</html>
Значение
Элемент верхнего уровня, который оборачивает весь документ HTML.
Как указать
Элемент HTML используется для глобальных настроек, таких как атрибуты языка или темы.
Разметка
<html lang="ko">...</html>Пример запроса
Установите атрибут `html lang` правильно для каждого региона.
<head><title>...</title></head>
Значение
Область документа для метаданных, заголовков, значков, SEO-тегов и скриптов, которые не являются содержимым страницы.
Как указать
Используйте этот термин, когда требуется изменить SEO-заголовок, описание, канонический URL или метаданные.
Разметка
<head><title>...</title></head>Пример запроса
Обновляйте заголовок метаданных для страницы с терминами структуры HTML.
<body>Visible page</body>
Значение
Область документа, содержащая видимое содержимое страницы.
Как указать
Большинство изменений макета, заголовков, меню и инструментов вносятся внутри основного содержимого.
Разметка
<body>Visible page</body>Пример запроса
Сохраняйте однотонный фон в светлом и темном режимах.
<title>AI Engineering Tools</title>
Значение
Название страницы, отображаемое во вкладке браузера и часто используемое поисковыми системами.
Как указать
Используйте это, когда видимый заголовок H1 подходит, но заголовок браузера или SEO необходимо изменить.
Разметка
<title>AI Engineering Tools</title>Пример запроса
Сделайте заголовок браузера более конкретным, не меняя видимый заголовок страницы.
<meta name="description" content="...">
Значение
Метки метаданных, описывающие страницу, область просмотра, кодировку или информацию для предварительного просмотра в социальных сетях.
Как указать
Мета-описания влияют на предварительные просмотры и фрагменты поиска, а не на видимый текст страницы.
Разметка
<meta name="description" content="...">Пример запроса
Обновляйте мета-описание, чтобы указать на искомые термины HTML.
Области страницы
заголовок
header
<header>...</header>
Значение
Семантическая область для вводного или верхнего навигационного контента.
Как указать
Используйте `header`, когда вы нацелены на заголовок сайта, верхнюю навигацию, кнопку темы, кнопку языка или кнопку меню.
Разметка
<header>...</header>Пример запроса
Переместите элемент переключателя языка внутрь элементов управления заголовка рядом с кнопкой меню.
Значение
Семантическая область для основных ссылок навигации.
Как указать
Используйте nav при редактировании ссылок на категории, групп меню или навигации по страницам.
Разметка
<nav>...</nav>Пример запроса
Группируйте ссылки меню внутри навигации по категориям: Converter, Math и Programming.
Значение
Основная область содержимого страницы. Страница обычно должна иметь один основной элемент.
Как указать
Используйте main для различения содержимого страницы от заголовка, подвала или меню.
Разметка
<main>...</main>Пример запроса
Оставляйте плавающее меню над основным контентом, не отодвигая его вниз.
Области страницы
раздел
section
<section>...</section>
Значение
Тематическая группа связанных элементов контента, обычно с заголовком.
Как указать
Используйте раздел, когда вы нацелены на большой блок страницы, например, заголовок, инструменты или справочный контент.
Разметка
<section>...</section>Пример запроса
Уменьшить вертикальный отступ раздела "Инструменты" на мобильных устройствах.
Области страницы
статья
article
<article>...</article>
Значение
Самодостаточный элемент контента, такой как карточка, публикация, запись ссылки или результат.
Как указать
Используйте `article`, когда каждая повторяющаяся карточка имеет свой собственный заголовок и текст.
Разметка
<article>...</article>Пример запроса
Сделайте каждую статью термина более компактной на рабочем столе.
Области страницы
в качестве дополнения
aside
<aside>...</aside>
Значение
Область для вспомогательного контента, связанного с основным контентом, часто боковая панель или примечание.
Как указать
Используйте `aside`, когда требуется панель фильтров, боковая навигация или вспомогательная заметка.
Разметка
<aside>...</aside>Пример запроса
Переместите боковую панель ниже основного содержимого на мобильных устройствах.
Области страницы
нижний колонтитул
footer
<footer>...</footer>
Значение
Нижний регион для юридических ссылок, вторичной навигации, контактной информации или закрытия контента.
Как указать
Используйте `footer`, когда вы нацелены на нижнюю часть страницы, а не на нижнюю часть раздела.
Разметка
<footer>...</footer>Пример запроса
Добавить небольшую группу ссылок на юридическую информацию в подвал.
Значение
Элемент заголовка от h1 до h6, который придает структуру содержимому страницы.
Как указать
Используйте уровень заголовка, когда вы хотите изменить иерархию, а не только визуальный размер.
Важно
Не используйте теги h1 или h2 только для изменения размера; используйте CSS для визуального размера и заголовки для структуры документа.
Разметка
<h1>Page title</h1>Пример запроса
Оставляйте заголовок страницы как h1 и используйте h2 или h3 для заголовков карточек.
Как указать
Используйте абзац при изменении описательного текста или его форматирования.
Разметка
<p>Description text.</p>Пример запроса
Сократите абзац под заголовком "hero".
<a href="/ko/tools/math-prompt">Start</a>
Значение
Элемент ссылки, который переходит на другую страницу, маршрут, файл или местоположение.
Как указать
Используйте якорь или ссылку, когда элемент перемещается в другое место, а не выполняет действие на месте.
Разметка
<a href="/ko/tools/math-prompt">Start</a>Пример запроса
Измените ссылку "Инструменты" так, чтобы она прокручивала страницу к разделу "Инструменты".
Значение
Группа связанных элементов, упорядоченных либо без порядка (ul), либо упорядоченных (ol).
Как указать
Используйте список, когда требуется добавить, удалить, изменить порядок или сгруппировать повторяющиеся текстовые элементы.
Разметка
<ul><li>Item</li></ul>Пример запроса
Группируйте элементы меню в списки категорий.
<table><tr><td>Cell</td></tr></table>
Значение
Структурированная сетка строк и ячеек для табличных данных.
Как указать
Используйте таблицу, когда содержимое представляет собой данные в формате строк и столбцов, а не просто визуальную сетку карточек.
Разметка
<table><tr><td>Cell</td></tr></table>Пример запроса
Используйте таблицу для данных таблицы истинности вместо обычных блоков `div`.
Контент
Блок кода
code / pre
<pre><code>npm run build</code></pre>
Значение
теги кода обозначают текст кода. `pre` сохраняет переносы строк и отступы для многострочного кода.
Как указать
Используйте блок кода, когда команды или примеры должны сохранять точное форматирование.
Разметка
<pre><code>npm run build</code></pre>Пример запроса
Отображать команды терминала в блоке кода.
Контент
Сильный и акцент
strong / em
<strong>Important</strong>
Значение
Семантические элементы выделения. `strong` означает важность; `em` означает акцентированное выделение.
Как указать
Используйте их для значительного выделения, а не просто для декоративного выделения полужирным или курсивом шрифтом.
Разметка
<strong>Important</strong>Пример запроса
Используйте слово "strong" для предупреждающего сообщения внутри заметки.
<img src="/hero.png" alt="Tool preview">
Значение
Элемент, отображающий файл изображения.
Как указать
Используйте `image`, когда требуется заменить, изменить размер, обрезать или добавить альтернативный текст к визуальному контенту.
Разметка
<img src="/hero.png" alt="Tool preview">Пример запроса
Добавить четкий атрибут alt к изображению-заставке.
Медиа
Альтернативный текст
alt
<img alt="Menu panel open">
Значение
Текст, описывающий изображение для программ чтения с экрана и когда изображение не может быть загружено.
Как указать
Используйте атрибут `alt`, когда требуется улучшить доступность или уточнить значение изображения.
Важно
Декоративные изображения могут использовать пустой атрибут alt, но для значимых изображений требуется полезное описание.
Разметка
<img alt="Menu panel open">Пример запроса
Добавить текст alt, который объясняет, что показывает скриншот.
Значение
Графический элемент, часто используемый для значков, диаграмм и масштабируемых фигур.
Как указать
Используйте SVG, когда визуальный элемент представляет собой простую форму или значок, который должен оставаться четким.
Разметка
<svg>...</svg>Пример запроса
Используйте SVG-иконку для кнопки меню, если нет доступной библиотеки иконок.
Формы и элементы
Кнопка
button
<button type="button">Menu</button>
Значение
Элемент управления, который выполняет действие при нажатии или касании.
Как указать
Используйте кнопку, когда элемент управления изменяет состояние UI, открывает меню, отправляет форму или выполняет действие.
Важно
Для навигации ссылка обычно лучше, чем кнопка.
Разметка
<button type="button">Menu</button>Пример запроса
Сделайте кнопку меню закрывающей выпадающее меню выбора языка перед открытием меню.
Формы и элементы
Форма.
form
<form>...</form>
Значение
Группа элементов управления, используемых для сбора и отправки пользовательского ввода.
Как указать
Используйте `form`, когда поля ввода принадлежат к одной отправке или одному рабочему процессу ввода.
Разметка
<form>...</form>Пример запроса
Группируйте поле поиска и элементы управления категориями в одной области, похожей на форму.
Формы и элементы
Метка
label
<label for="search">Search</label>
Значение
Текст, который называет элемент управления формы.
Как указать
Используйте метку, когда входным данным требуется видимое или удобное для чтения скринридером имя.
Разметка
<label for="search">Search</label>Пример запроса
Добавить метку для поля ввода поиска, не загромождая UI.
Формы и элементы
Ввод
input
<input type="search" placeholder="Search">
Значение
Поле, в котором пользователь вводит или выбирает значение.
Как указать
Используйте `input`, когда вы нацелены на поля поиска, текстовые поля, числа, флажки или другие простые элементы управления.
Разметка
<input type="search" placeholder="Search">Пример запроса
Сделайте поле поиска полноразмерным на мобильных устройствах.
Формы и элементы
Выбрать.
select
<select><option>English</option></select>
Значение
Нативный выпадающий список для выбора одного варианта из списка.
Как указать
Используйте элемент "select", когда элемент управления является нативным выпадающим списком формы, а не пользовательской панелью меню.
Разметка
<select><option>English</option></select>Пример запроса
Примените стиль к элементу выбора языка, чтобы выбранный вариант был читаемым в темном режиме.
Формы и элементы
Текстовое поле
textarea
<textarea>Long text</textarea>
Значение
Многострочный текстовый ввод.
Как указать
Используйте текстовое поле, когда пользователям необходимо вставлять или редактировать более длинный текст.
Разметка
<textarea>Long text</textarea>Пример запроса
Увеличьте высоту текстового поля для ввода длинных запросов.
<button class="icon-button">...</button>
Значение
Атрибут, используемый для группировки элементов для стилизации или поведения.
Как указать
Класс часто является наиболее практичным способом применения повторяющегося элемента UI.
Разметка
<button class="icon-button">...</button>Пример запроса
Примените один и тот же класс ко всем кнопкам переключения категорий меню.
<section id="tools">...</section>
Значение
Уникальный идентификатор одного элемента на странице.
Как указать
Используйте `id`, когда ссылка должна прокручивать определенный раздел, или метка должна быть связана с одним полем ввода.
Важно
Один и тот же идентификатор не должен использоваться повторно для нескольких элементов на одной странице.
Разметка
<section id="tools">...</section>Пример запроса
Добавьте идентификатор (id) к разделу "Инструменты", чтобы ссылка "Просмотр инструментов" могла прокручивать страницу до этого раздела.
<a href="/ko/reference/html-structure-terms">HTML</a>
Значение
URL-адрес назначения или фрагмент для ссылки.
Как указать
Используйте `href`, когда ссылка ведет на неправильную страницу или раздел.
Разметка
<a href="/ko/reference/html-structure-terms">HTML</a>Пример запроса
Измените атрибут href элемента меню "Программирование" на новую страницу со структурой HTML.
<img src="/images/example.png" alt="Example">
Значение
Путь к исходному файлу для изображений, скриптов, iframes и аналогичных медиафайлов.
Как указать
Используйте атрибут "src", когда изображение или скрипт отсутствует, недействителен или должен быть заменен.
Разметка
<img src="/images/example.png" alt="Example">Пример запроса
Заменить атрибут src изображения на новый путь к изображению-превью.
Атрибуты
Атрибут данных
data-*
<html data-theme="dark">
Значение
Пользовательские атрибуты, используемые для хранения состояния или метаданных в элементе.
Как указать
Используйте атрибуты данных, когда стиль зависит от состояния, такого как тема, открыто, закрыто или выбрано.
Разметка
<html data-theme="dark">Пример запроса
Используйте `data-theme` в элементе `html` для переключения цветов темного режима.
<div role="menu">...</div>
Значение
Атрибут доступности, который описывает, какой тип объекта UI представляет элемент.
Как указать
Используйте атрибут "role", когда пользовательскому компоненту требуется четкая семантика, например, меню, диалоговое окно, вкладка или уведомление.
Важно
Нативные семантические элементы обычно лучше, чем добавление атрибута role к обычному элементу div.
Разметка
<div role="menu">...</div>Пример запроса
Назначьте списку пользовательских языков соответствующую роль в меню.
Доступность
aria-label
aria-label
<button aria-label="Toggle menu">...</button>
Значение
Текстовая метка для вспомогательных технологий, когда видимый текст отсутствует или недостаточен.
Как указать
Используйте `aria-label` для элементов управления, состоящих только из иконок, таких как кнопки меню, поиска, закрытия или темы.
Разметка
<button aria-label="Toggle menu">...</button>Пример запроса
Добавьте атрибут aria-label, который четко определяет кнопку меню "гамбургер".
Доступность
aria-expanded
aria-expanded
<button aria-expanded="false">Menu</button>
Значение
Атрибут доступности, указывающий, открыта или закрыта ли управляемая панель.
Как указать
Используйте это для выпадающих кнопок, аккордеонов и переключателей меню.
Разметка
<button aria-expanded="false">Menu</button>Пример запроса
Обновляйте атрибут aria-expanded, когда категория меню открывается или закрывается.
Связи
Родительский и дочерний элементы
Parent and child
<nav><a>Link</a></nav>
Значение
Родительский элемент содержит дочерние элементы внутри себя.
Как указать
Используйте это, когда целевой элемент зависит от его местоположения, например, ссылки внутри навигации или кнопки внутри заголовка.
Разметка
<nav><a>Link</a></nav>Пример запроса
Применяйте стиль только к ссылкам, которые являются дочерними элементами навигационного блока.
Значение
Элементы, имеющие одного и того же родителя, являются братьями и сестрами.
Как указать
Используйте атрибут "sibling", когда расстояние или взаимодействие зависят от соседних элементов.
Разметка
<button /> <button />Пример запроса
Уменьшить расстояние между кнопками заголовка.
<section><article><h2>Title</h2></article></section>
Значение
Структура, созданная при размещении элементов внутри других элементов.
Как указать
Используйте nesting, когда необходимо точно указать, какой внутренний элемент следует изменить.
Разметка
<section><article><h2>Title</h2></article></section>Пример запроса
В каждой карточке переместите пример запроса под элементы управления свойствами.
<div class="container">...</div>
Значение
Элемент, используемый в основном для группировки, ограничения или позиционирования других элементов.
Как указать
Используйте "wrapper", когда для макета требуется окружающий элемент, а не изменения каждого дочернего элемента.
Разметка
<div class="container">...</div>Пример запроса
Добавить обертку вокруг элементов управления заголовка, чтобы выпадающее меню могло быть выровнено по правому краю.
<div class="container">Page content</div>
Значение
Обертка, которая выравнивает содержимое страницы и ограничивает его читаемой шириной.
Как указать
Используйте контейнер, когда изменяется общая ширина контента или отступы по бокам.
Разметка
<div class="container">Page content</div>Пример запроса
Сделайте основной контейнер содержимого немного уже на рабочем столе.
Значение
Обертка, используемая в React для группировки элементов без добавления дополнительного элемента DOM.
Как указать
Используйте фрагмент, когда необходимо группировать элементы, не влияя на макет или селекторы CSS.
Разметка
<>...</>Пример запроса
Используйте фрагмент вместо добавления ненужного обертывающего `div`.
Доступность
Семантический HTML.
Semantic HTML
<main><section><h1>...</h1></section></main>
Значение
HTML, использующий элементы в соответствии с их значением, а не только с их визуальным видом.
Как указать
Используйте семантический HTML при улучшении структуры, доступности, SEO или удобства обслуживания.
Разметка
<main><section><h1>...</h1></section></main>Пример запроса
Используйте семантический HTML для разделов справочной страницы вместо общих div-элементов.
Доступность
Ориентир
Landmark
<header> <nav> <main> <footer>
Значение
Важные области страницы, которые помогают пользователям вспомогательных технологий быстро ориентироваться.
Как указать
Заголовок, навигация, основная часть, боковая панель и подвал могут служить ориентирами.
Разметка
<header> <nav> <main> <footer>Пример запроса
Оставляйте один четкий основной элемент на каждой странице.
Доступность
Доступное имя
Accessible name
<button aria-label="Open menu">☰</button>
Значение
Имя, которое вспомогательная технология использует для объявления элемента управления.
Как указать
Используйте атрибут `accessible name`, когда элемент управления визуально понятен, но не имеет имени для программ чтения с экрана.
Разметка
<button aria-label="Open menu">☰</button>Пример запроса
Дайте переключателю темы понятное и доступное имя в каждой локали.
Доступность
tabindex
tabindex
<button tabindex="0">Action</button>
Значение
Атрибут, который может влиять на порядок фокуса клавиатуры.
Как указать
Используйте это осторожно, когда пользовательские элементы управления недоступны с помощью клавиатуры.
Важно
Положительные значения tabindex могут создавать запутанный порядок навигации с клавиатуры. Нативная последовательность фокуса обычно лучше.
Разметка
<button tabindex="0">Action</button>Пример запроса
Избегайте положительных значений tabindex и сохраняйте естественный порядок навигации с помощью клавиатуры.