# JSSDK

# 1. web-view 组件

承载网页内容的容器组件。

基础库 3.6.4 起，SDK 2.47.11 起，支持在 web-view 页面使用 cover-view 组件

若在 web-view 内嵌套使用，因底层渲染层级的原因，web-view 下的 cover-view 节点必须要添加一个 fixed 定位的根节点，例如：

<web-view src="https://some-url.com">
    <cover-view style="position: fixed;top: 0;right: 0;width: 100vw;height: 100vh;">
        ...
    </cover-view>
</web-view>

也可以以下方式使用，作为根节点的 cover-view 也建议添加 position: fixed，规避层级问题

<web-view src="https://some-url.com">
</web-view>
<cover-view style="position: fixed;top: 0;right: 0;width: 100vw;height: 100vh;">
    ...
</cover-view>

属性说明

属性	类型	必填	说明
src	string	否	打开的网页链接
timeout	number	0	指定超时事件，若规定时间内没收到网页调用 ft.complete()，则会触发 bindtimeout 事件
bindmessage	eventhandler	否	网页向小程序 postMessage 时，会在特定时机（小程序后退、组件销毁、分享）触发并收到消息。e.detail = { data }，data 是多次 postMessage 的参数组成的数组
bindload	eventhandler	否	网页加载成功时候触发此事件。e.detail = { src }
binderror	eventhandler	否	网页加载失败的时候触发此事件。e.detail = { src }
bindevent	eventhandler	否	接收网页通过 JSSDK 发送的数据
bindtimeout	eventhandler	否	仅在 timeout 有配置时生效，网页加载超时以及网没有调用 ft.complete 时触发

# 2. JSSDK 介绍

web-view 网页中可使用 JSSDK，通过使用 JSSDK，网页开发者可高效地使用拍照、选图、语音、位置等手机系统的能力，同时可以直接使用小程序的特有能力，为用户提供更优质的网页体验。

由于 JSSDK 是基于小程序中的 web-view 组件提供的能力，因此仅在小程序中使用 web-view 打开域名链接才可以调用 JSSDK。web-view 打开的链接受白名单管控，请在管理后台「开发管理-域名设置」中配置白名单域名地址。

# 3. 如何在 web-view 中使用 JSSDK

# 3.1 网页中通过 script 标签引入

<script src="path/to/jssdk.min.js">

JSSDK 1.4.20 (opens new window)

JSSDK 1.4.20(ESM) (opens new window)

# 3.2 通过 npm 引入

1、安装

npm install finclip-js-sdk

2、使用