Communitygithub.com

kubai-easing-curves

根據使用場景為專案中的動畫設定合適的緩動曲線與持續時間:入場用 ease-out,離場用 ease-in,位置變化用 ease-in-out,小型確認回饋用 overshoot,拖曳鬆手後用 spring,並統一為動效 token(easing、motion curves)。

kubai-easing-curves 是什麼?

這個技能會掃描使用者專案中所有的 CSS 過渡、keyframe 動畫、動畫函式庫(如 Framer Motion、GSAP、Web Animations API)以及手寫的 requestAnimationFrame 迴圈,列出每個動畫的觸發方式、持續時間與曲線。接著,它會根據動畫的角色(入場、離場、螢幕內移動、手勢、懸停/按下)替換成預先定義的緩動曲線 token,並調整持續時間,同時尊重 prefers-reduced-motion 無障礙設定。此技能支援 Claude Code、Cursor 與其他支援技能檔案的 AI 代理工具。它能確保整個產品中動畫的曲線一致,避免混用 CSS 預設的 ease、linear 或 ease-in,並產出易於維護的設計 token。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/kubai087/vibedesign-skills/tree/HEAD/skills/kubai-easing-curves

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

按場景選擇緩動曲線

《999 個小技巧,讓你的產品更有質感》第 011 期 · @kubai087

在使用者的專案裡按下列要求改造。要求以使用者的口吻寫成:文中的 I、me、my 指使用者;遇到標示「要先問」的地方,先停下來問使用者再繼續。

改造要求

為我的產品中的動畫賦予正確的緩動曲線,讓元素抵達、離開與移動時的感覺符合預期。在我現有的程式碼與設計系統內工作:保留每個動畫的動作內容、移動距離與觸發方式。只改變它們隨時間變化的方式,以及持續時間(若後者不合理時)。

  1. 從現有狀態開始
  • 找出每一個過渡與動畫:CSS 過渡與 keyframes、動畫函式庫(Framer Motion、GSAP、Web Animations API)以及手寫的 requestAnimationFrame 迴圈。針對每個動畫列出其元件、觸發方式、持續時間與曲線。
  • 標記那些仍使用 CSS 預設 ease、會移動的物件上用了 linear,以及出現的物件上用了 ease-in 的情況。
  1. 將曲線定義為 token 在 motion token 旁邊定義一次,且僅使用這些:
  • --ease-out: cubic-bezier(0, 0, .58, 1)。任何進入的元素:toast、選單、彈出視窗、對話框、抽屜。
  • --ease-out-strong: cubic-bezier(.22, 1, .36, 1)。點擊後立即穩定下來的小型元件:圖示、標籤、選中的藥丸。感覺最靈敏。
  • --ease-in: cubic-bezier(.42, 0, 1, 1)。任何離開的元素,且只能用在此處:toast 超時、對話框或抽屜關閉、選單收起、滑走的列表項目。它開始慢、離開時全速,用在進場會感覺延遲且突然停止。
  • --ease-in-out: cubic-bezier(.42, 0, .58, 1)。留在螢幕上僅改變位置或大小的元素:分頁或分段控制器下的指示標、輪播翻頁、重新排序時調整位置的項目、側邊欄縮放、平滑滾動到錨點。不用於進場:它的緩慢開頭會讓人感覺延遲。
  • --ease-overshoot: cubic-bezier(.34, 1.56, .64, 1)。稍微超出目標位置約 10% 再彈回。小型、有趣的回饋:核取方塊勾選、按讚、徽章數字彈入、開關旋鈕歸位。絕對不能用於對話框、抽屜或任何大於約 64px 的元素,也不應用在使用者整天重複的動作上。
  • --ease-spring: linear(0, .32, .78, 1.04, 1.09, 1.06, 1.02, 1, .99, .99, 1)。拖曳或滑動後鬆手的元素,像物體一樣穩定下來:底部面板彈開或收回、半滑動後返回的卡片、下拉刷新彈回、重新排序後的項目落定。優先使用動畫庫本身的 spring(搭配釋放速度);只有在沒有動畫庫時才使用此 token,若瀏覽器不支援 linear() 則降級為 --ease-out-strong。
  • linear:僅用於持續旋轉而非移動的元素:旋轉圖示、進度條、跑馬燈。
  • CSS 預設的 ease 不算一個選擇。任何未設定曲線的地方都要替換掉。
  1. 持續時間
  • 小型 UI(toast、工具提示、選單、核取方塊):進入 150-250ms,離開 120-200ms。離開比進入短。
  • 中型(對話框、含內容的彈出視窗、抽屜):250-350ms。
  • 大型或全螢幕(面板、頁面轉場):350-500ms。再長會感覺慢。
  • Spring 與 overshoot:約為一般持續時間的 1.5 倍,因為需要穩定時間。
  • 將持續時間與曲線 token 放在一起(--duration-sm、-md、-lg)。
  1. 依角色套用
  • 進入:ease-out,從元素應屬的方向進入(toast 從頂部邊緣、選單從其觸發點),短距離(8-24px),從 96% 放大並比移動稍微早一點淡入。在 toast 上,輕微模糊(約 8px)並隨落地而消失是不錯的點綴。
  • 離開:ease-in,路徑相反,且時間更短。
  • 螢幕內移動:ease-in-out。
  • 剛出現的元素內部的零件(其圖示、文字、計數)可延後 100-200ms 使用強 ease-out,使其分步落地而非一次全部出現。
  • 手勢:在游標或手指移動時,1:1 跟隨不加緩動。鬆開後,以 spring 完成,若函式庫允許則使用釋放速度。
  • 懸停與按下:100-150ms ease-out。絕對不要在懸停時動畫 layout。
  • 動畫 transform 與 opacity(filter 謹慎使用),不要動 top、left、width 或 height,這些會觸發 layout 與 repaint。
  1. 保持一致且無障礙
  • 每個角色在整個產品中只用一個曲線。不要手動調整每個元件。
  • 遵循 prefers-reduced-motion:保留透明度變化,移除移動與縮放,將 spring 與 overshoot 改為簡單的 150ms 淡入淡出。
  • 絕對不要讓使用者等待動畫:任何動畫都不能阻擋輸入,新動作應從舊動畫當前位置中斷它。
  1. 交付
  • 先列出你找到的每個動畫、其當前曲線與持續時間,以及你將給予的角色與曲線。
  • 然後加入 token,切換每個動畫,並列出你修改的每個檔案。
  • 不要改變動畫的內容、移動距離或觸發方式。如果某個動畫沒有明確的角色,先問我。

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

