模板样式表(templatestyles)可以让用户在不需要界面管理员权限下也能编写适用于条目正文的样式表。关于如何编写样式表,参见MDN文档。
首先,用户需要创建一个内容模型为“纯CSS”页面用以存放样式表:
.css
结尾的页面时,系统会自动将页面的内容模型切换为“纯CSS”。恭喜,你已经创建了一个模板样式表!您现在可以在该页面编写CSS文本了。
在需要使用样式表的页面输入<templatestyles src="【样式表页面名】" />
即可使用!建议将该标签放在页面最开头,避免网速缓慢用户加载过程中出现样式闪烁的问题。
如果页面名省略了名字空间则会默认使用模板名字空间(与嵌入模板一致)。
目前wrapper
参数并不能正确生效。<templatestyles/>
还支持wrapper
参数用以在所有样式的选择器前额外追加一个选择器,限制生效范围,适合于修改广泛使用的样式表前先复制一份到沙盒样式表中并在沙盒页中做比较用(比如<templatestyles src="Example/styles.css" wrapper="div.example" />
将会在所有样式的选择器前追加div.example
选择器,使得样式只在<div class="example"/>
内生效)。
Lua模块亦能通过frame:extensionTag
使用:
local p = {};
function p.templateStyle( frame, src )
return frame:extensionTag( 'templatestyles', '', { src = "【样式表页面名】" } );
end
return p;
你可以在Help:沙盒/styles.css中添加样式,并在Help:沙盒中引入<templatestyles src="Help:沙盒/styles.css" />
和需要测试的内容。建议对大量嵌入的样式表做出更改之前先进行测试。
为了保障网站安全性和确保所有用户都能显示一致的样式,模板样式表扩展对样式表内容有以下限制:
(这些限制由服务器判定,编辑器也会有相关提示,推荐不要使用 Wikiplus 或 In-page Edit 等编辑工具而是使用编辑界面以获得相关提示)
at-rule
、无法识别或不支持的属性或属性值,可以使用的属性和属性值参见扩展源码;@font-face
,则其font-family
样式值包含的字体名必须带有TemplateStyles
前缀;body.skin-vector
等皮肤 class,body
是必要的.mw-parser-output
以将样式限制在正文范围内,避免恶意用户篡改其他部分(如编辑按钮等),如果需要在正文以外范围使用(如系统消息,例如编辑冲突警告),则需要在相应页面手动用<div class="mw-parser-output">...</div>
包裹整个源码。sanitized-css
),因此可以使用new_content_model
变量使用滥用过滤器跟踪或控制对它们的更改。data-mw-deduplicate
属性的<style/>
标签,其中data-mw-deduplicate
的值形如TemplateStyles:r123456"
,而123456是样式表的修订版ID(可以用Special:Diff查看)。
|