跳到主要內容
maxstudioNews
教學DEV Community (Claude Code)約 10 分鐘

探討 Claude Code 的 Awwwards 動畫技能:是否支援 prefers-reduced-motion?

Claude Code 的「awwwards-animations」技能聲稱支援 prefers-reduced-motion,但其預設模式並未實際實作此設定。文章指出,該技能的 CSS 片段僅適用於 CSS 動畫,無法涵蓋 GSAP 或 Lenis 等 JavaScript 驅動的動畫。為解決此問題,文章提供了使用 gsap.matchMedia() 和 Lenis 條件式渲染的程式碼範例,以確保動畫能正確尊重用戶的動態偏好設定。

探討 Claude Code 的 Awwwards 動畫技能:是否支援 prefers-reduced-motion?
圖片來源:DEV Community (Claude Code)

Claude Code 的 awwwards-animations 技能在其測試清單中列出了「尊重 prefers-reduced-motion」,但其九種現成模式中沒有一種會檢查此設定。該技能的 CSS 片段僅能應用於 CSS 動畫。如果您希望 Claude Code 輸出符合 Awwwards 風格、且尊重此設定的捲動動畫,您需要將其與官方的 gsap-core 技能搭配使用,並自行添加檢查邏輯。

awwwards-animations 技能對於減少動態的說明為何?我們在 2026 年 11 月 15 日讀取了 DevMartinese/awwwards-animations-skill 專案中 c92d00b 提交版本的技能文件。該文件開頭寫道:「建立 Awwwards/FWA 品質等級的頂級網頁動畫。

React 優先方法。60fps 不可妥協。」來源:SKILL.md 於 c92d00b,「Awwwards Animations」。

在 SKILL.md 中,「減少動態」出現在兩個地方,參考檔案中還有更多:一個「無障礙設計」區塊,包含 Motion useReducedMotion() 範例和一個全域 CSS 區塊。測試清單中有一行:「- [ ] 尊重 prefers-reduced-motion」。

在 references/performance.md 中,有一個「低階設備減少動態」範例,將完整動畫替換為 0.3 秒的淡入淡出效果,並附有一行清單。在 references/motion-patterns.md 中有一個 useReducedMotion 提示,而在 references/audio-reactive.md 中則有一個 window.matchMedia 檢查。

無障礙設計的涵蓋範圍確實存在,因此問題在於其影響程度。截至 2026 年 11 月 15 日,此技能擁有 3,211 次安裝和 15 個 GitHub 星星(透過 Skillselion 列表的 skills.sh 註冊表和 GitHub)。在您發布之前,請務必仔細閱讀其輸出結果。

這九種快速模式是否尊重 prefers-reduced-motion?答案是否定的。此技能提供了九種快速模式:磁性游標、磁性按鈕、視差英雄區塊、文字字元顯示、圖片顯示、故障文字、碎形樹、幾何分割和粗獷主義網格。我們搜尋了檔案中的「reduce」一詞。唯一的命中點是無障礙設計區塊和測試清單,兩者都位於模式之後。沒有任何一個模式會讀取用戶設定。

參考檔案也幾乎沒有提供相關資訊。在 references/gsap-react.md 中,「reduce」一詞並未出現。在 references/lenis-react.md 中,它只出現一次,在「Reduce lerp value」中。我們閱讀的技能檔案中,沒有一個提到 gsap.matchMedia()。

因此,當您要求 Claude Code 產生「帶有 Lenis 平滑捲動的視差英雄區塊」時,即使技能提供了程式碼,除非您明確要求,否則輸出中不會包含減少動態的分支。

該技能的 CSS 片段是否涵蓋 GSAP 和 Lenis?該片段如下:@media ( prefers-reduced-motion : reduce ) { * , * : : before , * : : after { animation-duration : 0.01ms ! important ; transition-duration : 0.01ms ! important ; } }。

它縮短了 CSS 動畫和 CSS 轉場。GSAP 的補間動畫在 JavaScript 中於 GSAP 節拍器上運行,因此 gsap.to() 呼叫會忽略此設定。Lenis 也會在 JavaScript 中緩解捲動位置。

我們搜尋了 lenis 1.3.17 套件(技能安裝說明中指定的版本)的 dist 和 README 檔案,尋找「reduced」一詞,但沒有找到任何匹配項,因此也沒有發現內建的處理方式。實際上,這個 CSS 區塊只保護了懸停轉場和關鍵影格。捲動擦洗時間軸、文字顯示和平滑捲動層是主要的動態效果,但它們並未被涵蓋。

如何為 GSAP 捲動動畫添加減少動態功能?GreenSock 自己的 gsap-core 技能提供了缺失的部分。我們在 greensock/gsap-skills 專案中 aed9cfd 提交版本的技能文件中讀到:「gsap.matchMedia() (GSAP 3.11+) 僅在媒體查詢匹配時運行設定程式碼;當它停止匹配時,在此運行中建立的所有動畫和 ScrollTriggers 都會自動還原。」

來源:skills/gsap-core/SKILL.md 於 aed9cfd,「無障礙設計和響應式 (gsap.matchMedia())」。

