The <angle>
CSS data type represents an angle value expressed in degrees, gradians, radians, or turns. It is used, for example, in <gradient>
s and in some transform
functions.
The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.
Syntax
The <angle>
data type consists of a <number>
followed by one of the units listed below. As with all dimensions, there is no space between the unit literal and the number. The angle unit is optional after the number 0
.
Optionally, it may be preceded by a single +
or -
sign. Positive numbers represent clockwise angles, while negative numbers represent counterclockwise angles. For static properties of a given unit, any angle can be represented by various equivalent values. For example, 90deg
equals -270deg
, and 1turn
equals 4turn
. For dynamic properties, like when applying an animation
or transition
, the effect will nevertheless be different.
Units
deg
- Represents an angle in degrees. One full circle is
360deg
. Examples:0deg
,90deg
,14.23deg
. grad
- Represents an angle in gradians. One full circle is
400grad
. Examples:0grad
,100grad
,38.8grad
. rad
- Represents an angle in radians. One full circle is 2π radians which approximates to
6.2832rad
.1rad
is 180/π degrees. Examples:0rad
,1.0708rad
,6.2832rad
. turn
- Represents an angle in a number of turns. One full circle is
1turn
. Examples:0turn
,0.25turn
,1.2turn
.
Examples
Setting a clockwise right angle
[[File:../../../../../media.prod.mdn.mozit.cloud/attachments/2012/07/09/3406/29e9fe51ee421f44dbd51003819d3897/Angle90.png|class=default internal|Angle90.png]] | 90deg = 100grad = 0.25turn ≈ 1.5708rad
|
Setting a flat angle
[[File:../../../../../media.prod.mdn.mozit.cloud/attachments/2012/07/09/3407/56dea5dd6129c55716ba70946a612b07/Angle180.png|class=default internal|Angle180.png]] | 180deg = 200grad = 0.5turn ≈ 3.1416rad
|
Setting a counterclockwise right angle
[[File:../../../../../media.prod.mdn.mozit.cloud/attachments/2012/07/09/3408/3c7c819fc7e98e06177581e34150248a/AngleMinus90.png|class=default internal|AngleMinus90.png]] | -90deg = -100grad = -0.25turn ≈ -1.5708rad
|
Setting a null angle
[[File:../../../../../media.prod.mdn.mozit.cloud/attachments/2012/07/09/3409/4c32e226d687aa5b00229778611c259d/Angle0.png|class=default internal|Angle0.png]] | 0 = 0deg = 0grad = 0turn = 0rad
|
Specifications
Specification | Status | Comment |
---|---|---|
CSS Values and Units Module Level 4The definition of '<angle>' in that specification. | Editor's Draft | |
CSS Values and Units Module Level 3The definition of '<angle>' in that specification. | Candidate Recommendation | Initial definition. |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Update compatibility data on GitHub
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
<angle>
|
Chrome
Full support 2 |
Edge
Full support 12 |
Firefox
Full support 3.6 |
IE
Full support 9 |
Opera
Full support 15 |
Safari
Full support 4 |
WebView Android
Full support 2 |
Chrome Android
Full support 18 |
Firefox Android
Full support 4 |
Opera Android
Full support 14 |
Safari iOS
Full support 3.2 |
Samsung Internet Android
Full support 1.0 |
deg
|
Chrome
Full support 2 |
Edge
Full support 12 |
Firefox
Full support 3.6 |
IE
Full support 9 |
Opera
Full support 15 |
Safari
Full support 4 |
WebView Android
Full support 2 |
Chrome Android
Full support 18 |
Firefox Android
Full support 4 |
Opera Android
Full support 14 |
Safari iOS
Full support 3.2 |
Samsung Internet Android
Full support 1.0 |
grad
|
Chrome
Full support 2 |
Edge
Full support 12 |
Firefox
Full support 3.6 |
IE
Full support 9 |
Opera
Full support 15 |
Safari
Full support 4 |
WebView Android
Full support 2 |
Chrome Android
Full support 18 |
Firefox Android
Full support 4 |
Opera Android
Full support 14 |
Safari iOS
Full support 3.2 |
Samsung Internet Android
Full support 1.0 |
rad
|
Chrome
Full support 2 |
Edge
Full support 12 |
Firefox
Full support 3.6 |
IE
Full support 9 |
Opera
Full support 15 |
Safari
Full support 4 |
WebView Android
Full support 2 |
Chrome Android
Full support 18 |
Firefox Android
Full support 4 |
Opera Android
Full support 14 |
Safari iOS
Full support 3.2 |
Samsung Internet Android
Full support 1.0 |
turn
|
Chrome
Full support 2 |
Edge
Full support 12 |
Firefox
Full support 13 |
IE
Full support 9 |
Opera
Full support 15 |
Safari
Full support 4 |
WebView Android
Full support 2 |
Chrome Android
Full support 18 |
Firefox Android
Full support 14 |
Opera Android
Full support 14 |
Safari iOS
Full support 3.2 |
Samsung Internet Android
Full support 1.0 |
Legend
- Full support
- Full support
See also
- CSS data types
- The
<gradient>
type - CSS rotation transforms:
rotate()
,rotate3d()
,rotateX()
,rotateY()
, androtateZ()
- CSS transforms
- Using CSS transforms
- Using CSS gradients
<angle> by Mozilla Contributors is licensed under CC-BY-SA 2.5.