Template:View: Difference between revisions
I've been cleaning up the various uses of this template recently, and I think having this as a "shortcut" for Template:Navbar makes more sense. |
(No difference)
|
Revision as of 13:33, 17 April 2018
 | This template uses Lua: |
{{Navbar}}'s extremely high use rate and consequent protection level are because it is integrated as a feature into numerous navigation box and infobox templates used in millions of articles. It is also a regular feature of many internal-use templates and tables of the Wikipedia, Help, and Template namespaces.
Usage
General
When one of the following examples is placed inside a given template (or block of content used for selective transclusion), it adds basic navbar navigational functionality:
{{navbar|{{subst:PAGENAME}}|mini=y}}{{navbar|{{subst:PAGENAME}}|plain=y}}{{navbar|{{subst:PAGENAME}}|fontstyle=color: green; font-style: italic;}}
The {{subst:PAGENAME}} will be substituted with the page name of the real location of the content when parsed by the servers. For example, {{navbar|Navbar/doc}} gives:
· <span style="" title="<translate nowrap> Edit this template</translate>"><translate> edit</translate>
When used in content that is selectively transcluded but which is also used as-is in its original location, this template should be wrapped in <includeonly>...</includeonly> markup, so that it only appears when transcluded.
Font size and weight
Font-size is 88% when used in a topical navbar template or in plain text, and 100% when nested in a navbox or infobox (because those templates' text size is already reduced; the "100%" is relative to the surrounding template's own content, not that of the entire page). 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). Do not abuse this to make excessively small text (i.e. less than 85% of the normal page text), since that causes for many readers.
In a topical navbar, the weight is "normal"; when nested in a navbox or infobox, it inherits the style of the surrounding content. The middot bullets are bold for better visibility.
Block level element
The template generates block-level markup with <div>...</div> tags, and therefore, any surrounding markup cannot include <span>...</span> tags, which would cause a div-span-flip lint error.
Examples
Required parameters
{{navbar|Template Name}}– the template name is required.
Optional parameters
Note that to show the history, move, and watchlist links, |template= needs to be set to the template value specifically. Individual values can be left out of this list, e.g. {{navbar|template=Template Name|h|m|w}} will only show the view, history, move, and watchlist links.
Shortcut templates
The mini=y and plain=y parameters can be avoided by using the {{v}} or {{view}} templates, respectively, instead.
{{view}} and {{v}} also support changing the shown links, for example only view and edit, or only view and talk:
| Code | Result |
|---|---|
| template=view/doc}} | |
| template=view/doc|talk}} | |
| template=view/doc|talk|edit}} | |
| template=v/doc}} | |
| template=v/doc|t}} | |
| template=v/doc|t|e}} |
Notes
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
- {{Navbar-header}}
- Positions · <span style="" title="<translate nowrap> Edit this template</translate>"><translate> e</translate> on the right edge of the line, often used in non-collapsible navbox heading.
- {{Navbar-collapsible}}
- For use in conjunction with collapsible tables, floats · <span style="" title="<translate nowrap> Edit this template</translate>"><translate> e</translate> opposite of the [hide]/[show] feature.
See also
- {{Ed}} — plain-style edit link surrounded by <small> tags, specifically for templates only
- {{Ed right}} — plain-style edit link surrounded by <small> tags and aligned to right of page, specifically for templates only
- {{Edit}} — plain-style edit link, applicable to all Wikipedia namespaces
- {{Edit section}} — edit link surrounded by <div> tags by default which can specify which section to edit on a page, applicable to all Wikipedia namespaces
- {{Vedit}} — plain-style edit link which edit with the Wikipedia:VisualEditor, applicable to all Wikipedia namespaces
Templates with view, talk and edit links:
- {{Navbar}} — navigation bar with configurable caption and view·talk·edit links, specifically for templates only
- {{View}} — navbar-style view·talk·edit links, specifically for templates only
- {{VTE}} & {{V}} — navbar-style V·T·E links (i.e. view·talk·edit links in short forms), specifically for templates only
Other internal link templates, including:
- {{Talk}} – plain talk link
- {{Watch}} – plain link that adds the page to your watchlist
- Category:Internal template-link templates
| Template | Collapsible | Header color | Image | Groups | Style (body) parameter/s |
|---|---|---|---|---|---|
| {{Navbox}} | collapsible | navbox | Left/right of body | Yes | Yes |
| {{Navbox with collapsible groups}} | collapsible | navbox | Left/right of body and/or in each list | Yes | Yes |
| {{Navbox with columns}} | collapsible | navbox | Left/right of columns | No | Yes |
| Type | CSS classes | JavaScript | Collapses when | Custom initial state |
Nesting |
|---|---|---|---|---|---|
| Collapsible tables | mw-collapsible | Defined in Common.js | 2 or more autocollapse on page | Yes | Yes |
TemplateData
TemplateData for View
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 |