uniapp中使用render.js进行openers、arcgis等地图操作
一、为啥需要render.js
render.js主要作用于APP上,因为Uniapp本质为vue+js+html进行开发,整个技术栈还是H5,对DOM元素进行操作。而APP中没用Dom元素这个概念。因此利用render.js这个视图层的工具来进行渲染。
备注:
app中视图层和逻辑层的概念:
视图层:就是我们看到的APP上的元素,类似于web中的HTML那些
逻辑层:就是APP上实现各种操作的东西,类似于web的js干的事情。
render.js中的视图层和逻辑层:
视图层就是使用ang="renderjs"的<script>标签
逻辑层就是普通的<script>标签
二、render.js干啥的
运行在视图层的js,大幅度降低逻辑层和视图层的通讯损耗,提高视图交互能力。
在视图层操作DOM,运行web的js库。可以操作DOM。
三、怎么使用render.js
3.1 基本用法
在原先vue文件内的的script标签的同级新增一个script,设置lang=renderjs
,module=(值任意,相当于命名空间,之后会根据这个名字调用其中的方法)。
javascript
//test为render.js模块的名称,lang是固定写法 lang="renderjs"表示这个script内是render.js
<script module="test" lang="renderjs">
export default {
mounted() {
// ...
},
methods: {
// ...
}
}
</script>
3.2 使用规则
1、页面渲染、使用props传值只能使用逻辑层的数据,就是template里面的HTML元素传值要使用不带lang的script标签data内定义的变量。
2、按钮的事件,逻辑层通过HTML标签定义的事件比如直接使用button控件的 @click,视图层通过document操作dom元素。
3、带render.js的视图层可以通过this.XXX拿到啥不带的逻辑层的数据;逻辑层不能直接通过this.xxx拿到视图层的数据
4、带render.js的视图层,调用方法时,可以通过this.$ownerInstance.callMethod('函数名', 数据)向啥不带的逻辑层发送数据
5、由于renderjs的视图层与uni的普通script逻辑层运行在同一环境,不能保证加载顺序,所以,尽量把操作dom部分放在renderjs中,所有数据通过数据传递后,在renderjs中操作。
在renderjs中,可能会有获取不到数据的情况,请确保组件数据优先与renderjs加载,确定所传输的数据有值
html
<template>
<view class="demo">
<!-- info随便写,但是要与chang后面的一致,text是renderjsmodule名称 -->
<!--data是要想renderjs发送的数据,updateData是renderjs中的监听方法 -->
//下面这个写法,会监听逻辑层变量data,data值发生变化的时候,会自动调用视图层text中定义的updateData方法
<view @click="text.onClick" :info="data" :change:info="text.updateData" ref="video"></view>
<view> {{data}}</view>
<button @click="text.emitData">直接调用renderjs中的emitData的方法</button>
</view>
</template>
<!-- 普通的script标签 -->
<script>
export default {
data(){
return {
data: "hello"
}
},
methods:{
sendMsg(msg) {
console.log(msg) // 不好
},
getMessage(options){
console.log("测试renderjs调用此方法:"+JSON.stringify(options))
}
// 接收renderjs发回的数据
receiveRenderData(val) {
console.log('renderjs返回的值-->', val);
},
}
}
</script>
<!-- renderjs的script标签 -->
<script module="text" lang="renderjs">
export default {
data(){
return {
name:'我是render.js中的值'
}
},
methods:{
onClick(event, ownerInstance) {
// 向 uni 的script发送信息,实现视图层向逻辑层发送数据
ownerInstance.callMethod('sendMsg', '不好')
//或者另外一个写法
this.$ownerInstance.callMethod('sendMsg', '不好')
},
updateData(newValue, oldValue, ownerInstance, instance) {
// newValue: 新数据
// oldValue: 老数据
ownerInstance.callMethod('getMessage',{
test: '123'
}) //调用vue页面普通script标签内的getMessage方法,传递个json{test:'123'}
// 向uni-app页面组件发送信息
this.sendMsg();
},
// 发送数据到逻辑层
emitData(e, ownerVm) {
ownerVm.callMethod('receiveRenderData', this.name)
}
sendMsg() {
// 向页面传参
this.$ownerInstance.callMethod('getMessage','123')
},
}
}
</script>
使用注意事项:
1、render.js的生命周期不和uniapp相同,而是和vue相同。
2、可以使用 vue 组件的生命周期(不支持 beforeDestroy、destroyed、beforeUnmount、unmounted),不可以使用 App、Page 的生命周期
3、视图层和逻辑层通讯方式与 WXS 一致,另外可以通过 this.$ownerInstance 获取当前组件的 ComponentDescriptor 实例。
4、注意逻辑层给数据时最好一次性给到渲染层,而不是不停从逻辑层向渲染层发消息,那样还是会产生逻辑层和视图层的多次通信,还是会卡。
5、观测更新的数据在视图层可以直接访问到
6、APP 端视图层的页面引用资源的路径相对于根目录计算,例如:./static/test.js
++特别注意事项++:
1.在renderjs层不能使用uni或其他框架的API,例如uni.request、uni.getlocation等等方法,需在原生层调用后触发监听将数据传入。
2.在APP端renderjs层的data与原生层的data互不相干
3.this.$ownerInstance.callMethod方法必须通过点击事件执行
4.地图方法都要写在renderjs层中,不能使用子组件,所以都要传值到render.js中操作,不能再子组件中调用地图的API方法。
5、在template中使用一开始给renderjs的命名加.
的方式调用其中的方法