uniapp中使用render.js进行openlayers、arcgis等地图操作_renderjs

uniapp中使用render.js进行openlayers、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=(值任意，相当于命名空间，之后会根据这个名字调用其中的方法)。

//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加载，确定所传输的数据有值

<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的命名加.的方式调用其中的方法