模板:Px/doc
![]() | 此页面是Template:Px的模板文档。 此页面可能包含了模板的使用说明、分类和其他内容。 |
![]() | 此模板文档被引用于约47,000个页面。 为了避免造成大规模的影响,所有对此模板文档的编辑应先于沙盒、测试样例或您的沙盒上测试。 测试后无误的版本可以一次性地加入此模板文档中,但是修改前请务必于讨论页发起讨论。 模板引用数量会自动更新。 |
This is the {{px}} template.
This meta-template helps other templates, such as infoboxes, to take image size parameters in both of the forms "40" or "40px". It takes up to three parameters and returns the first one that has any content. That is, the first one that is defined (not null) and not empty. Thus a default value for the width of the image can be fed as the second or third parameter.
Usage
[编辑]Here is what this template does. Code to the left, actual rendering to the right:
{{px|40}}
= 40px{{px|40px}}
= 40px
And with an optional second or even third parameter to be used as a default value if the first or second parameter is empty or undefined:
{{px||50}}
= 50px{{px||50px}}
= 50px
{{px|||60}}
= 60px{{px|||60px}}
= 60px
And here is how it can be used inside another template:
[[File:{{{image}}} | {{px|{{{size|}}}}} | {{{caption|}}} ]]
[[File:{{{image}}} | {{px|{{{size|}}}|250}} | {{{caption|}}} ]]
[[File:{{{image}}} | {{px| {{{size|}}} | {{{width|}}} | 250 }} | {{{caption|}}} ]]
Default values
[编辑]It used to be a bit tricky to handle empty but defined image size values in a template, since the MediaWiki pipetrick doesn't return the default value for empty parameters. That is, {{{width|250px}}}
does not return "250px" if the template was called like this: {{template|width=}}
The usual workaround was to do like this:
{{#if:{{{width|}}}|{{{width}}}|250px}}
When at the same time handling the "pxpx" bug this became even more messy code:
[[File:{{{image}}} | {{#if:{{{width|}}}|{{px|{{{width}}}}}|250px}} ]]
To simplify the coding, {{px}} allows for an optional default value to be defined allowing for the following:
[[File:{{{image}}} | {{px|{{{width|}}}|250}} ]]
Note! The parameters to {{px}} must use the pipe "|", like this: {{{width|}}}
. Or else {{px}} will be fed and return the string "{{{width}}}
" if width was not defined.
Background
[编辑]Old usage was to always pad on "px" since MediaWiki used to tolerate "40pxpx":
[[File:{{{image}}} | {{{size}}}px | {{{caption|}}} ]]
But since 25 March 2008 that does not work anymore. That is, image sizes on Wikipedia now needs to be given in the form "40px", not "40" or "40pxpx". This template helps doing that. Note that the bug has since been fixed, although you can continue using this template.
See also
[编辑]- Wikipedia:ClickFix – About the "pxpx" bug.
- {{ifempty}} – Helps detect empty parameters and fall back to default values. For instance for handling multiple image name parameters.
Test examples
[编辑]{{px|40}}
= 40px{{px|40px}}
= 40px{{px|40pxpx}}
= 40pxpx{{px|junk}}
= junk{{px}}
={{px|}}
={{px||}}
={{px|||}}
={{px|40|50}}
= 40px{{px||50}}
= 50px{{px||50px}}
= 50px{{px||50|60}}
= 50px{{px|||60}}
= 60px{{px|||60px}}
= 60px
- Currently fails. But the devs have stated that they are adding back parsing of "pxpx" in the next update to Wikipedia. So if you see a small image to the right then Wikipedia again accepts "pxpx".
- Giving the default width if the 1st parameter is empty
- Fails to use the default value of 50. Note the missing "|" in {{{width}}}.