Phase1EmergencyAdmin：DS migration: first-batch templates

2026-10-21T12:47:07Z

DS migration: first-batch templates

新页面

<templatestyles src="NovarkSeatMeter/styles.css" />{{{label|}}}

<noinclude>
== 用途 ==
席位条/计数计量条（迁移 catalog P-11；架构 A4）。保留旧站 `seat-bar`、`seat-bar-fill`、`seat-bar-text` 与 `novark-seat-meter` 的语义：数值文本与计量视觉同时存在，不在正文手写百分比或任意 CSS。

== 参数 ==
* `value`：当前值（必填，非负数）。
* `max`：总数（必填，正数）。
* `tone`：`silver`、`gold`、`blue-red`、`blue`、`red`、`green`、`purple`；缺省 `silver`。七色取自旧 `wiki/theme-v2.css` L197-L249 的真实命名色。
* `label`：可读数值文本，通常写“45 / 199”。
* `percent`：由 `value/max` 计算的 0–100 数值（必填，派生值），只用于局部数值样式 `width`；必须与 value/max 一致。

== 为什么不是 <progress> ==
MediaWiki 1.43.11 的 `includes/parser/Sanitizer.php` 白名单不包含 `<progress>`（证据：`reports/migration/extension-lock-evidence.json`），该标签会被清理器剥离，只剩文本。按架构 A4 采用“经数字范围校验后生成的局部数值样式”作为等价实现：迁移器校验 value/max 为合法数值、percent 由二者计算，样式其余部分仍由 TemplateStyles 负责；模板本身不接受任意 CSS 片段。

== 示例 ==
<pre>{{NovarkSeatMeter
|value=45
|max=199
|tone=silver
|label=45 / 199
|percent=22.61
}}</pre>

== 校验 ==
* 非法值（负数、max<=0、value>max、percent 越界）必须由迁移器显式报错并进入例外，不得静默截断。
* 隔离渲染需在 360px 宽度与深色模式下核对可读性与窄屏。

<templatedata>
{
"description": "席位/计数计量条：保留数值文本与计量视觉；value/max 为稳定接口，percent 为经数值范围校验后生成的局部数值样式（MediaWiki 1.43.11 清理器不保留 progress 标签），tone 只接受七种命名色，label 为可读文本。",
"params": {
"value": {
"label": "当前值",
"description": "必填的非负数值（与来源数据一致）；不做静默截断。",
"type": "number",
"required": true,
"example": "45"
},
"max": {
"label": "总数",
"description": "必填的正数值，大于 0；来源数据缺失时不要用猜测值。",
"type": "number",
"required": true,
"example": "199"
},
"tone": {
"label": "命名色调",
"description": "旧站已观察的命名色：silver、gold、blue-red、blue、red、green、purple；缺省 silver。不接受任意输入生成 CSS。",
"type": "line",
"required": false,
"suggestedvalues": [
"silver",
"gold",
"blue-red",
"blue",
"red",
"green",
"purple"
],
"default": "silver",
"example": "silver"
},
"label": {
"label": "可读数值文本",
"description": "显示给读者的数值文本，通常为“45 / 199”；与 value/max 一致，不另造百分比。",
"type": "line",
"required": false,
"example": "45 / 199"
},
"percent": {
"label": "填充百分比（派生）",
"description": "由迁移器按 value/max 计算并校验的 0–100 数值，只进入局部数值样式；编辑者手写时必须与 value/max 一致，不得改变来源数据。",
"type": "number",
"required": true,
"example": "22.61"
}
},
"paramOrder": [
"value",
"max",
"tone",
"label",
"percent"
],
"format": "inline"
}
</templatedata>
</noinclude>

模板:NovarkSeatMeter - 版本历史

Phase1EmergencyAdmin：​DS migration: first-batch templates

Phase1EmergencyAdmin：DS migration: first-batch templates