Template:Userbox/doc
此頁面是Template:Userbox的Template文档。 此頁面可能包含了模板的使用說明、分類和其他内容。 |
此模板使用Lua语言: |
此Template文档被引用於約31,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}} |
| |||||
{{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)
有關微格式的參數設置,請參考微格式專題。