Skip to content

AiArtifacts 智能组件

AiArtifacts 是一个沉浸式的侧边渲染面板,专门用于展示 AI 生成的复杂内容,如 HTML 页面、React/Vue 原型、长代码模块或结构化文档。

基础用法

通过 v-model:visible 控制显示隐藏,并传入 data 结构描述内容及其版本。

基础用法

多版本支持

Artifact 允许用户在不同的迭代版本之间自由切换,通过 versions 数组提供历史记录。您可以通过 version-change 事件监听用户的切换行为。

提示:在侧边面板顶部点击 v1/v2 即可体验版本切换。
版本切换

渲染模式

支持 preview (实时渲染) 和 code (源码高亮) 模式。目前预览模式支持标准的 HTML 结构沙盒。

源码模式

行内展示模式

通过设置 mode="inline",组件将不再作为固定侧边栏出现,而是作为普通的块级元素嵌入在页面流或对话气泡中。

控制台原型预览
版本历史
v1
v2
行内模式与主题自定义

API

Props

属性名说明类型默认值
visible是否可见booleanfalse
data数据结构ArtifactData
width面板宽度string | number'50%'
mode初始模式'preview' | 'code' | 'inline''preview'
themeOverrides主题变量覆盖ComponentThemeVars

ArtifactData

属性名说明类型
id唯一标识string
title标题/文件名string
type类型'code' | 'html' | 'markdown' | 'vue' | 'react' | 'diagram' | 'chart' | 'sandbox' | 'canvas'
versions版本列表ArtifactVersion[]

ArtifactVersion

属性名说明类型
version版本号string | number
content源代码内容string
description更改说明string

Events

事件名说明回调参数
version-change切换版本时触发(v: ArtifactVersion) => void
close关闭面板时触发

Released under the MIT License.