Qinyongr：导入1个版本：Userbox from zhwp

2016-06-11T15:55:05Z

导入1个版本：Userbox from zhwp

新页面

<includeonly></includeonly><noinclude>{{template doc page viewed directly}}</noinclude>

{{lua|Module:Userbox}}
== 模板介紹 ==
本模板適用於建置[[wikipedia:用戶框|用戶框]]，提供使用者在用戶頁面顯示使用者的一些資訊，以免於HTML與Wikitable參數的麻煩。

'''''[[WP:NFCC|合理使用圖像]]不得用於用戶框，任何使用者可在不經對方同意下，移除相關圖片。'''''

== 使用方式 ==

<pre style="overflow: auto">-{}-
{{userbox
| bodyclass = 
| border-c = 
| border-s = 
| float = 
| id = 
| id-a = 
| id-c = 
| id-fc = 
| id-h = 
| id-lh = 
| id-op = 
| id-p = 
| id-s = 
| id-w = 
| info-class = 
| info = 
| info-a = 
| info-c = 
| info-fc = 
| info-lh = 
| info-op = 
| info-p = 
| info-s = 
| nocat = 
| usercategory = 
| usercategory2 = 
| usercategory3 = 
}}
</pre>
* 全部參數皆為選填
* 圖像建議少於45px


多数基于HTML的表格仅用这些参数的一小部分。以下子集可以用来把HTML用户框快速转换成这里所用的格式：

<pre>
{{userbox
| border-c =
| id =
| id-c =
| id-fc =
| id-s =
| info =
| info-c =
| info-fc =
| info-lh =
| info-s =
| nocat = {{{nocat|}}}
| usercategory =
}}
</pre>

