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

{{Docpage}}<noinclude>{{К улучшению|2023-07-12}}</noinclude>
{{Ombox|text=Содержимое этого шаблона '''не отображается в мобильной версии''' и в принципе [[доступность|недоступно]] слабовидящим.}}
{{Стили шаблона|Шаблон:Comment/styles.css}}
Шаблон выделяет текст подчёркиванием и добавляет к нему [[Подсказка#Подсказка в компьютерных интерфейсах|всплывающую подсказку]].

'''Подсказка не видна в мобильной версии, то есть более чем половине читателей РуСказок, поэтому следует использовать шаблон только для несущественного текста. Вместо него следует использовать [[РуСказки:Сноски#Разделение ссылок и пояснений|механизм сносок]].'''

{{TOC right}}

== Использование ==
{{Tc||''текст''|''подсказка''{{Optp|''ссылка на статью''}}}}

{{Optp/comment}}

== Примеры ==
* {{Пример|Comment|РФ|Российская Федерация}}
* {{Пример|Comment|РФ|Российская Федерация|Россия}}

== Технические ограничения ==
* Содержимое шаблона недоступно использующим чтение с экрана (слабовидящим и др.).
* Пользователи смартфонов и планшетных компьютеров, как правило, не имеют возможности увидеть всплывающую подсказку, поэтому используйте данный шаблон только там, где это действительно необходимо.
* Если в параметрах шаблона есть знак <code>=</code>, то, как и в любом другом шаблоне, приходится использовать явные номера параметров: <code class="nowrap"><nowiki>{{Comment|1=текст|2=подсказка}}</nowiki></code>.
* Употребление шаблона внутри вики-ссылки (например, <code class="nowrap"><nowiki>[[РуСказки|Отображаемый {{Comment|текст|подсказка}}]]</nowiki></code> приводит к отключению стиля шаблон в последующем на странице. <code><nowiki>[[|{{Comment|невидно|}}]],{{Comment|невидно|}}[[|{{Comment|невидно|}}]]</nowiki></code>
** Стиль для Comment не загружается изнутри ссылки. На странице где-либо до первой такой ссылки нужен ещё один шаблон Comment (даже пустой) вне ссылки. Например, пустой шаблон до первой ссылки: <code><nowiki>{{Comment||}}[[|{{Comment|видно|}}]],[[статья|часть1{{Comment|видно|часть2}}часть3]]</nowiki></code>.
** Пользователи планшетов и смартфонов не смогут тапом перейти по ссылке.
** Ссылку на весь текст может делать сам шаблон, см. [[#Использование]].

== Обсуждение ==
Обстоятельства употребления шаблона активно обсуждались здесь: {{Ф|ПРЕ|Шаблон:Comment|2016/03}}.

== См. также ==
* {{Tl|Abbr}} — расширенная версия этого шаблона для аббревиатур.
* {{Tl|Комментарий}} — другой шаблон со схожим названием, но предназначенный исключительно для обсуждений.

== Параметры шаблона для визуального редактора ==
<templatedata>
{
	"description": "Всплывающая подсказка с заданным текстом и подчеркивание выбранного текста.",
	"params": {
		"1": {
			"label": "текст",
			"description": "видимый в статье текст",
			"type": "line",
			"required": true,
			"example": "РФ"
		},
		"2": {
			"label": "подсказка",
			"description": "текст, всплывающей подсказки показываемый при наведённом курсоре. В тексте подсказки не должно быть знака машинописных кавычек (этот текст уже вставляется внуть кавычек в HTML напр. как title=\"Российская Федерация\". Допустимо использование типографских кавычек «» вместо \" \" . При необходимости вместо кавычек \" \" допустимо использование &quot; .)",
			"type": "string",
			"required": true,
			"example": "Российская Федерация"
		},
		"3": {
			"label": "ссылка",
			"description": "Название статьи, чтобы выбранный текст стал викиссылкой",
			"type": "wiki-page-name",
			"required": false,
			"example": "Россия"
		}
	}
}
</templatedata>

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