@@ -8,14 +8,14 @@ ol.supermap.control = ol.supermap.control || {};
88 * @class ol.supermap.control.ChangeTileVersion
99 * @classdesc 版本切换控件(目前仅支持IE10及以上)暂时不支持自定义位置
1010 * @extends ol.control.Control
11- * @param options -{options} 可选参数 。如:<br>
12- * title - {string } 提示信息。<br>
13- * tooltip - {string } 提示显示位置 top | right | bottom | left。<br>
11+ * @param options -{object} 参数 。如:<br>
12+ * title - {String } 提示信息。<br>
13+ * tooltip - {String } 提示显示位置 top | right | bottom | left。<br>
1414 * collapsed - {boolean} 是否折叠。<br>
15- * lastText - {string } 上一个版本的按钮布局。<br>
16- * nextText - {string } 下一个版本的按钮布局。<br>
17- * ico - {string } 控件显示的logo。<br>
18- * orientation - {string } 方向horizontal|vertical。<br>
15+ * lastText - {String } 上一个版本的按钮布局。<br>
16+ * nextText - {String } 下一个版本的按钮布局。<br>
17+ * ico - {String } 控件显示的logo。<br>
18+ * orientation - {String } 方向horizontal|vertical。<br>
1919 * switch - {boolean} 是否显示上/下一个版本切换控件
2020 * @example
2121 * 用法: var control = new ol.supermap.control.ChangeTileVersion({
@@ -26,10 +26,6 @@ ol.supermap.control = ol.supermap.control || {};
2626 */
2727export default class ChangeTileVersion extends ol . control . Control {
2828
29- /*
30- * @function ol.supermap.control.ChangeTileVersion.prototype.constructor
31- * @param options -{options} 参数
32- */
3329 constructor ( options ) {
3430 options = options || { } ;
3531 //鼠标滑过时提示
@@ -71,7 +67,7 @@ export default class ChangeTileVersion extends ol.control.Control {
7167 if ( options . layer ) {
7268 this . setLayer ( options . layer ) ;
7369 }
74- /**
70+ /*
7571 * @function ol.supermap.control.ChangeTileVersion.prototype.initLayout
7672 * @description 初始化
7773 */
@@ -146,10 +142,7 @@ export default class ChangeTileVersion extends ol.control.Control {
146142 else {
147143 this . _sliderContainer . style . width = 150 + 'px' ;
148144 }
149- /**
150- * @function ol.supermap.control.ChangeTileVersion.prototype.addDomEvent
151- * @description 为元素添加事件
152- */
145+
153146 addDomEvent ( this . _container , "click" , function ( e ) {
154147 e . preventDefault ( ) ;
155148 e . stopPropagation ( ) ;
@@ -170,6 +163,15 @@ export default class ChangeTileVersion extends ol.control.Control {
170163 return this . _container ;
171164 }
172165
166+ /*
167+ * @function ol.supermap.control.ChangeTileVersion.prototype.createElement
168+ * @description 新建元素
169+ * @param tagName -{string} 标签名
170+ * @param className -{string} 类名
171+ * @param container -{object} 容器
172+ * @return {object|Element } 元素
173+ */
174+
173175 function createElement ( tagName , className , container ) {
174176 var el = document . createElement ( tagName ) ;
175177 el . className = className || '' ;
@@ -180,6 +182,16 @@ export default class ChangeTileVersion extends ol.control.Control {
180182 return el ;
181183 }
182184
185+ /*
186+ * @function ol.supermap.control.ChangeTileVersion.prototype.addDomEvent
187+ * @description 为元素添加事件
188+ * @param obj -{object} 事件对象集
189+ * @param type -{string} 事件类型
190+ * @param fn -{object} 容器
191+ * @param context -{object} 当前环境
192+ * @return {addDomEvent } 添加的事件
193+ */
194+
183195 function addDomEvent ( obj , type , fn , context ) {
184196 var handler = function ( e ) {
185197 if ( fn ) {
@@ -238,10 +250,11 @@ export default class ChangeTileVersion extends ol.control.Control {
238250 this . tilesVersion ( version ) ;
239251 }
240252 }
253+
241254 /**
242255 * @function ol.supermap.control.ChangeTileVersion.prototype.setContent
243256 * @description 设置版本相关信息
244- * @param version -{string } 版本信息
257+ * @param version -{object } 版本信息
245258 */
246259 setContent ( version ) {
247260 var content = version || { } ;
@@ -261,19 +274,23 @@ export default class ChangeTileVersion extends ol.control.Control {
261274 this . _sliderValue . innerHTML = value ;
262275 return this ;
263276 }
277+
264278 /**
265- * @function ol.supermap.control.ChangeTileVersion.prototype.setVersionName
279+ * @function ol.supermap.control.ChangeTileVersion.prototype.setToolTip
266280 * @description 设置提示信息
267- * @param tooltip -{HTMLElement}||{String} 版本内容
281+ * @param tooltip -{string} 工具提示
282+ * @return {ChangeTileVersion }
268283 */
269284 setToolTip ( tooltip ) {
270285 this . tooltip . innerHTML = tooltip ;
271286 return this ;
272287 }
288+
273289 /**
274290 * @function ol.supermap.control.ChangeTileVersion.prototype.updateLength
275291 * @description 更新进度条长度
276- * @param length -{number}进度条长度
292+ * @param length -{number} 进度条长度
293+ * @return {ChangeTileVersion }
277294 */
278295 updateLength ( length ) {
279296 if ( length > 0 ) {
@@ -282,10 +299,12 @@ export default class ChangeTileVersion extends ol.control.Control {
282299 }
283300 return this ;
284301 }
302+
285303 /**
286304 * @function ol.supermap.control.ChangeTileVersion.prototype.setLayer
287305 * @description 绑定图层
288- * @param layer -{object} 图层信息
306+ * @param layer -{object} 图层
307+ * @return {ChangeTileVersion }
289308 */
290309 setLayer ( layer ) {
291310 if ( layer ) {
@@ -304,10 +323,11 @@ export default class ChangeTileVersion extends ol.control.Control {
304323 me . getTileSetsInfo ( ) ;
305324 return this ;
306325 }
326+
307327 /**
308328 * @function ol.supermap.control.ChangeTileVersion.prototype.update
309329 * @description 更新缓存切片集及进度条长度
310- * @param tileVersions -{object} 瓦片信息
330+ * @param tileVersions -{object} 待更新的切片版本
311331 */
312332 update ( tileVersions ) {
313333 this . tileVersions = tileVersions ;
@@ -317,6 +337,7 @@ export default class ChangeTileVersion extends ol.control.Control {
317337 /**
318338 * @function ol.supermap.control.ChangeTileVersion.prototype.getTileSetsInfo
319339 * @description 请求获取切片集信息
340+ * @return {ChangeTileVersion }
320341 */
321342 getTileSetsInfo ( ) {
322343 var me = this ;
@@ -328,6 +349,7 @@ export default class ChangeTileVersion extends ol.control.Control {
328349 }
329350 return this ;
330351 }
352+
331353 /**
332354 * @function ol.supermap.control.ChangeTileVersion.prototype.removeLayer
333355 * @description 移除绑定的地图图层
@@ -365,7 +387,9 @@ export default class ChangeTileVersion extends ol.control.Control {
365387 /**
366388 * @function ol.supermap.control.ChangeTileVersion.prototype.tilesVersion
367389 * @description 根据指定版本号请求版本
390+ * @param version -{object} 版本信息
368391 */
392+
369393 tilesVersion ( version ) {
370394 var layer = this . options . layer ,
371395 tileVersions = this . tileVersions ;
@@ -378,13 +402,15 @@ export default class ChangeTileVersion extends ol.control.Control {
378402 }
379403 }
380404 }
405+
381406 /**
382407 * @function ol.supermap.control.ChangeTileVersion.prototype.getValue
383408 * @description 获取进度条的值。注:(进度条的值并不是版本号)
384409 */
385410 getValue ( ) {
386411 return this . slider . value ;
387412 }
413+
388414 /**
389415 * @function ol.supermap.control.ChangeTileVersion.prototype.getVersion
390416 * @description 获取当前进度条值对应的版本号
0 commit comments