<web-view>
基礎庫 1.6.4 開始支持,低版本需做兼容處理
web-view 組件是一個可以用來承載網頁的容器,<strong>會自動鋪滿整個小程序頁面</strong>。<strong>個人類型與海外類型的小程序暫不支持使用。</strong>
屬性名 | 類型 | 默認值 | 說明 |
---|---|---|---|
src | String | none | webview 指向網頁的鏈接。需登錄小程序管理后臺配置域名白名單。 |
示例代碼:
<!-- wxml -->
<web-view src="https://mp.weixin.qq.com/"></web-view>
相關接口 1
<web-view/>網頁中可使用JSSDK 1.3.0提供的接口返回小程序頁面。 支持的接口有:
接口名 | 說明 | 最低版本 |
---|---|---|
wx.miniProgram.navigateTo | 參數與小程序接口一致 | 1.6.4 |
wx.miniProgram.navigateBack | 參數與小程序接口一致 | 1.6.4 |
wx.miniProgram.switchTab | 參數與小程序接口一致 | 即將開放 |
wx.miniProgram.reLaunch | 參數與小程序接口一致 | 即將開放 |
wx.miniProgram.redirectTo | 參數與小程序接口一致 | 即將開放 |
示例代碼:
<!-- html -->
<script type="text/javascript" src="https://res.wx.qq.com/open/js/jweixin-1.3.0.js"></script>
// javascript
wx.miniProgram.nav igateTo({url: '/path/to/page'})
相關接口 2
<web-view/>網頁中僅支持以下JSSDK接口:
接口模塊 | 接口說明 | 具體接口 |
---|---|---|
判斷客戶端是否支持js | checkJSApi | |
圖像接口 | 拍照或上傳 | chooseImage |
預覽圖片 | previewImage | |
上傳圖片 | uploadImage | |
下載圖片 | downloadImage | |
獲取本地圖片 | getLocalImgData | |
音頻接口 | 開始錄音 | startRecord |
停止錄音 | stopRecord | |
監聽錄音自動停止 | onVoiceRecordEnd | |
播放語音 | playVoice | |
暫停播放 | pauseVoice | |
停止播放 | stopVoice | |
監聽語音播放完畢 | onVoicePlayEnd | |
上傳接口 | uploadVoice | |
下載接口 | downloadVoice | |
智能接口 | 識別音頻 | translateVoice |
設備信息 | 獲取網絡狀態 | getNetworkType |
地理位置 | 使用內置地圖 | getLocation |
獲取地理位置 | openLocation | |
搖一搖周邊 | 開啟ibeacon | startSearchBeacons |
關閉ibeacon | stopSearchBeacons | |
監聽ibeacon | onSearchBeacons | |
微信掃一掃 | 調起微信掃一掃 | scanQRCode |
微信卡券 | 拉取使用卡券列表 | chooseCard |
批量添加卡券接口 | addCard | |
查看微信卡包的卡券 | openCard | |
長按識別 | 小程序圓形碼 | 無 |
相關接口 3
用戶分享時可獲取當前<web-view/>的URL,即在onShareAppMessage回調中返回webViewUrl參數。
示例代碼:
Page({
onShareAppMessage(options) {
console.log(options.webViewUrl)
}
})
相關接口 4
在網頁內可通過window.__wxjs_environment變量判斷是否在小程序環境。
示例代碼:
// web-view下的頁面內
console.log(window.__wxjs_environment === 'miniprogram') // true
快速接入<web-view>
1. 由于該組件是由基礎庫1.6.4開始支持,需先更新開發者工具,選擇基礎庫版本1.6.4
屏幕快照 2017-11-08 11.30.05.png
2. 配置業務域名
開發者登錄小程序后臺mp.weixin.qq.com,選擇設置-開發設置-業務域名,新增配置域名模塊
業務域名配置
3. wxml中,使用<web-view>組件,并設置src為上面配置的域名
<web-view src="https://tongdulong.cccwei.com/"></web-view>
調研中遇到的問題
問題一 :
屏幕快照 2017-11-08 11.34.53.png
出現該錯誤是由于域名沒有成功配置,或者沒有使用https
問題二 :
image.png
問題三 :
image.png
在配置wx.config時url必須為當前頁面url
html文件最好直接命名為index.html