Template:Userbox

{{{info}}}

此模板使用Lua语言：

Module:Userbox

此Template被引用於約32,000個頁面。
為了避免造成大規模的影響，所有對此Template的編輯應先於沙盒、測試樣例或您的沙盒上測試。
測試後無誤的版本可以一次性地加入此Template中，但是修改前請務必於討論頁發起討論。

模板引用數量會自動更新。

此模板的文档不存在、不全面或不能详细描述其功能及/或其代码中的参数。请帮助扩充并改进其文档。

模板介紹

本模板適用於建置用戶框，提供使用者在用戶頁面顯示使用者的一些資訊，以免於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}}

{{{info}}}

{{Userbox
|border-c = #aaffaa
|border-s = 2
|id       = foo
|id-c     = #ffffee
|id-s     = 20
|info     = ''foo bar''
|info-c   = #ffeeff
|info-s   = 12
}}

foo

foo bar

以下展示高度超过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
}}

foo logo

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.

以下展示怎样能修改用户框并进一步指定参数来降低用户框的高度以达到推荐的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
}}

foo logo

We have specified values to lessen the distance in between text lines & padding space in between cell content and its border.

以下针对高级用户，展示怎样指定其他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
}}

foo logo

foo bar

foo logo

foo bar

模板数据

以下是该模板的模板数据，适用于可视化编辑器等工具。

Userbox模板数据

本模板適用於建置用戶框，提供使用者在用戶頁面顯示使用者的一些資訊，以免於HTML與Wikitable參數的麻煩。

模板参数[编辑模板数据]
参数		描述	类型	状态
bodyclass	`bodyclass`	自訂HTML Class參數默认值 id-c	字符串	可选
border-c	`border-c`	邊框色彩	字符串	可选
border-s	`border-s`	邊框像素大小默认值 1	字符串	可选
float	`float`	流動對齊方式 left\|right\|none 默认值 left	字符串	可选
id	`id`	id 圖片或文字（選用）默认值 x45px	字符串	可选
id-a	`id-a`	id 水平對齊方式 left/center/right/justify 默认值 center	字符串	可选
id-c	`id-c`	id 的背景色彩默认值 #d0d0d0	字符串	可选
id-fc	`id-fc`	id 的文字色彩默认值 black	字符串	可选
id-h	`id-h`	id 框的像素大小默认值 45	字符串	可选
id-lh	`id-lh`	id 行高默认值 1em	字符串	可选
id-op	`id-op`	id 的其他 CSS 參數	字符串	可选
id-p	`id-p`	id 的儲存格留白值默认值 0 1px 0 0	字符串	可选
id-s	`id-s`	id 文字點數默认值 14	字符串	可选
id-w	`id-w`	id 框長度，單位是像素默认值 45	字符串	可选
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 默认值 left	字符串	可选
info-c	`info-c`	info 框背景色默认值 #e0e0e0	字符串	可选
info-fc	`info-fc`	info 框文字色彩默认值 black	字符串	可选
info-lh	`info-lh`	info 框行高默认值 1.25em	字符串	可选
info-op	`info-op`	info 框的其他CSS樣式參數	字符串	可选
info-p	`info-p`	info 框的留白值默认值 0 4px 0 4px	字符串	可选
info-s	`info-s`	info 文字點數默认值 8	字符串	可选
nocat	`nocat`	屏蔽頁面分類默认值 false	字符串	可选
usercategory	`usercategory`	使用者自設分類（選用）	字符串	可选
usercategory2	`usercategory2`	使用者自設分類（選用）	字符串	可选
usercategory3	`usercategory3`	使用者自設分類（選用）	字符串	可选

重定向

{{用户框}}：中文名重定向。
{{User box}}、{{User Box}}：为便于在{{Userboxes}}中引用而创建的重定向。

参见

维基百科:用户框
{{Userbox-2}}：左右两边都有id区的用户框。
{{Userbox-r}}：右边有id区的用户框。
{{Userbox-m}}：只有id区的用户框。
网页颜色

微格式

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)

有關微格式的參數設置，請參考微格式專題。

上述文档嵌入自Template:Userbox/doc。
编者可以在本模板的沙盒和测试样例页面进行实验。
请在/doc子页面中添加分类。本模板的子页面。