recursal/MDN huggingface dataset:
accesskey
=========

Глобальный атрибут **accesskey** даёт возможность быстро перейти к элементу с помощью комбинации клавиш. Значение атрибута состоит из одного печатного символа (в том числе спец. символы, акценты и другие, которые можно написать с клавиатуры).

Интерактивный пример
--------------------

**Примечание:** Спецификация WHATWG допускает использования нескольких символов разделённых пробелом. Однако, на момент написания, эта функциональность не поддерживается в современных браузерах. IE и Edge в таком случае будет использовать первый символ, игнорируя остальные.

Активация элементов с помощью Accesskey зависит от браузера и платформы:

|  | Windows | Linux | macOS |
| --- | --- | --- | --- |
| Firefox | `Alt`+ `Shift`+`*key*` | 
 В Firefox 57 и новее: `Control` + `Option` +
 `*key*` -OR- `Control` + `Alt` +
 `*key*`В Firefox 14 и новее: `Control`+ `Alt`+
 `*key*`В Firefox 13 и старше, `Control`+`*key*` |
| Internet Explorer | `Alt` + `*key*` | N / A |
| Google Chrome | `Alt` + `*key*` | `Control`+ `Alt`+`*key*` |
| Safari | `Alt` + `*key*` | N / A | `Control`+ `Alt`+`*key*` |
| Opera 15+ | `Alt` + `*key*` | `Control`+ `Alt`+`*key*` |
| Opera 12 | `Shift`+ `Esc` показывает список элементов, доступных
 для быстрого перехода. Перейти на нужный элемент можно нажав
 соответствующий символ (`*key*`)
  |
|

Обратите внимание, что в Firefox пользователь может настроить свой модификатор активации.

Проблемы с доступностью
-----------------------

В добавок к слабой поддержке браузерами всех возможностей в спецификации, у атрибута `accesskey` есть проблемы с доступностью:

* Значение атрибута `accesskey` может конфликтовать с комбинациями клавиш системы, браузера или вспомогательными инструментами доступности.
* Определённые значения атрибута `accesskey` могут отсутствовать на некоторых клавиатурах. Это особенно сильно проявляется, если вы используете язык отличный от английского.
* Числовые значения атрибута могут `accesskey` затруднить работу с сайтом для людей с расстройствами мышления. Например, когда числовые значения не имеют логической связи со связанным элементом.
* Не существует стандартизированного способа информировать пользователя о наличии атрибута `accesskey` на элементе. Неинформированный пользователь может случайно активировать элемент с атрибутом `accesskey`.

Ввиду этих причин рекомендуется не использовать атрибут `accesskey` для обычных сайтов и веб-приложений.

* WebAIM: Keyboard Accessibility - Accesskey
Спецификации
------------

| Specification |
| --- |
| HTML Standard # the-accesskey-attribute |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* `Element.accessKey`
* `HTMLElement.accessKeyLabel` (en-US)
* Все глобальные атрибуты .
inputmode
=========

Глобальный атрибут **`inputmode`** является вычисленным атрибутом, который предоставляет подсказку для типа данных, которые может ввести пользователь при редактировании содержания элемента. Атрибут может принимать следующие значения:

`none`

Без виртуальной клавиатуры; это полезно когда приложение или сайт имплементируют свои собственные клавиатуру или поле ввода.

`text`

Стандартная раскладка клавиатуры для пользователя, учитывая его локализацию.

`decimal`

Дробные значения чисел, содержащие разряд и соответствующий символ-разделитель, который учитывает локализацию пользователя (чаще всего "." или ","). Устройства могут показывать или нет символ минуса (отрицательное значение).

`numeric`

Числовая раскладка клавиатуры; числа от 0 до 9. Устройства могут показывать или нет символ минуса (отрицательное значение).

`tel`

Раскладка для ввода номера телефона, включая числа от 0 до 9, звёздочку ("\*"), и решётку ("#"). Поля ввода форм, что имеют обязательное поле номера телефона должны использовать `<input type="tel">`.

`search`

Виртуальная клавиатура, оптимизированная для работы с поиском. Например, кнопка ввода может быть заменена на "Поиск", и др.

`email`

Виртуальная клавиатура, оптимизированная для ввода электронной почты, с использованием символа "@" и др. Поля ввода форм, что имеют обязательное поле электронной почты должны использовать `<input type="email">` (en-US).

`url`

Виртуальная клавиатура, оптимизированная для ввода ссылок. Может иметь кнопку "/", расположенную в более удобном месте. Поле может содержать функцию истории ввода и др. Поля ввода форм, что имеют обязательное поле ссылки URL должны использовать `<input type="url">` (en-US).

