You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: changes.md
+27Lines changed: 27 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,5 +1,32 @@
1
1
# Change Log
2
2
3
+
## XD Release 20.0.12 (June 2019)
4
+
5
+
### UI Changes
6
+
7
+
***"Launchpad" UI and menu structure changes** -- XD 20 introduces a new, easier way for users to run plugins -- the "launchpad" sidebar menu:
8
+
<divstyle="background:url(images/launchpad-icon.png); width: 39px; height: 111px; margin-left: 40px"alt="Launchpad icon"></div><!-- works around fancybox plugin breaking image size-->
9
+
10
+
This panel lists all installed plugins, with quick access to all the same commands as the Plugins menu. In addition, XD now arranges plugin menu items more cleanly:
11
+
* Multiple menu items are automatically grouped together into a submenu named after the plugin. There's
12
+
no longer any need to manually specify submenus.
13
+
* If your plugin only has a single menu item, it'll still be available directly at the top level of the
14
+
Plugins menu.
15
+
* However, _top level menu items always use the name of the plugin._ If your plugin's single menu item had a
16
+
different label specified, it will be ignored.
17
+
18
+
### API Improvements
19
+
20
+
***Text scenenode super/subscript** -- Work with Text nodes and style assets using the new [textScript](./reference/scenegraph.md#Text-textScript)
21
+
feature.
22
+
23
+
### Known Issues
24
+
25
+
No new known issues. See the [Known Issues page](./known-issues.md) for a comprehensive list of existing known issues.
Copy file name to clipboardExpand all lines: reference/assets.md
+6-1Lines changed: 6 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -68,6 +68,10 @@ Assets library entry representing a set of text character styles.
68
68
69
69
Character style properties. See documentation for the [Text](scenegraph.md#Text) node type for more details.
70
70
71
+
When creating a new character style, all properties are mandatory except those with default values specified here. When deleting
72
+
an existing character style, always pass the exact object returned by [`characterStyles.get()`](#module_assets-characterStyles-get) (with all properties fully
73
+
specified) to avoid any ambiguity.
74
+
71
75
| Property | Type | Description |
72
76
| --- | --- | --- |
73
77
| fontFamily | !string | the font family |
@@ -79,6 +83,7 @@ Character style properties. See documentation for the [Text](scenegraph.md#Text)
79
83
| underline | !boolean | whether underline is turned on |
80
84
| strikethrough | ?boolean | (**Since**: XD 19) Default false; whether strikethrough is turned on |
81
85
| textTransform | ?string | (**Since**: XD 19) Default "none"; one of "none", "uppercase", "lowercase", or "titlecase" |
86
+
| textScript | ?string | (**Since**: XD 20) Default "none"; one of "none", "superscript", or "subscript" |
82
87
83
88
84
89
* * *
@@ -246,7 +251,7 @@ var assets = require("assets"),
246
251
charSpacing:0,
247
252
lineSpacing:0,
248
253
underline:false
249
-
// (leaves optional strikethrough & textTransform properties at default values)
`host.app` | `string` | Indicates that this is a plugin for Adobe XD (currently, the only valid value here is `"XD"`). | Develop / Publish
82
82
`host.minVersion` | `string` | Minimum required version of the host app (in `x.y` format) that can run this plugin. <br> **Note:** Must be two segments. Typically, you'll leave the minor segment set to `0`, e.g. `16.0`. | Develop / Publish
83
83
`host.maxVersion` | `string` | Maximum version of host app that can run this plugin. Same formatting as `host.minVersion`. | Optional
84
-
`uiEntryPoints` | <code>array<MenuItemDefinition| SubmenuDefinition></code> | Describes the entries your plugin adds to the _Plugins_ menu in XD. See the next section for details. | Develop / Publish
84
+
`uiEntryPoints` | <code>array<[MenuItemDefinition](#MenuItemDefinition)></code> | Describes the entries your plugin adds to the _Plugins_ menu & "plugin launchpad" sidebar in XD. See the next section for details. | Develop / Publish
85
85
86
-
## UI entry points array
86
+
## UI entry points
87
87
88
-
The `uiEntryPoints` field is an _array_ of objects, and each object must match one of the two formats below. Items appear in the _Plugins_ menu in the same order as they're listed in the `uiEntryPoints` array.
88
+
The `uiEntryPoints` field is an _array_ of objects matching the MenuItemDefinition format specified below. These entries appear both in the _Plugins_ menu in the native menubar, and the "plugin launchpad" sidebar panel.
89
89
90
-
_It is strongly encouraged to only add **one** item to `uiEntryPoints`_ -- either one top-level MenuItemDefinition, or one SubmenuDefinition containing multiple submenu items. In either case, this menu
91
-
item should closely match the name of your plugin so it is easy to locate after installing (bear in mind the user may have a bunch of other plugins' entries in this menu already).
90
+
* If only one entry point is specified, clicking the plugin name in the menu or in the launchpad sidebar runs your plugin command directly. There is no label to specify since the plugin name acts as the label.
92
91
93
-
### MenuItemDefinition (executable menu items)
92
+
* If multiple entry points are specified, items are automatically grouped into a submenu and into a collapsible section in the launchpad sidebar. The overall submenu/section uses the plugin name as its label, but you
93
+
must specify a label for each individual MenuItemDefinition. Items appear in the submenu/section in the same order as they're listed in the `uiEntryPoints` array.
94
+
95
+
### MenuItemDefinition
94
96
95
97
Key | Type | Description
96
98
----|------|------------
97
99
`type` | `string` | Entry point type. Currently `"menu"` is the only supported value.
98
-
`label` | `string` or `Object` | Label for this menu item that the user will select to run your plugin. May be a single string _or_ an object containing localized strings (see "Menu Localization" below).
100
+
`label` | <code>?string|[LocaleMap](#menu-localization)</code> | _Required_ if multiple items defined; _ignored_ if only one defined (see above).<br><br> Label for this menu item that the user will select to run your plugin. May be a single string _or_ an object containing localized strings (see "Menu Localization" below).
99
101
`commandId` | `string` | Identifier that links the menu item to a function in your plugin's JavaScript code. This identifier needs to be unique within your plugin. It can be whatever you like, but it makes sense to succinctly describe what the command will do.
100
102
`shortcut` | `Object` | _Optional._ Object defining Mac and Windows keyboard shortcuts for this menu item, formatted as `{"mac": "string", "win": "string"}`. See "Keyboard shortcuts" below for details.
101
103
102
-
### SubmenuDefinition (submenu)
103
-
104
-
Key | Type | Description
105
-
----|------|------------
106
-
`type` | `string` | Entry point type. Currently `"menu"` is the only supported value.
107
-
`label` | `string` or `Object` | Label for this submenu. May be a single string _or_ an object containing localized strings (see "Menu Localization" below).
108
-
`menuItems` | `Array<MenuItemDefinition>` | Nested array specifying the menu items this submenu contains. Only a single submenu nesting level is supported, so this array may not contain any `SubmenuDefinition`s itself, only executable `MenuItemDefinition`s.
109
-
110
104
### Keyboard shortcuts
111
105
112
106
Keyboard shortcuts are defined separately for each platform (as seen in the example at the top of this tutorial). Each definition is a string that follows this syntax:
0 commit comments