引入

ImagePreview和其他組件不同，不是通過HTML結構的方式來使用，而是通過函數(shù)調用的方式。使用前需要先引入它。

import Vue from 'vue';
import { ImagePreview } from 'vant';

Vue.use(ImagePreview);

代碼演示

基礎用法

直接傳入圖片數(shù)組，即可展示圖片預覽

ImagePreview([
  'https://img.yzcdn.cn/1.jpg',
  'https://img.yzcdn.cn/2.jpg'
]);

傳入配置項

通過傳入配置對象，可以指定初始圖片的位置、監(jiān)聽關閉事件

ImagePreview({
  images: [
    'https://img.yzcdn.cn/1.jpg',
    'https://img.yzcdn.cn/2.jpg'
  ],
  startPosition: 1,
  onClose() {
    // do something
  }
});

異步關閉

通過asyncClose屬性可以開啟異步關閉，開啟后異步關閉后，只能通過實例上的 close 方法關閉圖片預覽

const instance = ImagePreview({
  images: [
    'https://img.yzcdn.cn/1.jpg',
    'https://img.yzcdn.cn/2.jpg'
  ],
  asyncClose: true
});

setTimeout(() => {
  instance.close();
}, 1000);

組件調用

如果需要在圖片預覽內嵌入組件或其他自定義內容，可以使用組件調用的方式，調用前需要通過 Vue.use 注冊組件

<van-image-preview v-model="show" :images="images" @change="onChange">
  <template v-slot:index>第{{ index }}頁</template>
</van-image-preview>

export default {
  data() {
    return {
      show: false,
      index: 0,
      images: [
        'https://img.yzcdn.cn/1.jpg',
        'https://img.yzcdn.cn/2.jpg'
      ]
    };
  },

  methods: {
    onChange(index) {
      this.index = index;
    }
  }
}

API

Options

通過函數(shù)調用 ImagePreview 時，支持傳入以下選項：

Props

通過組件調用 ImagePreview 時，支持以下 Props：

Events

通過組件調用 ImagePreview 時，支持以下事件：

Slots

通過組件調用 ImagePreview 時，支持以下插槽：

onClose 回調參數(shù)

常見問題

在桌面端無法操作組件？

參見在桌面端使用。