开发一个封装iframe的vue组件
VUE的基本组成单元,我看应该是组件。用VUE开发前端项目,就是开发一个个组件,然后搭积木一样,将项目搭建出来。组件包含在页面,或者是更大的组件里面。在这里,组件与页面的界限,好像并不明显。事实上,对于单页应用,只有一个页面。
组件的好处,一是可以加强复用;二是能够将特定功能封装,利于调用;三是由于职责分明,组件高内聚,组件间低耦合,利于系统功能的优化、扩展和维护。好处多多。
开发组件,主要有2部分内容:1、组件内部逻辑2、外部接口由于我这两天弄的组件,里面包含有一个<iframe>,那么还有一部分工作内容:3、iframe接口
一、组件介绍这是一个地图插件。功能是展示地图,以及接受外部命令,加载图层、绘制图形等相关操作。地图采用arcgis for js实现。由于我们过去开发的项目,地图操作有一些积累,不过并没有前后端分离,没有采用VUE或REACT,还是传统的WEB页面。因为时间紧,也想直接复用以前的成果,于是考虑用<iframe>承载地图页面,封装在VUE组件里,由组件对接外部命令并与iframe里的地图页面交互。
二、组件内部结构及逻辑1、代码组织结构2、地图组件Map.vue
<template> <div class='map-container'> <!-- 承载地图页面 --> <iframe :src='https://www.haobala.com/bcjs/src' ref='iframe' @load='iframeLoad'></iframe> </div></template><!-- Add 'scoped' attribute to limit CSS to this component only --><style scoped='scoped'> .map-container iframe{ width: 100%; height: 100%; border: none; }</style><script> import config from ’../../vue.config’//里面有路径信息 let iframeWin = null;//私有变量 export default { props:[’size’],//纯测试,没啥用,对应<Map ref='map' size='100'></Map> data() { return {src: ’’,//地图页面地址isLoaded: false,//地图页面是否加载完毕iMap: null,//地图页面暴露出来的,供外部访问的对象require: null//arcgis的require函数,用于引用自定义插件。我们过去写了不少自定义的地图插件 } }, created() { this.src = config.publicPath + ’map.html’ }, mounted() { //监听iframe的消息 window.addEventListener(’message’, this.handleMessage) iframeWin = this.$refs.iframe.contentWindow }, methods: { iframeLoad() {this.isLoaded = true;window.console.log('map is ready') }, async handleMessage() {//接收来自iframe的消息this.require = iframeWin.require;this.iMap = iframeWin.iMap; }, loadLayer(nodes,servers){this.iMap.layerHandler.load(nodes,servers); }, isReady(){return this.isLoaded; } } }</script>
有关组件的结构,比如
export default { props:,//标记里的属性 data() {//公共变量 }, created() {//加载时? }, mounted() {//加载完毕时 }, methods: {//公共方法 }}
export代表了这是对外。所以里面的属性、变量、方法,都可以被外部访问。如果想私有,应该在export之外定义。如本例:
像这类简单的介绍,在网上怎么也搜不到。vue的中文站点,陈旧,内容支离破碎,对初学者极不友好,加重了学习的成本。
三、iframe接口组件Map.vue与里面的iframe是怎么通信的呢?通过系统消息和直接访问iframe的对象。直接访问iframe里的对象有个前提,就是不能跨域。
iframe承载的地图页面map.html
<!DOCTYPE HTML PUBLIC '-//W3C//DTD HTML 4.01//EN' 'http://www.w3.org/TR/html4/strict.dtd'><html> <head>... </head> <body> <div id='map'></div>... </div> </body></html><script src='http://192.168.0.200/pubzy211/arcgis_js_api/3.19/init.js'></script><script type='text/javascript'> var iMap = {}; //外部引用接口 require([ 'esri/config', 'esri/map', 'esri/geometry/Extent', 'esri/SpatialReference', 'layerlib/LtLayer', 'dojo/dom', 'dojo/_base/array', 'dojo/parser', 'dojo/domReady!' ], function( esriConfig, Map, Extent, SpatialReference, LtLayer, dom, arrayUtils, parser ) { //map var map = ... /* 外部接口 */ iMap = { map: map, legend: legend, home: home, tipDialog: tipDialog, toggle: toggle, overviewMap: overviewMap }; iMap.drawHandler = ... iMap.layerHandler = ...; iMap.centerAt = ...; iMap.clear = ...; iMap.restoreView = ...; // 向父vue页面发送加载完毕信号 window.parent.postMessage({ cmd: ’mapIsReady’, params: { success: true, data: true } }, ’*’); /* end of 外部接口 */ });</script>
地图组件Map.vue对应iframe部分,详见一.2中的代码
export default {。。。 mounted() { //监听iframe的消息 window.addEventListener(’message’, this.handleMessage) //获得iframe的window对象 iframeWin = this.$refs.iframe.contentWindow }, methods: { iframeLoad() {this.isLoaded = true;window.console.log('map is ready') }, async handleMessage() {//接收来自iframe的消息this.require = iframeWin.require;this.iMap = iframeWin.iMap; }, loadLayer(nodes,servers){ //加载图层this.iMap.layerHandler.load(nodes,servers); } } }四、外部接口
Map.vue是一个组件,它要跟它所在的组件或页面进行通信。
现在,Map.vue放在了一个容器页面Home.vue(即测试页面)里,里面还有一个命令组件Layer.vue。点击命令组件里的按钮,地图要做出相应的响应。其中的原理如下:
命令组件的按钮点击后,发射信息到容器页面,然后容器页面调用地图组件的方法。
测试页面Home.vue
<template> <div id='app1'> <div id='map-container'> <div>地图组件</div> <Map ref='map' size='100'></Map> </div> <div id='layer-container'> <div>其他组件</div> <Layer @loadLayer='loadLayer' @loadCloud='loadCloud' @clear='clearMap'></Layer> </div> </div></template><script> import Map from ’../components/Map.vue’ import Layer from ’../components/Layer.vue’ export default { name: ’App’, components: { Map, Layer }, methods:{ loadLayer(nodes,servers){//加载图层let map = this.$refs.map;map.loadLayer(nodes,servers); }, loadCloud(data){//加载卫星云图let map = this.$refs.map;map.require(['drawlib/Cloud'], function (Cloud) { let iMap = map.iMap; let cloudId = ’cloud’; let cloud = new Cloud(iMap.map); iMap.drawHandler.push(cloudId, cloud); cloud.draw(data,cloudId);}); }, clearMap(){//清除let map = this.$refs.map;map.iMap.clear(); } } }</script><style>。。。</style>
命令组件Layer.vue
<template> <div class='layer-container'> <button @click='loadLayer'>加载图层</button> <button @click='loadCloud'>卫星云图</button> <button @click='clear'>清除</button> </div></template><script> export default { methods: { loadLayer() {let nodes = ...let servers = ...this.$emit('loadLayer', nodes,servers) }, loadCloud(){let data = ...;this.$emit('loadCloud', data); }, clear(){this.$emit('clear'); } }, }</script><style scoped='scoped'>。。。</style>
注意命令组件发射消息中指定的方法,在容器页面中都有相关的属性与之对应:
命令组件loadCloud(){ let data = ...; this.$emit('loadCloud', data);},容器页面<Layer @loadLayer='loadLayer' @loadCloud='loadCloud' @clear='clearMap'></Layer>五、运行结果
六、总结其他组件要与地图组件交互,中间要通过容器页面,其他组件与地图组件并没有直接交互。这其实是一种命令模式。好处是其他组件和地图组件解耦,没有耦合在一起,意味着互不影响。这有利于地图组件本身的扩展和优化。缺点的话,每个东东都要通过容器页面转发,容器页面代码可能会有冗余,有些方法根本就是个传声筒,给人的感觉是重重复复的写,意义不太大。
以上就是开发一个封装iframe的vue组件的详细内容,更多关于封装iframe的vue组件的资料请关注好吧啦网其它相关文章!
相关文章: