Vant3 Image 圖片

介紹

增強版的 img 標(biāo)簽，提供多種圖片填充模式，支持圖片懶加載、加載中提示、加載失敗提示。

實例演示

引入

通過以下方式來全局注冊組件，更多注冊方式請參考組件注冊。

import { createApp } from 'vue';
import { Image as VanImage } from 'vant';

const app = createApp();
app.use(VanImage);

代碼演示

基礎(chǔ)用法

基礎(chǔ)用法與原生 img 標(biāo)簽一致，可以設(shè)置 src、width、height、alt 等原生屬性。

<van-image width="100" height="100" src="https://img.yzcdn.cn/vant/cat.jpeg" rel="external nofollow"  rel="external nofollow"  rel="external nofollow"  rel="external nofollow"  rel="external nofollow"  rel="external nofollow"  />

填充模式

通過 fit 屬性可以設(shè)置圖片填充模式，可選值見下方表格。

<van-image
  width="10rem"
  height="10rem"
  fit="contain"
  src="https://img.yzcdn.cn/vant/cat.jpeg" rel="external nofollow"  rel="external nofollow"  rel="external nofollow"  rel="external nofollow"  rel="external nofollow"  rel="external nofollow" 
/>

圓形圖片

通過 round 屬性可以設(shè)置圖片變圓，注意當(dāng)圖片寬高不相等且 fit 為 contain 或 scale-down 時，將無法填充一個完整的圓形。

<van-image
  round
  width="10rem"
  height="10rem"
  src="https://img.yzcdn.cn/vant/cat.jpeg" rel="external nofollow"  rel="external nofollow"  rel="external nofollow"  rel="external nofollow"  rel="external nofollow"  rel="external nofollow" 
/>

圖片懶加載

設(shè)置 lazy-load 屬性來開啟圖片懶加載，需要搭配 Lazyload 組件使用。

<van-image
  width="100"
  height="100"
  lazy-load
  src="https://img.yzcdn.cn/vant/cat.jpeg" rel="external nofollow"  rel="external nofollow"  rel="external nofollow"  rel="external nofollow"  rel="external nofollow"  rel="external nofollow" 
/>

import { createApp } from 'vue';
import { Lazyload } from 'vant';

const app = createApp();
app.use(Lazyload);

加載中提示

Image 組件提供了默認(rèn)的加載中提示，支持通過 loading 插槽自定義內(nèi)容。

<van-image src="https://img.yzcdn.cn/vant/cat.jpeg" rel="external nofollow"  rel="external nofollow"  rel="external nofollow"  rel="external nofollow"  rel="external nofollow"  rel="external nofollow" >
  <template v-slot:loading>
    <van-loading type="spinner" size="20" />
  </template>
</van-image>

加載失敗提示

Image 組件提供了默認(rèn)的加載失敗提示，支持通過 error 插槽自定義內(nèi)容。

<van-image src="https://img.yzcdn.cn/vant/cat.jpeg" rel="external nofollow"  rel="external nofollow"  rel="external nofollow"  rel="external nofollow"  rel="external nofollow"  rel="external nofollow" >
  <template v-slot:error>加載失敗</template>
</van-image>

API

Props

圖片填充模式

Events

Slots

主題定制

樣式變量

組件提供了下列 CSS 變量，可用于自定義樣式，使用方法請參考 ConfigProvider 組件。

常見問題

如何引用本地圖片？

在 .vue 文件中通過相對路徑引用本地圖片時，需要在圖片的鏈接外包上一層 require()，將圖片 URL 轉(zhuǎn)換為 webpack 模塊請求，并結(jié)合 file-loader 或者 url-loader 進行處理。

<!-- 錯誤寫法 -->
<van-image src="./image.png" />

<!-- 正確寫法 -->
<van-image :src="require('./image.png')" />


    

對此更詳細(xì)的解釋可以參考 vue-loader 的處理資源路徑章節(jié)。

使用 image 標(biāo)簽無法渲染？

使用 Image 組件時，可能會遇到將 <image> 作為標(biāo)簽名時無法渲染的問題，比如下面的寫法：

<template>
  <image src="xxx" />
</template>

<script>
import { Image } from 'vant';

export default {
  components: {
    Image,
  },
};
<script>

這是因為 <image> 標(biāo)簽是原生的 SVG 標(biāo)簽，Vue 不允許將原生標(biāo)簽名注冊為組件名，使用 <van-image> 即可規(guī)避這個問題。