Атрибутом по умолчанию является `text`, которое учитывает локализацию пользователя.

Спецификация
------------

| Specification |
| --- |
| HTML Standard # attr-inputmode |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* Все глобальные атрибуты.
<figcaption>: Элемент подписи иллюстрации
=========================================

**HTML-элемент `<figcaption>` или элемент подписи иллюстрации** представляет собой подпись (заголовок) или легенду, описывающую остальную часть содержимого родительского элемента `<figure>`.

Интерактивный пример
--------------------

| Категории контента | Нет |
| --- | --- |
| Допустимое содержимое | Потоковый контент |
| Пропуск тегов | Нет, открывающий и закрывающий теги обязательны. |
| Допустимые родители | Элемент `<figure>`; элемент `<figcaption>` должен быть первым или последним потомком. |
| Допустимые ARIA-роли | `group (en-US)`, `presentation (en-US)` |
| DOM-интерфейс | `HTMLElement` |

Атрибуты
--------

Этот элемент принимает только глобальные атрибуты.

Примеры
-------

Для примеров `<figcaption>` смотрите `<figure>`.

Спецификации
------------

| Specification |
| --- |
| HTML Standard # the-figcaption-element |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* Элемент `<figure>`
<section> - элемент секции
==========================

**HTML-элемент `<section>`** представляет собой автономный раздел — который не может быть представлен более точным по семантике элементом — внутри HTML-документа. Как правило, но не всегда, разделы имеют заголовок.

Интерактивный пример
--------------------

Например, меню навигации должно быть помещено в элемент `<nav>`, но список результатов поиска и отображение карты с её элементами управления не имеют специфических элементов и могут быть помещены в `<section>`.

**Примечание:** Если содержимое элемента имеет смысл объединить как единое целое (в цельный и независимый блок), то элемент `<article>` может стать лучшим выбором.


| Категории контента | Основной поток, секционный контент, явный контент. |
| --- | --- |
| Допустимое содержимое | Основной поток |
| Пропуск тега | Ни одного; Оба тега, открывающий и закрывающий, являются обязательными. |
| Допустимые родители | Любой элемент, который разрешает контент основного потока в качестве содержимого. Обратите внимание, что элемент `<section>` не должен быть потомком элемента `<address>`. |
| Допустимые ARIA-роли | `alert (en-US)`, `alertdialog (en-US)`, `application (en-US)`, `banner (en-US)`, `complementary (en-US)`, `contentinfo (en-US)`, `dialog (en-US)`, `document (en-US)`, `feed (en-US)`, `log (en-US)`, `main (en-US)`, `marquee (en-US)`, `navigation (en-US)`, `search (en-US)`, `status (en-US)`, `tabpanel (en-US)` |
| DOM-интерфейс | `HTMLElement` |

Атрибуты
--------

К этому элементу применимы только глобальные атрибуты.

Примечание
----------

* Каждый элемент `<section>` должен быть идентифицирован, обычно путём добавления заголовка (элементы `<h1>` (en-US)-`<h6>` (en-US)) в качестве дочернего элемента.
* Если имеет смысл по-особому объединить содержимое элемента `<section>` (например, сделать цельным и независимым разделом HTML-документа), используйте вместо него элемент `<article>`.
* Не используйте элемент `<section>` как общий контейнер; для этого есть `<div>`, особенно когда секционирование применяется только для стилизации. На практике раздел должен логически выделяться в структуре документа.
Пример 1
--------

### До


```html
<div>
  <h1>Заголовок</h1>
  <p>Много замечательного контента</p>
</div>
```

### После


```html
<section>
  <h1>Заголовок</h1>
  <p>Много замечательного контента</p>
</section>
```

Пример 2
--------

### До


```html
<div>
  <h2>Заголовок</h2>
  <img src="bird.jpg" alt="птица" />
</div>
```

### После


```html
<section>
  <h2>Заголовок</h2>
  <img src="bird.jpg" alt="птица" />
</section>
```

Спецификации
------------

| Specification |
| --- |
| HTML Standard # the-section-element |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* Связанные с этим разделом элементы: `<body>`, `<nav>`, `<article>`, `<aside>`, `<h1>` (en-US), `<h2>` (en-US), `<h3>` (en-US), `<h4>` (en-US), `<h5>` (en-US), `<h6>` (en-US), `<hgroup>`, `<header>`, `<footer>`, `<address>`;
* Разделы и структура документа HTML5.
* ARIA: роль region (en-US)
<data>
======

