模板:Userbox/doc

本模板可以快速创建在用户的用户页显示的用户框，创建者不需要了解HTML或wiki表格语法。

使用

结构

用户框结构是这样的：

id区域info区域

参数

完整参数：

{{Userbox
  | bodyclass = <!-- 作用于整个HTML表格的HTML类，用来样式化、标记微格式等。 -->
  | border-c = <!-- 边框颜色, 默认为id-c或#999999 -->
  | border-s = <!-- 边框宽度, 单位为像素 (px) -->
  | float = <!-- left|right|none, 默认为left -->
  | id = <!-- id图像或文本 (图像大小正常情况下不应超过90×45px) -->
  | id-a = <!-- id区域的内容在水平方向上的对齐 (left|center|right|justify), 默认为left -->
  | id-c = <!-- id区域背景色, 默认为#dddddd -->
  | id-fc = <!-- id区域文本颜色, 默认为info-fc或黑色 -->
  | id-h = <!-- id区域高度, 单位为像素, 默认为45px -->
  | id-lh = <!-- id区域行高, 默认为1.25em -->
  | id-op = <!-- id区域的其他CSS参数 -->
  | id-p = <!-- id区域内边距, 默认为 0 1px 0 0 -->
  | id-s = <!-- id区域文本大小, 单位为点 (point), 默认为14 -->
  | id-w = <!-- id区域宽度 -->
  | info-class = <!-- 作用于“info”HTML表格行的HTML类, 用来样式化、标记微格式等。 -->
  | info = <!-- info文本或图像 -->
  | info-a = <!-- info区域内容在水平方向上的对齐 (left|center|right|justify), 默认为left -->
  | info-c = <!-- info区域背景色, 默认为#eeeeee -->
  | info-fc = <!-- info区域文本颜色, 默认为黑色 -->
  | info-lh = <!-- info区域行高, 默认为1.25em -->
  | info-op = <!-- info区域的其他CSS参数 -->
  | info-p = <!-- info区域内边距, 默认为 0 4px 0 4px -->
  | info-s = <!-- info区域文本大小, 单位为点 (point), 默认为8 -->
  | nocat = <!-- 禁用用户框的页面分类, 默认为false (会分类) -->
  | usercategory = <!-- 使用此用户框的用户的分类, 没有链接和“Category:”部分, 可选 -->
  | usercategory2 = <!-- 用户分类, 可选 -->
  | usercategory3 = <!-- 用户分类, 可选 -->
  | usercategory4 = <!-- 用户分类, 可选 -->
  | usercategory5 = <!-- 用户分类, 可选 -->
}}

• 所有参数都是可选项。
• 图像应缩放至x45px或更小。

多数情况下，用户框只会使用一小部分参数。下面是一些常用参数：

{{Userbox
  | border-c = 
  | id       = 
  | id-c     = 
  | id-fc    = 
  | id-s     = 
  | info     = 
  | info-c   = 
  | info-fc  = 
  | info-lh  = 
  | info-s   = 
}}

示例

基本的用户框：

