Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

UXP API reference for v6.4 #90

Closed
wants to merge 11 commits into from
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
41 changes: 0 additions & 41 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -38,44 38,3 @@ UXP_REPO_SOURCE_DOCS="<path-to-torq-native>/docs/dist"

The side navigation panel in the devsite is generated from the `reference-*.js` files.

### Work in progress or TODO

1. For Persistent file storage APIs, `storage.md` is not utilized yet. Some fixes to the old files were manually added. Refer to https://github.com/AdobeDocs/uxp/commit/b3c0c783bf3195704abfe18e1190ca7b5c0d534d. Make sure you dont update `Persistent file storage/index.md` until you want to use storage.md.
* FileSystem.md was manually created by copying content from Storage.md
2. In the future, `_transclusions` should be generated from `torq-native`. For now, any new files should be manually added to `_transclusions` and `reference-*.js` files. Otherwise, it will not appear in the devsite.
3. Few files were manually changed in this repo. Be careful while merging their content. The incomming changes might be missing some information or change formatting. In the future, move these changes to the UXP source files.
* `reference-js/index.md`
* `LocalStorage.md`
* `SessionStorage.md`
* `Versions.md`
* `version3P.md`
* `known-issues.md`
* `changelog3P.md`
* `src/pages/uxp/index.md`
* `reference-spectrum/index.md`
* `reference-js/index.md`
* `HTMLWebViewElement.md`
4. Maintain a consistent order for the API information.
* Since
* Description
* See <link>
* Params
* Returns
* Throws
* Examples
5. Inconsistency in types
* *String, string
* *Boolean, bool, boolean
* *Array array
* *Promise Promise<void>
* *\* any
* *Object object
* int number Number
6. Other fixes done manually in this repo which should be fixed in sourve files:
* Backticks in H1 titles in source files.
* Extra dots. Example `Promise.<void>` in SecureStorage.md
* `<br>` tags without a closing `</br>`
7. Index pages (coming from index.md) show links ordered alphabetically. For example: https://developer.adobe.com/photoshop/uxp/2022/uxp/reference-js/Global Members/HTML DOM/. But the left side panel (coming from reference-*.js) is not necessarily alphabetical. Make them consistent.



Original file line number Diff line number Diff line change
@@ -0,0 1,4 @@

import Content from "uxp-documentation/src/pages/uxp/reference-js/Global Members/Path/Path.md";

<Content query="product=photoshop"/>
Original file line number Diff line number Diff line change
@@ -1,4 1,4 @@

import Content from "uxp-documentation/src/pages/uxp/reference-js/Global Members/Crypto/Crypto.md";

<Content query="product=photoshop"/>
<Content query="product=xd"/>
4 changes: 4 additions & 0 deletions _transclusions/xd/uxp/reference-js/Global Members/Path.md
Original file line number Diff line number Diff line change
@@ -0,0 1,4 @@

import Content from "uxp-documentation/src/pages/uxp/reference-js/Global Members/Path/Path.md";

<Content query="product=xd"/>
2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
@@ -1,7 1,7 @@
{
"private": true,
"name": "uxp-documentation",
"version": "0.0.17",
"version": "6.4",
"license": "Apache-2.0",
"repository": {
"type": "git",
Expand Down
4 changes: 4 additions & 0 deletions reference-js.js
Original file line number Diff line number Diff line change
Expand Up @@ -245,6 245,10 @@ module.exports=[
}
],
"path": "/uxp/reference-js/Global Members/HTML Elements/"
},
{
"title": "Path",
"path": "/uxp/reference-js/Global Members/Path/"
}
],
"path": "/uxp/reference-js/Global Members/"
Expand Down
22 changes: 22 additions & 0 deletions src/pages/uxp/changelog3P.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 4,28 @@ index_desc: Change Log in UXP version

# UXP Changelog

## UXP v6.4

### New
- [UXP-20237]: Webviews for Panels
- [UXP-20191]: Support Path Module APIs
- [UXP-20247]: Script can run fsapi with full access in localFileSystem

### Bugs Fixes
- [UXP-19364]: PluginManifest parsing / Load Plugin errors not logged in UDT
- [UXP-19978]: Error shown in UDT APP logs on Plugin UnLoad
- [UXP-20059]: UXP script : file session tokens are not getting created
- [UXP-20199]: Error message and stack are empty in case of reject("error string") executed in script
- [UXP-20121]: [Win only]-Volume is being muted automatically for 3rd video in the tutorial while opening the video in Theatre mode
- [UXP-20039]: After closing the theatre mode, video's are Overlapping while scrolling up and down in DP
- [UXP-19995]: Provide an API to programmatically close dialog in pop-out/theatre mode.
- [UXP-20095]: Plugin Data folder shouldn't be created for scripts
- [UXP-20168]: Crash on exit
- [UXP-20215]: script.setResult("kSuccess") not working
- [UXP-19851]: Resource Leaks in Window Dialog on UWP
- [UXP-19920]: Privilege plugin fail to add in XD in certain cases
- Fixed mouse/keyboard events within Webview in XD v55 and Win 10.

