模板:Userbox/doc
![]() | 此页面是Template:Userbox的模板文档。 此页面可能包含了模板的使用说明、分类和其他内容。 |
![]() | 此模板使用Lua语言: |
![]() | 此模板文档被引用于约31,000个页面。 为了避免造成大规模的影响,所有对此模板文档的编辑应先于沙盒、测试样例或您的沙盒上测试。 测试后无误的版本可以一次性地加入此模板文档中,但是修改前请务必于讨论页发起讨论。 模板引用数量会自动更新。 |
![]() | 此模板的文档不存在、不全面或不能详细描述其功能及/或其代码中的参数。请帮助扩充并改进其文档。 |
模板介绍
编辑本模板适用于建置用户框,提供使用者在用户页面显示使用者的一些资讯,以免于HTML与Wikitable参数的麻烦。
合理使用图像不得用于用户框,任何使用者可在不经对方同意下,移除相关图片。
使用方式
编辑{{Userbox |bodyclass = <!--自订HTML Class参数--> |border-c = <!--边框色彩 (预设与 id-c 之参数相同)--> |border-s = <!--边框像素大小 (预设值:1)--> |float = <!--流动对齐方式 left|right|none (预设值:left)--> |id = <!--id 图片或文字(选用,预设尺寸是x45px)--> |id-a = <!--id 水平对齐方式 left/center/right/justify (预设:center)--> |id-c = <!--id 的背景色彩 (预设:#d0d0d0)--> |id-fc = <!--id 的文字色彩 (预设:black)--> |id-h = <!--id 框的像素大小 (预设:45)--> |id-lh = <!--id 行高 (预设:1em)--> |id-op = <!--id 的其他 CSS 参数--> |id-p = <!--id 的储存格留白值 (预设:0 1px 0 0)--> |id-s = <!--id 文字点数 (预设:14)--> |id-w = <!--id 框长度 (预设:45)--> |info-class = <!--Adds an HTML class attribute to the "info" HTML table-row, to allow for styling, emission of microformats, etc.--> |info = <!--info 框图文内容--> |info-a = <!--info 框水平对齐方式 left/center/right/justify (预设:left)--> |info-c = <!--info 框背景色 (预设:#e0e0e0)--> |info-fc = <!--info 框文字色彩 (预设:black)--> |info-lh = <!--info 框行高 (预设:1.25em)--> |info-op = <!--info 框的其他CSS样式参数--> |info-p = <!--info 框的留白值 (预设:0 4px 0 4px)--> |info-s = <!--info 文字点数 (预设:8)--> |nocat = <!--屏蔽页面分类 (预设:false)--> |usercategory = <!--使用者自设分类(选用)--> |usercategory2 = <!--使用者自设分类(选用)--> |usercategory3 = <!--使用者自设分类(选用)--> }}
- 全部参数皆为选填
- 图像建议少于45px
多数基于HTML的表格仅用这些参数的一小部分。以下子集可以用来把HTML用户框快速转换成这里所用的格式:
{{Userbox |border-c = |id = |id-c = |id-fc = |id-s = |info = |info-c = |info-fc = |info-lh = |info-s = |nocat = {{{nocat|}}} |usercategory = }}
范例
编辑代码 | 效果 | |||||
---|---|---|---|---|---|---|
{{Userbox}} |
| |||||
{{Userbox |border-c = #aaffaa |border-s = 2 |id = foo |id-c = #ffffee |id-s = 20 |info = ''foo bar'' |info-c = #ffeeff |info-s = 12 }} |
| |||||
以下展示高度超过45px的用户框的默认外观,比较一下上下两个用户框的差异。 | ||||||
{{Userbox |border-c = #aaffaa |border-s = 2 |id = foo logo |id-c = #ffffee |info = ''We are trying to see default distance in between text lines, see the distance in between cell content and its border, and also see total height.'' |info-c = #ffeeff }} |
| |||||
以下展示怎样能修改用户框并进一步指定参数来降低用户框的高度以达到推荐的45px,即使有四行文字。在四行文字之下,单元格边距参数info-p也可以设置成1pt 1pt 1pt 2pt,或者1pt 2pt以达到更好的效果。 | ||||||
{{Userbox |border-c = #aaffaa |border-s = 1 |id = foo logo |id-c = #ffffee |id-lh = 1.1em |id-s = 14 |info = ''We have specified values to lessen the distance in between text lines & padding space in between cell content and its border.'' |info-c = #ffeeff |info-lh = 1.05em |info-p = 1pt |info-s = 8 }} |
| |||||
以下针对高级用户,展示怎样指定其他CSS属性,例如,font-family调整字体,text-align从默认参数调整对齐方式。如下所示,右边是2个用户框:上面一个是不带font-family或text-align参数;下面一个是以填写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:'Courier New'; text-align:center; |info-s = 14 }} |
|
模板数据
编辑本模板适用于建置用户框,提供使用者在用户页面显示使用者的一些资讯,以免于HTML与Wikitable参数的麻烦。
参数 | 描述 | 类型 | 状态 | |
---|---|---|---|---|
bodyclass | bodyclass | 自订HTML Class参数
| 字符串 | 可选 |
border-c | border-c | 边框色彩 | 字符串 | 可选 |
border-s | border-s | 边框像素大小
| 字符串 | 可选 |
float | float | 流动对齐方式 left|right|none
| 字符串 | 可选 |
id | id | id 图片或文字(选用)
| 字符串 | 可选 |
id-a | id-a | id 水平对齐方式 left/center/right/justify
| 字符串 | 可选 |
id-c | id-c | id 的背景色彩
| 字符串 | 可选 |
id-fc | id-fc | id 的文字色彩
| 字符串 | 可选 |
id-h | id-h | id 框的像素大小
| 字符串 | 可选 |
id-lh | id-lh | id 行高
| 字符串 | 可选 |
id-op | id-op | id 的其他 CSS 参数 | 字符串 | 可选 |
id-p | id-p | id 的储存格留白值
| 字符串 | 可选 |
id-s | id-s | id 文字点数
| 字符串 | 可选 |
id-w | id-w | id 框长度,单位是像素
| 字符串 | 可选 |
info-class | info-class | Adds an HTML class attribute to the “info” HTML table-row, to allow for styling, emission of microformats, etc. | 字符串 | 可选 |
info | info | info 框图文内容 | 字符串 | 可选 |
info-a | info-a | info 框水平对齐方式 left/center/right/justify
| 字符串 | 可选 |
info-c | info-c | info 框背景色
| 字符串 | 可选 |
info-fc | info-fc | info 框文字色彩
| 字符串 | 可选 |
info-lh | info-lh | info 框行高
| 字符串 | 可选 |
info-op | info-op | info 框的其他CSS样式参数 | 字符串 | 可选 |
info-p | info-p | info 框的留白值
| 字符串 | 可选 |
info-s | info-s | info 文字点数
| 字符串 | 可选 |
nocat | nocat | 屏蔽页面分类
| 字符串 | 可选 |
usercategory | usercategory | 使用者自设分类(选用) | 字符串 | 可选 |
usercategory2 | usercategory2 | 使用者自设分类(选用) | 字符串 | 可选 |
usercategory3 | usercategory3 | 使用者自设分类(选用) | 字符串 | 可选 |
重定向
编辑参见
编辑微格式
编辑- bodyclass
- This parameter is inserted into the "class" attribute for the userbox as a whole.
- info-class
- This parameter is inserted into the "class" attribute for the info component.
This template supports the addition of microformat information.[翻译请求] This is done by adding "class" attributes to various data cells, indicating what kind of information is contained within. To flag a userbox as containing hCard information about a person, for example, add the following parameter:
|bodyclass = vcard
or
|info-class = vcard
then (for example):
|title = ... the books of <span class="fn">[[Iain Banks]]</span>
... and so forth.
Examples include:
- en:User:UBX/Iain Banks - person
- en:Template:User Microformats - group (WikiProject Microformats)
- en:Template:User Brum - place (Birmingham)
有关微格式的参数设置,请参考微格式专题。