#### image
圖片。
| 屬性名 | 類型 | 默認值 | 說明 | 最低版本 |
| --------- | ----------- | ------------- | ---------------------------------------- | ---------------------------------------- |
| src | String | | 圖片資源地址 | |
| mode | String | 'scaleToFill' | 圖片裁剪、縮放的模式 | |
| lazy-load | Boolean | false | 圖片懶加載。只針對page與scroll-view下的image有效 | [1.5.0](https://mp.weixin.qq.com/debug/wxadoc/dev/framework/compatibility.html) |
| binderror | HandleEvent | | 當錯誤發生時,發布到 AppService 的事件名,事件對象event.detail = {errMsg: 'something wrong'} | |
| bindload | HandleEvent | | 當圖片載入完畢時,發布到 AppService 的事件名,事件對象event.detail = {height:'圖片高度px', width:'圖片寬度px'} | |
**注:image組件默認寬度300px、高度225px**
**mode 有效值:**
mode 有 13 種模式,其中 4 種是縮放模式,9 種是裁剪模式。
| 模式 | 值 | 說明 |
| ---- | ------------ | ---------------------------------------- |
| 縮放 | scaleToFill | 不保持縱橫比縮放圖片,使圖片的寬高完全拉伸至填滿 image 元素 |
| 縮放 | aspectFit | 保持縱橫比縮放圖片,使圖片的長邊能完全顯示出來。也就是說,可以完整地將圖片顯示出來。 |
| 縮放 | aspectFill | 保持縱橫比縮放圖片,只保證圖片的短邊能完全顯示出來。也就是說,圖片通常只在水平或垂直方向是完整的,另一個方向將會發生截取。 |
| 縮放 | widthFix | 寬度不變,高度自動變化,保持原圖寬高比不變 |
| 裁剪 | top | 不縮放圖片,只顯示圖片的頂部區域 |
| 裁剪 | bottom | 不縮放圖片,只顯示圖片的底部區域 |
| 裁剪 | center | 不縮放圖片,只顯示圖片的中間區域 |
| 裁剪 | left | 不縮放圖片,只顯示圖片的左邊區域 |
| 裁剪 | right | 不縮放圖片,只顯示圖片的右邊區域 |
| 裁剪 | top left | 不縮放圖片,只顯示圖片的左上邊區域 |
| 裁剪 | top right | 不縮放圖片,只顯示圖片的右上邊區域 |
| 裁剪 | bottom left | 不縮放圖片,只顯示圖片的左下邊區域 |
| 裁剪 | bottom right | 不縮放圖片,只顯示圖片的右下邊區域 |
**示例:**
```
<view class="page">
<view class="page__hd">
<text class="page__title">image</text>
<text class="page__desc">圖片</text>
</view>
<view class="page__bd">
<view class="section section_gap" wx:for="{{array}}" wx:for-item="item">
<view class="section__title">{{item.text}}</view>
<view class="section__ctn">
<image style="width: 200px; height: 200px; background-color: #eeeeee;" mode="{{item.mode}}" src="{{src}}"></image>
</view>
</view>
</view>
</view>
Page({
data: {
array: [{
mode: 'scaleToFill',
text: 'scaleToFill:不保持縱橫比縮放圖片,使圖片完全適應'
}, {
mode: 'aspectFit',
text: 'aspectFit:保持縱橫比縮放圖片,使圖片的長邊能完全顯示出來'
}, {
mode: 'aspectFill',
text: 'aspectFill:保持縱橫比縮放圖片,只保證圖片的短邊能完全顯示出來'
}, {
mode: 'top',
text: 'top:不縮放圖片,只顯示圖片的頂部區域'
}, {
mode: 'bottom',
text: 'bottom:不縮放圖片,只顯示圖片的底部區域'
}, {
mode: 'center',
text: 'center:不縮放圖片,只顯示圖片的中間區域'
}, {
mode: 'left',
text: 'left:不縮放圖片,只顯示圖片的左邊區域'
}, {
mode: 'right',
text: 'right:不縮放圖片,只顯示圖片的右邊邊區域'
}, {
mode: 'top left',
text: 'top left:不縮放圖片,只顯示圖片的左上邊區域'
}, {
mode: 'top right',
text: 'top right:不縮放圖片,只顯示圖片的右上邊區域'
}, {
mode: 'bottom left',
text: 'bottom left:不縮放圖片,只顯示圖片的左下邊區域'
}, {
mode: 'bottom right',
text: 'bottom right:不縮放圖片,只顯示圖片的右下邊區域'
}],
src: '../../resources/cat.jpg'
},
imageError: function(e) {
console.log('image3發生error事件,攜帶值為', e.detail.errMsg)
}
})
```
- 簡介
- 第一章 公眾號開發
- 使用微信JSSDK
- 接口權限配置
- 分享接口
- 隱藏按鈕項
- 微信支付
- 第二章 小程序開發
- 基礎知識
- 分包加載
- WXSS樣式表
- 配置
- app.json配置
- window
- tabBar
- page.json配置
- 邏輯層
- app.js
- 場景值
- page.js
- 初始化數據
- 生命周期函數
- 頁面相關事件處理函數
- 事件處理函數
- 頁面實例方法
- 路由
- 文件作用域
- 模塊化
- 視圖層
- 模板語法
- 列表渲染
- 條件渲染
- 模板
- 事件
- 引用
- WXS語法規范
- WXS數據類型
- WXS控制流程
- WXS基礎類庫
- 組件
- 視圖容器
- view
- scroll-view
- swiper
- movable-view
- cover-view
- 基礎組件
- icon
- text
- rich-text
- progress
- 表單組件
- button
- checkbox
- form
- input
- label
- picker
- picker-view
- radio
- slider
- switch
- textarea
- 導航組件
- navigator
- 媒體組件
- audio
- image
- video
- camera
- 地圖組件
- map
- 畫布組件
- canvas
- 開放能力
- web-view
- 自定義組件
- 組件模版和樣式
- Component
- 組件傳值
- 組件事件
- Behaviors
- 組件間關系
- 網絡請求
- wx.request
- 微信登錄
- 獲取 openid 和 unionid
- 獲取用戶信息
- 將 wx.request 封裝為 promise
- 上傳圖片接口封裝
- 數據存儲
- 存儲數據和讀取數據
- 獲取數據緩存信息
- 移除數據緩存
- 獲取用戶設置
- openSetting
- getSetting
- 第三章 小游戲開發
- 參考資料