**HTML-элемент `<data>`** связывает данное содержимое с машиночитаемым представлением. Если содержимое относится к времени или дате, необходимо использовать элемент `<time>`.

Интерактивный пример
--------------------

| Категории контента | Потоковый контент, фразовый контент, явный контент. |
| --- | --- |
| Разрешённое содержимое | Фразовый контент. |
| Пропуск тегов | Нет, открывающий и закрывающий теги обязательны. |
| Разрешённые родители | Любой элемент который принимает фразовый контент. |
| DOM-интерфейс | `HTMLDataElement` |

Атрибуты
--------

Этот элемент включает глобальные атрибуты.

`value`

Этот атрибут определяет машиночитаемый перевод содержимого элемента.

Пример
------

Следующий пример отображает названия продуктов, а также связывает каждое имя с номером продукта.


```html
<p>New Products</p>
<ul>
  <li><data value="398">Mini Ketchup</data></li>
  <li><data value="399">Jumbo Ketchup</data></li>
  <li><data value="400">Mega Jumbo Ketchup</data></li>
</ul>
```

Спецификации
------------

| Specification |
| --- |
| HTML Standard # the-data-element |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* HTML-элемент `<time>`.
<head>: элемент метаданных документа
====================================

**HTML-элемент `<head>`** содержит машиночитаемую информацию (metadata) о документе, например его заголовок, скрипты и страницы стилей.

**Примечание:** `<head>` в основном содержит информацию для машинной обработки, а не для восприятия человеком. Информацию, видимую человеком, такую как заголовки верхнего уровня и перечисленные авторы, смотрите в элементе `<header>`.


| Категории контента | Отсутствуют. |
| --- | --- |
| Допустимое содержимое | Если документ является документом `<iframe>` (en-US) с атрибутом `srcdoc` (en-US), или если информация о заголовке доступна из протокола более высокого уровня (например, строки темы в электронном письме HTML), то ноль или более элементов содержащих метаданные.Иначе, один или более элементов содержащих метаданные, один из которых является элементом `<title>`. |
| Пропуск тегов | Открывающий тег может быть пропущен, если первым, что находится внутри элемента `<head>` является другой элемент. Закрывающий тег может быть пропущен, если первое, что следует за элементом `<head>` не является пробелом или комментарием. |
| Допустимые родители | Элемент `<html>` (`<head>` является его первым дочерним элементом). |
| Допустимые ARIA-роли | нет |
| DOM-интерфейс | `HTMLHeadElement` |

Атрибуты
--------

К этому элементу применимы глобальные атрибуты.

`profile`

URI (en-US) одного или более профилей метаданных, разделённых пробелами.

Пример
------


```html
<!doctype html>
<html>
  <head>
    <title>Заголовок страницы</title>
  </head>
</html>
```

Примечание
----------

HTML5-совместимые браузеры автоматически создают элемент `<head>`, если его теги пропущены в разметке. Такое поведение не гарантируется в старых браузерах.

Спецификации
------------

| Specification |
| --- |
| HTML Standard # the-head-element |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* Элементы, которые могут использоваться внутри `<head>`:
    + `<title>`
    + `<base>`
    + `<link>`
    + `<style>`
    + `<meta>`
    + `<script>`
    + `<noscript>`
    + `<template>`
<ruby>
======

`HTML-элемент<ruby>` предназначен для добавления небольшой аннотации сверху или снизу от заданного текста. Такая форма записи преимущественно используется для идеографической письменности вроде китайского языка, но может применяться и для других языков, если требуется написать один текст над другим.

| Категории контента | Основной поток(Flow content), текстовой контент(phrasing content), явный контент(palpable content). |
| --- | --- |
| Допустимое содержимое | Текстовый контент(phrasing content). |
| Пропуск тегов | Нет, открывающий и закрывающий теги обязательны. |
| Допустимые родители | Любой элемент который согласован с текстовым контентом(phrasing content) (en-US). |
| Допустимые ARIA-роли | Любые |
| DOM-интерфейс | `HTMLElement` |

Атрибуты
--------

Этот элемент включает в себя только глобальные атрибуты.

Примеры
-------

### Пример 1: Символы


```html
<ruby>
  漢 <rp>(</rp><rt>Kan</rt><rp>)</rp> 字 <rp>(</rp><rt>ji</rt><rp>)</rp>
</ruby>
```

### Пример 2: Слово


```html
<ruby> 明日 <rp>(</rp><rt>Ashita</rt><rp>)</rp> </ruby>
```

