常见问题

为什么按钮没有样式？

Vite / Webpack 等浏览器构建会自动引入样式。直接通过 CDN 使用 UMD 脚本时，需要同时引入 Viewer.js 的 CSS，见快速上手中的浏览器全局示例。

如何用缩略图预览原图？

组件使用 url="data-source"；指令和 API 将 options.url 设置为 data-source，读取图片上的原图地址。

<img src="thumb.jpg" data-source="large.jpg" />

如何从旧版本迁移？

默认插件改为局部引入：component 改为 Viewer，directive() 改为 vViewer，api 改为 useViewer，通过配置对象传入 images 和 options，并自动管理生命周期。旧的 Viewer 类改名为 ViewerJs。

组件的 options 保留兼容但不推荐使用，迁移为直接属性、Vue 事件和 ref 方法的示例见组件迁移说明。

inited 事件已移除，改为通过组件 ref 调用方法，如 gallery.value.show()。

组件的 images 和 trigger 属性也已移除，图片由插槽渲染并自动监听 DOM 变化；只传图片数组时使用 useViewer({ images })。