Template:Wide image/sandbox: Difference between revisions

Browse history interactively

← Previous edit

Content deleted Content added

VisualWikitext

Inline

Latest revision as of 12:50, 19 April 2019

This is the template sandbox page for Template:Wide image (diff).
See also the companion subpage for test cases.

Template documentation[view] [edit] [history] [purge]

This template is used on approximately 9,300 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 uses Lua:

Module:Wide image (sandbox)

This template allows you to easily include a panorama image. If the image is too wide, scrollbars will be added. If you do not want the image to use a thumbnail frame, you can use |border=no.

Usage

{{Wide image|name|image width|caption|box width|alignment|alt=alt text}}

An image width option is required. This specifies the full width at which the image will be displayed, and is distinct from box width (the width of the box on the page).
A caption option is optional, and an image frame will be used if a caption is supplied. If the caption contains an equal sign, use the parameter |3=caption in the place of |caption. If the caption supplied is exactly equal to image syntax such as thumb, the image's tooltip will no longer display the caption, but instead default to the name of the image.
The box width option is optional, and if given a value in pixels followed by "px", or a value in percent followed by "%", will set the width of the box to that amount. For example, 45% would use 45% of the text section width, (not a percentage of the image width).
The alignment option is also optional but requires box width to be defined. If given a value of right oder left, the entire wide image will float to the right or left. If given a value of none the image will not float.
The alt text describes the image's visual appearance to visually disabled readers. Please see WP:ALT for details.

To change the scroll direction from left-to-right to right-to-left, use |dir=rtl.

To align the caption, use |align-cap=.

To remove the outer border, use |border=no.

Example

Without caption

{{wide image|Helsinki z00.jpg|1800px|
|alt=Panorama of city with mixture of five to ten story buildings}}

smaller

{{wide image|Helsinki z00.jpg|400px|
|alt=Panorama of city with mixture of five to ten story buildings}}

With caption

{{wide image|Helsinki z00.jpg|1800px|[[Helsinki]] panorama
|alt=Panorama of city with mixture of five to ten story buildings}}

Helsinki panorama

Right aligned

{{wide image|Helsinki z00.jpg|1800px|[[Helsinki]] panorama|45%|right
|alt=Panorama of city with mixture of five to ten story buildings}}
This text goes after the ''wide image'' template. [[Lorem ipsum]] dolor sit amet...

Helsinki panorama

This text goes after the wide image template. Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Left aligned

{{wide image|Helsinki z00.jpg|1800px|[[Helsinki]] panorama|45%|left
|alt=Panorama of city with mixture of five to ten story buildings}}
This text goes after the ''wide image'' template. Lorem ipsum dolor sit amet...

Helsinki panorama

This text goes after the wide image template. Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Center aligned 75% width

{{wide image|Helsinki z00.jpg|1800px|[[Helsinki]] panorama|75%|center
|alt=Panorama of city with mixture of five to ten story buildings}}
This text goes after the ''wide image'' template. Lorem ipsum dolor sit amet...

Helsinki panorama

This text goes after the wide image template. Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

No alignment

{{wide image|Helsinki z00.jpg|1800px|[[Helsinki]] panorama|45%|none
|alt=Panorama of city with mixture of five to ten story buildings}}
This text goes after the ''wide image'' template. Lorem ipsum dolor sit amet...

Helsinki panorama

This text goes after the wide image template. Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Scroll right to left

{{wide image|Helsinki z00.jpg|1800px|[[Helsinki]] panorama
|alt=Panorama of city with mixture of five to ten story buildings
|dir=rtl}}

Helsinki panorama

TemplateData

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for Template:Wide image in articles based on its TemplateData.

TemplateData for Wide image

Allows you to easily include a panorama image. If the image is too wide, scrollbars will be added.

Template parameters[Edit template data]
This template prefers inline formatting of parameters.
Parameter		Description	Typ	Status
Filename	`1` `image`	Name of the file to display. Example: Helsinki z00.jpg	File	required
Image width	`2`	Give the width in pixels (like: 1600px) that you want the included image to be	String	required
Caption	`3` `caption`	A caption for the image that will be shown below image	String	optional
Width of frame	`4` `width`	Limit the width of the frame enclosing the picture. Example: "400px" or "40%"	String	optional
Frame alignment	`5` `align`	Either of: left, right, center or none. When specified also requires you to set the "Width of frame" option Suggested values `left` `right` `center` `none` Default center	String	optional
Picture alignment	`dir`	Use the value 'rtl' to make the right side of the image the initial visible portion inside the scroll frame Suggested values `ltr` `rtl` Default ltr (left to right)	String	optional
Alt text	`alt`	Describes the image's visual appearance to visually disabled readers. Please see WP:ALT for details	String	optional

Tracking category

Category:Pages using wide image with unknown parameters (1)

@@ Line 1: / Line 1: @@
+{{#invoke:wide image/sandbox|main}}<noinclude>
-<includeonly><div class="thumb {{#switch:{{{5}}}
+{{documentation}}<!-- Add categories to the /doc subpage, not here! -->
-|left= tleft" style="
-|right= tright" style="
-|none= tnone" style="
-|#default=tnone" style="margin-left: auto; margin-right:auto; overflow:hidden;
-}} width:{{{4|auto}}}; max-width:{{#ifeq:{{{border|}}}|no|{{#expr:{{str sub|{{{2}}}|0|{{#expr:{{str find|{{{2}}}|px}} -1}}}}}}px|{{#expr:{{str sub|{{{2}}}|0|{{#expr:{{str find|{{{2}}}|px}} -1}}}} + 8}}px}};">
-{{#ifeq:{{{border|}}}|no||<div class="thumbinner">}}<div class="noresize overflowbugx" style="overflow:auto;{{#ifeq:{{{dir|}}}|rtl|direction:rtl;}}">[[File:{{{1}}}|{{{2}}}|alt={{{alt|}}}|{{#invoke:Unstrip|unstrip|{{#switch:{{{3}}}
-|thumb
-|thumbnail
-|frame
-|border={{{1}}}
-|#default={{#if:{{{3|}}}|{{#ifeq:{{{dir|}}}|rtl|&#x202A;}}{{{3|}}}{{#ifeq:{{{dir|}}}|rtl|&#x202C;}}|}}}}}}]]</div>{{ #if: {{{3|}}}|<div class="thumbcaption" {{#if:{{{align-cap|}}}|style="text-align:{{{align-cap}}}"}}>{{#ifeq:{{{border|}}}|no||<div class="magnify">[[:File:{{{1}}}| ]]</div>}}{{{3}}}</div>|}}
-{{#ifeq:{{{border|}}}|no||</div>}}</div></includeonly><noinclude>
-{{documentation}}
 <!-- If you copy this template, you need to add the overflowx and overflowy CSS classes to your global CSS for Internet Explorer users. On the English Wikipedia, these are conditionally loaded by [[MediaWiki:Common.js]] -->
-<!-- Add categories to the /doc subpage, not here! -->
 </noinclude>