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
90deg = 100grad = 0.25turn ≈ 1.5708rad |
Setting a flat angle
180deg = 200grad = 0.5turn ≈ 3.1416rad |
Setting a counterclockwise right angle
-90deg = -100grad = -0.25turn ≈ -1.5708rad |
Setting a null angle
0 = 0deg = 0grad = 0turn = 0rad |
Specifications
Specification | Status | Comment |
---|---|---|
CSS Values and Units Module Level 4 The definition of '<angle>' in that specification. |
Editor's Draft | |
CSS Values and Units Module Level 3 The definition of '<angle>' in that specification. |
Candidate Recommendation | Initial definition. |
Browser compatibility
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