Шаблон: Abbr

Документация по шаблону [ просмотреть ] [ изменить ] [ историю ] [ очистить ]

Этот шаблон не следует использовать в шаблонах цитирования, таких как Citation Style 1 и Citation Style 2 , поскольку он включает разметку, которая загрязняет создаваемые ими метаданные COinS ; см. Википедию: COinS .

Этот шаблон используется примерно на 641 000 страницах . Чтобы избежать серьезных сбоев и нагрузки на сервер, любые изменения следует тестировать на подстраницах / sandbox или / testcases шаблона или на собственной подстранице пользователя . Протестированные изменения могут быть добавлены на эту страницу одним редактированием. Обсудите изменения на странице обсуждения, прежде чем реализовывать их. Счетчик включений обновляется автоматически ( см. Документацию ).

Шаблон {{ Abbr }} используется для записи сокращения (включая акроним или инициализм) с его значением. Это оболочка для элемента HTML , создающая всплывающую подсказку, указывающую значение термина. Вариант {{ Tooltip }} тот же самый, за исключением того, что в нем используется элемент, и он предназначен для предоставления при наведении указателя мыши примечаний о не сокращениях. <abbr>...</abbr><span>...</span>

Обратите внимание: не используйте {{abbr}}или не <abbr>помечайте материал, кроме сокращений (включая акронимы). Использование его для создания всплывающих подсказок в другом месте является неправильным использованием базового HTML и вызывает проблемы с доступностью . Для всплывающих подсказок общего назначения используйте вместо этого.{{tooltip}}

использование

Шаблон  и его вариант принимают два безымянных параметра в следующем порядке:{{abbr}}{{tooltip}}

|1= или первый безымянный параметр

термин, который необходимо объяснить; отображается как текст и может использовать вики-разметку, например ссылку на статью о том, к чему она относится.

|2= или второй безымянный параметр

расширение, определение или другое примечание о термине; отображается как всплывающее окно при наведении курсора на термин. В этом параметре нельзя использовать вики-разметку .

Используйте явно пронумерованные параметры, если содержимое параметра содержит =символ равенства ( ):

• Сложный пример: [[Mass–energy equivalence|{{abbr|{{math|''E'' {{=}} ''mc''<sup>2</sup>}}|2=Energy = mass times the speed of light squared}}]]
• Производит: E = mc ²

Именованные параметры (обычно не требуются) и вводимые данные:

|class=

Один или несколько классов CSS (разделенных пробелами, если их несколько)

|id=

HTML id(т. Е. Привязка ссылки); он должен быть уникальным на всей странице.#ID name here

|style=

Произвольный встроенный CSS для применения к отображаемому тексту термина (не влияет на текст всплывающей подсказки). Для любого ввода, который необходимо пометить кавычками (например, потому что он содержит пробел), используйте только прямые одинарные кавычки, например|style=font-family: 'Times New Roman', serif;

Примеры

{{abbr | MSLP | Среднее давление на уровне моря}}

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

{{abbr | UK | United Kingdom | class = country-name | id = foobar}}

[[WP: COI | {{подсказка | конфликт интересов | в конкретном смысле, используемом в политике Википедии}}]]

Связывание должно выполняться определенным образом

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

Не размещайте ссылки и не используйте любую другую вики-разметку или разметку HTML во meaningвсплывающем окне - только обычный текст.
Всплывающее окно для meaningтекста при наведении указателя мыши создается title=атрибутом внутри <abbr>открывающего тега элемента HTML, поэтому оно не может сам содержать какой-либо HTML (или разметку, которая преобразуется в HTML при отображении). Сюда входят такие простые вещи, как ''italics''.

Проблемы доступности и валидности HTML

Этот шаблон предназначен только для использования с сокращениями (включая акронимы и инициалы).

Руководство по обеспечению доступности веб-контента содержит рекомендации по использованию <abbr>элемента, созданного с помощью этого шаблона; см. раздел H28: Определение сокращений с использованием элементов abbr и acronym .

Более того, спецификации HTML (как W3C, так и WHATWG ) строго определяют <abbr>элемент как зарезервированный для разметки сокращений. Злоупотребление им для всплывающих подсказок нарушает нашу семантическую разметку и делает наш контент недействительным HTML (технически « неправильно сформированный »; он пройдет базовый автоматический тест валидатора, потому что такой инструмент не может определить, что логическое применение данных к структуре неверно, только то, что теги правильно вложены и т. д.).

Перенаправления

Следующие имена шаблонов будут перенаправлены на {{ Abbr }}:

• {{ Abbrv }}
• {{ Define }}

{{ Tooltip }} - это отдельный шаблон с той же документацией.

Данные шаблона

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

• {{ Abbrlink }}, вариант этого шаблона, который включает автоматические вики-ссылки для термина (аббревиатуры).
• {{ Hover title }}, то же самое, что {{ Tooltip }}, за исключением того, что параметры 1 и 2 перевернуты, и некоторые параметры для управления связыванием
• {{ R-фраза }}, которая генерирует кодовый номер для R-фразы («фраза риска», например, «Взрывоопасно в сухом виде»). Сама R-фраза включена во всплывающую подсказку, а код ссылается на Список R-фраз .