Template:Wp/khw/Navbar/doc
| This is a documentation subpage for Template:Wp/khw/Navbar. It contains usage information, categories and other content that is not part of the original template page. |
| Uses Lua: |
Usage
[edit source]General
[edit source]When one of the following examples is placed inside a given template, it adds navbar navigational functionality:
{{Wp/khw/Navbar|{{subst:PAGENAME}}|mini=y}}{{Wp/khw/Navbar|{{subst:PAGENAME}}|plain=y}}{{Wp/khw/Navbar|{{subst:PAGENAME}}|fontstyle=color: green; font-style: italic;}}
The {{subst:PAGENAME}} will be substituted with the template's name when parsed by the servers. For example, {{Wp/khw/Navbar|Navbar/doc}} gives:
Font-size
[edit source]Font-size is 88% when used in a navbar, and 100% when nested in a navbox.
In the navbar, the weight is "normal"; when nested in navbox, it takes on the outer setting. The middot is bold. The |fontstyle= parameter can be used to adjust font size as needed (e.g. to reduce font size even more when the template is used inside a block element with a large font size).
Examples
[edit source]Required parameters
[edit source]{{Wp/khw/Navbar|Template Name}}– the template name is required.
Optional parameters
[edit source]| Options | Parameters | Produces... | "Shortcut" template |
|---|---|---|---|
| Basic | {{Wp/khw/Navbar|Template Name}} | ||
| Different text | {{Wp/khw/Navbar|Template Name|text=This template:}} | ||
| Without "This box:" text | {{Wp/khw/Navbar|Template Name|plain=y}} | {{Wp/khw/view}} | |
| Short version | {{Wp/khw/Navbar|Template Name|mini=y}} | {{Wp/khw/v}} | |
| With brackets | {{Wp/khw/Navbar|Template Name|brackets=y}} | ||
| With font styling examples (span) | {{Wp/khw/Navbar|Template Name|fontstyle=color: green; font-style: italic;}} | ||
| With whole-template styling examples (Wp/khw/div) | {{Wp/khw/Navbar|Template Name|style=float:right; background: Beige; padding: 5px; border: 1px solid;}} |
Shortcut templates
[edit source]The mini=y and plain=y parameters can be avoided by using the {{Wp/khw/v}} or {{Wp/khw/view}} templates, respectively, instead.
{{Wp/khw/view}} and {{Wp/khw/v}} also support changing the shown links, for example only view and edit, or only view and talk:
| Code | Result |
|---|---|
{{Wp/khw/view|template=Wp/khw/view/doc|edit}} | |
{{Wp/khw/v|template=Wp/khw/v/doc|t}} |
Notes
[edit source]Navbar is contained within a <div>...</div> in order to accommodate a horizontal unnumbered list. This means it cannot be placed inside a <span>...</span> or other inline element, because the HTML Tidy extension will 'fix' situations where it finds block elements inside inline elements.
Prepackaged
[edit source]- {{Wp/khw/Navbar-header}}
- Positions on the right edge of the line, often used in non-collapsible navbox heading.
- {{Wp/khw/Navbar-navframe}}
- For use in conjunction with NavFrame divs, positions opposite of the [hide]/[show] feature.
- {{Wp/khw/Navbar-collapsible}}
- For use in conjunction with Wp/khw/Collapsible tables, floats opposite of the [hide]/[show] feature.
See also
[edit source]- {{Wp/khw/Ed}} – navbar style edit link
- {{Wp/khw/Ed right}} – navbar style edit link aligned to right of page
- {{Wp/khw/Edit}} – plain edit link
- {{Wp/khw/Edit section}} – edit link aligned to right of page
- {{Wp/khw/Edit sup}} – edit link with <sup> tags
- {{Wp/khw/Edit sub}} – edit link with <sub> tags
- {{Wp/khw/Navbar}} – with additional links
- {{Wp/khw/Vedit}} – edit with the Visual Editor
- {{Wp/khw/Watch}}
| Collapsible | Header color | Image | Groups | Style (body) parameter/s | Examples | |
|---|---|---|---|---|---|---|
| {{Wp/khw/Navbox}} | collapsible | navbox | Left/right of body | Yes | Yes | |
| {{Wp/khw/Navbox with collapsible groups}} | collapsible | navbox | Left/right of body and/or in each list | Yes | Yes |
|
| {{Wp/khw/Navbox with columns}} | collapsible | navbox | Left/right of columns | No | Yes |
| Type | CSS classes | JavaScript | Collapses when | Custom initial state | Nesting |
|---|---|---|---|---|---|
| Collapsible tables | collapsible | Defined in Common.js | 2 or more autocollapse on page | Yes | Yes |
TemplateData
[edit source]TemplateData for Wp/khw/Navbar
When placed inside a given template, it adds navbar navigational functionality
| Parameter | Description | Type | Status | |
|---|---|---|---|---|
| Template Name | 1 | The name of the template, so links work correctly
| String | required |
| Different text | text | Allows custom text to replace the default 'this box'
| String | optional |
| Without 'This box:' text | plain | Removes 'This box'
| Number | optional |
| Short Version | mini | Shortens text to V T E
| Number | optional |
| with brackets | brackets | adds brackets before and after the links
| Number | optional |
| Font color | fontstyle | Allows you to change the color of the font (in the format color:green)
| String | optional |
| To float to the side | style | Allows the template to float to the side (format=float:right)
| String | optional |