Module:InfoboxImage/doc: Difference between revisions
→Examples: add example calling Template:Multiple image |
m 96 revisions imported from wikipedia:Module:InfoboxImage/doc |
||
| (13 intermediate revisions by 9 users not shown) | |||
| Line 1: | Line 1: | ||
{{used in system}} | {{used in system}} | ||
{{Module rating|protected}} | {{Module rating|protected}} | ||
{{Lua|Module:InfoboxImage/data}} | |||
{{for|guide on extended image syntax used in wikitext|Wikipedia:Extended image syntax}} | |||
==Overview== | ==Overview== | ||
| Line 35: | Line 37: | ||
|- | |- | ||
| upright | | upright | ||
| If upright=yes, adds "upright" which displays image at 75% of default image size (which is | | If upright=yes, adds "upright" which displays image at 75% of default image size (which is 250px if not changed at [[Special:Preferences]]). If a value, adds "upright=''value''" to image, where values less than 1 scale the image down (0.9 = 90%) and values greater than 1 scale the image up (1.15 = 115%). | ||
|- | |- | ||
| center | | center | ||
| Line 54: | Line 56: | ||
Note: If you specify the maxsize or sizedefault params, then you should include the px after the number. | Note: If you specify the maxsize or sizedefault params, then you should include the px after the number. | ||
==Parameters displayed in image syntax== | ==Parameters displayed in image syntax== | ||
| Line 71: | Line 71: | ||
When "size" and "sizedefault" are not defined, "maxsize" is used (in actual use "px" is required after the number; omitted here to show it is not added by the module): | When "size" and "sizedefault" are not defined, "maxsize" is used (in actual use "px" is required after the number; omitted here to show it is not added by the module): | ||
:<syntaxhighlight lang="wikitext" style="overflow:auto;">{{#invoke:InfoboxImage | InfoboxImage | image={{{image}}} | maxsize= | :<syntaxhighlight lang="wikitext" style="overflow:auto;">{{#invoke:InfoboxImage | InfoboxImage | image={{{image}}} | maxsize=256px }}</syntaxhighlight> | ||
:<code>{{#invoke:InfoboxImage | InfoboxImage | image={{{image}}} | maxsize= | :<code>{{#invoke:InfoboxImage | InfoboxImage | image={{{image}}} | maxsize=256px }}</code> | ||
When "size", "sizedefault", and "maxsize" are not defined, "frameless" is added, which displays the image at the default thumbnail size ( | When "size", "sizedefault", and "maxsize" are not defined, "frameless" is added, which displays the image at the default thumbnail size (250px, but logged in users can change this at [[Special:Preferences]]) and is required if using "upright" to scale the default size: | ||
:<syntaxhighlight lang="wikitext" style="overflow:auto;">{{#invoke:InfoboxImage | InfoboxImage | image={{{image}}} }}</syntaxhighlight> | :<syntaxhighlight lang="wikitext" style="overflow:auto;">{{#invoke:InfoboxImage | InfoboxImage | image={{{image}}} }}</syntaxhighlight> | ||
:<code>{{#invoke:InfoboxImage | InfoboxImage | image={{{image}}} }}</code> | :<code>{{#invoke:InfoboxImage | InfoboxImage | image={{{image}}} }}</code> | ||
| Line 121: | Line 121: | ||
| {{#invoke:InfoboxImage|InfoboxImage|image=Abbey Rd Studios.jpg|size=100px}} | | {{#invoke:InfoboxImage|InfoboxImage|image=Abbey Rd Studios.jpg|size=100px}} | ||
|- | |- | ||
| {{mlx|InfoboxImage|InfoboxImage|image{{=}}{{elc| | | {{mlx|InfoboxImage|InfoboxImage|image{{=}}{{elc|File:Abbey Rd Studios.jpg|200px}}}} | ||
| {{#invoke:InfoboxImage|InfoboxImage|image=[[ | | {{#invoke:InfoboxImage|InfoboxImage|image=[[File:Abbey Rd Studios.jpg|200px]]}} | ||
|- | |- | ||
| {{mlx|InfoboxImage|InfoboxImage|image{{=}}{{elc| | | {{mlx|InfoboxImage|InfoboxImage|image{{=}}{{elc|File:Abbey Rd Studios.jpg|200px}}|title{{=}}Abbey Road!}} | ||
| {{#invoke:InfoboxImage|InfoboxImage|image=[[ | | {{#invoke:InfoboxImage|InfoboxImage|image=[[File:Abbey Rd Studios.jpg|200px]]|title=Abbey Road!}} | ||
|- | |- | ||
| {{mlx|InfoboxImage|InfoboxImage|image{{=}}Abbey Rd Studios.jpg|sizedefault{{=}}250px|alt{{=}}The front stairs and door of Abbey Road Studios}} | | {{mlx|InfoboxImage|InfoboxImage|image{{=}}Abbey Rd Studios.jpg|sizedefault{{=}}250px|alt{{=}}The front stairs and door of Abbey Road Studios}} | ||
| Line 133: | Line 133: | ||
| {{#invoke:InfoboxImage|InfoboxImage|image=Abbey Rd Studios.jpg|sizedefault=250|alt=The front stairs and door of Abbey Road Studios}} | | {{#invoke:InfoboxImage|InfoboxImage|image=Abbey Rd Studios.jpg|sizedefault=250|alt=The front stairs and door of Abbey Road Studios}} | ||
|- | |- | ||
| {{mlx|InfoboxImage|InfoboxImage|image{{=}}Abbey Rd Studios.jpg|sizedefault{{=}}250px|alt{{=}}The front stairs and door of Abbey Road Studios|title=Exterior, front view of Abbey Road studios}} | | {{mlx|InfoboxImage|InfoboxImage|image{{=}}Abbey Rd Studios.jpg|sizedefault{{=}}250px|alt{{=}}The front stairs and door of Abbey Road Studios|title{{=}}Exterior, front view of Abbey Road studios}} | ||
| {{#invoke:InfoboxImage|InfoboxImage|image=Abbey Rd Studios.jpg|sizedefault=250px|alt=The front stairs and door of Abbey Road Studios|title=Exterior, front view of Abbey Road studios}} | | {{#invoke:InfoboxImage|InfoboxImage|image=Abbey Rd Studios.jpg|sizedefault=250px|alt=The front stairs and door of Abbey Road Studios|title=Exterior, front view of Abbey Road studios}} | ||
|- | |- | ||
| Line 148: | Line 148: | ||
| {{#invoke:InfoboxImage|InfoboxImage|image=Image is needed male.svg}} | | {{#invoke:InfoboxImage|InfoboxImage|image=Image is needed male.svg}} | ||
|- | |- | ||
| {{mlx|InfoboxImage|InfoboxImage|image{{=}}Image is needed male.svg|suppressplaceholder=no}} | | {{mlx|InfoboxImage|InfoboxImage|image{{=}}Image is needed male.svg|suppressplaceholder{{=}}no}} | ||
| {{#invoke:InfoboxImage|InfoboxImage|image=Image is needed male.svg|suppressplaceholder=no}} | | {{#invoke:InfoboxImage|InfoboxImage|image=Image is needed male.svg|suppressplaceholder=no}} | ||
|- | |- | ||
| Line 157: | Line 157: | ||
| {{#invoke:InfoboxImage|InfoboxImage|image=[[File:Image is needed male.svg|200px]]|suppressplaceholder=no}} | | {{#invoke:InfoboxImage|InfoboxImage|image=[[File:Image is needed male.svg|200px]]|suppressplaceholder=no}} | ||
|- | |- | ||
| {{mlx|InfoboxImage|InfoboxImage|image{{=}}Abbey Rd Studios.jpg|size=50px|maxsize{{=}}100px}} | | {{mlx|InfoboxImage|InfoboxImage|image{{=}}Abbey Rd Studios.jpg|size{{=}}50px|maxsize{{=}}100px}} | ||
| {{#invoke:InfoboxImage|InfoboxImage|image=Abbey Rd Studios.jpg|size=50px|maxsize=100px}} | | {{#invoke:InfoboxImage|InfoboxImage|image=Abbey Rd Studios.jpg|size=50px|maxsize=100px}} | ||
|- | |- | ||
| {{mlx|InfoboxImage|InfoboxImage|image{{=}}Abbey Rd Studios.jpg|size=200px|maxsize{{=}}100px}} | | {{mlx|InfoboxImage|InfoboxImage|image{{=}}Abbey Rd Studios.jpg|size{{=}}200px|maxsize{{=}}100px}} | ||
| {{#invoke:InfoboxImage|InfoboxImage|image=Abbey Rd Studios.jpg|size=200px|maxsize=100px}} | | {{#invoke:InfoboxImage|InfoboxImage|image=Abbey Rd Studios.jpg|size=200px|maxsize=100px}} | ||
|- | |- | ||
| Line 172: | Line 172: | ||
| {{#invoke:InfoboxImage|InfoboxImage|image=no such image|maxsize=100px|center=yes}} | | {{#invoke:InfoboxImage|InfoboxImage|image=no such image|maxsize=100px|center=yes}} | ||
|- | |- | ||
| {{mlx|InfoboxImage|InfoboxImage|image{{=}}{{ | | {{mlx|InfoboxImage|InfoboxImage|image{{=}}{{tlx|Multiple image|width{{=}}50|image1{{=}}Yellow card.svg|image2{{=}}Red card.svg}}}} | ||
| {{#invoke:InfoboxImage|InfoboxImage|image={{multiple image|width=50|image1=Yellow card.svg|image2=Red card.svg}}}} | | {{#invoke:InfoboxImage|InfoboxImage|image={{multiple image|width=50|image1=Yellow card.svg|image2=Red card.svg}}}} | ||
|} | |} | ||
== Placeholder images which can be suppressed == | == Placeholder images which can be suppressed == | ||
{| | {{div col|colwidth=22em}} | ||
* [[:File:Blue - replace this image female.svg]] | * [[:File:Blue - replace this image female.svg]] | ||
* [[:File:Blue - replace this image male.svg]] | * [[:File:Blue - replace this image male.svg]] | ||
* [[:File:Male no free image yet.png]] | * [[:File:Male no free image yet.png]] | ||
* [[:File:Flag of None (square).svg]] | * [[:File:Flag of None (square).svg]] | ||
| Line 199: | Line 197: | ||
* [[:File:Red - replace this image female.svg]] | * [[:File:Red - replace this image female.svg]] | ||
* [[:File:Red - replace this image male.svg]] | * [[:File:Red - replace this image male.svg]] | ||
* [[:File:Replace this image female.svg]] | * [[:File:Replace this image female.svg]] | ||
* [[:File:Replace this image male (blue).svg]] | * [[:File:Replace this image male (blue).svg]] | ||
| Line 215: | Line 212: | ||
* [[:File:NoDVDcover copy.png]] | * [[:File:NoDVDcover copy.png]] | ||
* [[:File:Noribbon.svg]] | * [[:File:Noribbon.svg]] | ||
* [[:File:No portrait-BFD-test.svg]] | * [[:File:No portrait-BFD-test.svg]] | ||
* [[:File:Placeholder barnstar ribbon.png]] | * [[:File:Placeholder barnstar ribbon.png]] | ||
| Line 250: | Line 246: | ||
* [[:File:Project Trains no image.png]] | * [[:File:Project Trains no image.png]] | ||
* [[:File:Image-request.png]] | * [[:File:Image-request.png]] | ||
{{div col end}} | |||
== Tracking categories == | == Tracking categories == | ||
* {{clc|Pages using infoboxes with thumbnail images}} | * {{clc|Pages using infoboxes with thumbnail images}} | ||
* {{clc|Pages using infoboxes with URL in image parameter}} | |||
<includeonly>{{Sandbox other|| | <includeonly>{{Sandbox other|| | ||
| Line 260: | Line 257: | ||
[[Category:Modules that add a tracking category]] | [[Category:Modules that add a tracking category]] | ||
[[Category:Infobox modules]] | [[Category:Infobox modules]] | ||
}}</includeonly> | }}</includeonly><noinclude> | ||
[[Category:Module documentation pages]] | |||
</noinclude> | |||
Latest revision as of 15:59, 24 January 2026
Lua error in Module:Effective_protection_level at line 64: attempt to index field 'TitleBlacklist' (a nil value).
| File:Green check.svg | This module is rated as ready for general use. It has reached a mature state, is considered relatively stable and bug-free, and may be used wherever appropriate. It can be mentioned on help pages and other Wikipedia resources as an option for new users. To minimise server load and avoid disruptive output, improvements should be developed through sandbox testing rather than repeated trial-and-error editing. |
Lua error in Module:Effective_protection_level at line 64: attempt to index field 'TitleBlacklist' (a nil value).
-->
| File:Lua-Logo.svg | This module depends on the following other modules: |
Overview
This module is used within infoboxes to process the image parameters and tidy up the formatting of the result.
Parameters
| Parameter | Description |
|---|---|
| image | Required. The main parameter that should be passed over which contains the image info. |
| size | Size to display image, in pixels. Use is discouraged per WP:THUMBSIZE; see |upright= below instead.
|
| maxsize | Maximum size to display image. Note: If no size or sizedefault params specified then image will be shown at maxsize. |
| sizedefault | The size to use for the image if no size param is specified. Defaults to frameless. |
| alt | Alt text for the image. |
| title | Title text for image (mouseover text). |
| border | If yes, then a border is added. |
| page | The page number to be displayed when using a multi-page image. |
| upright | If upright=yes, adds "upright" which displays image at 75% of default image size (which is 250px if not changed at Special:Preferences). If a value, adds "upright=value" to image, where values less than 1 scale the image down (0.9 = 90%) and values greater than 1 scale the image up (1.15 = 115%). |
| center | If yes, then the image is centered. |
| thumbtime | thumbtime param, used for video clips. |
| suppressplaceholder | If no, then will not suppress certain placeholder images. See § Placeholder images which can be suppressed. |
| link | Page to go to when clicking on the image. |
| class | HTML classes to add to the image. |
Note: If you specify the maxsize or sizedefault params, then you should include the px after the number.
Parameters displayed in image syntax
All parameters:
- <syntaxhighlight lang="wikitext" style="overflow:auto;">[[File:{{{image}}}|page={{{page}}}|{{{size}}}|center|alt={{{alt}}}|link={{{link}}}|border|upright={{{upright}}}|thumbtime={{{thumbtime}}}|class={{{class}}}|{{{title}}}]]</syntaxhighlight>
[[File:{{{image}}}|page={{{page}}}|{{{size}}}|center|alt={{{alt}}}|link={{{link}}}|border|upright={{{upright}}}|thumbtime={{{thumbtime}}}|class={{{class}}}|{{{title}}}]]
When "size" and "maxsize" are defined, the smaller of the two is used (if "px" is omitted it will be added by the module):
- <syntaxhighlight lang="wikitext" style="overflow:auto;">[[File:{{{image}}}|250px]]</syntaxhighlight>
[[File:{{{image}}}|250px]]
When "size" is not defined, "sizedefault" is used, even if larger than "maxsize" (in actual use "px" is required after the number; omitted here to show it is not added by the module):
- <syntaxhighlight lang="wikitext" style="overflow:auto;">[[File:{{{image}}}|250px]]</syntaxhighlight>
[[File:{{{image}}}|250px]]
When "size" and "sizedefault" are not defined, "maxsize" is used (in actual use "px" is required after the number; omitted here to show it is not added by the module):
- <syntaxhighlight lang="wikitext" style="overflow:auto;">[[File:{{{image}}}|256px]]</syntaxhighlight>
[[File:{{{image}}}|256px]]
When "size", "sizedefault", and "maxsize" are not defined, "frameless" is added, which displays the image at the default thumbnail size (250px, but logged in users can change this at Special:Preferences) and is required if using "upright" to scale the default size:
- <syntaxhighlight lang="wikitext" style="overflow:auto;">[[File:{{{image}}}|frameless]]</syntaxhighlight>
[[File:{{{image}}}|frameless]]
Use of "upright" without a number value, which displays the image at approximately 75% of the user's default size (multiplied by 0.75 then rounded to nearest 10):
- <syntaxhighlight lang="wikitext" style="overflow:auto;">[[File:{{{image}}}|frameless|upright]]</syntaxhighlight>
[[File:{{{image}}}|frameless|upright]]
When "alt" is used without "title", the alt text is also used as the title:
- <syntaxhighlight lang="wikitext" style="overflow:auto;">[[File:{{{image}}}|frameless|alt=Alt text]]</syntaxhighlight>
[[File:{{{image}}}|frameless|alt=Alt text]]
For more information, see Wikipedia:Extended image syntax.
Sample usage
<syntaxhighlight lang="wikitext" style="overflow:auto;"> |image = </syntaxhighlight>
Examples
{{#invoke:InfoboxImage|InfoboxImage}}
|
|
{{#invoke:InfoboxImage|InfoboxImage|image=}}
|
|
|
|
File:Abbey Rd Studios.jpg |
|
|
File:Abbey Rd Studios.jpg |
|
|
File:Abbey Rd Studios.jpg |
|
|
File:Abbey Rd Studios.jpg |
{{#invoke:InfoboxImage|InfoboxImage|image=
|
File:Abbey Rd Studios.jpg |
{{#invoke:InfoboxImage|InfoboxImage|image=
|
File:Abbey Rd Studios.jpg |
{{#invoke:InfoboxImage|InfoboxImage|image=Abbey Rd Studios.jpg|sizedefault=250px|alt=The front stairs and door of Abbey Road Studios}}
|
The front stairs and door of Abbey Road Studios |
{{#invoke:InfoboxImage|InfoboxImage|image=Abbey Rd Studios.jpg|sizedefault=250|alt=The front stairs and door of Abbey Road Studios}}
|
The front stairs and door of Abbey Road Studios |
{{#invoke:InfoboxImage|InfoboxImage|image=Abbey Rd Studios.jpg|sizedefault=250px|alt=The front stairs and door of Abbey Road Studios|title=Exterior, front view of Abbey Road studios}}
|
The front stairs and door of Abbey Road Studios |
{{#invoke:InfoboxImage|InfoboxImage|image=Abbey Rd Studios.jpg|alt=The front stairs and door of Abbey Road Studios}}
|
The front stairs and door of Abbey Road Studios |
{{#invoke:InfoboxImage|InfoboxImage|image=Abbey Rd Studios.jpg|size=100px|alt=The front stairs and door of Abbey Road Studios}}
|
The front stairs and door of Abbey Road Studios |
{{#invoke:InfoboxImage|InfoboxImage|image=Bandera de Bilbao.svg|size=100|border=yes}}
|
File:Bandera de Bilbao.svg |
{{#invoke:InfoboxImage|InfoboxImage|image=Image is needed male.svg}}
|
|
{{#invoke:InfoboxImage|InfoboxImage|image=Image is needed male.svg|suppressplaceholder=no}}
|
File:Image is needed male.svg |
{{#invoke:InfoboxImage|InfoboxImage|image=
|
|
{{#invoke:InfoboxImage|InfoboxImage|image=
|
File:Image is needed male.svg |
{{#invoke:InfoboxImage|InfoboxImage|image=Abbey Rd Studios.jpg|size=50px|maxsize=100px}}
|
File:Abbey Rd Studios.jpg |
{{#invoke:InfoboxImage|InfoboxImage|image=Abbey Rd Studios.jpg|size=200px|maxsize=100px}}
|
File:Abbey Rd Studios.jpg |
{{#invoke:InfoboxImage|InfoboxImage|image=
|
File:Abbey Rd Studios.jpg |
{{#invoke:InfoboxImage|InfoboxImage|image=Abbey Rd Studios.jpg|maxsize=100px|center=yes}}
|
|
{{#invoke:InfoboxImage|InfoboxImage|image=no such image|maxsize=100px|center=yes}}
|
|
{{#invoke:InfoboxImage|InfoboxImage|image=
|
Placeholder images which can be suppressed
- File:Blue - replace this image female.svg
- File:Blue - replace this image male.svg
- File:Male no free image yet.png
- File:Flag of None (square).svg
- File:Flag of None.svg
- File:Flag of.svg
- File:Green - replace this image female.svg
- File:Green - replace this image male.svg
- File:Image is needed female.svg
- File:Image is needed male.svg
- File:Location map of None.svg
- File:Male no free image yet.png
- File:Missing flag.png
- File:No flag.svg
- File:No free portrait.svg
- File:No portrait (female).svg
- File:No portrait (male).svg
- File:Red - replace this image female.svg
- File:Red - replace this image male.svg
- File:Replace this image female.svg
- File:Replace this image male (blue).svg
- File:Replace this image male.svg
- File:Silver - replace this image female.svg
- File:Silver - replace this image male.svg
- File:Replace this image.svg
- File:Cricket no pic.png
- File:CarersLogo.gif
- File:Diagram Needed.svg
- File:Example.jpg
- File:Image placeholder.png
- File:No male portrait.svg
- File:Nocover-upload.png
- File:NoDVDcover copy.png
- File:Noribbon.svg
- File:No portrait-BFD-test.svg
- File:Placeholder barnstar ribbon.png
- File:Project Trains no image.png
- File:Image-request.png
- File:Sin bandera.svg
- File:Sin escudo.svg
- File:Replace this image - temple.png
- File:Replace this image butterfly.png
- File:Replace this image.svg
- File:Replace this image1.svg
- File:Resolution angle.png
- File:Image-No portrait-text-BFD-test.svg
- File:Insert image here.svg
- File:No image available.png
- File:NO IMAGE YET square.png
- File:NO IMAGE YET.png
- File:No Photo Available.svg
- File:No Screenshot.svg
- File:No-image-available.jpg
- File:Null.png
- File:PictureNeeded.gif
- File:Place holder.jpg
- File:Unbenannt.JPG
- File:UploadACopyrightFreeImage.svg
- File:UploadAnImage.gif
- File:UploadAnImage.svg
- File:UploadAnImageShort.svg
- File:CarersLogo.gif
- File:Diagram Needed.svg
- File:No male portrait.svg
- File:NoDVDcover copy.png
- File:Placeholder barnstar ribbon.png
- File:Project Trains no image.png
- File:Image-request.png