application

The application module exposes APIs for exporting content, initiating edits from panel UI, and getting version / locale info.

• application
  • .editDocument(options, editFunction) | (editFunction)
  • .createRenditions(renditions) ⇒ Promise<Array, string>
  • .version : string
  • .appLanguage : string
  • .systemLocale : string
  • .activeDocument : !DocumentInfo

application.editDocument(options, editFunction) | (editFunction)

Call editDocument() from a plugin panel UI event listener to initiate an edit operation batch in order to modify the XD document. This API is irrelevant for plugin menu item commands, which are wrapped in an edit batch automatically.

XD calls the editFunction() synchronously (before editDocument() returns). This function is treated the same as a menu command handler:

• It is passed two arguments, the selection and the root node of the scenegraph
• It can return a Promise to extend the duration of the edit asynchronously

You can only call editDocument() in response to a user action, such as a button "click" event or a text input's "input" event. This generally means you must call it while a UI event handler is on the call stack.

For UI events that often occur in rapid-fire clusters, such as dragging a slider or pressing keys in a text field, XD tries to smartly merge consecutive edits into a single atomic Undo step. See the mergeId option below to customize this behavior.

Kind: static method of application

Typedef EditSettings

Example

let Color = require("scenegraph").Color;
let application = require("application");

let panelButton = document.querySelector("panel #myButton");

// When button is clicked, set selected item's fill to solid red
panelButton.addEventListener("click", event => {
    application.editDocument(selection => {
        selection.items[0].fill = new Color("red");
    });
});

application.createRenditions(renditions)

Generate renditions of nodes in the document in a batch. Overwrites any existing files without warning.

A single createRenditions() call can generate any number of renditions, including multiple renditions of the same node (with different output settings) or renditions of multiple different nodes. Only one createRenditions() call can be executing at any given time, so wait for the Promise it returns before calling it again.

Kind: static method of application
Returns: Promise<Array<RenditionResult>, string> - Promise which is fulfilled with an array of RenditionResults (pointing to the same outputFiles that were originally passed in, or rejected with an error string if one or more renditions failed for any reason.

Typedef RenditionSettings

All rendition settings fields are required (for a given rendition type) unless otherwise specified.

Typedef RenditionResult

Example

// Generate PNG rendition of the selected node
let application = require("application");
let fs = require("uxp").storage.localFileSystem;

let file = await fs.getFileForSaving();
let shape = selection.items[0];
let renditions = [
  {
    node: shape,
    outputFile: file,
    type: application.RenditionType.PNG,
    scale: 2
  }
];
application.createRenditions(renditions).then(function(results) {
  // ...do something with outputFiles on disk...
});

application.version : string

Adobe XD version number in the form "major.minor.patch.build"

Kind: static property of application
Read only: true

Example

console.log("Version:", application.version); // e.g. "13.0.21.3"

application.appLanguage : string

Current language the application UI is using. This may not equal the user's OS locale setting: it is the closest locale supported by XD - use this when you want your plugin's UI to be consistent with XD's UI. Specifies language only, with no region info (e.g. "fr", not "fr_FR").

Kind: static property of application
Read only: true

Example

console.log("XD locale:", application.appLanguage); // e.g. "en"

application.systemLocale : string

User's OS-wide locale setting. May not match the XD UI, since XD does not support all world languages. Includes both language and region (e.g. "fr_CA" or "en_US").

Kind: static property of application
Read only: true

Example

console.log("OS locale:", application.systemLocale); // e.g. "en_US"

application.activeDocument : !DocumentInfo

Information about the document which this instance of the plugin is attached to.

Kind: static property of application
Read only: true

Typedef DocumentInfo

Example

let application = require("application");
let documentInfo = application.activeDocument;
console.log("Document title: " + documentInfo.name);
console.log("Document ID: " + documentInfo.guid);