查看“︁模板:Font/doc”︁的源代码

本模板原来自萌娘百科百科的[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 这里]看到。经过双方编者的修改，本模板可能已与来源有很大差异。

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

== 结构 ==
本模板有8个参数：
{| class="wikitable" width="100%"
  ! 参数名
  ! 简介
  ! 参数类型
  ! 默认值
  |-
  | <code>class</code>
  | 目标文字的 class 属性。
  | class 名称
  | ''无''
  |-
  | <code>title</code>
  | 文字的注释。鼠标悬停在文字上时会以“弹出式提示框”的形式显示。
  | 任意字符，除管道符（'''<nowiki>|</nowiki>'''）、连续两个大括号（<nowiki>{{</nowiki>、<nowiki>}}</nowiki>）外。管道符可以用<code><nowiki>{{!}}</nowiki></code>代替。
  | ''无''
  |-
  | <code>font</code>, <code>font-family</code>
  | 目标文字字体。
  | 字体名称，多个字体应用半角逗号（''','''）隔开。可能的值参见[https://www.w3school.com.cn/cssref/css_websafe_fonts.asp 网络安全字体]、[[wikipedia:zh:Microsoft_Windows字体列表|Windows字体列表]]、[[wikipedia:zh:macOS字体列表|macOS字体列表]]等信息。
  | 参见[[MediaWiki:Common.css]]
  |-
  | <code>size</code>, <code>font-size</code>
  | 目标文字缩放尺寸。
  | 数字；使用时需附单位：<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>
  |-
  | <code>color</code>
  | 目标文字文字颜色。
  | 颜色代码；使用十六进制代码时应用半角井号（<code>#</code>）做前缀，如'''#000000'''。参见[https://developer.mozilla.org/zh-CN/docs/Web/CSS/color_value <color> - MDN Web文档]。
  | <code>inherit</code>
  |-
  | <code>bgcolor</code>
  | 目标文字背景颜色
  | 颜色代码；具体信息同上。
  | 透明（即无背景）
  |-
  | <code>shadowcolor</code>
  | 目标文字阴影颜色。
  | 颜色代码；具体信息同上。
  | 无（即无阴影）
  |-
  | <code>style</code>, <code>css</code>
  | 目标文字的其他CSS样式
  | 可能的值参见[https://developer.mozilla.org/zh-CN/docs/Web/CSS/CSS_Fonts CSS Fonts]。也可以应用任何在{{SITENAME}}允许的 CSS 样式。
  | ''无''
  |-
  | <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样式|1=文字}}</nowiki></code>

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

== 范例 ==
比如，输入<code><nowiki>{{Font|color=#7f5620|font=楷体|size=20px|文字在这里。}}</nowiki></code>

结果会是︰{{Font|color=#7f5620|font=楷体|size=20px|文字在这里。}}

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

== 模板数据 ==
{{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>

== 外部链接与注释 ==