编辑“︁Template:Color block/doc”︁（章节）

==颜色色块模板==
本模板可用于显示[[CSS]]颜色名称/16进制颜色值及其对应色块。

用法：

<pre>
{{Color block|<参数1：颜色值>|[参数2：自定义名称（可选）]|[附加功能参数]}}
</pre>
* <code><参数1：颜色值></code>可使用[[#使用CSS颜色名称|CSS颜色名称]]或[[#使用16进制颜色值|16进制颜色值]]。
* <code>[参数2：自定义名称（可选）]</code>可用于显示CSS颜色名称或颜色值以外的自定义内容。
* 附加功能参见[[#附加功能]]部分。

<pre>
{{Color block|color=<颜色值>|text=[自定义名称（可选）]|[附加功能参数]}}
</pre>
* <code><颜色值></code>同以上参数1。
* <code>[自定义名称（可选）]</code>同以上参数2。
* 附加功能参见[[#附加功能]]部分。


===使用CSS颜色名称===
'''CSS支持的全部颜色名称：[https://www.w3.org/TR/css-color-3/#svg-color W3 CSS color names]'''

用例：
<pre>
{{Color block|red}}
</pre>
输出：{{Color block|red}}


用例：
<pre>
{{Color block|color=red}}
</pre>
输出：{{Color block|color=red}}


===使用16进制颜色值===
'''注意：16进制颜色值必须以#字符开头。'''

用例：
<pre>
{{Color block|#0000ff}}
</pre>
输出：{{Color block|#0000ff}}


用例：
<pre>
{{Color block|color=#0000ff}}
</pre>
输出：{{Color block|color=#0000ff}}


===使用自定义名称===
您可在CSS颜色名称或16进制值之后，显示自定义的颜色名称。


用例：
<pre>
{{Color block|#ffbf00|琥珀色}}
</pre>
输出：{{Color block|#ffbf00|琥珀色}}


用例：
<pre>
{{Color block|color=#ffbf00|text=琥珀色}}
</pre>
输出：{{Color block|color=#ffbf00|text=琥珀色}}


===附加功能===

====颜色名称悬停提示====
若使用自定义颜色，您可以使用参数<code>color-tooltip=1</code>来显示CSS颜色名称或16进制颜色值。如果您使用计算机访问维基百科，使用鼠标悬停在颜色名称上，方可看到该颜色名称或颜色值。

用例：
<pre>
{{Color block|#ffbf00|琥珀色|color-tooltip=1}}
</pre>
输出：{{Color block|#ffbf00|琥珀色|color-tooltip=1}}


====不输出文本====
您可以使用参数<code>no-text=1</code>使之不输出文本内容。此时指定自定义颜色名称的参数2不起作用。

用例：
<pre>
{{Color block|#ff00ff|no-text=1}}
{{Color block|#ff00ff|品红色|no-text=1}}
</pre>
输出：{{Color block|#ff00ff|no-text=1}} {{Color block|#ff00ff|品红色|no-text=1}}


====加粗字体====
您可以使用参数<code>bold=1</code>实现字体加粗。


用例：
<pre>
{{Color block|green|bold=1}}
</pre>
输出：{{Color block|green|bold=1}}


用例：
<pre>
{{Color block|#0000ff|bold=1}}
</pre>
输出：{{Color block|#0000ff|bold=1}}


用例：
<pre>
{{Color block|#ffbf00|琥珀色|bold=1}}
</pre>
输出：{{Color block|#ffbf00|琥珀色|bold=1}}


用例：
<pre>
{{Color block|#ffbf00|琥珀色|bold=1|color-tooltip=1}}
</pre>
输出：{{Color block|#ffbf00|琥珀色|bold=1|color-tooltip=1}}