Шаблон:Comment/doc: различия между версиями
Перейти к навигации
Перейти к поиску
Andras (обсуждение | вклад) м (→См. также) |
Andras (обсуждение | вклад) мНет описания правки |
||
| (не показана 1 промежуточная версия этого же участника) | |||
| Строка 1: | Строка 1: | ||
{{Docpage}} | {{Docpage}}<noinclude>{{К улучшению|2023-07-12}}</noinclude> | ||
{{Ombox|text=Содержимое этого шаблона '''не отображается в мобильной версии''' и в принципе [[доступность|недоступно]] слабовидящим.}} | {{Ombox|text=Содержимое этого шаблона '''не отображается в мобильной версии''' и в принципе [[доступность|недоступно]] слабовидящим.}} | ||
{{Стили шаблона|Шаблон:Comment/styles.css}} | {{Стили шаблона|Шаблон:Comment/styles.css}} | ||
| Строка 18: | Строка 18: | ||
== Технические ограничения == | == Технические ограничения == | ||
* Содержимое шаблона | * Содержимое шаблона недоступно использующим чтение с экрана (слабовидящим и др.). | ||
* Пользователи | * Пользователи смартфонов и планшетных компьютеров, как правило, не имеют возможности увидеть всплывающую подсказку, поэтому используйте данный шаблон только там, где это действительно необходимо. | ||
* Если в параметрах шаблона есть знак <code>=</code>, то, как и в любом другом шаблоне, приходится использовать явные номера параметров: <code class="nowrap"><nowiki>{{Comment|1=текст|2=подсказка}}</nowiki></code>. | * Если в параметрах шаблона есть знак <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> | * Употребление шаблона внутри вики-ссылки (например, <code class="nowrap"><nowiki>[[РуСказки|Отображаемый {{Comment|текст|подсказка}}]]</nowiki></code> приводит к отключению стиля шаблон в последующем на странице. <code><nowiki>[[|{{Comment|невидно|}}]],{{Comment|невидно|}}[[|{{Comment|невидно|}}]]</nowiki></code> | ||
Текущая версия от 10:21, 12 июля 2023
 |
 | Эта страница требует существенной переработки. |
 | Содержимое этого шаблона не отображается в мобильной версии и в принципе недоступно слабовидящим. |
 | Этот шаблон использует TemplateStyles и загружает следующие таблицы CSS-стилей:
|
Шаблон выделяет текст подчёркиванием и добавляет к нему всплывающую подсказку.
Подсказка не видна в мобильной версии, то есть более чем половине читателей РуСказок, поэтому следует использовать шаблон только для несущественного текста. Вместо него следует использовать механизм сносок.
Использование
{{Comment|текст|подсказка|ссылка на статью}}
Серым показаны необязательные параметры.
Примеры
{{Comment|РФ|Российская Федерация}}→ РФ{{Comment|РФ|Российская Федерация|Россия}}→ РФ
Технические ограничения
- Содержимое шаблона недоступно использующим чтение с экрана (слабовидящим и др.).
- Пользователи смартфонов и планшетных компьютеров, как правило, не имеют возможности увидеть всплывающую подсказку, поэтому используйте данный шаблон только там, где это действительно необходимо.
- Если в параметрах шаблона есть знак
=, то, как и в любом другом шаблоне, приходится использовать явные номера параметров:{{Comment|1=текст|2=подсказка}}. - Употребление шаблона внутри вики-ссылки (например,
[[РуСказки|Отображаемый {{Comment|текст|подсказка}}]]приводит к отключению стиля шаблон в последующем на странице.[[|{{Comment|невидно|}}]],{{Comment|невидно|}}[[|{{Comment|невидно|}}]]- Стиль для Comment не загружается изнутри ссылки. На странице где-либо до первой такой ссылки нужен ещё один шаблон Comment (даже пустой) вне ссылки. Например, пустой шаблон до первой ссылки:
{{Comment||}}[[|{{Comment|видно|}}]],[[статья|часть1{{Comment|видно|часть2}}часть3]]. - Пользователи планшетов и смартфонов не смогут тапом перейти по ссылке.
- Ссылку на весь текст может делать сам шаблон, см. #Использование.
- Стиль для Comment не загружается изнутри ссылки. На странице где-либо до первой такой ссылки нужен ещё один шаблон Comment (даже пустой) вне ссылки. Например, пустой шаблон до первой ссылки:
Обсуждение
Обстоятельства употребления шаблона активно обсуждались здесь: Шаблон:Ф.
См. также
- {{Abbr}} — расширенная версия этого шаблона для аббревиатур.
- {{Комментарий}} — другой шаблон со схожим названием, но предназначенный исключительно для обсуждений.
Параметры шаблона для визуального редактора
Всплывающая подсказка с заданным текстом и подчеркивание выбранного текста.
| Параметр | Описание | Тип | Статус | |
|---|---|---|---|---|
| текст | 1 | видимый в статье текст
| Однострочный | обязательный |
| подсказка | 2 | текст, всплывающей подсказки показываемый при наведённом курсоре. В тексте подсказки не должно быть знака машинописных кавычек (этот текст уже вставляется внуть кавычек в HTML напр. как title="Российская Федерация". Допустимо использование типографских кавычек «» вместо " " . При необходимости вместо кавычек " " допустимо использование " .)
| Строковый (без форматирования) | обязательный |
| ссылка | 3 | Название статьи, чтобы выбранный текст стал викиссылкой
| Имя страницы | необязательный |