From 81f02cfa86d108fc094d6fd6ad68aa2bfe8780be Mon Sep 17 00:00:00 2001 From: Arthur Sedlukha Date: Sat, 23 Nov 2024 04:50:49 +0900 Subject: [PATCH] [ru]: update Web/HTML/Element/base translation (#24271) * [ru]: docs sync * [ru]: Technical summary title added * [ru]: - page-type browser-compat removed, sourceCommit added * [ru]: - typo * Apply suggestions from code review Co-authored-by: Leonid Vinogradov --------- Co-authored-by: Leonid Vinogradov --- files/ru/web/html/element/base/index.md | 102 +++++++++++++++++++----- 1 file changed, 82 insertions(+), 20 deletions(-) diff --git a/files/ru/web/html/element/base/index.md b/files/ru/web/html/element/base/index.md index 25f82d31b01582..b4d134f6fb32cd 100644 --- a/files/ru/web/html/element/base/index.md +++ b/files/ru/web/html/element/base/index.md @@ -1,43 +1,105 @@ --- title: slug: Web/HTML/Element/base +l10n: + sourceCommit: 1a48b6abdd27e168c78edcf04a7a9f6a8e0fdc15 --- {{HTMLSidebar}} -**HTML-элемент** **``** определяет основной адрес (URL), используемый для всех относительных адресов (URLs) в документе. Может быть только один **``** элемент в одном документе. -Основной адрес (URL) документа можно запросить скриптом используя {{domxref('document.baseURI')}}. +HTML-элемент **``** определяет базовый URL-адрес, используемый для создания всех _относительных_ URL-адресов в документе. В документе может быть только один элемент ``. -| [Категории контента](/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` - - : Базовый адрес (URL) для указания полного пути (основной, главный адрес). Если указан данный атрибут, значит этот элемент должен находиться до других элементов с атрибутами URLs. Разрешены абсолютные (внешние) и относительные (внутренние) адреса (URLs). + - : Базовый 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**; все последующие значения проигнорируются. + - : **Ключевое слово** или **заданное автором имя** для определения {{Glossary("browsing context", "контекста просмотра")}}, который будет использован при отображении результатов навигации из элементов {{HTMLElement("a")}}, {{HTMLElement("area")}} или {{HTMLElement("form")}}, если у них не задан свой атрибут `target`. Следующие ключевые слова имеют специальные значения: + + - `_self` (по умолчанию): отображает результат в текущем контексте просмотра. + - `_blank`: отображает результат в новом, безымянном контексте просмотра. + - `_parent`: отображает результат в родительском контексте просмотра, если текущая страница находится внутри фрейма. Если родителя нет, работает так же, как `_self`. + - `_top`: отображает результат в самом верхнем контексте просмотра (контексте, который является предком текущего и не имеет родителя). Если родителя нет, работает так же, как `_self`. + +## Примечания по использованию + +### Несколько элементов `` + +Если используется несколько элементов ``, учитываются только значения первых атрибутов `href` и `target`, все остальные игнорируются. + +### Ссылки на фрагменты документов + +Ссылки, указывающие на фрагмент внутри документа, например, ``, формируются с использованием ``, и переход по ним вызывает HTTP-запрос к базовому URL-адресу с добавленным фрагментом. + +Например, если задан элемент `` и ссылка `К фрагменту`, то она будет вести на `https://example.com/#anchor`. + +### Значение target не должно содержать символы переноса строк, табуляции или < + +Если атрибут [`target`](#target) содержит символ ASCII переноса строки, табуляции или символ `<`, значение сбрасывается на `_blank`. +Это необходимо для предотвращения атак с инъекцией незавершённой разметки. Это вид атаки без использования скриптов, при которой в страницу внедряется незавершённый атрибут `target`, в который попадает весь последующий текст до тех пор, пока браузер не встретит символ, закрывающий атрибут. + +### Open Graph + +Теги [Open Graph](https://ogp.me/) не учитывают `` и всегда должны содержать полные абсолютные URL-адреса. Например: + +```html + +``` ## Примеры ```html - - + + + ``` +## Техническая сводка + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Категории контента + Метаданные
Допустимое содержимоеОтсутствует. Это {{Glossary("void element","пустой элемент")}}.
Пропуск теговДолжен иметь открывающий тег и не иметь закрывающего.
Допустимые родителиТег {{HTMLElement("head")}}, который не содержит другой элемент <base>.
Неявная ARIA-рольНет соответствующей роли
Допустимые ARIA-ролиАтрибут role не допускается
DOM-интерфейс{{domxref("HTMLBaseElement")}}
+ ## Спецификации {{Specifications}}