Импортёр: 1 версия импортирована

2024-05-02T09:01:44Z

1 версия импортирована

← Предыдущая версия	Версия от 12:01, 2 мая 2024
(нет различий)

ru>Andras в 10:21, 12 июля 2023

2023-07-12T10:21:12Z

Новая страница

{{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=\"Российская Федерация\". Допустимо использование типографских кавычек «» вместо \" \" . При необходимости вместо кавычек \" \" допустимо использование " .)",
"type": "string",
"required": true,
"example": "Российская Федерация"
},
"3": {
"label": "ссылка",
"description": "Название статьи, чтобы выбранный текст стал викиссылкой",
"type": "wiki-page-name",
"required": false,
"example": "Россия"
}
}
}
</templatedata>

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

Шаблон:Comment/doc - История изменений

Импортёр: 1 версия импортирована

ru>Andras в 10:21, 12 июля 2023