View source for Template:Transform-rotate/doc

{{Documentation subpage}}
<!-- Categories go at the bottom of this page. -->
A shorthanded [[Cascading style sheet|CSS]] code for rotating elements inside style attribute. Use it inside the <code>style=""</code> attribute of HTML elements like other CSS properties.

*First unnamed parameter <code>{{{1}}}</code> for rotation angle (in degree). Positive values rotate right, negative values rotate left.
*The named parameter {{para|display}} allows you to change the CSS display property. It defaults to <code>display: inline-block;</code>

When using this template to create the rotating effect, editors should consider carefully about the [[WP:accessibility|accessibility]].

''{{A note}} This template does not support IE8 or older. IE8 requires cumbersome calculating of matrices. You may implement it into this template if you know how to translate the formula into [[Wikipedia:Lua|Lua]].''


==Examples==
The rotating happens at the center of the object and its effective dimensions will retain the original values of the object as if unrotated, so you may adjust the position and padding to avoid unwanted overlapping. Use the <code>display=</code> parameter to further control positioning.

{|class=wikitable
!Syntax!!Result
|- style="vertical-align:top;"
|colspan=2|
*'''Some rotated characters:'''
|-
|<syntaxhighlight lang="html"><span style="{{Transform-rotate|90}}">5</span> <span style="{{Transform-rotate|180}}">5</span> <span style="{{Transform-rotate|270}}">5</span> <span style="{{Transform-rotate|360}}">5</span></syntaxhighlight>
|<span style="{{Transform-rotate|90}}">5</span> <span style="{{Transform-rotate|180}}">5</span> <span style="{{Transform-rotate|270}}">5</span> <span style="{{Transform-rotate|360}}">5</span>
|-
|colspan=2|
*'''Some rotated special characters ''(useful when the font-family has no italic or oblique font)'':'''
|-
|<syntaxhighlight lang="html"><span style="font-size: 1.4em; {{Transform-rotate|0}}">∫</span> <span style="font-size: 1.4em; {{Transform-rotate|20}}">∫</span> <span style="font-size: 1.4em; {{Transform-rotate|40}}">∫</span> <span style="font-size: 1.4em; {{Transform-rotate|60}}">∫</span></syntaxhighlight>
|<span style="font-size: 1.4em; {{Transform-rotate|0}}">∫</span> <span style="font-size: 1.4em; {{Transform-rotate|20}}">∫</span> <span style="font-size: 1.4em; {{Transform-rotate|40}}">∫</span> <span style="font-size: 1.4em; {{Transform-rotate|60}}">∫</span>
|-
|colspan=2|
*'''Works with numbers, too'''
|-
|<syntaxhighlight lang="html"><span style="{{Transform-rotate|0}}">0</span> <span style="{{Transform-rotate|10}}">1</span> <span style="{{Transform-rotate|20}}">2</span> <span style="{{Transform-rotate|30}}">3</span> <span style="{{Transform-rotate|40}}">4</span> <span style="{{Transform-rotate|50}}">5</span> <span style="{{Transform-rotate|60}}">6</span> <span style="{{Transform-rotate|70}}">7</span> <span style="{{Transform-rotate|80}}">8</span> <span style="{{Transform-rotate|90}}">9</span></syntaxhighlight>
|<span style="{{Transform-rotate|0}}">0</span> <span style="{{Transform-rotate|10}}">1</span> <span style="{{Transform-rotate|20}}">2</span> <span style="{{Transform-rotate|30}}">3</span> <span style="{{Transform-rotate|40}}">4</span> <span style="{{Transform-rotate|50}}">5</span> <span style="{{Transform-rotate|60}}">6</span> <span style="{{Transform-rotate|70}}">7</span> <span style="{{Transform-rotate|80}}">8</span> <span style="{{Transform-rotate|90}}">9</span>
|-
|colspan=2|
*'''Or with arbitrary text'''
|-
|<syntaxhighlight lang="html"><span style="{{Transform-rotate|-90}}">This text<br />is vertically<br />aligned.</span><br />&nbsp;<br /><span style="{{Transform-rotate|-180}}">This text is upside down.</span></syntaxhighlight>
|<span style="{{Transform-rotate|-90}}">This text<br />is vertically<br />aligned.</span><br />&nbsp;<br /><span style="{{Transform-rotate|-180}}">This text is upside down.</span>
|-
|colspan=2|
*'''This is a placeholder image, It is rotated 90 degrees clockwise.'''
|-style="vertical-align:top;"
|<syntaxhighlight lang="html"><div style="position:relative; top:0px; left:0px; {{Transform-rotate|90|display=block}}">[[file:Image PlaceHolder.png|200px]]</div></syntaxhighlight>
|<div style="position:relative; top:0px; left:0px; {{Transform-rotate|90|display=block}}">[[file:Image PlaceHolder.png|200px]]</div>
|-
|colspan=2|
*'''This is a red horizontal line drawn across the text at the angle of 30 degree anticlockwise.'''
|-style="vertical-align:top;"
|<syntaxhighlight lang="html"><div style="border:3px solid red; width:150px; position:relative; top:50px; opacity:0.5; {{Transform-rotate|-30|display=block}}"></div>Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.</syntaxhighlight>
|<div style="border:3px solid red; width:150px; position:relative; top:50px; opacity:0.5; {{Transform-rotate|-30|display=block}}"></div>Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
|}

Serious bug:

{|class=wikitable
!Syntax!!Result
|-
| <syntaxhighlight lang="html"><span style="{{Transform-rotate|90}}">The text will be rotated, but not the space the text need to display. So the cell is not tall enough, but much much too wide.</span></syntaxhighlight>
| <span style="{{Transform-rotate|90}}">The text will be rotated, but not the space the text need to display. So the cell is not tall enough, but much much too wide.</span>
|-
|}

==Related templates==

* {{tl|MirrorH}}
* {{tl|transform}}

<includeonly>{{Sandbox other||
<!-- Categories go here: -->
[[Category:Cross-browser compatibility templates]]
[[Category:Graphics templates]]
}}</includeonly>