模板:Userbox/doc

[清除缓存]

这是文档页面，它应该被放置到Template:Userbox，查看Template:Documentation以获取更多信息。

此模板可在不需要熟悉HTML或Wiki语法的情况下快速创建一个用于在用户页上显示的用户框。

要查看用户框列表，详见Minecraft基岩版开发Wiki:Userbox.

用途

{{userbox
| bodyclass     = <!--自定义 HTML class参数，如样式化和微格式等-->
| float         = <!--id 流动对齐方式 left|right|none （默认为left）-->
| border-c      = <!--边框颜色（默认为id-c）-->
| border-s      = <!--以像素为单位的边框宽度（默认为1）-->
| id            = <!--id 的图像或者（以及）是文字-->
| id-a          = <!--id 的水平对齐方式 left/center/right/justify （默认为center）-->
| id-c          = <!--id 的背景颜色（默认为#d0d0d0）-->
| id-fc         = <!--id 字体颜色（默认为black）-->
| id-s          = <!--id 以点数为单位的文本大小（默认为14）-->
| id-p          = <!--id 的储存格留白值（默认为0 1px 0 0）-->
| id-lh         = <!--id 框行高（默认为1.25em）-->
| id-op         = <!--id 框的其它CSS参数-->
| id-w          = <!--id 框以像素为单位的框宽度（默认为45）-->
| id-h          = <!--id 框以像素为单位的框高度（默认为45）-->
| info-class    = <!--向“info”HTML表格行添加一个HTML class特性以进行样式化和微格式等-->
| info          = <!--info 框的文字或者（以及）是文字-->
| info-a        = <!--info 框的水平对齐方式 left/center/right/justify （默认为left）-->
| info-c        = <!--info 框背景颜色（默认为#e0e0e0）-->
| info-fc       = <!--info 框字体颜色（默认为black）-->
| info-s        = <!--info 框以点数为单位的文字大小（默认为8）-->
| info-p        = <!--info 的储存格留白值（默认为0 4px 0 4px）-->
| info-lh       = <!--info 框的行高度（默认为1.25em）-->
| info-op       = <!--info 框的其它CSS参数-->
| nocat         = <!--屏蔽页面分类（默认为false）-->
| usercategory  = <!--用户分类（可选）-->
| usercategory2 = <!--用户分类（可选）-->
| usercategory3 = <!--用户分类（可选）-->
}}

• 所有参数都是可选的。
• 图片应该被缩放至45x45px或者更小。

多数基于HTML的表只使用下列少数特性中的一个。下列的代码可用来快速把一个HTML用户框转换为要使用的格式：

{{userbox
| border-c      = 
| info-c        = 
| id-c          = 
| id-fc         = 
| id-s          = 
| id            = 
| info-fc       = 
| info-lh       = 
| info-s        = 
| info          = 
| nocat         = {{{nocat|}}}
| usercategory  = 
}}

示例

代码	效果
{{userbox}}	id info
{{userbox | id = foo | id-s = 20 | id-c = #ffffee | info = ''foo bar'' | info-c = #ffeeff | info-s = 12 | border-c = #aaffaa | border-s = 2 }}	foo foo bar
下面的示例展示了用户框的默认外观，它的高度大于45px。对比下面和上面之间的用户框。
{{userbox | id = foo logo | id-c = #ffffee | info = ''我们正在尝试查看默认行距以及列内容、边框之间的默认距离，以及整个用户框的默认高度。'' | info-c = #ffeeff | border-c = #aaffaa | border-s = 2 }}	foo logo 我们正在尝试查看默认行距以及列内容、边框之间的默认距离，以及整个用户框的默认高度。
下面的示例显示了如何改变定义了几个参数以降低用户框的高度至推荐高度45px的带有4行文字的用户框。列间距参数“info-p”可以设置为“1pt 1pt 1pt 2pt”，也可以为“1pt 2pt”显示4行文字以获得最佳效果。
{{userbox | id = foo logo | id-s = 14 | id-c = #ffffee | id-lh = 1.1em | info = ''我们已经指定了减少行距的值和列内容间、边框之间的间距的值。'' | info-c = #ffeeff | info-s = 8 | info-p = 1pt | info-lh = 1.05em | border-c = #aaffaa | border-s = 1 }}	foo logo 我们已经指定了减少行距的值和列内容间、边框之间的间距的值。
下面的示例面向高级用户。此示例显示了如何定义其它的CSS参数，例如定义“font-family”来更改用户框的字体，定义“text-decoration”来更改文本修饰。右下方有2个用户框：上面一个没有带“font-family”和“text-decoration”参数，下面的那个则使用了如下所示的借助了“info-op”字段的代码。
{{userbox | id = foo logo | id-s = 14 | id-c = #ffe | id-lh = 1.1em | info = foo bar | info-c = #fef | info-s = 14 | info-op = font-family: 'Courier New'; text-decoration: overline; | border-c = #afa | border-s = 2 }}	foo logo foo bar   foo logo foo bar

微格式

bodyclass：此参数的值会被插入到整个用户框的“class”特性中。

info-class：此参数的值会被插入到info组件的“class”特性中。

此模板支持附加的微格式信息。这是通过向不同的数据列插入“class”特性来完成的，指示出应包含何种信息。例如，要标记一个含有关于一个人的hCard信息用户框，需要添加下列参数：

| bodyclass     = vcard

或

| info-class    = vcard

然后（示例）：

| title         = ...the books of <span class="fn">[[Iain Banks]]</span>

...以及添加其它用户需要的参数。