== 範例 ==
{|
!style="width: 300px;"| 代码
!效果
|-
| <pre>{{userbox}}</pre> || {{userbox}}
|-
| <pre>{{userbox
| border-c = #aaffaa
| border-s = 2
| id = foo
| id-c = #ffffee
| id-s = 20
| info = ''foo bar''
| info-c = #ffeeff
| info-s = 12
}}</pre> || {{userbox|id=foo|id-s=20|id-c=#ffffee|info=''foo bar''|info-c=#ffeeff|info-s=12|border-c=#aaffaa|border-s=2}}
|-
| colspan="2"| 以下展示高度超过45px的用户框的默认外观，比较一下上下两个用户框的差异。
|-
| <pre>{{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
}}</pre> || {{userbox|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|border-c=#aaffaa|border-s=2}}
|-
| colspan="2"| 以下展示怎样能修改用户框并进一步指定参数来降低用户框的高度以达到推荐的45px，即使有四行文字。在四行文字之下，单元格边距参数info-p也可以设置成1pt 1pt 1pt 2pt，或者1pt 2pt以达到更好的效果。
|-
| <pre>{{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
}}</pre> || {{userbox|id=foo logo|id-s=14|id-lh=1.1em|id-c=#ffffee|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-s=8|info-p=1pt|info-lh=1.05em|border-c=#aaffaa|border-s=1}}
|-
| colspan="2"| 以下针对高级用户，展示怎样指定其他[[CSS]]属性，例如，font-family调整字体，text-align从默认参数调整对齐方式。如下所示，右边是2个用户框：上面一个是不带font-family或text-align参数；下面一个是以填写info-op参数来使用此类代码显示的。
|-
| <pre>{{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
}}</pre> || colspan="2"| {{Userbox|id=foo logo|id-s=14|id-lh=1.1em|id-c=#ffe|info=foo bar|info-c=#fef|info-s=14|border-c=#afa|border-s=2}} <br style="clear:both"> <br /> {{Userbox|id=foo logo|id-s=14|id-lh=1.1em|id-c=#ffe|info=foo bar|info-c=#fef|info-s=14|info-op=font-family:'Courier New'; text-align:center;|border-c=#afa|border-s=2}}
|}

== 模板数据 ==
{{TemplateDataHeader}}

<templatedata>
{
"description": "本模板適用於建置用戶框，提供使用者在用戶頁面顯示使用者的一些資訊，以免於HTML與Wikitable參數的麻煩。",
"params": {
"bodyclass": {
"label": "bodyclass",
"description": "自訂HTML Class參數",
"type": "string",
"default": "id-c"
},
"border-c": {
"label": "border-c",
"description": "邊框色彩",
"type": "string"
},
"border-s": {
"label": "border-s",
"description": "邊框像素大小",
"type": "string",
"default": "1"
},
"float": {
"label": "float",
"description": "流動對齊方式 left|right|none",
"type": "string",
"default": "left"
},
"id": {
"label": "id",
"description": "id 圖片或文字（選用）",
"type": "string",
"default": "x45px"
},
"id-a": {
"label": "id-a",
"description": "id 水平對齊方式 left/center/right/justify",
"type": "string",
"default": "center"
},
"id-c": {
"label": "id-c",
"description": "id 的背景色彩",
"type": "string",
"default": "#d0d0d0"
},
"id-fc": {
"label": "id-fc",
"description": "id 的文字色彩",
"type": "string",
"default": "black"
},
"id-h": {
"label": "id-h",
"description": "id 框的像素大小",
"type": "string",
"default": "45"
},
"id-lh": {
"label": "id-lh",
"description": "id 行高",
"type": "string",
"default": "1em"
},
"id-op": {
"label": "id-op",
"description": "id 的其他 CSS 參數",
"type": "string"
},
"id-p": {
"label": "id-p",
"description": "id 的儲存格留白值",
"type": "string",
"default": "0 1px 0 0"
},
"id-s": {
"label": "id-s",
"description": "id 文字點數",
"type": "string",
"default": "14"
},
"id-w": {
"label": "id-w",
"description": "id 框長度，單位是像素",
"type": "string",
"default": "45"
},
"info-class": {
"label": "info-class",
"description": "Adds an HTML class attribute to the “info” HTML table-row, to allow for styling, emission of microformats, etc.",
"type": "string"
},
"info": {
"label": "info",
"description": "info 框圖文內容",
"type": "string"
},
"info-a": {
"label": "info-a",
"description": "info 框水平對齊方式 left/center/right/justify",
"type": "string",
"default": "left"
},
"info-c": {
"label": "info-c",
"description": "info 框背景色",
"type": "string",
"default": "#e0e0e0"
},
"info-fc": {
"label": "info-fc",
"description": "info 框文字色彩",
"type": "string",
"default": "black"
},
"info-lh": {
"label": "info-lh",
"description": "info 框行高",
"type": "string",
"default": "1.25em"
},
"info-op": {
"label": "info-op",
"description": "info 框的其他CSS樣式參數",
"type": "string"
},
"info-p": {
"label": "info-p",
"description": "info 框的留白值",
"type": "string",
"default": "0 4px 0 4px"
},
"info-s": {
"label": "info-s",
"description": "info 文字點數",
"type": "string",
"default": "9"
},
"nocat": {
"label": "nocat",
"description": "屏蔽頁面分類",
"type": "string",
"default": "false"
},
"usercategory": {
"label": "usercategory",
"description": "使用者自設分類（選用）",
"type": "string"
},
"usercategory2": {
"label": "usercategory2",
"description": "使用者自設分類（選用）",
"type": "string"
},
"usercategory3": {
"label": "usercategory3",
"description": "使用者自設分類（選用）",
"type": "string"
}
}
}
</templatedata>

== 参见 ==
*[[维基百科:用户框]]
*{{tl|userbox-2}}——左右两边都有 id 区的用户框。
*{{tl|userbox-r}}——右边有 id 区的用户框。
*{{tl|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:

<pre>
| bodyclass = vcard
</pre>

''or''

<pre>
| info-class = vcard
</pre>

''then'' (for example):

<pre><nowiki>
| title = …the books of <span class="fn">[[Iain Banks]]</span>
</nowiki></pre>

...and so forth.

Examples include:

* [[:en:User:UBX/Iain Banks]] - person
* [[:en:Template:User Microformats]] - group (WikiProject Microformats)
* [[:en:Template:User Brum]] - place (Birmingham)

有關微格式的參數設置，請參考[[Wikipedia:專題/微格式|微格式專題]]。

<includeonly>

[[Category:用户框模板| ]]
[[Category:维基百科元模板|用戶框]]

</includeonly>

Template:Userbox/doc - 版本历史

Qinyongr：​导入1个版本：Userbox from zhwp

Qinyongr：导入1个版本：Userbox from zhwp