tencent cloud

PrevNext

文档反馈

请输入关键字

Recent Pages

文档
腾讯云小程序平台
    文档
    Download PDF

    开放能力

    最后更新时间：2024-10-29 18:16:59
    下载PDF

      web-view

      功能说明：承载网页的容器。会自动铺满整个小程序页面。
      参数及说明：
      属性
      类型
      默认值
      说明
      src
      string
      -
      webview 指向网页的链接。网页需登录小程序管理后台配置业务域名。
      bindmessage
      eventhandler
      -
      网页使用 wx.miniProgram.postMessage 方法向小程序发送消息时，小程序会在特定时机（小程序后退、组件销毁、分享）触发并收到消息。e.detail = { data }，data 是多次 postMessage 的参数组成的数组
      bindload
      eventhandler
      -
      网页加载成功时候触发此事件。e.detail = { src }
      binderror
      eventhandler
      -
      网页加载失败的时候触发此事件。e.detail = { url, fullUrl }，其中 fullUrl 为加载失败时的完整 url
      bindevent
      eventhandler
      -
      网页使用 wx.miniProgram.sendWebviewEvent 方法向小程序发送消息时，小程序会触发此事件。e.detail = { data }，data 是 sendWebviewEvent 的参数
      注意：
      网页内 iframe 的域名也需要配置到域名白名单。
      开发者工具上，可以在 <web-view> 组件上击调试按钮，打开 <web-view> 组件的调试。
      每个页面只能有一个 <web-view>，<web-view> 会自动铺满整个页面，并覆盖其他组件。
      <web-view> 网页与小程序之间不支持除 JSSDK 提供的接口之外的通信。
      避免在链接中带有中文字符，在 iOS 中会有打开白屏的问题，建议加一下 encodeURIComponent。
      相关接口详见JSSDK接口说明
      <web-view>组件所在页面的导航栏标题优先级：<title></title>(H5网页) > wx.navigationBarTitleText(miniprogram) > navigationBarTitleText(page.json)> navigationBarTitleText(app.json)

      授权

      部分接口需要经过用户授权同意才能调用。我们把这些接口按使用范围分成多个 scope ，用户选择对 scope 来进行授权，当授权给一个 scope 之后，其对应的所有接口都可以直接使用。
      此类接口调用时：
      如果用户未接受或拒绝过此权限，会弹窗询问用户，用户单击同意后方可调用接口；
      如果用户已授权，可以直接调用接口；
      如果用户已拒绝授权，则不会出现弹窗，而是直接进入接口 fail 回调。请开发者兼容用户拒绝授权的场景。

      获取用户授权设置

      开发者可以使用 wx.getSetting 获取用户当前的授权状态。

      打开设置界面

      用户可以在小程序设置界面（「右上角」 - 「设置」）中控制对该小程序的授权状态。
      开发者可以调用 wx.openSetting 打开设置界面，引导用户开启授权。

      提前发起授权请求

      开发者可以使用 wx.authorize 在调用需授权 API 之前，提前向用户发起授权请求。

      scope 列表

      scope
      对应接口
      描述
      scope.userinfo
      wx.getUserInfo
      用户信息
      scope.userLocation
      wx.getLocation、wx.startLocationUpdate、wx.startLocationUpdateBackground
      获取地理位置信息
      scope.userFuzzyLocation
      wx.getFuzzyLocation
      获取模糊地理位置信息
      scope.record
      live-pusher 组件 or wx.startRecord、wx.operateRecorder
      直播或者录音
      scope.camera
      camera 组件
      相机组件
      scope.addPhoneCalendar
      wx.addPhoneCalendar
      添加日志
      scope.writePhotosAlbum
      wx.saveImageToPhotosAlbum
      保存图片到相册
      scope.bluetooth
      wx.openBluetoothAdapter
      蓝牙
      scope.chooseImage
      wx.chooseImage
      选择相册中的图片
      scope.chooseVideo
      wx.chooseVideo
      选择相册中的视频
      scope.chooseMedia
      wx.chooseMedia
      媒体
      scope.makeMedia
      wx.makeMedia
      媒体
      scope.addPhoneContact
      wx.addPhoneContact、wx.chooseContact
      添加/选择联系人

      授权有效期

      一旦用户明确同意或拒绝过授权，其授权关系会记录在客户端本地，直到删除小程序。

      最佳实践

      在真正需要使用授权接口时，才向用户发起授权申请，并在授权申请中说明清楚要使用该功能的理由。
      
      联系我们

      联系我们，为您的业务提供专属服务。

      联系我们
      技术支持

      如果你想寻求进一步的帮助，通过工单与我们进行联络。我们提供7x24的工单服务。

      提交工单
      7x24 电话支持
      Copyright © 2013-2024 Tencent Cloud. All Rights Reserved.
      隐私条款服务条款缓存条款