## UXP v6.3

### New
Expand Down
7 changes: 2 additions & 5 deletions src/pages/uxp/known-issues.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,9 40,6 @@ The following issues are known. Please check this page with future updates, as k
* The `location` attribute for `sp-tooltip` seems like it would control the position of the tooltip relative to its attachment. This is not how the attribute actually works -- it instead controls the tooltip's "tip" direction. If `location` is set to `bottom`, the tip will be pointed upwards under the assumption that your code has already placed the tooltip below the control. (PS-56708) _Better tooltip handling is coming in a future release_.
* The numeric `sp-textfield` can trigger numeric validation errors, even when the entered value would seem to be correct. This will be addressed in a future release. The limitation on valid ranges is an issue with numeric fields in Photoshop in general and is a separate issue. (PS-57698)

## WebView
* Mouse/Keyboard events within Webview doesn't work in XD v55 and Win 10 due to a [Microsoft issue](https://github.com/microsoft/microsoft-ui-xaml/issues/6427). Fix for this is in progress.

## Events

* `uxpshowpanel` and the corresponding `show` callback occurs only once, when the panel is initially made visible. It will not recur. This will be fixed in the future. (PS-57284)
Expand All @@ -65,8 62,8 @@ The following issues are known. Please check this page with future updates, as k
* `<label for="id"/>` is not supported. Wrap `<label>` around the control instead.
* `<input type="file" />` is not supported.
* `<input type="color" />` is not supported.
* Using unitless values in `width` and `height` attributes are not supported in UXP 3.1. Use `px`, or CSS styles.
* `<label>` uses `inline-flex` layout semantics in UXP 3.1 mode, with `flex-wrap: wrap` enabled. If you need to prevent wrapping, use `flex-wrap: nowrap` on these elements. Note that the default layout behavior is now _horizontal_ not _vertical_.
* Using unitless values in `width` and `height` attributes are not supported in UXP v3.1. Use `px`, or CSS styles.
* `<label>` uses `inline-flex` layout semantics in UXP v3.1 mode, with `flex-wrap: wrap` enabled. If you need to prevent wrapping, use `flex-wrap: nowrap` on these elements. Note that the default layout behavior is now _horizontal_ not _vertical_.
* `<progress>` is not theme aware.
* Password field values cannot be read on macOS. A workaround for this is to set the `type` to `text` on `focus` and switch it back to `password` on `blur`.

Expand Down
2 changes: 1 addition & 1 deletion src/pages/uxp/reference-css/Styles/opacity.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 3,7 @@ jsDoc: true
---
# opacity

**Since :** UXP 2
**Since:** UXP v2.0

Sets the opacity of an element. The value is between 0 (transparent) and 1 (opaque).

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 17,7 @@ Note: Clipboard access is not supported for 3P plugins with manifest version upt
<a name="clipboard-setcontent" id="clipboard-setcontent"></a>

## setContent(data)
Set data to clipboard.
Set data to clipboard.
Note: This is a non-standard API.

**Returns**: `Promise`
Expand All @@ -35,7 35,7 @@ navigator.clipboard.setContent({"text/plain": "Hello!"});
<a name="clipboard-getcontent" id="clipboard-getcontent"></a>

## getContent()
Get data from clipboard.
Get data from clipboard.
Note: This is a non-standard API.

**Returns**: `Promise`
Expand Down Expand Up @@ -114,7 114,7 @@ navigator.clipboard.readText();
<a name="clipboard-clearcontent" id="clipboard-clearcontent"></a>

## clearContent()
Clear clipboard content.
Clear clipboard content.
Note: Nonstandard: This method is non-standard.

**Returns**: `Promise`
Expand Down
6 changes: 6 additions & 0 deletions src/pages/uxp/reference-js/Global Members/HTML DOM/Element.md
Original file line number Diff line number Diff line change
Expand Up @@ -184,6 184,12 @@ Indicates if the element will focus automatically when it is loaded
- https://w3c.github.io/DOM-Parsing/#the-innerhtml-mixin


| Param | Type |
| --- | --- |
| value | `string` |



Comment on lines 187 to 192
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This doesn't feel right. It might be coming from a set function, but this just makes the "multiple innerHTML confusion" worse 🤔

<a name="element-outerhtml" id="element-outerhtml"></a>

## outerHTML : `string`
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -41,6 41,11 @@ Access to all the custom data attributes (data-*) set.
## innerText : `string`


