Template:Wide image/doc
This is a documentation subpage for Template:Wide image. It may contain usage information, categories and other content that is not part of the original template page. |
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: |
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
[edit]{{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 asthumb
, 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 ofright
orleft
, the entire wide image will float to the right or left. If given a value ofnone
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
[edit]Without caption
[edit]{{wide image|Helsinki z00.jpg|1800px|
|alt=Panorama of city with mixture of five to ten story buildings}}
smaller
[edit]{{wide image|Helsinki z00.jpg|400px|
|alt=Panorama of city with mixture of five to ten story buildings}}
With caption
[edit]{{wide image|Helsinki z00.jpg|1800px|[[Helsinki]] panorama
|alt=Panorama of city with mixture of five to ten story buildings}}
Right aligned
[edit]{{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...
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
[edit]{{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...
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
[edit]{{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...
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
[edit]{{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...
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
[edit]{{wide image|Helsinki z00.jpg|1800px|[[Helsinki]] panorama
|alt=Panorama of city with mixture of five to ten story buildings
|dir=rtl}}
TemplateData
[edit]TemplateData for Wide image
Allows you to easily include a panorama image. If the image is too wide, scrollbars will be added.
Parameter | Description | Type | 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
| 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
| 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
[edit]See also
[edit]- {{Panorama}} – with an option to set the height
- {{Scalable image}}
- {{Tall image}}
- {{Scrollable}}