當您無法產生有效的 CSS cubic-bezier 曲線時,請使用 CSS Cubic Bezier Generator:輸入有效的控制點、檢查時間曲線,並複製完整宣告。手動建立的曲線看似合理,卻可能無效,因為 CSS 要求每個 x 控制座標都必須介於零到一之間,而 y 座標則控制輸出進度,可以超出一般範圍。產生器會將 x1、y1、x2 和 y2 轉換成符合標準的時間函數,保留固定的起點 (0, 0) 與終點 (1, 1),並立即更新圖表、5 個進度取樣和動態預覽。您可以先選用 5 種標準化緩動關鍵字之一,也可以自行輸入座標。即使選擇關鍵字預設值,可見輸出仍會顯示全部 4 個數字,因此沒有需要還原的隱藏預設值。請複製完整的 transition-timing-function 宣告,包括分號,然後在您的介面中使用實際屬性、移動距離和持續時間進行測試。此工具只會建立時間曲線;不會加入持續時間、延遲、關鍵影格或完整轉場。所有運算都在您的瀏覽器中進行,不會上傳、儲存或傳送任何曲線、CSS 或互動資料至動畫服務。

讓 cubic-bezier 值有效的條件
cubic-bezier() 時間函數會將已消耗的輸入進度對應至輸出進度。其曲線一律從點 (0, 0) 開始,並在 (1, 1) 結束;可編輯的值 x1、y1、x2 和 y2 是兩個中間控制點。x 座標會在輸入時間中定位這些點,因此 CSS 要求 x1 和 x2 都必須維持在 0 到 1 的閉區間內。y 座標描述輸出進度,可以低於 0 或高於 1,藉此產生預期動作或超射。
產生器會將 x 輸入限制在這個有效的 CSS 範圍內。其介面可接受 −10 到 10 之間的有限 y 值,運算時會在產生輸出前分別驗證這些限制。這些 y 值限制屬於產生器介面,並不等同於 x 座標必須維持在 0 到 1 之間的 CSS 規則。
| CSS 關鍵字 | x1, y1, x2, y2 | 標準時間行為 |
|---|---|---|
| linear | 0, 0, 1, 1 | 以固定速率推進 |
| ease | 0.25, 0.1, 0.25, 1 | 一般平滑加速與減速 |
| ease-in | 0.42, 0, 1, 1 | 逐漸開始 |
| ease-out | 0, 0, 0.58, 1 | 逐漸結束 |
| ease-in-out | 0.42, 0, 0.58, 1 | 逐漸開始與結束 |
這些對應關係由 W3C CSS Easing Functions Level 1 定義,而 MDN 的 cubic-bezier() 參考資料則提供以瀏覽器為主的語法與範例。當預設值的時間曲線已符合預期動態時,請使用預設值;需要更精細控制時,請選擇自訂座標。
選擇關鍵字並不會讓關鍵字本身成為可見輸出。宣告會顯示全部 4 個控制值,方便您記錄、比較及修改。只有在將宣告序列化時,數字才會四捨五入至小數點後三位;運算過程會保留完整的 JavaScript 數值精確度。
產生並複製可用的時間宣告
- 開啟產生器。 前往 CSS Cubic Bezier Generator,即可同時使用 4 個控制座標、預設按鈕、圖表、取樣、預覽和輸出。
- 選擇預設值或輸入座標。 當目標符合時,請選擇 linear、ease、ease-in、ease-out 或 ease-in-out。若要自行輸入,請設定 x1、y1、x2 和 y2。請將兩個 x 座標維持在 0 到 1 之間,並在產生器中使用 −10 到 10 之間的有限 y 座標。
- 檢查曲線及其行為。 查看圖表以掌握整體形狀,檢查 5 個數值進度取樣,並使用 Run preview 觀看產生的緩動效果。請留意加速、減速、預期動作、超射令人困惑的變化。
- 複製完整宣告。 使用複製控制項,將完整的 transition-timing-function 宣告(包括分號)放入剪貼簿。瀏覽器政策可能會要求剪貼簿權限。如果拒絕存取,宣告仍會保持可見且可選取,狀態也不會顯示複製成功。
- 在實際元件中測試。 將產生的時間函數套用至實際轉場,並測試介面所使用的屬性、距離和持續時間。預覽成功並不能取代最終設計中的測試。
輸出刻意僅限於一個時間函數。它不會產生關鍵影格序列、彈簧模型、linear() 停駐點清單、steps() 時間曲線、持續時間、延遲、重複次數或完整的轉場簡寫。
檢查圖表、取樣和動態
圖表使用固定的 0 到 1 正方形,讓一般時間曲線能在框架大小不變的情況下進行比較。標準曲線會保持在該框架內。極端 y 座標可能使部分曲線延伸到可見正方形之外,但這不代表結果已遭限制或被侷限於圖表邊界。在這些情況下,請使用數值取樣和動態預覽檢查實際緩動效果。
5 個取樣可以回答單靠控制點圖表無法回答的問題:在已消耗輸入時間的特定比例下,動畫值已推進多遠?輸入會在零、0.25、0.5、0.75 和 1 時進行評估。對於 0.5 這類輸入,運算器會先找出 x 座標為 0.5 的曲線參數,再評估該參數下的 y。它會使用有界限的 Newton 迭代,必要時再以二分法結束,避免錯誤假設曲線參數始終等於已消耗時間。
Run preview 會使用 900 毫秒的 transform 轉場和完全相同的產生緩動字串,讓圓形在兩個水平位置間切換。反复點擊即可比較正向和反向動態。此預覽呈現的是時間曲線,而非保證的正式環境效能:距離、持續時間、動畫屬性、算繪成本、輸入裝置和周圍動態,都可能讓最終元件呈現不同感受。
修正結果看似遺失或錯誤的原因
請分開處理座標有效性、剪貼簿傳遞和動態適用性。曲線可能因無效而被拒絕、未經確認就遭到複製,或雖獲 CSS 接受,卻仍不適合該介面。
| 症狀 | 意義 | 處理方式 |
|---|---|---|
| x 座標無法設定為低於 0 或高於 1 | 建議值會構成無效的 CSS | 將 x1 或 x2 回復至 0 到 1 的閉區間 |
| y 座標未獲接受 | 該值超出產生器可接受的有限範圍 | 使用 −10 到 10 之間的有限值 |
| 曲線延伸到正方形之外 | 極端 y 值造成進度超過 0 或 1 | 檢查取樣和動態;不要假設有施加限制 |
| 複製控制項未確認成功 | 剪貼簿權限可能遭拒絕 | 手動選取並複製仍可見的宣告 |
| 50% 取樣出乎預期 | 曲線參數不一定等於已消耗的輸入進度 | 使用表格中顯示的 x 軸輸入和運算輸出 |
技術上有效的曲線不一定容易理解、無障礙、效能良好或適用。超射幅度過大可能讓控制項看似反向移動、移出容器,或顯示原本應維持裁切的內容。雖然移動元素和數值取樣會使用實際運算出的緩動效果,仍應避免快速震盪,並在元素轉場時檢查焦點與指標行為。
如果產生的座標有效,且取樣描述了您預期的進度,剩餘問題通常在於使用情境,而非產生結果。請測試實際版面配置和互動,不要只為配合固定的預覽圓形就變更曲線。
在宣告實際執行之處進行測試
複製的行數只提供時間設定,本身不會建立移動。請將它用作 transition-timing-function 的值,再分別設定動畫屬性和持續時間。如需瞭解產生的時間設定與完整 CSS 宣告之間的差別,請參閱 CSS Cubic Bezier Generator: Full Transition or Just Timing?。
請在實際屬性和距離下測試正向與反向狀態。也要檢查預定的持續時間、算繪需求、輸入方式及附近發生的任何動態。預覽中固定的 900 毫秒圓形無法重現所有正式環境條件。
在動畫並非必要的情況下,請尊重減少動態偏好。重要的狀態變更在沒有動態的情況下仍應易於理解,移動控制項也不應妨礙焦點或指標輸入。當曲線在實際環境中呈現符合目的的效果後,請將相同且可見的宣告複製到專案中,並記錄其 4 個控制值,以便比較和維護。