源代码	显示
{{Userbox | border-c = #aaffaa | border-s = 2 | id = foo | id-c = #ffffee | id-s = 20 | info = foo bar | info-c = #ffeeff | info-s = 12 }}	foofoo bar

下面这个用户框（大大）高于45px，比较上下两个用户框的大小：

源代码	显示
{{userbox | border-c = #aaffaa | border-s = 2 | id = foo logo | id-c = #ffffee | info = 尝试查看文本行间的默认距离、单元格内容和边框的默认距离和总高度。''这里放些占位符，以及占位符，并且只有占位符。'' | info-c = #ffeeff }}	foo logo尝试查看文本行间的默认距离、单元格内容和边框的默认距离和总高度。这里放些占位符，以及占位符，并且只是占位符。

高度可以通过指定像行高和内边距这样的参数降下来，用户框可以在有4行文本的时候将高度限制在推荐的45px，像这样：

源代码	显示
{{Userbox | border-c = #aaffaa | border-s = 1 | id = foo logo | id-c = #ffffee | id-lh = 1.1em | id-s = 14 | info = 我们指定了几个值来缩小文本间距和单元格内容和边框之间的内边距。''这里放些占位符，以及占位符，并且只是占位符。'' | info-c = #ffeeff | info-lh = 1.05em | info-p = 1pt | info-s = 8 }}	foo logo我们指定了几个值来缩小文本间距和单元格内容和边框之间的内边距。这里放些占位符，以及占位符，并且只是占位符。

下面的示例适用于高级用户，展示了如何指定其他CSS属性，例如“font-family”用来更改字体、“text-decoration”用来在文本周围添加线条。下方右侧是两个用户框：上面的没有任何复制参数，左侧的代码显示底部的用户框（通过使用info-op参数）：

源代码	显示
{{Userbox | border-c = #afa | border-s = 2 | id = foo logo | id-c = #ffe | id-lh = 1.1em | id-s = 14 | info = foo bar | info-c = #fef | info-op = font-family: "Consolas", "Courier New", monospace; text-decoration: wavy overline green; | info-s = 14 }}	foo logofoo bar foo logofoo bar

一个正常的用户框：

这位用户是加狗主义者。  

微格式

嘛，基本上不会用到。

bodyclass

该参数作为一个整体插入到用户框的“class”属性中。

info-class

该参数作为一个整体插入到info区域的“class”属性中。

此模板支持添加微格式信息。这是通过向各种数据单元添加“class”属性来实现的，这些属性指示了其中包含的信息类型。例如，要将用户框标记为包含关于某人的hCard信息，请添加以下参数：

| bodyclass = vcard

或

| infoclass = vcard

然后（作为示例）：

| title = …<span class="fn">[[wikipedia:zh:伊恩·M.班克斯|伊恩·M.班克斯]]</span>的书。

等等。

提醒

用户框设定上只能用在用户（User:）命名空间里，在主命名空间使用会使页面被分类至Category:含有位于错误命名空间的模板的页面。

用户框默认靠左浮动，这会使得主内容文本显示在它的右侧，可以通过调整float属性或使用{{Clear}}模板来改变显示情况：

源代码	显示
{{Userbox | id = A | info = 用户框A }} {{Userbox | id = B | info = 用户框B }} {{Userbox | id = C | info = 用户框C }} {{Userbox | id = D | info = 用户框D }} {{Lorem_ipsum}} <!-- 生成占位文本的模板 -->	A用户框A B用户框B C用户框C D用户框D Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
{{Userbox | float = none <!-- 取消浮动 --> | id = A | info = 用户框A }} {{Userbox | float = none | id = B | info = 用户框B }} {{Userbox | float = none | id = C | info = 用户框C }} {{Userbox | float = none | id = D | info = 用户框D }} {{Lorem_ipsum}}	A用户框A B用户框B C用户框C D用户框D Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
{{Userbox | float = right <!-- 靠右浮动 --> | id = A | info = 用户框A }} {{Userbox | float = right | id = B | info = 用户框B }} {{Userbox | float = right | id = C | info = 用户框C }} {{Userbox | float = right | id = D | info = 用户框D }} {{Lorem_ipsum}}	A用户框A B用户框B C用户框C D用户框D Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
{{Userbox | id = A | info = 用户框A }} {{Userbox | id = B | info = 用户框B }} {{Userbox | id = C | info = 用户框C }} {{Userbox | id = D | info = 用户框D }} {{Clear}} <!-- 直接用Clear模板也行 --> {{Lorem_ipsum}}	A用户框A B用户框B C用户框C D用户框D Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

一组用户框可以套在<div>…</div>里面来统一添加外边距、调整浮动等：

源代码

显示

<div style="float: right; margin-left: 1em;"> <!-- 1em的左外边距、靠右浮动 --> {{Userbox | float = none <!-- 必须取消用户框的浮动 --> | id = A | info = 用户框A }} {{Userbox | float = none | id = B | info = 用户框B }} {{Userbox | float = none | id = C | info = 用户框C }} {{Userbox | float = none | id = D | info = 用户框D }} </div> {{Lorem_ipsum}}

A用户框A B用户框B C用户框C D用户框D Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

参见

其他用户框元模板：

• {{Userbox-r}} — id区域位于右侧。
• {{Userbox-2}} — 有左右两个id区域。

Category:用户框 — 所有用户框。