docs.sheetjs.com/docz/docs/02-getting-started/01-installation/05-extendscript.md

55 lines
2.0 KiB
Markdown
Raw Normal View History

2022-05-16 03:26:04 +00:00
---
title: ExtendScript
2022-08-24 23:48:22 +00:00
pagination_prev: getting-started/index
2023-07-26 20:18:07 +00:00
pagination_next: getting-started/examples/index
2022-05-16 03:26:04 +00:00
sidebar_position: 5
sidebar_custom_props:
summary: Photoshop, InDesign, and other Creative Cloud apps
---
import current from '/version.js';
ExtendScript is a dialect of JavaScript used in Photoshop and InDesign scripts.
2022-05-16 03:26:04 +00:00
Each standalone release script is available at https://cdn.sheetjs.com/.
2022-05-16 03:26:04 +00:00
`xlsx.extendscript.js` is a special ExtendScript-compatible build. The script is
carefully assembled to work around ExtendScript quirks. Due to bugs in various
JavaScript minifiers and tools, scripts cannot be compressed or post-processed.
2022-05-16 03:26:04 +00:00
<p><a href={"https://cdn.sheetjs.com/xlsx-" + current + "/package/dist/xlsx.extendscript.js"}>{"https://cdn.sheetjs.com/xlsx-" + current + "/package/dist/xlsx.extendscript.js"}</a> is the URL for {current}</p>
2022-05-16 03:26:04 +00:00
After downloading the script, it can be directly referenced with `#include`:
```c
#include "xlsx.extendscript.js"
```
2023-02-11 07:13:53 +00:00
2023-06-25 09:36:58 +00:00
:::tip pass
2023-04-27 09:12:19 +00:00
[Watch the repo](https://git.sheetjs.com/SheetJS/sheetjs) or subscribe to the
[RSS feed](https://git.sheetjs.com/sheetjs/sheetjs/tags.rss) to be notified when
new versions are released!
:::
2023-04-16 07:21:15 +00:00
For local deployments, the scripts can be placed in the `Scripts` folder. The
path is application-specific.
| App | Location |
|:----------|:-----------------------------------------------------------------|
| Photoshop | `\Presets\Scripts` within the Application folder |
| InDesign | Windows > Utilities > Scripts, click `☰` > "Reveal in Explorer" |
2024-06-04 03:54:48 +00:00
:::note CEP and UXP usage
2023-04-16 07:21:15 +00:00
The ExtendScript build should be used when performing spreadsheet operations
from the host context (within a `jsx` script file).
2024-06-04 03:54:48 +00:00
**CEP**: [The standalone scripts](/docs/getting-started/installation/standalone)
should be added to CEP extension HTML.
**UXP**: [The standalone scripts](/docs/getting-started/installation/standalone)
can be loaded directly in UXP scripts using the `require` function.
2023-04-16 07:21:15 +00:00
:::