From 68e0a834bc48643d8481c3921b06aa38c1021349 Mon Sep 17 00:00:00 2001 From: Arthur Sedlukha Date: Mon, 28 Oct 2024 22:20:30 +0300 Subject: [PATCH 1/8] docs: sync --- files/ru/web/html/element/base/index.md | 48 ++++++++++++++++++++----- 1 file changed, 39 insertions(+), 9 deletions(-) diff --git a/files/ru/web/html/element/base/index.md b/files/ru/web/html/element/base/index.md index 25f82d31b01582..618d5a0ba998a0 100644 --- a/files/ru/web/html/element/base/index.md +++ b/files/ru/web/html/element/base/index.md @@ -20,22 +20,52 @@ slug: Web/HTML/Element/base К элементу **``**`можно применять` [глобальные атрибуты.](/ru/docs/Web/HTML/Global_attributes) +> [!WARNING] +> Элемент должен иметь атрибут href, target или оба. Если указан хотя бы один из этих атрибутов, должен располагаться перед другими элементами с атрибутами URL, такими как href у . + - `href` - - : Базовый адрес (URL) для указания полного пути (основной, главный адрес). Если указан данный атрибут, значит этот элемент должен находиться до других элементов с атрибутами URLs. Разрешены абсолютные (внешние) и относительные (внутренние) адреса (URLs). + - : Базовый URL, используемый в документе для относительных URL. Разрешены абсолютные и относительные URL. + [`data:`](ru/docs/Web/URI/Schemes/data) и [`javascript:`](/ru/docs/Web/URI/Schemes/javascript) URL не разрешены. - `target` - - : Значение атрибута определяет имя контекста, которое применяется для ссылок (``) и форм (`
`). Они нужны _для отображения контекста_ (пример: вкладка, окно или встроенный фрейм). Следующие ключевые слова имеют специальные значения: - - **`_self`**: загружает результат в текущем окне или вкладке. _Если атрибут не указан, является значением по умолчанию._ - - `_blank`: загружает результат в новом окне или бланке. - - **`_parent`**: загружает данные в родительском окне. Если значение **`_parent`** не указано, используется значение **`_self`**. - - **`_top`**: загружает данные в контексте верхнего уровня (то есть, отображает полученный контекст без обратного перехода, если не имеет родительского значения). Если нет родительских данных используется как **`_self`**. -> **Примечание:** `если указано несколько элементов ` , будут использованы только первые **href** и **target**; все последующие значения проигнорируются. + - : Значение атрибута определяет **ключевое слово** или **заданное автором имя** контекста просмотра по умолчанию для отображения результатов навигации из элементов {{HTMLElement("a")}}, {{HTMLElement("area")}} или {{HTMLElement("form")}}, у которых отсутствуют явные атрибуты `target`. Следующие ключевые слова имеют специальные значения: + + - `_self` (по умолчанию): загружает результат в текущем контексте просмотра. + - `_blank`: загружает результат в новом, безымянном контексте просмотра. + - `_parent`: загружает результат в родительском контексте просмотра текущего, если текущая страница находится внутри фрейма. Если родителя нет, работает так же, как `_self`. + - `_top`: загружает результат в самом верхнем контексте просмотра (контексте, который является предком текущего и не имеет родителя). Если родителя нет, работает так же, как `_self`. + +## Примечания по использованию + +### Несколько элементов \ + +Если используется несколько элементов ``, учитываются только первые значения атрибутов `href` и `target` — все остальные игнорируются. + +### Якоря на странице + +Ссылки, указывающие на фрагмент внутри документа, например, ``, разрешаются с использованием ``, что вызывает HTTP-запрос к базовому URL с добавленным фрагментом. + +Например, если задано `` и ссылка `К якорю`, то ссылка указывает на `https://example.com/#anchor`. + +### Значение target не должно содержать символ ASCII переноса строки, табуляции или < + +Если атрибут [`target`](#target) содержит символ ASCII переноса строки, табуляции или символ `<`, значение сбрасывается на `_blank`. +Это сделано для предотвращения атак с инъекцией незавершенной разметки, атаки без использования скриптов, при которой в страницу внедряется незавершенный атрибут `target`, захватывающий любой следующий текст до тех пор, пока браузер не встретит символ, закрывающий атрибут. + +### Open Graph + +Теги [Open Graph](https://ogp.me/) не учитывают `` и всегда должны содержать полные абсолютные URL. Например: + +```html + +``` ## Примеры ```html - - + + + ``` ## Спецификации From e1b3469a50602ffb1711406898fa41a26557048e Mon Sep 17 00:00:00 2001 From: Arthur Sedlukha Date: Mon, 28 Oct 2024 22:48:34 +0300 Subject: [PATCH 2/8] docs: sync --- files/ru/web/html/element/base/index.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/files/ru/web/html/element/base/index.md b/files/ru/web/html/element/base/index.md index 618d5a0ba998a0..fb0d267e9e9c00 100644 --- a/files/ru/web/html/element/base/index.md +++ b/files/ru/web/html/element/base/index.md @@ -21,11 +21,11 @@ slug: Web/HTML/Element/base К элементу **``**`можно применять` [глобальные атрибуты.](/ru/docs/Web/HTML/Global_attributes) > [!WARNING] -> Элемент должен иметь атрибут href, target или оба. Если указан хотя бы один из этих атрибутов, должен располагаться перед другими элементами с атрибутами URL, такими как href у . +> Элемент `` должен иметь атрибут `href`, `target` или оба. Если указан хотя бы один из этих атрибутов, `` должен располагаться перед другими элементами с атрибутами URL, такими как `href` у {{HTMLElement("link")}}. - `href` - : Базовый URL, используемый в документе для относительных URL. Разрешены абсолютные и относительные URL. - [`data:`](ru/docs/Web/URI/Schemes/data) и [`javascript:`](/ru/docs/Web/URI/Schemes/javascript) URL не разрешены. + [`data:`](/ru/docs/Web/URI/Schemes/data) и [`javascript:`](/ru/docs/Web/URI/Schemes/javascript) URL не разрешены. - `target` - : Значение атрибута определяет **ключевое слово** или **заданное автором имя** контекста просмотра по умолчанию для отображения результатов навигации из элементов {{HTMLElement("a")}}, {{HTMLElement("area")}} или {{HTMLElement("form")}}, у которых отсутствуют явные атрибуты `target`. Следующие ключевые слова имеют специальные значения: From d9c2aa305dfa51bd27ffe3ed6093c56b9e0d38c5 Mon Sep 17 00:00:00 2001 From: sedlukha Date: Fri, 1 Nov 2024 09:19:14 +0300 Subject: [PATCH 3/8] [ru]: docs sync --- files/ru/web/html/element/base/index.md | 54 +++++++++++++++++++------ 1 file changed, 42 insertions(+), 12 deletions(-) diff --git a/files/ru/web/html/element/base/index.md b/files/ru/web/html/element/base/index.md index fb0d267e9e9c00..bd1374f44a8709 100644 --- a/files/ru/web/html/element/base/index.md +++ b/files/ru/web/html/element/base/index.md @@ -1,27 +1,22 @@ --- title: slug: Web/HTML/Element/base +page-type: html-element +browser-compat: html.elements.base --- {{HTMLSidebar}} -**HTML-элемент** **``** определяет основной адрес (URL), используемый для всех относительных адресов (URLs) в документе. Может быть только один **``** элемент в одном документе. -Основной адрес (URL) документа можно запросить скриптом используя {{domxref('document.baseURI')}}. +HTML-элемент **``** определяет основной адрес (URL), используемый для всех относительных адресов (URLs) в документе. Может быть только один `` элемент в документе. -| [Категории контента](/ru/docs/Web/Guide/HTML/Content_categories) | Метаданные | -| ---------------------------------------------------------------- | ---------------------------------------------------------------- | -| Допустимое содержимое | Отсутствует. Это {{Glossary("empty element","пустой элемент")}}. | -| Пропуск тегов | Без закрывающего тега. | -| Допустимые родители | {{HTMLElement("head")}}, {{HTMLElement("body")}}. | -| Допустимые ARIA-роли | Нет | -| DOM-интерфейс | {{domxref("HTMLBaseElement")}} | +Используемый базовый URL документа можно получить в скриптах с помощью {{domxref('Node.baseURI')}}. Если в документе нет элементов ``, то значение `baseURI` по умолчанию равно {{domxref("location.href")}}. -## Атрибуты **``** +## Атрибуты -К элементу **``**`можно применять` [глобальные атрибуты.](/ru/docs/Web/HTML/Global_attributes) +К элементу ``можно применять [глобальные атрибуты.](/ru/docs/Web/HTML/Global_attributes) > [!WARNING] -> Элемент `` должен иметь атрибут `href`, `target` или оба. Если указан хотя бы один из этих атрибутов, `` должен располагаться перед другими элементами с атрибутами URL, такими как `href` у {{HTMLElement("link")}}. +> Элемент `` должен иметь атрибут `href`, `target` или оба. Если указан хотя бы один из этих атрибутов, `` **должен** располагаться перед другими элементами с атрибутами URL, такими как `href` у {{HTMLElement("link")}}. - `href` - : Базовый URL, используемый в документе для относительных URL. Разрешены абсолютные и относительные URL. @@ -68,6 +63,41 @@ slug: Web/HTML/Element/base ``` + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Категории контента + Метаданные
Допустимое содержимоеОтсутствует. Это {{Glossary("void element","пустой элемент")}}.
Пропуск теговДолжен иметь открывающий тег и без закрывающего тега.
Допустимые родителиТег {{HTMLElement("head")}}, который не содержит другой элемент <base>.
Неявная ARIA-рольНет
Допустимые ARIA-ролиАтрибут role не допускается
DOM-интерфейс{{domxref("HTMLBaseElement")}}
+ ## Спецификации {{Specifications}} From 75ddff340c7c159b72e3bcd14991262351ceb061 Mon Sep 17 00:00:00 2001 From: Arthur Sedlukha Date: Fri, 1 Nov 2024 10:34:40 +0300 Subject: [PATCH 4/8] [ru]: Technical summary title added --- files/ru/web/html/element/base/index.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/files/ru/web/html/element/base/index.md b/files/ru/web/html/element/base/index.md index bd1374f44a8709..2cf7c6187954cb 100644 --- a/files/ru/web/html/element/base/index.md +++ b/files/ru/web/html/element/base/index.md @@ -63,6 +63,8 @@ HTML-элемент **``** определяет основной адре ``` +## Техническая сводка + From f19c74e52ae039e71c4726b0f4dd33a123e82937 Mon Sep 17 00:00:00 2001 From: Arthur Sedlukha Date: Fri, 1 Nov 2024 12:15:02 +0300 Subject: [PATCH 5/8] Update index.md --- files/ru/web/html/element/base/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/ru/web/html/element/base/index.md b/files/ru/web/html/element/base/index.md index 2cf7c6187954cb..3ee7d15ba7c954 100644 --- a/files/ru/web/html/element/base/index.md +++ b/files/ru/web/html/element/base/index.md @@ -87,7 +87,7 @@ HTML-элемент **``** определяет основной адре - + From 4afb694d37d68018d2a8f50cb4901acd8a92f0f2 Mon Sep 17 00:00:00 2001 From: sedlukha Date: Mon, 4 Nov 2024 21:57:07 +0300 Subject: [PATCH 6/8] [ru]: - page-type browser-compat removed, sourceCommit added --- files/ru/web/html/element/base/index.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/files/ru/web/html/element/base/index.md b/files/ru/web/html/element/base/index.md index 3ee7d15ba7c954..eceae00c67f925 100644 --- a/files/ru/web/html/element/base/index.md +++ b/files/ru/web/html/element/base/index.md @@ -1,8 +1,8 @@ --- title: slug: Web/HTML/Element/base -page-type: html-element -browser-compat: html.elements.base +l10n: + sourceCommit: 1a48b6abdd27e168c78edcf04a7a9f6a8e0fdc15 --- {{HTMLSidebar}} From 292bffab137f24374230b0fa30657c586a39c6e9 Mon Sep 17 00:00:00 2001 From: sedlukha Date: Mon, 4 Nov 2024 21:59:03 +0300 Subject: [PATCH 7/8] [ru]: - typo --- files/ru/web/html/element/base/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/ru/web/html/element/base/index.md b/files/ru/web/html/element/base/index.md index eceae00c67f925..390d339e58c6d5 100644 --- a/files/ru/web/html/element/base/index.md +++ b/files/ru/web/html/element/base/index.md @@ -13,7 +13,7 @@ HTML-элемент **``** определяет основной адре ## Атрибуты -К элементу ``можно применять [глобальные атрибуты.](/ru/docs/Web/HTML/Global_attributes) +К элементу `` можно применять [глобальные атрибуты.](/ru/docs/Web/HTML/Global_attributes) > [!WARNING] > Элемент `` должен иметь атрибут `href`, `target` или оба. Если указан хотя бы один из этих атрибутов, `` **должен** располагаться перед другими элементами с атрибутами URL, такими как `href` у {{HTMLElement("link")}}. From 5a8d69e4ff8efc77fbe58855b60bd02282d3fd61 Mon Sep 17 00:00:00 2001 From: Arthur Sedlukha Date: Fri, 22 Nov 2024 22:02:12 +0300 Subject: [PATCH 8/8] Apply suggestions from code review Co-authored-by: Leonid Vinogradov --- files/ru/web/html/element/base/index.md | 40 ++++++++++++------------- 1 file changed, 20 insertions(+), 20 deletions(-) diff --git a/files/ru/web/html/element/base/index.md b/files/ru/web/html/element/base/index.md index 390d339e58c6d5..b4d134f6fb32cd 100644 --- a/files/ru/web/html/element/base/index.md +++ b/files/ru/web/html/element/base/index.md @@ -7,49 +7,49 @@ l10n: {{HTMLSidebar}} -HTML-элемент **``** определяет основной адрес (URL), используемый для всех относительных адресов (URLs) в документе. Может быть только один `` элемент в документе. +HTML-элемент **``** определяет базовый URL-адрес, используемый для создания всех _относительных_ URL-адресов в документе. В документе может быть только один элемент ``. -Используемый базовый URL документа можно получить в скриптах с помощью {{domxref('Node.baseURI')}}. Если в документе нет элементов ``, то значение `baseURI` по умолчанию равно {{domxref("location.href")}}. +Базовый URL-адрес документа можно получить с помощью {{domxref('Node.baseURI')}}. Если в документе нет элементов ``, то значение `baseURI` по умолчанию равно {{domxref("location.href")}}. ## Атрибуты -К элементу `` можно применять [глобальные атрибуты.](/ru/docs/Web/HTML/Global_attributes) +Этот элемент поддерживает [глобальные атрибуты](/ru/docs/Web/HTML/Global_attributes). > [!WARNING] -> Элемент `` должен иметь атрибут `href`, `target` или оба. Если указан хотя бы один из этих атрибутов, `` **должен** располагаться перед другими элементами с атрибутами URL, такими как `href` у {{HTMLElement("link")}}. +> Элемент `` должен иметь атрибут `href`, `target` или оба. Если указан хотя бы один из этих атрибутов, то `` **должен** располагаться перед другими элементами с атрибутами, содержащими URL-адреса в качестве значений, такими как `href` у {{HTMLElement("link")}}. - `href` - - : Базовый URL, используемый в документе для относительных URL. Разрешены абсолютные и относительные URL. - [`data:`](/ru/docs/Web/URI/Schemes/data) и [`javascript:`](/ru/docs/Web/URI/Schemes/javascript) URL не разрешены. + - : Базовый URL-адрес, используемый в документе для формирования относительных URL-адресов. Допускаются абсолютные и относительные адреса. + [`data:`](/ru/docs/Web/URI/Schemes/data) и [`javascript:`](/ru/docs/Web/URI/Schemes/javascript) URL-адреса использовать нельзя. - `target` - - : Значение атрибута определяет **ключевое слово** или **заданное автором имя** контекста просмотра по умолчанию для отображения результатов навигации из элементов {{HTMLElement("a")}}, {{HTMLElement("area")}} или {{HTMLElement("form")}}, у которых отсутствуют явные атрибуты `target`. Следующие ключевые слова имеют специальные значения: + - : **Ключевое слово** или **заданное автором имя** для определения {{Glossary("browsing context", "контекста просмотра")}}, который будет использован при отображении результатов навигации из элементов {{HTMLElement("a")}}, {{HTMLElement("area")}} или {{HTMLElement("form")}}, если у них не задан свой атрибут `target`. Следующие ключевые слова имеют специальные значения: - - `_self` (по умолчанию): загружает результат в текущем контексте просмотра. - - `_blank`: загружает результат в новом, безымянном контексте просмотра. - - `_parent`: загружает результат в родительском контексте просмотра текущего, если текущая страница находится внутри фрейма. Если родителя нет, работает так же, как `_self`. - - `_top`: загружает результат в самом верхнем контексте просмотра (контексте, который является предком текущего и не имеет родителя). Если родителя нет, работает так же, как `_self`. + - `_self` (по умолчанию): отображает результат в текущем контексте просмотра. + - `_blank`: отображает результат в новом, безымянном контексте просмотра. + - `_parent`: отображает результат в родительском контексте просмотра, если текущая страница находится внутри фрейма. Если родителя нет, работает так же, как `_self`. + - `_top`: отображает результат в самом верхнем контексте просмотра (контексте, который является предком текущего и не имеет родителя). Если родителя нет, работает так же, как `_self`. ## Примечания по использованию -### Несколько элементов \ +### Несколько элементов `` -Если используется несколько элементов ``, учитываются только первые значения атрибутов `href` и `target` — все остальные игнорируются. +Если используется несколько элементов ``, учитываются только значения первых атрибутов `href` и `target`, все остальные игнорируются. -### Якоря на странице +### Ссылки на фрагменты документов -Ссылки, указывающие на фрагмент внутри документа, например, ``, разрешаются с использованием ``, что вызывает HTTP-запрос к базовому URL с добавленным фрагментом. +Ссылки, указывающие на фрагмент внутри документа, например, ``, формируются с использованием ``, и переход по ним вызывает HTTP-запрос к базовому URL-адресу с добавленным фрагментом. -Например, если задано `` и ссылка `К якорю`, то ссылка указывает на `https://example.com/#anchor`. +Например, если задан элемент `` и ссылка `К фрагменту`, то она будет вести на `https://example.com/#anchor`. -### Значение target не должно содержать символ ASCII переноса строки, табуляции или < +### Значение target не должно содержать символы переноса строк, табуляции или < Если атрибут [`target`](#target) содержит символ ASCII переноса строки, табуляции или символ `<`, значение сбрасывается на `_blank`. -Это сделано для предотвращения атак с инъекцией незавершенной разметки, атаки без использования скриптов, при которой в страницу внедряется незавершенный атрибут `target`, захватывающий любой следующий текст до тех пор, пока браузер не встретит символ, закрывающий атрибут. +Это необходимо для предотвращения атак с инъекцией незавершённой разметки. Это вид атаки без использования скриптов, при которой в страницу внедряется незавершённый атрибут `target`, в который попадает весь последующий текст до тех пор, пока браузер не встретит символ, закрывающий атрибут. ### Open Graph -Теги [Open Graph](https://ogp.me/) не учитывают `` и всегда должны содержать полные абсолютные URL. Например: +Теги [Open Graph](https://ogp.me/) не учитывают `` и всегда должны содержать полные абсолютные URL-адреса. Например: ```html @@ -79,7 +79,7 @@ HTML-элемент **``** определяет основной адре - +
Неявная ARIA-рольНетНет соответствующей роли
Допустимые ARIA-роли
Пропуск теговДолжен иметь открывающий тег и без закрывающего тега.Должен иметь открывающий тег и не иметь закрывающего.
Допустимые родители