跳转到内容

Template:Userbox/doc

本页使用了标题或全文手工转换
维基百科,自由的百科全书

模板介紹

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

 
foo logofoo bar

模板数据

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

Userbox模板数据

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

模板参数

参数描述类型状态
bodyclassbodyclass

自訂HTML Class參數

默认值
id-c
字符串可选
border-cborder-c

邊框色彩

字符串可选
border-sborder-s

邊框像素大小

默认值
1
字符串可选
floatfloat

流動對齊方式 left|right|none

默认值
left
字符串可选
idid

id 圖片或文字(選用)

默认值
x45px
字符串可选
id-aid-a

id 水平對齊方式 left/center/right/justify

默认值
center
字符串可选
id-cid-c

id 的背景色彩

默认值
#d0d0d0
字符串可选
id-fcid-fc

id 的文字色彩

默认值
black
字符串可选
id-hid-h

id 框的像素大小

默认值
45
字符串可选
id-lhid-lh

id 行高

默认值
1em
字符串可选
id-opid-op

id 的其他 CSS 參數

字符串可选
id-pid-p

id 的儲存格留白值

默认值
0 1px 0 0
字符串可选
id-sid-s

id 文字點數

默认值
14
字符串可选
id-wid-w

id 框長度,單位是像素

默认值
45
字符串可选
info-classinfo-class

Adds an HTML class attribute to the &ldquo;info&rdquo; HTML table-row, to allow for styling, emission of microformats, etc.

字符串可选
infoinfo

info 框圖文內容

字符串可选
info-ainfo-a

info 框水平對齊方式 left/center/right/justify

默认值
left
字符串可选
info-cinfo-c

info 框背景色

默认值
#e0e0e0
字符串可选
info-fcinfo-fc

info 框文字色彩

默认值
black
字符串可选
info-lhinfo-lh

info 框行高

默认值
1.25em
字符串可选
info-opinfo-op

info 框的其他CSS樣式參數

字符串可选
info-pinfo-p

info 框的留白值

默认值
0 4px 0 4px
字符串可选
info-sinfo-s

info 文字點數

默认值
8
字符串可选
nocatnocat

屏蔽頁面分類

默认值
false
字符串可选
usercategoryusercategory

使用者自設分類(選用)

字符串可选
usercategory2usercategory2

使用者自設分類(選用)

字符串可选
usercategory3usercategory3

使用者自設分類(選用)

字符串可选

重定向

参见

微格式

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:

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