模板:Font：修订间差异

2021年3月19日 (五) 21:40的最新版本

模板文档

本模板原来自萌娘百科百科的Template:Font/doc (版本号4611645)，依 CC BY-SA 3.0 授权引入；原贡献者可以在这里看到。经过双方编者的修改，本模板可能已与来源有很大差异。

本模版基于 CSS 样式，用来设定字体、大小、颜色、阴影及底色。本模板本质是一个预包装的 <span> 元素。

结构

本模板有8个参数：

参数名	简介	参数类型	默认值
`class`	目标文字的 class 属性。	class 名称	无
`title`	文字的注释。鼠标悬停在文字上时会以“弹出式提示框”的形式显示。	任意字符，除管道符（\|）、连续两个大括号（{{、}}）外。管道符可以用`{{!}}`代替。	无
`font`, `font-family`	目标文字字体。	字体名称，多个字体应用半角逗号（,）隔开。可能的值参见网络安全字体、Windows字体列表、macOS字体列表等信息。	参见MediaWiki:Common.css
`size`, `font-size`	目标文字缩放尺寸。	数字；使用时需附单位：`px` / `em` / `ch` / `pt` / `%`，或是使用calc()，否则默认单位为px。	`14px`
`color`	目标文字文字颜色。	颜色代码；使用十六进制代码时应用半角井号（`#`）做前缀，如#000000。参见<color> - MDN Web文档。	`inherit`
`bgcolor`	目标文字背景颜色	颜色代码；具体信息同上。	透明（即无背景）
`shadowcolor`	目标文字阴影颜色。	颜色代码；具体信息同上。	无（即无阴影）
`style`, `css`	目标文字的其他CSS样式	Wiki允许的 CSS 样式。	无
`1`, `text`	目标文字内容。如果在使用时没有为一个参数给定名称（即`{{font\|参数名=参数值}}`），那么第一个这样的参数会被理解为参数 `1`。	任意字符，除管道符（\|）、连续两个大括号（{{、}}）外。管道符可以以`{{!}}`代替。	无；这是`必需`参数。

语法

{{Font|class=class属性|title=标题|font=文字字体|size=大小|color=颜色|bgcolor=背景颜色|shadowcolor=阴影颜色|css=其他css样式|文字}}
{{Font|class=class属性|title=标题|font=文字字体|size=大小|color=颜色|bgcolor=背景颜色|shadowcolor=阴影颜色|css=其他css样式|1=文字}}

注意：

除参数1外其他参数均是可省略参数，若省略，则会使用“结构”中所述的默认值。
调换各参数的顺序不会影响使用。
如果文字中有出现半角等号（=），则必须使用第二种用法，否则文字不会显示。

范例

