Question 1

How to use v-viewer with Vue 3 Composition API?

Accepted Answer

Import the API method directly, e.g., `import { api as viewerApi } from 'v-viewer'`, and call it within your setup function, as shown in the README's Composition API examples for dynamic viewer creation.

Question 2

v-viewer vs viewer.js: which should I choose for Vue?

Accepted Answer

v-viewer is better if you want Vue-native integration with directives and components, while raw viewer.js is more flexible for non-Vue projects. v-viewer wraps viewer.js, so it adds convenience but depends on it.

Question 3

Can I customize the toolbar in v-viewer?

Accepted Answer

Yes, through the options prop or directive configuration, using viewer.js settings. The README includes a custom toolbar CodePen demo showing how to adjust buttons and layout.

Question 4

Does v-viewer support server-side rendering (SSR)?

Accepted Answer

It requires client-side JavaScript and Vue, so for SSR, you need to handle hydration carefully. The README doesn't cover SSR explicitly, so testing with frameworks like Nuxt is recommended.

Question 5

How to dynamically update images in v-viewer?

Accepted Answer

Use the component's images prop or trigger prop, and for the directive, apply modifiers like 'rebuild' to refresh the viewer when images change, as explained in the README's usage sections.

Question 6

Is v-viewer good for large image galleries?

Accepted Answer

It can handle galleries, but performance may degrade with many images due to re-renders. Use the 'static' modifier for fixed galleries to optimize, but monitor bundle size from viewer.js.

v-viewer

What is v-viewer?

Overview

Use Cases

Best For

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions