You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

107 lines
3.1 KiB
JavaScript

import defaultValue from "../../Core/defaultValue.js";
import defined from "../../Core/defined.js";
import DeveloperError from "../../Core/DeveloperError.js";
import knockout from "../../ThirdParty/knockout.js";
import createCommand from "../createCommand.js";
/**
* A view model that represents each item in the {@link BaseLayerPicker}.
*
* @alias ProviderViewModel
* @constructor
*
* @param {Object} options The object containing all parameters.
* @param {String} options.name The name of the layer.
* @param {String} options.tooltip The tooltip to show when the item is moused over.
* @param {String} options.iconUrl An icon representing the layer.
* @param {String} [options.category] A category for the layer.
* @param {ProviderViewModel.CreationFunction|Command} options.creationFunction A function or Command
* that creates one or more providers which will be added to the globe when this item is selected.
*
* @see BaseLayerPicker
* @see ImageryProvider
* @see TerrainProvider
*/
function ProviderViewModel(options) {
//>>includeStart('debug', pragmas.debug);
if (!defined(options.name)) {
throw new DeveloperError("options.name is required.");
}
if (!defined(options.tooltip)) {
throw new DeveloperError("options.tooltip is required.");
}
if (!defined(options.iconUrl)) {
throw new DeveloperError("options.iconUrl is required.");
}
if (typeof options.creationFunction !== "function") {
throw new DeveloperError("options.creationFunction is required.");
}
//>>includeEnd('debug');
var creationCommand = options.creationFunction;
if (!defined(creationCommand.canExecute)) {
creationCommand = createCommand(creationCommand);
}
this._creationCommand = creationCommand;
/**
* Gets the display name. This property is observable.
* @type {String}
*/
this.name = options.name;
/**
* Gets the tooltip. This property is observable.
* @type {String}
*/
this.tooltip = options.tooltip;
/**
* Gets the icon. This property is observable.
* @type {String}
*/
this.iconUrl = options.iconUrl;
this._category = defaultValue(options.category, "");
knockout.track(this, ["name", "tooltip", "iconUrl"]);
}
Object.defineProperties(ProviderViewModel.prototype, {
/**
* Gets the Command that creates one or more providers which will be added to
* the globe when this item is selected.
* @memberof ProviderViewModel.prototype
* @memberof ProviderViewModel.prototype
* @type {Command}
* @readonly
*/
creationCommand: {
get: function () {
return this._creationCommand;
},
},
/**
* Gets the category
* @type {String}
* @memberof ProviderViewModel.prototype
* @readonly
*/
category: {
get: function () {
return this._category;
},
},
});
/**
* A function which creates one or more providers.
* @callback ProviderViewModel.CreationFunction
* @returns {ImageryProvider|TerrainProvider|ImageryProvider[]|TerrainProvider[]}
* The ImageryProvider or TerrainProvider, or array of providers, to be added
* to the globe.
*/
export default ProviderViewModel;