比如，输入{{Font|color=#7f5620|font=楷体|size=20px|文字在这里。}}

结果会是︰文字在这里。

输入	结果
`{{Font\|不变化}}`	不变化
`{{Font\|color=#7f5620\|font=楷体\|size=20px\|啡色的文字。}}`	啡色的文字。
`{{Font\|color=#bf00bf\|font=Century Gothic\|size=35px\|Hello World!}}`	Hello World!
`{{Font\|bgcolor=#364d6a\|color=#c9b295\|font=Simhei\|size=16px\|囧囧囧囧囧}}`	囧囧囧囧囧
`{{Font\|title=就像这样\|bgcolor=#f9f9ef\|color=#5a7aad\|shadowcolor=blue\|font=Simhei\|size=24px\|可以选用全部选项。}}`	可以选用全部选项。
`{{Font\|size=25px\|可以只选用其中一项选项。}}`	也可以只选用其中一项选项。
`{{Font\|color=#FF0000\|1=如果有=出现，必须要指明参数为1，即在前面写上“1=”。}}`	如果有=出现，必须要指明参数为1，即在前面写上“1=”。

模板数据

这是用于新版可视化编辑器及其他工具的模板数据文档。

Font模板数据

本模版基于 CSS 样式, 用来设定字体、大小、颜色、阴影及底色。本模板本质是一个预包装的 <span> 元素。

模板参数[编辑模板数据]
此模板首选参数不换行的行内格式。
参数		描述	类型	状态
class	`class`	HTML class 属性	字符串	可选
title	`title`	注释, 就是 HTML title 属性	字符串	可选
字体	`font` `font-family`	文本使用的字体	字符串	可选
文本大小	`size` `font-size`	必须带单位, 而且不能使用诸如 «samller», «larger» 这类的定名	字符串	可选
文本颜色	`color`	可接受rgb, 十六进制rgb, hsl 和 X11 颜色名称。	字符串	可选
背景颜色	`bgcolor` `background-color`	可接受rgb, 十六进制rgb, hsl 和 X11 颜色名称。	字符串	可选
style	`style` `css`	HTML style 属性, 放其他CSS属性	字符串	可选
阴影颜色	`shadowcolor`	可接受rgb, 十六进制rgb, hsl 和 X11 颜色名称。	字符串	可选
内容	`text` `1`	无描述	wikitext片段	必需

外部链接与注释

@@ 第1行： / 第1行： @@
-<includeonly><span {{{{{|safesubst:}}}#if: {{{class|}}} |class="{{{class|}}}"}} {{{{{|safesubst:}}}#if: {{{title|}}} |title="{{{title|}}}"}} {{{{{|safesubst:}}}#if: {{{font|}}}{{{size|}}}{{{color|}}}{{{bgcolor|}}}{{{style|}}}{{{css|}}} |style="{{{{{|safesubst:}}}#if: {{{font|}}} |font-family:{{{font|}}};}} {{ {{{|safesubst:}}}#if:{{{size|}}}|
+<includeonly><span {{{{{|safesubst:}}}#if: {{{class|}}} |class="{{{class|}}}"}} {{{{{|safesubst:}}}#if: {{{title|}}} |title="{{{title|}}}"}} {{{{{|safesubst:}}}#if: {{{font|}}}{{{font-family|}}}{{{size|}}}{{{font-size|}}}{{{color|}}}{{{bgcolor|}}}{{{background-color|}}}{{{style|}}}{{{css|}}} |style="{{{{{|safesubst:}}}#if: {{{font|{{{font-family|}}}}}} |font-family:{{{font|{{{font-family|}}}}}};}} {{ {{{|safesubst:}}}#if:{{{size|{{{font-size|}}}}}}|
     {{ {{{|safesubst:}}}#if:
        {{ {{{|safesubst:}}}#switch:{{ {{{|safesubst:}}}#ifexpr:{{ {{{|safesubst:}}}#invoke:String|len|{{{size|}}}}} > 1|{{ {{{|safesubst:}}}#invoke:String|sub|{{{size|}}}|-2|-1}}|}}|px|em|pt|ch=t|#default=}}
@@ 第5行： / 第5行： @@
        {{ {{{|safesubst:}}}#ifeq:{{ {{{|safesubst:}}}#ifexpr:{{ {{{|safesubst:}}}#invoke:String|len|{{{size|}}}}} > 3|{{ {{{|safesubst:}}}#invoke:String|sub|{{{size|}}}|1|4}}|}}|calc|t|}}
       |font-size: {{{size|}}};|font-size: {{{size|}}}px;}}
-|}} {{{{{|safesubst:}}}#if: {{{color|}}} |color: {{{color}}};}} {{{{{|safesubst:}}}#if: {{{bgcolor|}}} |background-color:{{{bgcolor}}};}}{{{{{|safesubst:}}}#if: {{{shadowcolor|}}} |text-shadow: {{{shadowcolor|}}} 2px 4px 4px;}}  {{{{{|safesubst:}}}#if: {{{style|{{{css|}}}}}} |{{{style|{{{css}}}}}}|}}"}}>{{ {{{|safesubst:}}}#if: {{{1|}}}|{{{1}}}|<strong class="error">警告：font 模板的参数<code>{{{1}}}</code>未赋值。</strong>}}</span></includeonly><noinclude>
+|}} {{{{{|safesubst:}}}#if: {{{color|}}} |color: {{{color}}};}} {{{{{|safesubst:}}}#if: {{{bgcolor|{{{background-color|}}}}}} |background-color:{{{bgcolor|{{{background-color}}}}}};}}{{{{{|safesubst:}}}#if: {{{shadowcolor|}}} |text-shadow: {{{shadowcolor|}}} 2px 4px 4px;}}  {{{{{|safesubst:}}}#if: {{{style|{{{css|}}}}}} |{{{style|{{{css}}}}}}|}}"}}>{{ {{{|safesubst:}}}#if: {{{text|{{{1}}}}}}|{{{text|{{{1|}}}}}}|<strong class="error" style="font-size: inherit;">Template:Font中的错误: 文本参数未赋值。</strong>}}</span></includeonly><noinclude>
-{{documentation}}
+{{Documentation}}
 </noinclude>