Help:頁面狀態指示器
頁面狀態指示器是显示在主要内容之外的图标(或短文本片段),可提供有关文章状态的快速信息(例如该页面是否被保护 或是典范条目)。
它们也被称为顶部图标、页面图标或标题图标。
此功能在Gerrit change 162609的MediaWiki 1.25 版本中添加,以解决工單T25796并替换针对此问题的众多临时解决方案,例如英语维基百科的“top icon”模板。
查看頁面狀態指示器
頁面狀態指示器通常显示在页面的右上角、主要内容之外或页面标题之前。 它们的确切位置取决于皮肤 。
新增頁面狀態指示器
使用以下语法在頁面狀態指示器,修改name
属性和标签内容以适合您的喜好。
强烈建议为您需要的每种指示器类型创建一个模板 ,而不是直接在頁面中包含标签语法。
wikitext语法:
<indicator name="foo">[[File:Foo.svg|20px]]</indicator>
Lua模块语法:
mw.getCurrentFrame():extensionTag {
name = "indicator",
content = '[[File:Foo.svg|20px]]',
args = {
name = "foo"
}
}
请注意:
- 图片中的caption中的内容会出现在
title
属性中。 - 不局限于图片,您可以在这里添加任意的wikitext。 (只有MediaWiki 1.39 开启才支援模板樣式 ,参见T188443)
- 每个指示器都必须有一个唯一的标识符(名称)。 不能存在多个具有相同名称的指示器——如果出现重复,最后出现的标签将会胜出。
- 指示器按其名称(区分大小写)而非出现顺序显示。 这确保了跨页面的一致性,并提供了一种对它们进行排序或分组的简单方法。
- 指示器不会被追踪。 它们仅旨在反映页面上已经存在的内容或元資料,而不是資料本身。 您应该能够使用适当的追踪分类 、模板嵌入 列表、特殊页面 报告,或其他方式来列出包含给定指示器的页面。
已知問題
- 它们不会被Skin:Minerva Neue 展示,参见phab:T75299。
- 它们不能在VisualEditor 中预览
- You cannot add a widget of the Widgets extension between indicator tags.
在您的wiki上自定义显示
如果您使用的皮肤支援頁面狀態指示器(所有預設外觀都支援),您可以使用站点和用户CSS调整它们的显示。
要设置样式的CSS类是.mw-indicators
(对于整个包含块)和.mw-indicator
(对于每个单独的指示器)。
每个指示器还被赋予一个为#mw-indicator-name
的ID,其中name
是使用<indicator name="foo">
语法分配给指示器的名称。
在外觀中支援指示器
在手册:SkinMustache.php 查看有关array-indicators
的更多資訊。
在PHP程式碼使用指示器
存取OutputPage 物件并调用它的setIndicators()
方法,传递一个ID和您想要显示的HTML字符串。
如果要加入指向說明文件的帮助链接,请调用它的addHelpLink()
方法,该方法也由SpecialPage 和其他类实现。
这会在指示器区域中放置一个帮助链接;例如Special:WhatLinksHere。