进阶 v0.dev 2026-11-12 04:30:30 · 22 阅读

第15章 Design Mode 可视化设计模式

Design Mode

Design Mode 提供一种直观、可视化的方式来优化应用的用户界面。你可以在实时预览中选取任意元素,通过可视化面板(和/或自然语言指令)调整其样式,随后将修改同步回源代码。

启用 Design Mode

在预览工具栏中点击“Design Mode”按钮即可开启该模式。

Design Mode 会在运行中的应用旁打开,提供图层管理、选择控件及编辑面板。

该模式仅适用于使用最新预览运行时的会话,且仅限于该会话的最新版本。只读会话和移动端视图中不可用。

选中元素

开启 Design Mode 后,光标即变为选择工具。在预览中悬停于应用各区域时,对应元素会高亮显示。点击元素即可选中,v0 会显示选中手柄及该元素的设计面板。

要在“元素选择”与“正常交互”之间切换,可使用设计面板中的“Inspect”控件,或按 Cmd + I / Ctrl + I。按 Esc 可取消当前元素的选中状态。

修改元素

选中元素后,你有两种方式进行调整,且可在应用前将二者结合使用。

设计面板(用于精细调整)
设计面板提供了一组控件,用于进行精确的视觉调整,是打磨样式的理想工具。面板包含以下选项:
• 排版:字体族、字号、字重、行高、字距、对齐方式及文本装饰。
• 颜色:文本颜色。
• 背景:背景颜色。
• 布局:各边距(margin)与内边距(padding)。
• 边框:边框颜色、样式及宽度。
• 外观:透明度与圆角半径。
• 阴影:添加或自定义 box shadow。
• 内容:直接编辑元素的文本内容。
在面板中做的调整会在预览中实时生效,方便即时查看效果。这些修改会暂存为待处理状态,直到你点击应用(见下文)。 当检测到应用使用了 Tailwind CSS 时,Design Mode 会在合适位置提供兼容的 Tailwind 值。具体覆盖的 class 和 token 取决于项目中的定义。

指令(用于复杂修改)
对于结构性调整或面板难以直接表达的需求——例如“在此文本旁添加按钮”、“将此区域改为三栏网格”、“匹配上方卡片的样式”——直接在设计面板的文本框中输入自然语言指令即可。v0 会自动截取选中元素的截图,并连同指令一并发送。

撤销、重做、重置与预览

编辑过程中,面板提供若干控件,帮助你在提交前反复迭代:

  • Undo / Redo:在待处理的修改中向前或向后追溯。
  • Reset:清除当前元素所有待处理的 Design Mode 修改。
  • Before / after preview:临时关闭所有待处理修改,以便对照原始状态查看变更效果。

待处理修改会一直保留,直到你应用它们或离开该会话。若存在未应用的修改而试图离开,v0 会发出警告。

应用修改

确认修改满意后,点击设计面板中的 Apply。v0 会序列化这些修改(含指令及截图),发送至会话,并生成一个反映源代码变更的项目新版本。由于 Apply 会产生新的会话版本,你可以像处理其他 v0 修改一样,查看 diff、继续迭代或回滚。

核心特性

  • 作用于真实应用:Design Mode 基于项目的实时预览运行,所见即用户所见。
  • 可视化与提示词编辑结合:可在同一元素上先做精确的面板调整,再配合自然语言指令,最后统一应用。
  • 修改以新版本提交:Apply 会创建一个标准的 v0 会话版本,因此所有 Design Mode 修改均可 diff、审查与回滚。
  • 感知 Tailwind:当应用使用 Tailwind CSS 时,Design Mode 会在可能之处提供兼容的 Tailwind 值。

在你自己的应用中使用 Design Mode

关于 API 集成,Design Mode API 指南涵盖了无头编辑(headless edits)和浏览器 SDK 辅助工具。v0/browser 中的 createDesignModeBridge 将客户自有前端连接至 v0 代理预览中的编辑器运行时。后端使用 parseDesignModeMessage 验证 Apply 消息,并通过 API v2 保存数据,密钥保持在服务器端。

该 bridge 与框架无关,它连接现有编辑器,而非导出独立的 React 编辑器组件。应用仍需负责用户认证、会话访问授权及保存完成后的处理。

Previous | Terminal commands | Next | Design Systems 2.0

评论 (0)