<a name="htmlelement-lang" id="htmlelement-lang"></a>

## lang : `string`


<a name="element-nodename" id="element-nodename"></a>

## nodeName : `string`
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 18,11 @@ Access to all the custom data attributes (data-*) set.
## innerText : `string`


<a name="htmlelement-lang" id="htmlelement-lang"></a>

## lang : `string`


<a name="element-nodename" id="element-nodename"></a>

## nodeName : `string`
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 18,11 @@ Access to all the custom data attributes (data-*) set.
## innerText : `string`


<a name="htmlelement-lang" id="htmlelement-lang"></a>

## lang : `string`


<a name="element-nodename" id="element-nodename"></a>

## nodeName : `string`
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -51,6 51,11 @@ Access to all the custom data attributes (data-*) set.
## innerText : `string`


<a name="htmlelement-lang" id="htmlelement-lang"></a>

## lang : `string`


<a name="element-nodename" id="element-nodename"></a>

## nodeName : `string`
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 18,11 @@ Access to all the custom data attributes (data-*) set.
## innerText : `string`


<a name="htmlelement-lang" id="htmlelement-lang"></a>

## lang : `string`


<a name="element-nodename" id="element-nodename"></a>

## nodeName : `string`
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 18,11 @@ Access to all the custom data attributes (data-*) set.
## innerText : `string`


<a name="htmlelement-lang" id="htmlelement-lang"></a>

## lang : `string`


<a name="element-nodename" id="element-nodename"></a>

## nodeName : `string`
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 18,11 @@ Access to all the custom data attributes (data-*) set.
## innerText : `string`


<a name="htmlelement-lang" id="htmlelement-lang"></a>

## lang : `string`


<a name="element-nodename" id="element-nodename"></a>

## nodeName : `string`
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 25,11 @@ Access to all the custom data attributes (data-*) set.
## innerText : `string`


<a name="htmlelement-lang" id="htmlelement-lang"></a>

## lang : `string`


<a name="element-nodename" id="element-nodename"></a>

## nodeName : `string`
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -127,6 127,11 @@ Access to all the custom data attributes (data-*) set.
## innerText : `string`


<a name="htmlelement-lang" id="htmlelement-lang"></a>

## lang : `string`


<a name="element-nodename" id="element-nodename"></a>

## nodeName : `string`
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 24,11 @@ Access to all the custom data attributes (data-*) set.
## innerText : `string`


<a name="htmlelement-lang" id="htmlelement-lang"></a>

## lang : `string`


<a name="element-nodename" id="element-nodename"></a>

## nodeName : `string`
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 18,11 @@ Access to all the custom data attributes (data-*) set.
## innerText : `string`


<a name="htmlelement-lang" id="htmlelement-lang"></a>

## lang : `string`


<a name="element-nodename" id="element-nodename"></a>

## nodeName : `string`
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 18,11 @@ Access to all the custom data attributes (data-*) set.
## innerText : `string`


<a name="htmlelement-lang" id="htmlelement-lang"></a>

## lang : `string`


<a name="element-nodename" id="element-nodename"></a>

## nodeName : `string`
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 25,11 @@ Access to all the custom data attributes (data-*) set.
## innerText : `string`


<a name="htmlelement-lang" id="htmlelement-lang"></a>

## lang : `string`


<a name="element-nodename" id="element-nodename"></a>

## nodeName : `string`
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -23,6 23,11 @@ Access to all the custom data attributes (data-*) set.
## innerText : `string`


<a name="htmlelement-lang" id="htmlelement-lang"></a>

## lang : `string`


<a name="element-nodename" id="element-nodename"></a>

## nodeName : `string`
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -40,6 40,11 @@ Access to all the custom data attributes (data-*) set.
## innerText : `string`


<a name="htmlelement-lang" id="htmlelement-lang"></a>

## lang : `string`


<a name="element-nodename" id="element-nodename"></a>

## nodeName : `string`
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -38,6 38,11 @@ Access to all the custom data attributes (data-*) set.
## innerText : `string`


<a name="htmlelement-lang" id="htmlelement-lang"></a>

## lang : `string`


<a name="element-nodename" id="element-nodename"></a>

## nodeName : `string`
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -53,6 53,11 @@ Access to all the custom data attributes (data-*) set.
## innerText : `string`


<a name="htmlelement-lang" id="htmlelement-lang"></a>

## lang : `string`


<a name="element-nodename" id="element-nodename"></a>

## nodeName : `string`
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 18,11 @@ Access to all the custom data attributes (data-*) set.
## innerText : `string`


<a name="htmlelement-lang" id="htmlelement-lang"></a>

## lang : `string`


<a name="element-nodename" id="element-nodename"></a>

## nodeName : `string`
Expand Down
Loading