viewerDragDropMixin

viewerDragDropMixin

viewerDragDropMixin(viewer, options)
Widgets/Viewer/viewerDragDropMixin.js 54

A mixin which adds default drag and drop support for CZML files to the Viewer widget. Rather than being called directly, this function is normally passed as a parameter to Viewer#extend, as shown in the example below.

Name Type Description

viewer Viewer The viewer instance.

options

Object

optional Object with the following properties:

Name	Type	Default	Description
`dropTarget`	Element \| String	`viewer.container`	optional The DOM element which will serve as the drop target.
`clearOnDrop`	Boolean	`true`	optional When true, dropping files will clear all existing data sources first, when false, new data sources will be loaded after the existing ones.
`flyToOnDrop`	Boolean	`true`	optional When true, dropping files will fly to the data source once it is loaded.
`clampToGround`	Boolean	`true`	optional When true, datasources are clamped to the ground.
`proxy`	DefaultProxy		optional The proxy to be used for KML network links.

Throws:

DeveloperError : Element with id does not exist in the document.
DeveloperError : dropTarget is already defined by another mixin.
DeveloperError : dropEnabled is already defined by another mixin.
DeveloperError : dropError is already defined by another mixin.
DeveloperError : clearOnDrop is already defined by another mixin.

Example:

// Add basic drag and drop support and pop up an alert window on error.
var viewer = new Cesium.Viewer('cesiumContainer');
viewer.extend(Cesium.viewerDragDropMixin);
viewer.dropError.addEventListener(function(viewerArg, source, error) {
    window.alert('Error processing ' + source + ':' + error);
});