Vant4 Image 圖片

介紹

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

引入

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

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

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

代碼演示

基礎用法

基礎用法與原生 ?img? 標簽一致，可以設置 ?src?、?width?、?height?、?alt? 等原生屬性。

<van-image
  width="100"
  height="100"
  src="https://fastly.jsdelivr.net/npm/@vant/assets/cat.jpeg" rel="external nofollow"  rel="external nofollow"  rel="external nofollow"  rel="external nofollow"  rel="external nofollow"  rel="external nofollow"  rel="external nofollow" 
/>

填充模式

通過 ?fit? 屬性可以設置圖片填充模式，等同于原生的 object-fit 屬性，可選值見下方表格。

<van-image
  width="10rem"
  height="10rem"
  fit="contain"
  src="https://fastly.jsdelivr.net/npm/@vant/assets/cat.jpeg" rel="external nofollow"  rel="external nofollow"  rel="external nofollow"  rel="external nofollow"  rel="external nofollow"  rel="external nofollow"  rel="external nofollow" 
/>

圖片位置

通過 ?position? 屬性可以設置圖片位置，結合 ?fit? 屬性使用，等同于原生的 object-position 屬性。

<van-image
  width="10rem"
  height="10rem"
  fit="cover"
  position="left"
  src="https://fastly.jsdelivr.net/npm/@vant/assets/cat.jpeg" rel="external nofollow"  rel="external nofollow"  rel="external nofollow"  rel="external nofollow"  rel="external nofollow"  rel="external nofollow"  rel="external nofollow" 
/>

圓形圖片

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

<van-image
  round
  width="10rem"
  height="10rem"
  src="https://fastly.jsdelivr.net/npm/@vant/assets/cat.jpeg" rel="external nofollow"  rel="external nofollow"  rel="external nofollow"  rel="external nofollow"  rel="external nofollow"  rel="external nofollow"  rel="external nofollow" 
/>

圖片懶加載

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

<van-image
  width="100"
  height="100"
  lazy-load
  src="https://fastly.jsdelivr.net/npm/@vant/assets/cat.jpeg" rel="external nofollow"  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? 組件提供了默認的加載中提示，支持通過 ?loading? 插槽自定義內容。

<van-image src="https://fastly.jsdelivr.net/npm/@vant/assets/cat.jpeg" rel="external nofollow"  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? 組件提供了默認的加載失敗提示，支持通過 ?error? 插槽自定義內容。

<van-image src="https://fastly.jsdelivr.net/npm/@vant/assets/cat.jpeg" rel="external nofollow"  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

類型定義

組件導出以下類型定義：

import type { ImageFit, ImagePosition, ImageProps } from 'vant';

主題定制

樣式變量

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

常見問題

如何引用本地圖片？

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

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

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

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

使用 image 標簽無法渲染？

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

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

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

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

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