Справка:Индикаторы состояния страницы

Индикаторы состояния страницы — это значки (или короткие фрагменты текста), отображаемые вне основного содержания и предоставляющие быструю информацию о состоянии статьи (например, является ли страница защищённой или избранной статьёй).

Они также иногда называются верхними иконками, иконками страницы или иконками заголовка.

Эта функциональность была добавлена в MediaWiki 1.25 в Gerrit change 162609 для решения T25796 и замены различных местечковых решений этой проблемы, таких как шаблон «top icon» в английской Википедии.

С версии MediaWiki 1.43 MediaWiki может автоматически отображать статус защиты страницы в области индикатора состояния, см. Help:Protection indicators .

Просмотр индикаторов состояния страницы

Скриншот темы оформления Вектор с отмеченной зоной индикаторов.

Индикаторы статуса страницы обычно отображаются в правом верхнем углу страницы, за пределами основного содержания или прямо перед названием страницы. Их конкретное местоположение зависит от конкретной темы оформления .

Добавление индикаторов состояния страницы

Используйте следующий синтаксис, чтобы добавить индикаторы на страницу, меняя атрибут name и содержание тега в соответствии с вашими пожеланиями.

Настоятельно рекомедуется создать шаблон для каждого типа индикаторов, который вам понадобится, вместо включения кода тега непосредственно в статьи.

Синтаксис вики-текстом:

<indicator name="foo">[[File:Foo.svg|20px]]</indicator>

Синтаксис вики-текстом, когда параметры шаблона используются внутри тега:

{{#tag:indicator
 |[[File:{{{1|Foo.svg}}}|20px]]
 |name="foo"
}}

Синтаксис модуля Lua:

mw.getCurrentFrame():extensionTag {
	name = "indicator",
	content = '[[File:Foo.svg|20px]]',
	args = {
		name = "foo"
	}
}

Обратите внимание:

• При использовании описания изображения, оно автоматически становится атрибутом title с контентом этого описания.
• Можно добавлять любой вики-текст, не только изображения. (TemplateStyles поддерживается начиная только с MediaWiki 1.39 , см. T188443.)
• Каждый индикатор должен иметь уникальный идентификатор (наименование). Невозможно иметь несколько индикаторов с одним и тем же именем — в случае наличия дубликатов, последнее включение тега побеждает.
• Индикаторы сортируются по их названиям (с учётом регистра), а не по порядку их добавления. Это обеспечивает согласованность между страницами и обеспечивает простое средство их упорядочения или группировки.
• Индикаторы не отслеживаются. Они предназначены для отражения только содержания или метаданных, которые уже присутствуют на странице, а не для самой информации. Вы сможете использовать подходящую отслеживающую категорию , список включений шаблона, отчёты служебных страниц и прочие инструменты для получения списка страниц, включающих нужный индикатор.

Известные проблемы

• Они не отображаются в Тема оформления:MinervaNeue , см. phab:T75299.
• Они не работают в предпросмотре в VisualEditor .
• Вы не можете добавить виджет Extension:Widgets между тегами индикатора.

Настройка отображения в вашей вики

Если тема оформления, которую вы используете, поддерживает индикаторы состояния страницы (все темы по умолчанию поддерживают), вы можете регулировать из отображение, используя сайтовые и пользовательские CSS. Классами CSS для стилизации являются .mw-indicators (для всего блока содержимого) и .mw-indicator (для каждого отдельного индикатора).

Каждый индикатор также имеет идентификатор #mw-indicator-name, где name — это имя, присвоенное индикатору с использованием синтаксиса <indicator name="foo">.

Добавление поддержки индикаторов в темы оформления

См. array-indicators на Руководство:SkinMustache.php .

Использование индикаторов из PHP-кода

Получите доступ к объекту OutputPage и вызовите его метод setIndicators(), передав идентификатор и HTML-строку, которую вы хотите отобразить. Если вы хотите добавить справочную ссылку на документацию, вызовите его метод addHelpLink(), который также реализован в SpecialPage и других классах. Это добавит ссылку на справку в область индикаторов; например, см. Special:WhatLinksHere.