Remotion LabRemotion Lab
›Studio›Studio Quick Switcher

Studio Quick Switcher

學習如何使用 Remotion Studio 的 Quick Switcher 快速切換 Composition、導覽選單項目及搜尋官方文件。

總覽

Quick Switcher 是 Remotion Studio 的快速導覽工具，讓你可以不用滑鼠就能迅速切換 Composition、操作選單功能，甚至搜尋官方文件。

按下 ⌘/Ctrl + K 即可開啟 Quick Switcher。

切換 Composition

開啟 Quick Switcher 後，預設模式是選擇 Composition。在輸入欄位中輸入 Composition 的 ID 進行篩選：

⌘K → 輸入 "hero" → 顯示所有 ID 包含 "hero" 的 Composition

例如，若你的專案有以下 Composition：

  • HeroAnimation
  • HeroIntro
  • ProductDemo
  • OutroScene

輸入 "hero" 後，會過濾出 HeroAnimation 與 HeroIntro。

導覽選單項目

若在輸入欄位中以 > 作為第一個字元，可以導覽 Studio 的選單項目：

> render         → 觸發渲染功能
> fullscreen     → 切換全螢幕
> checkerboard   → 切換棋盤格背景

在 > 之後繼續輸入字元，可以進一步篩選選單項目。這讓你可以用鍵盤執行任何 Studio 內的功能，無需記住所有快捷鍵。

可用的選單指令範例

指令功能
> render開啟渲染對話框
> fullscreen切換全螢幕模式
> checkerboard切換棋盤格背景
> sidebar切換側邊欄

搜尋官方文件

若在輸入欄位中以 ? 作為第一個字元，可以直接搜尋 Remotion 官方文件：

? useCurrentFrame    → 搜尋 useCurrentFrame 相關文件
? interpolate        → 搜尋 interpolate 函式文件
? spring animation   → 搜尋彈性動畫相關文件

在 ? 之後輸入搜尋關鍵字，結果會即時更新。選擇結果後，會在瀏覽器中開啟對應的文件頁面。

鍵盤導覽

在 Quick Switcher 中，你可以完全用鍵盤操作：

按鍵功能
↑ / ↓在項目清單中上下移動
Enter選擇目前高亮的項目並關閉 Quick Switcher
Esc關閉 Quick Switcher

輸入模式總覽

輸入前綴模式範例
（無前綴）切換 CompositionHero
>選單指令> render
?搜尋文件? spring

實際使用場景

場景一：快速切換 Composition

當你的專案有數十個 Composition 時，用 Quick Switcher 比在側邊欄捲動清單更快：

  1. 按 ⌘/Ctrl + K
  2. 輸入 Composition ID 的部分字元
  3. 按 ↓ 選擇目標
  4. 按 Enter 確認

場景二：快速觸發渲染

不需要找渲染按鈕或記住快捷鍵：

  1. 按 ⌘/Ctrl + K
  2. 輸入 > r
  3. 選擇「render」選項
  4. 按 Enter 開啟渲染對話框

場景三：查閱 API 文件

開發過程中想快速查閱某個 API：

  1. 按 ⌘/Ctrl + K
  2. 輸入 ? interpolate
  3. 選擇相關文件項目
  4. 按 Enter 在瀏覽器中開啟文件

與快捷鍵的對比

Quick Switcher 與直接的鍵盤快捷鍵各有優缺點：

Quick Switcher鍵盤快捷鍵
學習成本低（只需記住 ⌘K）高（需記住各種組合鍵）
速度稍慢（需輸入字元）快（一鍵觸發）
功能覆蓋廣（幾乎所有功能）限於已定義的快捷鍵
適合場景不常用的功能、探索新功能高頻使用的操作

建議將高頻操作（如播放、暫停、跳幀）使用快捷鍵，其他功能則透過 Quick Switcher 存取。

參考資料