diff --git a/examples/reusable-source.html b/examples/reusable-source.html new file mode 100644 index 0000000000..e93074b7f6 --- /dev/null +++ b/examples/reusable-source.html @@ -0,0 +1,12 @@ +--- +layout: example.html +title: Reusable Source +shortdesc: Updating a tile source by changing the URL. +docs: > + You can call source.setUrl() to update the URL for a tile source. Note that when you change the URL for a tile source, existing tiles will not be replaced until new tiles are loaded. If you are interested instead in clearing currently rendered tiles, you can call the source.refresh() method. Alternatively, you can use two separate sources if you want to remove rendered tiles and start over loading new tiles. +--- +
+ + + + diff --git a/examples/reusable-source.js b/examples/reusable-source.js new file mode 100644 index 0000000000..b9c4ac3ca3 --- /dev/null +++ b/examples/reusable-source.js @@ -0,0 +1,39 @@ +goog.require('ol.Map'); +goog.require('ol.View'); +goog.require('ol.layer.Tile'); +goog.require('ol.source.XYZ'); + +var urls = [ + 'https://{a-c}.tiles.mapbox.com/v3/mapbox.blue-marble-topo-jan/{z}/{x}/{y}.png', + 'https://{a-c}.tiles.mapbox.com/v3/mapbox.blue-marble-topo-bathy-jan/{z}/{x}/{y}.png', + 'https://{a-c}.tiles.mapbox.com/v3/mapbox.blue-marble-topo-jul/{z}/{x}/{y}.png', + 'https://{a-c}.tiles.mapbox.com/v3/mapbox.blue-marble-topo-bathy-jul/{z}/{x}/{y}.png' +]; + +var source = new ol.source.XYZ(); + +var map = new ol.Map({ + target: 'map', + layers: [ + new ol.layer.Tile({ + source: source + }) + ], + view: new ol.View({ + center: [0, 0], + zoom: 2 + }) +}); + + +function updateUrl(index) { + source.setUrl(urls[index]); +} + +var buttons = document.getElementsByClassName('switcher'); +for (var i = 0, ii = buttons.length; i < ii; ++i) { + var button = buttons[i]; + button.addEventListener('click', updateUrl.bind(null, Number(button.value))); +} + +updateUrl(0); diff --git a/src/ol/source/xyzsource.js b/src/ol/source/xyzsource.js index fea537eebe..1091ada585 100644 --- a/src/ol/source/xyzsource.js +++ b/src/ol/source/xyzsource.js @@ -22,11 +22,11 @@ goog.require('ol.source.TileImage'); * * @constructor * @extends {ol.source.TileImage} - * @param {olx.source.XYZOptions} options XYZ options. + * @param {olx.source.XYZOptions=} opt_options XYZ options. * @api stable */ -ol.source.XYZ = function(options) { - options = options || {}; +ol.source.XYZ = function(opt_options) { + var options = opt_options || {}; var projection = options.projection !== undefined ? options.projection : 'EPSG:3857';