we-script 微信小程序加载远程 JavaScript 脚本开源项目

我要开发同款
匿名用户2020年09月21日
19阅读
开发技术JavaScript
所属分类手机/移动开发、微信小程序
授权协议MIT

作品详情

让微信小程序支持加载远程JavaScript脚本并执行组件,支持ES5语法。

Github地址:https://github.com/bplok20010/we-script

使用

小程序如何使用npm包,官方文档:https://developers.weixin.qq.com/miniprogram/dev/devtools/npm.html

npminstall--savewe-script

step1安装完成后,点击开发者工具中的菜单栏:工具-->构建npm

step2安装完成后,点击开发者工具中的菜单栏:工具-->项目详情-->本地设置-->[勾选]使用npm模块

在需要用的页面或组件的json文件添加声明,示例:

index.json

{"usingComponents":{"we-script":"we-script"}}

index.wxml

<we-scriptsrc="url"><view>hellowe-script<view></we-script>

注:多个we-script会并行加载及无序执行,无法保证执行顺序。如:

//并行加载及无序执行<we-scriptsrc="url1"/><we-scriptsrc="url2"/><we-scriptsrc="url3"/>

如需要确保执行顺序,应该使用数组,例如:

数组方式

<we-scriptsrc="{{[url1,url2,url3]}}"><view>hellowe-script<view></we-script>

we-script也支持嵌套,如:

<we-scriptsrc="url1"><we-scriptsrc="url2"><view>hellowe-script<view></we-script></we-script>

注意: 在嵌套的情况下we-script加载和执行也是并行且无序的,因为小程序生命周期触发机制(BUG?)导致,如果想在嵌套模式下保证顺序,需要自己手动控制,示例:

<we-scriptbind:onLoad="loadScript"src="url1"><we-scriptwx:if="url1_load_success"src="url2"><view>hellowe-script<view></we-script></we-script>

重要: 远程加载执行的代码所生成的函数,变量等数据存储在we-script默认的上下文中,可通过onLoad事件获取默认上下文,或通过onInit事件自定义上下文。

示例:

we-script-demo

we-script属性src

类型:string|string[]

要加载的远程脚本

text

类型:string|string[]

需要执行的JavaScript脚本字符串,text 优先级高于 src (互斥)

timeout

类型:number默认值:60000 毫秒

设置每个远程脚本加载超时时间

cache

类型:boolean

默认值:true

是否启用加载缓存,缓存策略是以当前请求地址作为key,缓存周期为当前用户在使用期间的生命周期。

once

类型:boolean

默认值:true

相同上下文及相同地址的脚本只执行一次。

we-script事件onInit

类型:(e)=>void

interfaceOnInitDetail{getContext:()=>{};setContext:(context:{})=>void;}

初始事件,监听该事件可获取当前执行上下文或自定义执行上下文。

示例:

//index.js{onInit(e){//自定义执行上下文e.detail.setContext({value:100})}}//index.wxml<we-scriptsrc="url"bind:onInit="onInit"/>onLoad

类型:(e)=>void

interfaceonLoadDetail{context:{};}

加载并执行成功后触发

onError

类型:(e)=>void

interfaceonErrorDetail{error:any;}

加载失败或执行错误后触发

其他

该组件使用eval5来解析JavaScript语法,支持 ES5

上生产环境前别忘记给需要加载的地址配置合法域名

we-script 内置类型及方法:

NaN;Infinity;undefined;null;Object;Array;String;Boolean;Number;Date;RegExp;Error;URIError;TypeError;RangeError;SyntaxError;ReferenceError;Math;parseInt;parseFloat;isNaN;isFinite;decodeURI;decodeURIComponent;encodeURI;encodeURIComponent;escape;unescape;eval;Function;console;setTimeout;clearTimeout;setInterval;clearInterval;wx;

内置类型和当前运行JavaScript环境相关,如环境本身不支持则不支持!

声明:本文仅代表作者观点,不代表本站立场。如果侵犯到您的合法权益,请联系我们删除侵权资源!如果遇到资源链接失效,请您通过评论或工单的方式通知管理员。未经允许,不得转载,本站所有资源文章禁止商业使用运营!
下载安装【程序员客栈】APP
实时对接需求、及时收发消息、丰富的开放项目需求、随时随地查看项目状态

评论