Load portal items via drag & drop

Note: Support for 3D on mobile devices may vary, view the system requirements for more information.

This sample demonstrates how to load a PortalItem from an ArcGIS for Portal item into your application.

1. Define a template to display items

You'll want to define a template to use for each PortalItem to display in the application.

var template =
  '<div data-itemid="{id}" class="card block" draggable="true">' +
    '<figure class="card-image-wrap"><img class="card-image" src="{thumbnailUrl}" alt="Card Thumbnail">' +
      '<figcaption class="card-image-caption">{title}</figcaption>' +
    '</figure>' +
    '<div class="card-content">' +
      '<ul>' +
        '<li>Published Date:</li>' +
        '{created}' +
        '<li>Owner:</li>' +
        '{owner}' +
      '</ul>' +
    '</div>' +
  '</div>';

2. Load the Portal Items

Create an array of all the Portal items to use in this application. We want to load the Portal items when they are created, because we want to use the information such as "id", "owner" and so on to display in the application.

var portalItems = layerItems.map(function(itemid) {
  return (new PortalItem({
    id: itemid
  })).load();
});

3. Create DOM elements to display item details on page

Use the eachAlways method of esri/core/promiseUtils to wait for the Portal items to finish loading. You can then use esri/core/lang to create DOM elements using the details of each Portal item to display on the page. You will also want to listen for the "dragstart" event of the DOM element and assign some data to be transferred to whereever that element is dropped.

promiseUtils.eachAlways(portalItems).then(function(items) {
  var docFrag = document.createDocumentFragment();
  items.map(function(result) {
    var item = result.value;
    var card = esriLang.substitute(item, template);
    var elem = document.createElement("div");
    elem.innerHTML = card;
    // This is a technique to turn a DOM string to a DOM element.
    var target = elem.firstChild;
    docFrag.appendChild(target);
    target.addEventListener("dragstart", function(event) {
      var id = event.currentTarget.getAttribute("data-itemid");
      event.dataTransfer.setData("text", id);
    });
  });
  document.querySelector(".cards-list").appendChild(docFrag);
  ...
});

4. Manage drag events

You need to listen for the "drop" and "dragover" events to properly drop the Portal item on the MapView. You can then get the id of the PortalItem and add the layer to the WebMap using Layer.fromPortalItem.

promiseUtils.eachAlways(portalItems).then(function(items) {
  ...
  view.container.addEventListener("dragover", function(event) {
    event.preventDefault();
    event.dataTransfer.dropEffect = "copy";
  })
  view.container.addEventListener("drop", function(event) {
    var id = event.dataTransfer.getData("text");
    // Get the first item that matches
    var resultItem = items.find(function(x) { return x.id === id; });
    var item = result.value;
    if (item && item.isLayer) {
      Layer.fromPortalItem({
        portalItem: item
      }).then(function(layer) {
        webmap.add(layer);
        view.extent = item.extent;
      });
    }
  })
});

Please refer to the Working with the ArcGIS Platform for information on how the ArcGIS API for JavaScript makes use of working with portal items.