模板:Font/doc：修订间差异

2022年6月9日 (四) 11:15的最新版本

本模板原来自萌娘百科百科的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><!-- 在这里加入模板的保护标识 --></includeonly>
-<!-- 在本行下编辑模板说明 -->
 本模板原来自萌娘百科百科的[https://zh.moegirl.org.cn/index.php?oldid=4611645 Template:Font/doc] (版本号4611645)，依 [https://creativecommons.org/licenses/by-sa/3.0/deed.zh CC BY-SA 3.0] 授权引入；原贡献者可以在[https://zh.moegirl.org.cn/index.php?title=Template:Font/doc&action=history 这里]看到。经过双方编者的修改，本模板可能已与来源有很大差异。
@@ 第8行： / 第6行： @@
 本模板有8个参数：
 {| class="wikitable" width="100%"
-!参数名!!简介!!参数类型!!默认值
+  ! 参数名
-|-
+  ! 简介
-|'''class'''
+  ! 参数类型
-| 目标文字的 class 属性。
+  ! 默认值
-|class 名称
+  |-
-|''无''
+  | <code>class</code>
-|-
+  | 目标文字的 class 属性。
-|'''title'''
+  | class 名称
-| 文字的注释。鼠标悬停在文字上时会以“弹出式提示框”的形式显示。
+  | ''无''
-|任意字符，除管道符（'''<nowiki>|</nowiki>'''）、连续两个大括号（<nowiki>{{</nowiki>、<nowiki>}}</nowiki>）外。管道符可以用<code><nowiki>{{!}}</nowiki></code>代替。
+  |-
-|''无''
+  | <code>title</code>
-|-
+  | 文字的注释。鼠标悬停在文字上时会以“弹出式提示框”的形式显示。
-|'''font'''
+  | 任意字符，除管道符（'''<nowiki>|</nowiki>'''）、连续两个大括号（<nowiki>{{</nowiki>、<nowiki>}}</nowiki>）外。管道符可以用<code><nowiki>{{!}}</nowiki></code>代替。
-| 目标文字字体。
+  | ''无''
-|字体名称，多个字体应用半角逗号（''','''）隔开。可能的值参见[https://www.w3school.com.cn/cssref/css_websafe_fonts.asp 网络安全字体]、[[zhwiki:Microsoft_Windows字体列表|Windows字体列表]]、[[zhwiki:macOS字体列表|macOS字体列表]]等信息。
+  |-
-|参见[[MediaWiki:Common.css]]
+  | <code>font</code>, <code>font-family</code>
-|-
+  | 目标文字字体。
-|'''size'''
+  | 字体名称，多个字体应用半角逗号（''','''）隔开。可能的值参见[https://www.w3school.com.cn/cssref/css_websafe_fonts.asp 网络安全字体]、[[wikipedia:zh:Microsoft_Windows字体列表|Windows字体列表]]、[[wikipedia:zh:macOS字体列表|macOS字体列表]]等信息。
-| 目标文字缩放尺寸。
+  | 参见[[MediaWiki:Common.css]]
-|数字；使用时需附单位：px/em/ch/pt/%，或是使用[https://developer.mozilla.org/zh-CN/docs/Web/CSS/calc calc()]，否则默认单位为px。
+  |-
-|14px
+  | <code>size</code>, <code>font-size</code>
-|-
+  | 目标文字缩放尺寸。
-|'''color'''
+  | 数字；使用时需附单位：<code>px</code> / <code>em</code> / <code>ch</code> / <code>pt</code> / <code>%</code>，或是使用[https://developer.mozilla.org/zh-CN/docs/Web/CSS/calc calc()]，否则默认单位为px。
-| 目标文字文字颜色。
+  | <code>14px</code>
-|颜色代码；使用十六进制代码时应用半角井号（'''#'''）做前缀，如'''#000000'''。参见[[Help:颜色列表]]。
+  |-
-|black
+  | <code>color</code>
-|-
+  | 目标文字文字颜色。
-|'''bgcolor'''
+  | 颜色代码；使用十六进制代码时应用半角井号（<code>#</code>）做前缀，如'''#000000'''。参见[https://developer.mozilla.org/zh-CN/docs/Web/CSS/color_value <color> - MDN Web文档]。
-| 目标文字背景颜色
+  | <code>inherit</code>
-|颜色代码；具体信息同上。
+  |-
-|透明（即无背景）
+  | <code>bgcolor</code>
-|-
+  | 目标文字背景颜色
-|'''shadowcolor'''
+  | 颜色代码；具体信息同上。
-| 目标文字阴影颜色。
+  | 透明（即无背景）
-|颜色代码；具体信息同上。
+  |-
-|无（即无阴影）
+  | <code>shadowcolor</code>
-|-
+  | 目标文字阴影颜色。
-|'''css'''
+  | 颜色代码；具体信息同上。
-| 目标文字的其他CSS样式
+  | 无（即无阴影）
-|可能的值参见[https://developer.mozilla.org/zh-CN/docs/Web/CSS/CSS_Fonts CSS Fonts]。也可以应用任何在萌百允许的 CSS 样式。
+  |-
-|''无''
+  | <code>style</code>, <code>css</code>
-|-
+  | 目标文字的其他CSS样式
-|'''1'''
+  | 可能的值参见[https://developer.mozilla.org/zh-CN/docs/Web/CSS/CSS_Fonts CSS Fonts]。也可以应用任何在{{SITENAME}}允许的 CSS 样式。
-| 目标文字内容。如果在使用时没有为一个参数给定名称（即<code><nowiki>{{font|参数名=参数值}}</nowiki></code>），那么第一个这样的参数会被理解为参数'''1'''。
+  | ''无''
-|任意字符，除管道符（'''<nowiki>|</nowiki>'''）、连续两个大括号（<nowiki>{{</nowiki>、<nowiki>}}</nowiki>）外。管道符可以以<code><nowiki>{{!}}</nowiki></code>代替。
+  |-
-|''无''；'''这是必须参数。 '''
+  | <code>1</code>, <code>text</code>
+  | 目标文字内容。如果在使用时没有为一个参数给定名称（即<code><nowiki>{{font|参数名=参数值}}</nowiki></code>），那么第一个这样的参数会被理解为参数 <code>1</code>。
+  | 任意字符，除管道符（'''<nowiki>|</nowiki>'''）、连续两个大括号（<nowiki>{{</nowiki>、<nowiki>}}</nowiki>）外。管道符可以以<code><nowiki>{{!}}</nowiki></code>代替。
+  | ''无''；这是<code>必需</code>参数。
 |}
-== 语法 ==<!--==使用方法==-->
+== 语法 ==
-#<code><nowiki>{{Font|class=class属性|title=标题|font=文字字体|size=大小|color=颜色|bgcolor=背景颜色|shadowcolor=阴影颜色|css=其他css样式|文字}}</nowiki></code>
+# <code><nowiki>{{Font|class=class属性|title=标题|font=文字字体|size=大小|color=颜色|bgcolor=背景颜色|shadowcolor=阴影颜色|css=其他css样式|文字}}</nowiki></code>
-#<code><nowiki>{{Font|class=class属性|title=标题|font=文字字体|size=大小|color=颜色|bgcolor=背景颜色|shadowcolor=阴影颜色|css=其他css样式|1=文字}}</nowiki></code>
+# <code><nowiki>{{Font|class=class属性|title=标题|font=文字字体|size=大小|color=颜色|bgcolor=背景颜色|shadowcolor=阴影颜色|css=其他css样式|1=文字}}</nowiki></code>
 注意：
-*除参数1外其他参数均是可省略参数，若省略，则会使用“结构”中所述的默认值。
+* 除参数1外其他参数均是可省略参数，若省略，则会使用“结构”中所述的默认值。
-*调换各参数的顺序不会影响使用。
+* 调换各参数的顺序不会影响使用。
-*如果文字中有出现半角等于号（'''='''），则必须使用第二种用法，否则文字不会显示。
+* 如果文字中有出现半角等号（<code>=</code>），则必须使用第二种用法，否则文字不会显示。
-== 范例 ==<!--==用例==-->
+== 范例 ==
 比如，输入<code><nowiki>{{Font|color=#7f5620|font=楷体|size=20px|文字在这里。}}</nowiki></code>
@@ 第71行： / 第72行： @@
 {| class="wikitable" width="100%"
-! 输入 !! 结果
+  ! 输入 !! 结果
-|-
+  |-
-|<code><nowiki>{{Font|不变化}}</nowiki></code>
+  | <code><nowiki>{{Font|不变化}}</nowiki></code>
-|{{Font|不变化}}
+  | {{Font|不变化}}
-|-
+  |-
-|<code><nowiki>{{Font|color=#7f5620|font=楷体|size=20px|啡色的文字。}}</nowiki></code>
+  | <code><nowiki>{{Font|color=#7f5620|font=楷体|size=20px|啡色的文字。}}</nowiki></code>
-|{{Font|color=#7f5620|font=楷体|size=20px|啡色的文字。}}
+  | {{Font|color=#7f5620|font=楷体|size=20px|啡色的文字。}}
-|-
+  |-
-|<code><nowiki>{{Font|color=#bf00bf|font=Century Gothic|size=35px|Hello World!}}</nowiki></code>
+  | <code><nowiki>{{Font|color=#bf00bf|font=Century Gothic|size=35px|Hello World!}}</nowiki></code>
-|{{Font|color=#bf00bf|font=Century Gothic|size=35px|Hello World!}}
+  | {{Font|color=#bf00bf|font=Century Gothic|size=35px|Hello World!}}
-|-
+  |-
-|<code><nowiki>{{Font|bgcolor=#364d6a|color=#c9b295|font=Simhei|size=16px|囧囧囧囧囧}}</nowiki></code>
+  | <code><nowiki>{{Font|bgcolor=#364d6a|color=#c9b295|font=Simhei|size=16px|囧囧囧囧囧}}</nowiki></code>
-|{{Font|bgcolor=#364d6a|color=#c9b295|font=Simhei|size=16px|囧囧囧囧囧}}
+  | {{Font|bgcolor=#364d6a|color=#c9b295|font=Simhei|size=16px|囧囧囧囧囧}}
-|-
+  |-
-|<code><nowiki>{{Font|title=就像这样|bgcolor=#f9f9ef|color=#5a7aad|shadowcolor=blue|font=Simhei|size=24px|可以选用全部选项。}}</nowiki></code>
+  | <code><nowiki>{{Font|title=就像这样|bgcolor=#f9f9ef|color=#5a7aad|shadowcolor=blue|font=Simhei|size=24px|可以选用全部选项。}}</nowiki></code>
-|{{Font|title=就像这样|bgcolor=#f9f9ef|color=#5a7aad|shadowcolor=blue|font=Simhei|size=24px|可以选用全部选项。}}
+  | {{Font|title=就像这样|bgcolor=#f9f9ef|color=#5a7aad|shadowcolor=blue|font=Simhei|size=24px|可以选用全部选项。}}
-|-
+  |-
-|<code><nowiki>{{Font|size=25px|可以只选用其中一项选项。}}</nowiki></code>
+  | <code><nowiki>{{Font|size=25px|可以只选用其中一项选项。}}</nowiki></code>
-|{{Font|size=25px|也可以只选用其中一项选项。}}
+  | {{Font|size=25px|也可以只选用其中一项选项。}}
-|-
+  |-
-|<code><nowiki>{{Font|color=#FF0000|1=如果有=出现，必须要指明参数为1，即在前面写上“1=”。}}</nowiki></code>
+  | <code><nowiki>{{Font|color=#FF0000|1=如果有=出现，必须要指明参数为1，即在前面写上“1=”。}}</nowiki></code>
-|{{Font|color=#FF0000|1=如果有=出现，必须要指明参数为1，即在前面写上“1=”。}}
+  | {{Font|color=#FF0000|1=如果有=出现，必须要指明参数为1，即在前面写上“1=”。}}
 |}
-== 重定向 ==
+== 模板数据 ==
-*{{tl|字体}}
+{{TemplateData_header}}
+<templatedata>
+{
+  "description": "本模版基于 CSS 样式, 用来设定字体、大小、颜色、阴影及底色。本模板本质是一个预包装的 <span> 元素。 ",
+  "format": "inline",
+  "params": {
+    "class": {
+      "description": "HTML class 属性",
+      "type": "string"
+    },
+    "title": {
+      "description": "注释, 就是 HTML title 属性",
+      "type": "string"
+    },
+    "font": {
+      "aliases": [
+        "font-family"
+      ],
+      "label": "字体",
+      "description": "文本使用的字体",
+      "type": "string"
+    },
+    "size": {
+      "aliases": [
+        "font-size"
+      ],
+      "label": "文本大小",
+      "description": "必须带单位, 而且不能使用诸如 «samller», «larger» 这类的定名",
+      "type": "string"
+    },
+    "color": {
+      "label": "文本颜色",
+      "description": "可接受rgb, 十六进制rgb, hsl 和 X11 颜色名称。",
+      "type": "string"
+    },
+    "bgcolor": {
+      "aliases": [
+        "background-color"
+      ],
+      "label": "背景颜色",
+      "inherits": "color",
+      "type": "string"
+    },
+    "style": {
+      "aliases": [
+        "css"
+      ],
+      "description": "HTML style 属性, 放其他CSS属性",
+      "type": "string"
+    },
+    "shadowcolor": {
+      "label": "阴影颜色",
+      "inherits": "color",
+      "type": "string"
+    },
+    "text": {
+      "aliases": [
+        "1"
+      ],
+      "label": "内容",
+      "required": true,
+      "type": "unbalanced-wikitext"
+    }
+  }
+}
+</templatedata>
 == 外部链接与注释 ==
-<references />
-{{Template:格式模板}}
-<includeonly>
-<!-- 本行下加入模板的分类 -->
-[[Category:格式模板]]
-</includeonly>