Difference between revisions of "Template:View"
en_wp>Primefac (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.) |
m (1 revision imported: This is probably a mistake) |
(No difference)
|
Latest revision as of 16:39, 16 July 2020
This template uses Lua: |
{{Navbar}}
provides a small "view · talk · edit" navigation bar. It is primarily used for content-heavy templates and other transcluded content blocks, so that the content inside the template or block is more easily editable Template:Lang where it was found, without having track it down through examining transclusion code. Template:Tnull'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[edit source]
General[edit source]
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;}}
{{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: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 Template:Xtag markup, so that it only appears when transcluded.
Font size and weight[edit source]
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 accessibility problems 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.
Examples[edit source]
Required parameters[edit source]
{{navbar|Template Name}}
– the template name is required.
Optional parameters[edit source]
Options | Parameters | Produces... | "Shortcut" template |
---|---|---|---|
Basic | {{navbar|Template Name}} |
||
Different text | {{navbar|Template Name|text=This template:}} |
||
Without "This box:" text | {{navbar|Template Name|plain=y}} |
{{view}} | |
Short version | {{navbar|Template Name|mini=y}} |
{{v}} | |
With brackets | {{navbar|Template Name|brackets=y}} |
||
With font styling examples (span) | {{navbar|Template Name|fontstyle=color: green; font-style: italic;}} |
||
With whole-template styling examples (div) | {{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 {{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:Demo | |
Template:Demo | |
Template:Demo | |
Template:Demo | |
Template:Demo | |
Template:Demo |
Notes[edit source]
Navbar is contained within a Template:Tag in order to accommodate a horizontal unnumbered list. This means it cannot be placed inside a Template:Tag or other inline element, because the HTML Tidy extension will 'fix' situations where it finds block elements inside inline elements.
Prepackaged[edit source]
- {{Navbar-header}}
- Positions on the right edge of the line, often used in non-collapsible navbox heading.
- {{Navbar-navframe}}
- For use in conjunction with NavFrame divs, positions opposite of the [hide]/[show] feature.
- {{Navbar-collapsible}}
- For use in conjunction with collapsible tables, floats opposite of the [hide]/[show] feature.
See also[edit source]
Other internal link templates, including:
- {{Talk}} – plain talk link
- {{Watch}} – plain link that adds the page to your watchlist
- Category:Internal template-link templates
TemplateData[edit source]
TemplateData for View
When placed inside a given template, it adds navbar navigational functionality
Parameter | Description | Type | Status | |
---|---|---|---|---|
Template Name |
| 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 |
The above documentation is transcluded from Template:Navbar/doc. (edit | history) Editors can experiment in this template's sandbox (create | mirror) and testcases (create) pages. Subpages of this template. |