scale3d()

Baseline 已廣泛支援

此特性已相當成熟，可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來，各瀏覽器均已提供此特性。

scale3d() CSS 函式定義了一個在3D空間中改變元素大小的變換。由於縮放量由向量 [sx, sy, sz] 定義，它可以用不同的比例改變不同的維度。其結果是一個 <transform-function> 資料型別。

試一試

transform: scale3d(1, 1, 1);

transform: scale3d(1.3, 1.3, 1.3);

transform: scale3d(0.5, 1, 1.7);

transform: scale3d(-1.4, 0.4, 0.7);

<section class="default-example" id="default-example">
  <div class="transition-all" id="example-element">
    <div class="face front">1</div>
    <div class="face back">2</div>
    <div class="face right">3</div>
    <div class="face left">4</div>
    <div class="face top">5</div>
    <div class="face bottom">6</div>
  </div>
</section>

#default-example {
  background: linear-gradient(skyblue, khaki);
  perspective: 800px;
  perspective-origin: 150% 150%;
}

#example-element {
  width: 100px;
  height: 100px;
  perspective: 550px;
  transform-style: preserve-3d;
}

.face {
  display: flex;
  align-items: center;
  justify-content: center;
  width: 100%;
  height: 100%;
  position: absolute;
  backface-visibility: inherit;
  font-size: 60px;
  color: white;
}

.front {
  background: rgb(90 90 90 / 0.7);
  transform: translateZ(50px);
}

.back {
  background: rgb(0 210 0 / 0.7);
  transform: rotateY(180deg) translateZ(50px);
}

.right {
  background: rgb(210 0 0 / 0.7);
  transform: rotateY(90deg) translateZ(50px);
}

.left {
  background: rgb(0 0 210 / 0.7);
  transform: rotateY(-90deg) translateZ(50px);
}

.top {
  background: rgb(210 210 0 / 0.7);
  transform: rotateX(90deg) translateZ(50px);
}

.bottom {
  background: rgb(210 0 210 / 0.7);
  transform: rotateX(-90deg) translateZ(50px);
}

這個縮放變換由一個三維向量來表徵。它的座標定義了在每個方向上進行的縮放量。如果所有三個座標都相等，則縮放是均勻的（等比例的），並且元素的寬高比得以保留（這是一種同心變換）。

當座標值超出 [-1, 1] 範圍時，元素將沿該維度增長；當在範圍內時，它將縮小。如果為負值，則結果是該維度上的點反射。值為 1 時沒有效果。

語法

css

scale3d(sx, sy, sz)

值

sx: 是一個<number>，表示縮放向量的橫座標（水平，x分量）。
sy: 是一個<number>，表示縮放向量的縱座標（垂直，y分量）。
sz: 是一個<number>，表示縮放向量的z分量。

笛卡爾座標，在 ℝ^2 上	齊次座標，在 ℝℙ^2 上	笛卡爾座標，在 ℝ^3 上	齊次座標，在 ℝℙ^3 上
此變換適用於 3D 空間，無法在平面上表示。		$\left( \begin{array}{ccc} sx & 0 & 0 \\ 0 & sy & 0 \\ 0 & 0 & sz \end{array} \right)$	$\left( \begin{array}{cccc} sx & 0 & 0 & 0 \\ 0 & sy & 0 & 0 \\ 0 & 0 & sz & 0 \\ 0 & 0 & 0 & 1 \end{array} \right)$

正式語法

<scale3d()> = 
  scale3d( [ <number> | <percentage> ]#{3} )

示例

不改變原點

HTML

html

<div>Normal</div>
<div class="scaled">Scaled</div>

CSS

css

div {
  width: 80px;
  height: 80px;
  background-color: skyblue;
}

.scaled {
  transform: perspective(500px) scale3d(2, 0.7, 0.2) translateZ(100px);
  background-color: pink;
}

結果

平移變換原點

HTML

html

<div>Normal</div>
<div class="scaled">Scaled</div>

CSS

css

div {
  width: 80px;
  height: 80px;
  background-color: skyblue;
}

.scaled {
  transform: perspective(500px) scale3d(2, 0.7, 0.2) translateZ(100px);
  transform-origin: left;
  background-color: pink;
}

結果

規範

規範
CSS 變換模組級別 2 # funcdef-scale3d

瀏覽器相容性

另見

幫助改進 MDN

瞭解如何貢獻

此頁面最後由MDN 貢獻者在2025年10月10日修改。

在 GitHub 上檢視此頁面 • 報告此內容的問題