這種還原行為正是您對捲動效果所期望的:如果訪客在會話期間更改了作業系統設定,ScrollTriggers 就會解除。同一區塊還添加了一條值得複製到您的專案說明中的規則:「尊重 prefers-reduced-motion 對於患有前庭功能障礙的用戶非常重要。

當 reduceMotion 為 true 時,請使用 duration: 0 或跳過動畫。」來源:skills/gsap-core/SKILL.md 於 aed9cfd,「無障礙設計和響應式 (gsap.matchMedia())」。

這是 awwwards 技能中的視差英雄區塊,圍繞該 API 重新編寫。查詢特意設定為「無偏好」情況:matchMedia 僅在其查詢之一匹配時呼叫處理程序,因此單獨的「減少」查詢會讓其他所有人都跳過動畫。這是一個基於上述兩個來源的草圖。我們沒有在瀏覽器中運行它來撰寫這篇文章。

```javascript

'use client'

import { useEffect , useRef } from 'react'

import gsap from 'gsap'

import { ScrollTrigger } from 'gsap/ScrollTrigger'

gsap . registerPlugin ( ScrollTrigger )

export function ParallaxHero ( ) {

const root = useRef < HTMLDivElement > ( null )

useEffect ( ( ) => {

const mm = gsap . matchMedia ( )

mm . add ( '(prefers-reduced-motion: no-preference)' , ( ) => {

// runs only when motion is allowed; reduced-motion visitors get a static hero

gsap . to ( '.parallax-bg' , {

yPercent : 50 ,

ease : 'none' ,

scrollTrigger : {

trigger : root . current ,

start : 'top top' ,

end : 'bottom top' ,

scrub : true ,

} ,

} )

} , root . current ?? undefined )

return ( ) => mm . revert ( ) // gsap-core: revert on unmount

} , [ ] )

return < div ref = { root } className = "relative h-screen overflow-hidden" > … < / div >

}

```

請注意,gsap-core 建議不要將 gsap.context() 巢狀嵌入 matchMedia 中,這就是為什麼此草圖使用普通的 useEffect 搭配 mm.revert(),而不是將呼叫包裝在 useGSAP 中。

如何為減少動態關閉 Lenis 平滑捲動?最簡單的方法是當訪客要求減少動態時,根本不掛載平滑捲動。該技能在其無障礙設計區塊中已經從 motion/react 導入了 useReducedMotion,因此可以重複使用它:

```javascript

'use client'

import { ReactLenis } from 'lenis/react'

import { useReducedMotion } from 'motion/react'

export function SmoothScroll ( { children } : { children : React . ReactNode } ) {

const reduced = useReducedMotion ( )

if ( reduced ) return < > { children } < / >

return < ReactLenis root > { children } < / ReactLenis >

}

```

這個 Hook 在第一次檢查之前可能會返回 null,因此 Lenis 可能會掛載一次。如果這種閃爍很重要,請在 reduced === false 時才進行渲染。我們的草圖為了簡潔,省略了技能自身 SmoothScroll 元件中的 GSAP 節拍器橋接。如果您保留該橋接,請僅在非減少動態分支內部渲染它。

您應該在 CLAUDE.md 中放入什麼,以便代理程式持續執行此操作?一個技能為一項任務提供模式。專案說明中的規則適用於每項任務,因此請將其放在那裡:「每個 GSAP 或 Lenis 動畫都需要一個 prefers-reduced-motion 分支。GSAP 請使用 gsap.matchMedia()。當用戶偏好減少動態時,請勿掛載 ReactLenis。」

然後檢查結果。awwwards 技能自己的清單說明要確認設定是否受到尊重。在 Chrome 開發者工具中,打開「渲染」面板並將「模擬 CSS 媒體功能 prefers-reduced-motion」設定為「reduce」,然後捲動頁面。如果不需要 JavaScript 途徑,請參閱我們的「CSS 捲動動畫 vs GSAP 指南」。

您應該同時安裝哪些技能?我們針對 Claude Code 的 Awwwards 風格技能排名清單包含了完整的入門堆疊。針對此問題的簡短版本是:用於 React 動態系統和模式庫的 awwwards-animations 列表。用於 matchMedia() 減少動態模式的官方 gsap-core 技能。

動畫和動態技能中心用於目錄中其餘的動態工具,以及無障礙設計技能中心用於審核頁面無障礙設計的技能。安裝次數和星級來自 2026 年 11 月 15 日的 Skillselion 目錄。檔案內容來自每個來源行中指定的 GitHub 提交。如果您已經發布了帶有減少動態分支的 Lenis 或 ScrollTrigger 英雄區塊,您是如何建構它的?

是 matchMedia 區塊、上下文提供者,還是其他方式?我為 Skillselion 工作,這是一個獨立的目錄,不隸屬於 Anthropic、OpenAI 或 Cursor。

Share

覺得值得一看?分享給朋友。

以上為 AI 自動翻譯導讀。原文版權歸 DEV Community (Claude Code) 所有, 建議透過「閱讀原文」前往原始網站,以取得最完整資訊並支持原作者。

Newsletter

不用每天追,AI 重點每週寄給你

43 個來源、每 2 小時更新,太多看不完。電子報每週挑最值得看的幾則,附上 Max 的看法。

每週一封。Email 只用來寄電子報,每封信都能一鍵退訂。