Спецификации
------------

| Specification |
| --- |
| HTML Standard # the-ruby-element |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* `<rt>` (en-US)
* `<rp>` (en-US)
* `<rb>` (en-US)
* `<rtc>` (en-US)
<address> - элемент для контактных адресов
==========================================

**HTML- тег `<address>`** задаёт контактные данные для ближайшего родительского `<article>` или `<body>` ; В последнем случае применяется ко всему документу, визуально выделяется курсивом.

**Примечание:**

* Для представления адреса, который не является контактной информацией, воспользуйтесь `<p>` элементом.
* Данный тег не должен содержать любой другой информации, кроме контактной. (пример: дата публикации - относится к `<time>` тегу ).
* Обычно тег <address> размещается внутри тега `<footer>` текущего блока, если есть хотя бы один.


| Категории контента (en-US) | Основной поток, palpable content. |
| --- | --- |
| Разрешённый контент | Основной поток, но без вложенного элемента <address>, без элементов заголовка (`<hgroup>`, `<h1>` (en-US), `<h2>` (en-US), `<h3>` (en-US), `<h4>` (en-US), `<h5>` (en-US), `<h6>` (en-US)), без секционного контента (`<article>`, `<aside>`, `<section>`, `<nav>`) и без `<header>` или `<footer>` элементов. |
| Опускание тегов | Нет, открывающий и закрывающий теги обязательны. |
| Разрешённые родительские элементы | Любой элемент, который принимает flow content (en-US). |
| DOM интерфейс | `HTMLElement` Prior to Gecko 2.0 (Firefox 4), Gecko implemented this element using the `HTMLSpanElement` (en-US) interface |

Атрибуты
--------

Этот элемент включает в себя глобальные атрибуты.

Пример
------


```html
<address>
  You can contact author at
  <a href="http://www.somedomain.com/contact">www.somedomain.com</a>.<br />
  If you see any bugs, please
  <a href="mailto:webmaster@somedomain.com">contact webmaster</a>.<br />
  You may also want to visit us:<br />
  Mozilla Foundation<br />
  1981 Landings Drive<br />
  Building K<br />
  Mountain View, CA 94043-0801<br />
  USA
</address>
```


Помимо элемента `<address>`, с такими же стандартными стилями как и он текст отображают `<i>` (en-US) или `<em>` элементы, более правильно использовать его, когда имеете дело с контактной информацией, так как он передаёт дополнительную семантическую информацию.

Спецификации
------------

| Specification |
| --- |
| HTML Standard # the-address-element |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* Другие элементы: `<body>`, `<nav>`, `<article>`, `<aside>`, `<h1>` (en-US), `<h2>` (en-US), `<h3>` (en-US), `<h4>` (en-US), `<h5>` (en-US), `<h6>` (en-US), `<hgroup>`, `<footer>`, `<section>`, `<header>`;
* Разделы и структура документа HTML5.
<base>
======

**HTML-элемент** **`<base>`** определяет основной адрес (URL), используемый для всех относительных адресов (URLs) в документе. Может быть только один **`<base>`** элемент в одном документе.
 Основной адрес (URL) документа можно запросить скриптом используя `document.baseURI` (en-US).


| Категории контента | Метаданные |
| --- | --- |
| Допустимое содержимое | Отсутствует. Это пустой элемент. |
| Пропуск тегов | Без закрывающего тега. |
| Допустимые родители | `<head>`, `<body>`. |
| Допустимые ARIA-роли | Нет |
| DOM-интерфейс | `HTMLBaseElement` |

Атрибуты **`<base>`**
---------------------

К элементу **`<base>`**`можно применять` глобальные атрибуты.

`href`

Базовый адрес (URL) для указания полного пути (основной, главный адрес). Если указан данный атрибут, значит этот элемент должен находиться до других элементов с атрибутами URLs. Разрешены абсолютные (внешние) и относительные (внутренние) адреса (URLs).

`target`

Значение атрибута определяет имя контекста, которое применяется для ссылок (`<a>`) и форм (`<form>`). Они нужны *для отображения контекста* (пример: вкладка, окно или встроенный фрейм). Следующие ключевые слова имеют специальные значения:

* **`_self`**: загружает результат в текущем окне или вкладке. *Если атрибут не указан, является значением по умолчанию.*
* `_blank`: загружает результат в новом окне или бланке.
* **`_parent`**: загружает данные в родительском окне. Если значение **`_parent`** не указано, используется значение **`_self`**.
* **`_top`**: загружает данные в контексте верхнего уровня (то есть, отображает полученный контекст без обратного перехода, если не имеет родительского значения). Если нет родительских данных используется как **`_self`**.


