Template:Userboxtop/doc
![]() | This is a documentation subpage for Template:Userboxtop. It may contain usage information, categories and other content that is not part of the original template page. |
![]() | This template is used on approximately 58,000 pages and changes may be widely noticed. Test changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Consider discussing changes on the talk page before implementing them. |
This template can be used to organize userboxes (or other user-page content) into a single column grouping.
Please do not use this in articles: for historic reasons this template uses different rules for floating alongside other templates and this will lead to unpredictable results. If you need to stack objects in an article for some reason, use {{stack}}. This template will add pages in the main namespace to Category:Articles incorrectly using userbox templates.
Usage
[edit]{{Userboxtop
| toptext =
| toptextstyle =
| align =
| left =
| backgroundcolor =
| bordercolor =
| extra-css =
| textcolor =
}}
{{userboxname1}}
{{userboxname2}}
{{userboxname3}}
{{userboxname4}}
{{...etc}}}
{{Userboxbottom}}
Note that {{Userboxbottom}}
must be separated from the last userbox by a newline. In the absence of a newline, other text on the page may appear inside the confines of the userbox area.
Parameters
[edit]All parameters are optional.
Parameter | Description |
---|---|
toptext
|
(or the first positional parameter) Overrides the default header "Userboxes". Can include wiki-markup. |
toptextstyle
|
Additional CSS code for the toptext .
|
align
|
(or the second positional parameter) left or center or right (default)
|
left
|
Left margin in CSS's ems. Defaults to 1. |
backgroundcolor
|
Any web color (name or #XXXXXX hex format). Defaults to #FFFFFF .
|
bordercolor
|
Any web color (name or #XXXXXX hex format). Defaults to #99B3FF .
|
extra-css
|
Additional CSS code for the box itself. |
textcolor
|
Any web color (name or #XXXXXX hex format). Defaults to #000000 .
|
You may also insert breaks by using {{userboxbreak}}. See that template for details.
Hiding userboxes
[edit]You can hide userboxes which use this (as well as a few other) forms of template-based userbox organization. Simply go to Special:Mypage/skin.css, which redirects to your current skin's CSS file, and add the following:
table.userboxes { display: none; }
Redirects
[edit]- {{BoxTop}}
- {{Boxboxtop}}
- {{Boxtop}}
- {{User box top}}
- {{Userbox top}}
See also
[edit]- {{Userboxbreak}}
- {{Userboxbottom}}
- {{Userboxside}}
- {{Userboxgroup}}
TemplateData
[edit]TemplateData for Userboxtop
This template can be used to organize userboxes (or other user-page content) into a single column grouping. Please do *not* use this in articles. Please see https://en.wikipedia.org/wiki/Template:Userboxtop/doc for full documentation.
Parameter | Description | Type | Status | |
---|---|---|---|---|
Header (toptext) | toptext 1 | Overrides the default header "Userboxes". Can include wiki-markup
| Line | suggested |
Alignment | align 2 | Whether you want your userbox to be left-aligned or right-aligned. Value must be 'left' or 'right'.
| Line | suggested |
Header style (toptextstyle) | toptextstyle | Additional CSS code for the header (toptext). | String | optional |
Text colour | textcolor | Default colour for text within this userbox. Any web color (name or #XXXXXX hex format). Defaults to #000000.
| Line | optional |
Left margin size | left | Left margin size (in CSS ems). Defaults to 1
| Number | optional |
Border colour | bordercolor | Colour for the userbox border. Any web color (name or #XXXXXX hex format). Defaults to #99B3FF.
| Line | optional |
Background colour | backgroundcolor | Background colour for this userbox. Any web color (name or #XXXXXX hex format). Defaults to #FFFFFF.
| Line | optional |
Extra CSS | extra-css | Additional CSS code for the box itself. | String | optional |