Package Exports
- be-exportable
- be-exportable/be-exportable.js
Readme
be-exportable [WIP]
Size of package, including custom element behavior framework (be-enhanced/be-hive):
Size of new code in this package:
Inline scripts
Make exports from inside a script tag accessible from the DOM.
<script nomodule be-exportable>
export const foo = 'bar';
</script>The script tag ends up with a custom field: oScript.beEnhanced.beExportable.exports that exposes each of the export const's. It also emits event "load" when it has finished exporting.
To wait for the script to load:
const enhancement = await oScript.beEnhanced.whenResolved('be-exportable');
const {foo} = enhancement.exports;Inline scripts can reference the script tag with the keyword "selfish".
Inline scripts are quite limited in the syntax. Only "export const blah" is exported.
External scripts
External scripts are far more flexible, but cannot reference the script tag with the keyword "selfish".
<script nomodule src="blah/blah.js" be-exportable>
</script>Repeating script tag
If the adorned script tag is inside a template / shadowDOM realm that is repeated throughout the page, the script tag can share the same export constants by setting the id to something starting with "shared-". To be extra safe, use a guid after the shared- prefix.
on* handler scripts [TODO]
Another option that can result in more compact syntax, without sacrificing security, is to support script found in existing (but useless in the context it is used) on* handlers:
<div be-exportable onload="export const test='hello';"></div>To access the export const symbols:
const enhancement = await oDiv.beEnhanced.whenResolved('be-exportable');
const {onload} = enhancement.exports;
const {test} = onload;Viewing Locally
- Install git.
- Fork/clone this repo.
- Install node.
- Open command window to folder where you cloned this repo.
npm install
npm run serve
- Open http://localhost:3030/demo/ in a modern browser.
Importing in ES Modules:
import 'be-exportable/be-exportable.js';Using from CDN:
<script type=module crossorigin=anonymous>
import 'https://esm.run/be-exportable';
</script>