支付寶小程序媒體組件 圖片·Image

圖片。支持 JPG、PNG、SVG、WEBP（iOS 不支持動(dòng)圖）、GIF 等格式。

使用說(shuō)明

使用 webview 嵌套 H5 時(shí)，若遇到圖片資源不顯示問題，可參考 配置 H5 白名單流程 獲取 H5 頁(yè)面中所有的域名地址（含圖片靜態(tài)資源的地址），全部加入域名白名單中。

掃碼體驗(yàn)

示例代碼

<!-- API-DEMO page/component/image/image.axml -->
<view class="page">
  <view class="page-description">圖片</view>
  <view class="page-section" a:for="{{array}}" a:for-item="item">
    <view class="page-section-title">{{item.text}}</view>
    <view class="page-section-demo" onTap="onTap">
      <image class="image"
        data-name="{{item.mode}}"
        onTap="onTap"
        mode="{{item.mode}}" src="{{src}}" onError="imageError" onLoad="imageLoad" />
    </view>
  </view>
</view>
// API-DEMO page/component/image/image.js
Page({
  data: {
    array: [{
      mode: 'scaleToFill',
      text: 'scaleToFill：不保持縱橫比縮放圖片，使圖片完全適應(yīng)',
    }, {
      mode: 'aspectFit',
      text: 'aspectFit：保持縱橫比縮放圖片，使圖片的長(zhǎng)邊能完全顯示出來(lái)',
    }, {
      mode: 'aspectFill',
      text: 'aspectFill：保持縱橫比縮放圖片，只保證圖片的短邊能完全顯示出來(lái)',
    }, {
      mode: 'widthFix',
      text: 'widthFix：寬度不變，高度自動(dòng)變化，保持原圖寬高比不變',
    }, {
      mode: 'top',
      text: 'top：不縮放圖片，只顯示圖片的頂部區(qū)域',
    }, {
      mode: 'bottom',
      text: 'bottom：不縮放圖片，只顯示圖片的底部區(qū)域',
    }, {
      mode: 'center',
      text: 'center：不縮放圖片，只顯示圖片的中間區(qū)域',
    }, {
      mode: 'left',
      text: 'left：不縮放圖片，只顯示圖片的左邊區(qū)域',
    }, {
      mode: 'right',
      text: 'right：不縮放圖片，只顯示圖片的右邊邊區(qū)域',
    }, {
      mode: 'top left',
      text: 'top left：不縮放圖片，只顯示圖片的左上邊區(qū)域',
    }, {
      mode: 'top right',
      text: 'top right：不縮放圖片，只顯示圖片的右上邊區(qū)域',
    }, {
      mode: 'bottom left',
      text: 'bottom left：不縮放圖片，只顯示圖片的左下邊區(qū)域',
    }, {
      mode: 'bottom right',
      text: 'bottom right：不縮放圖片，只顯示圖片的右下邊區(qū)域',
    }],
    src: '/image/ant.png',
  },
  imageError(e) {
    console.log('image 發(fā)生 error 事件，攜帶值為', e.detail.errMsg);
  },
  onTap(e) {
    console.log('image 發(fā)生 tap 事件', e);
  },
  imageLoad(e) {
    console.log('image 加載成功', e);
  },
});
/* API-DEMO page/component/image/image.acss */
.page-section-demo {
  display: flex;
  justify-content: space-around;
}
.image {
  background-color: red;
  width: 100px;
  height: 100px;
}

屬性

注意：image 組件默認(rèn)寬度 300px、高度 225px

mode

mode 有 13 種模式，其中 4 種是縮放模式，9 種是裁剪模式。

縮放模式

裁剪模式

說(shuō)明：圖片高度不能設(shè)置為 auto，如果需要圖片高度為 auto，直接設(shè)置 mode 為 widthFix。

常見問題

image 標(biāo)簽支持讀取流文件嗎？

小程序中顯示二進(jìn)制數(shù)據(jù)流的圖片，需要先將二進(jìn)制數(shù)據(jù)轉(zhuǎn)成 base64 字符串，然后把 base64 字符串放在 image 中的 src 中實(shí)現(xiàn)顯示。

真機(jī)調(diào)用 image 組件，顯示的圖片被壓縮？

建議把 mode 值設(shè)為 widthFix。