**Примечание:** `если указано несколько элементов <base>` , будут использованы только первые **href** и **target**; все последующие значения проигнорируются.

Примеры
-------


```html
<base href="http://www.example.com/page.html" />
<base target="\_blank" href="http://www.example.com/page.html" />
```

Спецификация
------------

| Specification |
| --- |
| HTML Standard # the-base-element |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.
<cite>
======

Описание
--------

**HTML-элемент <cite>** (*от англ. Citation*) представляет из себя ссылку на источник цитаты. Он должен включать в себя название произведения или URL, который может быть в сокращённом виде в соответствии с правилами, используемых для добавления метаданных цитирования.

**Примечание:**

* Творческая работа может включать в себя книгу, статью, очерк, стихотворение, суждение, песню, сценарий, фильм, ТВ-шоу, игру, скульптуру, живопись, театральную постановку, пьесу, оперу, мюзикл, выставку, юридический отчёт, компьютерную программу, веб-сайт, веб-страницу, сообщение или комментарий в блоге или на форуме, tweet, письменное или устное заявление и так далее.
* Спецификация W3C утверждает, что ссылка на творческую работу может содержать имя автора, в то время, как WHATWG заявляет, что она не может включать имя человека ни в коем случае.
* Используйте атрибут `cite` элемента `<blockquote>` или элемента `<q>` (en-US) для ссылки на интернет-ресурс источника.


| Content categories (en-US) | Flow content (en-US), phrasing content (en-US), palpable content. |
| --- | --- |
| Permitted content | Phrasing content (en-US). |
| Tag omission | Нет, открывающий и закрывающий теги обязательны. |
| Permitted parent elements | Any element that accepts phrasing content (en-US). |
| DOM interface | `HTMLElement` Up to Gecko 1.9.2 (Firefox 4) inclusive, Firefox implements the `HTMLSpanElement` (en-US) interface for this element. |

Атрибуты
--------

Для данного элемента доступны только глобальные атрибуты (en-US).

Пример
------


```html
More information can be found in <cite>[ISO-0000]</cite>
```

Примечание
----------

To avoid the default italic style from being used for the <cite> element use the CSS `font-style` property.

Спецификации
------------

| Specification |
| --- |
| HTML Standard # the-cite-element |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* Элемент `<blockquote>` для длинных цитат.
* Элемент `<q>` (en-US) для встраиваемых цитат.
<optgroup>
==========

**HTML-элемент `<optgroup>`** позволяет группировать опции, находящиеся внутри элемента `<select>`.

| Категории контента (en-US) | Нет |
| --- | --- |
| Допустимый контент | Ноль или более `<option>` элементов. |
| Пропуск тегов | Открывающий тег обязателен. Закрывающий тег может быть опущен, если сразу после элемента находится следующий элемент `<optgroup>`, или если это последний элемент внутри родителя. |
| Допустимые родители | Элемент `<select>` |
| Допустимые ARIA-роли | Нет |
| DOM-интерфейс | `HTMLOptGroupElement` (en-US) |

**Примечание:** Элементы optgroup не могут быть вложенными друг в друга.

Атрибуты
--------

Элемент `<optgroup>` допускает использование глобальных атрибутов.

`disabled`

Если установить этот атрибут, опции, находящиеся внутри элемента станут недоступными для выбора. Часто браузеры отображают эти опции серым цветом и игнорируют срабатывающие на них события, такие как события мыши или события получения фокуса.

`label`

Имя группы, которое будет отображено браузером в выпадающем списке. Этот атрибут обязателен.

Пример
------


```html
<select>
  <optgroup label="Группа 1">
    <option>Опция 1.1</option>
  </optgroup>
  <optgroup label="Группа 2">
    <option>Опция 2.1</option>
    <option>Опция 2.2</option>
  </optgroup>
  <optgroup label="Группа 3" disabled>
    <option>Опция 3.1</option>
    <option>Опция 3.2</option>
    <option>Опция 3.3</option>
  </optgroup>
</select>
```

### Результат

Спецификации
------------

| Specification |
| --- |
| HTML Standard # the-optgroup-element |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* Элементы, имеющие отношение к формам: `<form>`, `<legend>`, `<label>`, `<button>`, `<select>`, `<datalist>`, `<option>`, `<fieldset>`, `<textarea>` (en-US), `<input>`, `<output>`, `<progress>` и `<meter>`.