模板: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>

...以及加入其它用户需要的參數。