本文详解UniApp中利用render.js进行地图开发的原理与实践。重点解析视图层与逻辑层的通信机制,涵盖OpenLayers及ArcGIS等库的集成方法,通过具体代码示例说明如何规避DOM操作限制,实现高效地图交互与数据同步。
在UniApp开发中,利用render.js实现OpenLayers、ArcGIS等地图库的操作是一项常见且重要的技术实践。
一、为什么需要render.js
render.js主要应用于APP端。由于UniApp的技术栈本质上是Vue、JavaScript和HTML的组合,其底层仍属于H5范畴,因此默认情况下是对DOM元素进行操作。然而,在原生APP环境中并不存在DOM元素的概念。为了解决这一差异,UniApp引入了render.js作为视图层的渲染工具。
备注:
在APP开发中,存在视图层与逻辑层的概念区分:
视图层:指用户在APP界面上看到的元素,类似于Web开发中的HTML结构。
逻辑层:负责实现APP的各项业务逻辑和操作,类似于Web开发中JavaScript所承担的功能。
在render.js的架构中,视图层与逻辑层的定义如下:
视图层:通过设置lang="renderjs"的<script>标签来定义。
逻辑层:即普通的<script>标签,负责处理业务逻辑。
二、render.js的作用
render.js运行在视图层,其主要作用是大幅降低逻辑层与视图层之间的通信损耗,从而显著提升视图交互的性能与响应能力。
它允许在视图层直接操作DOM,并运行标准的Web JavaScript库,从而支持对DOM元素的直接操控。
三、如何使用render.js
3.1 基本用法
在原有的Vue文件script标签同级位置,新增一个script标签,并设置lang=renderjs。同时,通过module属性指定模块名称(值可任意),该名称将作为命名空间,后续将通过此名称调用其中定义的方法。
//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访问不带lang属性的逻辑层数据;反之,逻辑层不能直接通过this.xxx获取视图层的数据。
4、在带有render.js的视图层中,调用方法时可以通过this.$ownerInstance.callMethod('函数名', 数据)向不带lang属性的逻辑层发送数据。
5、由于renderjs的视图层与uni的普通script逻辑层运行在同一环境中,无法保证加载顺序。因此,建议将DOM操作部分放置在renderjs中,所有数据通过传递后,在renderjs中进行处理。
在renderjs中,可能会出现获取不到数据的情况。请确保组件数据优先于renderjs加载,并确认所传输的数据具有有效值。
<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等方法。这些方法需在原生层调用后,通过触发监听将数据传入renderjs。
2. 在APP端,renderjs层的data与原生层的data互不相干,各自独立。
3. this.$ownerInstance.callMethod方法必须通过点击事件执行。
4. 地图相关的方法都要写在renderjs层中,不能使用子组件。因此,所有数据需传递到render.js中进行操作,不能在子组件中直接调用地图的API方法。
5、在template中使用一开始给renderjs设置的命名加.的方式调用其中的方法。
总结
至此,关于UniApp中使用render.js进行OpenLayers、ArcGIS等地图操作的指南介绍完毕。如需了解更多相关UniApp render.js地图操作内容,请搜索本站以前的文章或继续浏览下面的相关文章。希望大家以后多多支持本站!