Редактирование: Шаблон:Abbr/doc

{{docpage}}
Этот шаблон выделяет [[Аббревиатура|аббревиатуру]] подчёркиванием и добавляет к ней всплывающую подсказку с расшифровкой. 

В соответствими с актуальным стандартом HTML [https://html.spec.whatwg.org/multipage/text-level-semantics.html#the-abbr-element] abbr используется только для "abbreviation or acronym". Для добавления всплывающей подсказки к прочим словам используется похожий шаблон {{tl|comment}}. См. также [[:en:Template:Abbr/doc#Accessibility and HTML validity concerns]].

Шаблон может установить ссылку на статью, имя которой — значение 1-го, 2-го или 3-го параметра, например: {{abbr|РФ|Российская Федерация|Россия}}.

{{днш|аббревиатура|аббр}}

== Использование ==
{{tc||''аббревиатура''|''расшифровка''{{optp|''№ параметра для ссылки или 0, чтобы подавить ссылку''}}}}

{{optp/comment}}{{^|1em}}

Необязательный третий параметр указывает, какой из параметров использовать для ссылки в качестве названия статьи.
* <code>0</code> — подавить ссылку
* <code>1</code> (по умолчанию) — использовать 1-й параметр (<code>''аббревиатура''</code>)
* <code>2</code> — использовать 2-й параметр (<code>''расшифровка''</code>)
* другое — использовать 3-й (этот же) параметр

== Примеры ==
* Ссылка подавлена:
: {{пример||ПТЗ|Павлодарский тракторный завод|0}}

* Ссылка по умолчанию или явно использует содержимое 1-го параметра:
: {{tc||АН СССР|Академия наук СССР}}<br><span style="margin-left: 6px;">или</span><br>{{пример||АН СССР|Академия наук СССР|1|_sep={{sp↓|||0}}}}

* Ссылка использует содержимое 2-го параметра:
: {{пример||ПАВ|поверхностно-активные вещества|2}}

* Ссылка на произвольную страницу в 3-м параметре:
: {{пример||ПАВ|поверхностно-активные вещества|Психоактивные вещества}}
: В данном случае ПАВ расшифровано как «поверхностно-активные вещества», ссылка указывает на статью «[[Психоактивные вещества]]».

== Технические ограничения ==
Технические ограничения те же, что и в шаблоне {{tl|comment}}.

* Если в параметры шаблона передаётся знак <code>=</code>, то [[WP:Механизм шаблонов#Неопределённые и пустые значения параметров|оформляется]]: <code><nowiki>{{abbr|1=a=b}}</nowiki></code> или <code><nowiki>{{abbr|a{{=}}b}}</nowiki></code>.
* В некоторых браузерах длина всплывающей подсказки ограничена. Например, в браузере Mozilla Firefox до третьей версии подсказки были однострочными.
* Пользователи [[смартфон]]ов и [[Планшетный компьютер|планшетных компьютеров]], как правило, не имеют возможности увидеть всплывающую подсказку, поэтому используйте данный шаблон только там, где это действительно необходимо.

==Templatedata==
<templatedata>
{
	"params": {
		"1": {
			"label": "аббревиатура",
			"type": "string",
			"suggested": true
		},
		"2": {
			"label": "расшифровка",
			"type": "string",
			"required": true
		},
		"3": {
			"description": "0 - показать без ссылки; 1 (по умолчанию) - имя статьи для ссылки в параметре 1 (аббревиатура); 2 - имя статьи для ссылки в параметре 2 (расшифровка); текст - использовать указанное здесь имя статьи для ссылки",
			"type": "string"
		}
	},
	"paramOrder": [
		"1",
		"2",
		"3"
	],
	"description": "Аббревиатуры и акронимы со сплывающей подсказкой."
}
</templatedata>

<includeonly>
[[Категория:Шаблоны:Форматирование]]
[[Категория:Шаблоны:Внутренние ссылки]]
</includeonly>