kubai-book-cards

卡片在悬停或聚焦时像书一样翻开一定角度,显示里面的内页,静止时外观保持不变。提供普通卡片、拟物精装书和极简文档三种风格。适用于文档、知识库、作品集和模板市场(book hover cards)。

kubai-holo-card

把产品里代表身份或收藏的卡片(会员卡、门票、徽章、个人卡片)改成镭射卡片:卡片朝指针方向 3D 倾斜,镭射与高光随光线移动,内部图案按深度产生视差,静止时轻微晃动,点击可翻到背面并显示厚度。附 Prism、Rainbow、Pearl、Sparkle、Chrome、Etched 六种材质的推荐参数,以及手感、厚度、翻转和层次的几档预设。开始前逐项询问,每项给出推荐值,由你选择或调整,确认后再按现有技术栈改造(holographic card, foil, 3D tilt, parallax)。

kubai-liquid-glass

为图片、壁纸或视频上方的卡片和面板添加液态玻璃材质:背景模糊与提亮、边缘折射与色散、根据背景自动调整的着色和文字颜色,深色和浅色模式下文字都清晰可读,布局保持不变(liquid glass, glassmorphism)。

kubai-scroll-cards

改造现有长页面:选出值得讲的段落,用五种由滚动驱动的卡片交互呈现——层叠卡片(新卡片逐张盖住旧卡片,旧卡片缩小、变暗)、卡组飞出(顶部卡片向一侧甩出,下一张顶上来)、横向展廊(页面固定,纵向滚动推动横向作品集)、封面轮播(中间一张最大,两侧缩小、转开、变暗)、图片展开(小图铺满屏幕,标题从景物后升起形成景深)。效果全部由滚动位置驱动,读者控制节奏,回滚即倒放,不劫持滚动;尺寸按不同屏幕和视窗高度计算,手机工具栏不会挡住内容,矮屏自动退回普通段落。附多档预设,开始前逐项询问,由你选择或调整,确认后按现有技术栈实现(scroll-driven animation, sticky, cover flow, svh)。

相關技能