`scale()` CSS function
The scale() CSS function defines a transformation that resizes an element on the 2D plane. Because the amount of scaling is defined by a vector [sx, sy], it can resize the horizontal and vertical dimensions at
The scale() CSS function defines a transformation that resizes an element on the 2D
plane. Because the amount of scaling is defined by a vector [sx, sy], it can resize the horizontal and vertical dimensions at
different scales. Its result is a <transform-function> data type.
CSS Demo: scale()
```css interactive-example-choice transform: scale(1);
```css interactive-example-choice
transform: scale(0.7);
```css interactive-example-choice transform: scale(1.3, 0.4);
```css interactive-example-choice
transform: scale(-0.5, 1);
```html interactive-example
This scaling transformation is characterized by a two-dimensional vector. Its coordinates define how much scaling is
done in each direction. If both coordinates are equal, the scaling is uniform (_isotropic_) and the aspect
ratio of the element is preserved (this is a [homothetic transformation](https://en.wikipedia.org/wiki/Homothetic_transformation)).
When a coordinate value is outside the \[-1, 1] range, the element grows along that dimension; when inside, it
shrinks. A negative value results in a [point reflection](https://en.wikipedia.org/wiki/Point_reflection)
in that dimension. The value `1` has no effect.
> [!NOTE]
> The `scale()` function only scales in 2D. To scale in 3D, use
> [`scale3d()`](/docs/Web/CSS/Reference/Values/transform-function/scale3d) instead.
## Syntax
```css
scale(sx)
scale(sx, sy)
Values
sx- : A <number> or <percentage> representing the abscissa (horizontal, x-component) of the scaling vector.
sy- : A <number> or <percentage> representing the ordinate (vertical, y-component) of the scaling vector.
If not defined, its default value is
sx, resulting in a uniform scaling that preserves the element's aspect ratio.
| Cartesian coordinates on ℝ^2 | Homogeneous coordinates on ℝℙ^2 | Cartesian coordinates on ℝ^3 | Homogeneous coordinates on ℝℙ^3 |
|---|---|---|---|
[sx 0 0 sy 0 0] |
Formal syntax
Accessibility
Scaling/zooming animations are problematic for accessibility, as they are a common trigger for certain types of migraine. If you need to include such animations on your website, you should provide a control to allow users to turn off animations, preferably site-wide.
Also, consider making use of the prefers-reduced-motion media feature — use it to write a media query that will turn off animations if the user has reduced animation specified in their system preferences.
Find out more:
- MDN Understanding WCAG, Guideline 2.3 explanations
- Understanding Success Criterion 2.3.3 | W3C Understanding WCAG 2.1
Examples
Scaling the X and Y dimensions together
HTML
<div>Normal</div>
<div class="scaled">Scaled</div>
CSS
div {
width: 80px;
height: 80px;
background-color: skyblue;
}
.scaled {
transform: scale(0.7); /* Equal to scaleX(0.7) scaleY(0.7) */
background-color: pink;
}
Result
200
Scaling X and Y dimensions separately, and translating the origin
HTML
<div>Normal</div>
<div class="scaled">Scaled</div>
CSS
div {
width: 80px;
height: 80px;
background-color: skyblue;
}
.scaled {
transform: scale(2, 0.5); /* Equal to scaleX(2) scaleY(0.5) */
transform-origin: left;
background-color: pink;
}
Result
200
Specifications
Browser compatibility
See also
- transform
- scale
- zoom
- <transform-function>
- scale3d()
- Other individual transform properties translate and rotate