spell-ui 0.8.12 → 0.8.13
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README-components.md +5 -3
- package/dist/{Dragging-B93hbRxF.js → Dragging-tHPSvf3G.js} +56 -13
- package/dist/Dragging-tHPSvf3G.js.map +1 -0
- package/dist/_spell-element/DOMElement.d.ts +8 -1
- package/dist/_spell-element/drawnWindow.d.ts +62 -0
- package/dist/_util/Dragging.d.ts +7 -0
- package/dist/components/components.types.d.ts +2 -0
- package/dist/components/ui-diagram/UIDiagram.d.ts +3 -0
- package/dist/components/ui-graph/GraphLayout.d.ts +54 -0
- package/dist/components/ui-graph/UIGraph.d.ts +355 -0
- package/dist/components/ui-graph/UIGraph.en.d.ts +137 -0
- package/dist/components/ui-graph/UIGraph.es.d.ts +48 -0
- package/dist/components/ui-graph/UIGraph.types.d.ts +193 -0
- package/dist/components/ui-graph/index.d.ts +5 -0
- package/dist/components/ui-json/UIJson.d.ts +275 -10
- package/dist/components/ui-json/UIJson.en.d.ts +148 -9
- package/dist/components/ui-json/UIJson.es.d.ts +34 -3
- package/dist/components/ui-json/index.d.ts +2 -2
- package/dist/components/ui-split-panel/UISplitPanel.d.ts +2 -16
- package/dist/components/ui-tree/UITree.d.ts +758 -26
- package/dist/components/ui-tree/UITree.en.d.ts +113 -3
- package/dist/components/ui-tree/UITree.es.d.ts +24 -0
- package/dist/components/ui-tree/UITree.types.d.ts +34 -0
- package/dist/components/ui-tree/UITreeItem.d.ts +40 -1
- package/dist/components/ui-tree/UITreeItem.en.d.ts +9 -0
- package/dist/components/ui-tree/UITreeItem.es.d.ts +2 -0
- package/dist/components/ui-tree/index.d.ts +3 -2
- package/dist/components/ui-tree-diagram/UITreeDiagram.d.ts +3 -0
- package/dist/{components.es-DEa8Ep42.js → components.es-DilRG1VO.js} +117 -9
- package/dist/components.es-DilRG1VO.js.map +1 -0
- package/dist/core.js +713 -671
- package/dist/core.js.map +1 -1
- package/dist/index.d.ts +1 -0
- package/dist/index.js +97 -96
- package/dist/jsx.d.ts +489 -20
- package/dist/ui-diagram.js +2 -2
- package/dist/ui-diagram.js.map +1 -1
- package/dist/ui-graph.editor-DLsXPyby.js +5 -0
- package/dist/ui-graph.editor-DLsXPyby.js.map +1 -0
- package/dist/ui-graph.js +1295 -0
- package/dist/ui-graph.js.map +1 -0
- package/dist/ui-json.editor-BS-v1bqO.js +5 -0
- package/dist/ui-json.editor-BS-v1bqO.js.map +1 -0
- package/dist/ui-json.js +629 -32
- package/dist/ui-json.js.map +1 -1
- package/dist/ui-property-editor.js +3 -2
- package/dist/ui-property-editor.js.map +1 -1
- package/dist/ui-root.js +34 -3
- package/dist/ui-root.js.map +1 -1
- package/dist/ui-site-nav.js +4 -4
- package/dist/ui-site-nav.js.map +1 -1
- package/dist/ui-split-panel.js +31 -61
- package/dist/ui-split-panel.js.map +1 -1
- package/dist/ui-tree-diagram.js +1 -1
- package/dist/ui-tree-diagram.js.map +1 -1
- package/dist/ui-tree.editor-Bqsa0dYQ.js +5 -0
- package/dist/ui-tree.editor-Bqsa0dYQ.js.map +1 -0
- package/dist/ui-tree.js +1734 -237
- package/dist/ui-tree.js.map +1 -1
- package/dist/util/PaneSizes.d.ts +42 -0
- package/dist/util/index.d.ts +2 -0
- package/package.json +1 -1
- package/dist/Dragging-B93hbRxF.js.map +0 -1
- package/dist/components.es-DEa8Ep42.js.map +0 -1
- package/dist/ui-json.editor-BgZbrB_W.js +0 -5
- package/dist/ui-json.editor-BgZbrB_W.js.map +0 -1
- package/dist/ui-tree.editor-BoQztwdz.js +0 -5
- package/dist/ui-tree.editor-BoQztwdz.js.map +0 -1
package/dist/jsx.d.ts
CHANGED
|
@@ -12210,6 +12210,289 @@ export interface UIFormAttributes {
|
|
|
12210
12210
|
/** `<ui-form>` in JSX: its own attributes, and HTML's global ones. */
|
|
12211
12211
|
export interface UIFormJSXAttributes extends Omit<UIGlobalJSXAttributes<UIHTMLElement<UIFormEventMap>>, keyof UIFormAttributes>, UIFormAttributes {
|
|
12212
12212
|
}
|
|
12213
|
+
/** `<ui-graph>`'s events, from its vocabulary: each one's `CustomEvent`, by name. */
|
|
12214
|
+
export interface UIGraphEventMap {
|
|
12215
|
+
/**
|
|
12216
|
+
* `ui-selecting`: A node, edge or port is about to be selected by a click: cancel it to keep the selection.
|
|
12217
|
+
* - `event.detail`: `{ kind: 'node' | 'edge' | 'port', id: string, path: string, item: object, originalEvent?: Event }`
|
|
12218
|
+
* - cancelable: `preventDefault()` vetoes it
|
|
12219
|
+
*/
|
|
12220
|
+
"ui-selecting": CustomEvent<{
|
|
12221
|
+
kind: "node" | "edge" | "port";
|
|
12222
|
+
id: string;
|
|
12223
|
+
path: string;
|
|
12224
|
+
item: object;
|
|
12225
|
+
originalEvent?: Event;
|
|
12226
|
+
}>;
|
|
12227
|
+
/**
|
|
12228
|
+
* `ui-changed`: What's selected changed: `value` is the new `selected`; `item` the node, edge or port itself. ALSO when the graph shown changes by a drill or a breadcrumb: `{ kind: 'path', path }` (`path` the new `path`), so one listener keeps a page in step with both.
|
|
12229
|
+
* - `event.detail`: `{ value: { kind: string, id: string, path: string } | undefined, kind?: string, id?: string, path?: string, item?: object, originalEvent?: Event } | { kind: 'path', path: string, originalEvent?: Event }`
|
|
12230
|
+
*/
|
|
12231
|
+
"ui-changed": CustomEvent<{
|
|
12232
|
+
value: {
|
|
12233
|
+
kind: string;
|
|
12234
|
+
id: string;
|
|
12235
|
+
path: string;
|
|
12236
|
+
} | undefined;
|
|
12237
|
+
kind?: string;
|
|
12238
|
+
id?: string;
|
|
12239
|
+
path?: string;
|
|
12240
|
+
item?: object;
|
|
12241
|
+
originalEvent?: Event;
|
|
12242
|
+
} | {
|
|
12243
|
+
kind: "path";
|
|
12244
|
+
path: string;
|
|
12245
|
+
originalEvent?: Event;
|
|
12246
|
+
}>;
|
|
12247
|
+
/**
|
|
12248
|
+
* `ui-node-toggled`: A node with children was opened or closed, by a person or by `open()` / `close()`.
|
|
12249
|
+
* - `event.detail`: `{ node: object, path: string, open: boolean, view: 'inline' | 'modal' | 'drill', originalEvent?: Event }`
|
|
12250
|
+
*/
|
|
12251
|
+
"ui-node-toggled": CustomEvent<{
|
|
12252
|
+
node: object;
|
|
12253
|
+
path: string;
|
|
12254
|
+
open: boolean;
|
|
12255
|
+
view: "inline" | "modal" | "drill";
|
|
12256
|
+
originalEvent?: Event;
|
|
12257
|
+
}>;
|
|
12258
|
+
}
|
|
12259
|
+
/** `<ui-graph>`'s own attributes, from its vocabulary. */
|
|
12260
|
+
export interface UIGraphAttributes {
|
|
12261
|
+
/**
|
|
12262
|
+
* The graph to draw, a `GraphData`: `nodes` (`id`, `label`, `kind`, `ports`, `children`, `data`) and `edges` (`from` / `to` `{ node, port }`). An end with no `node` is the enclosing node's port. A JS property (JSON in the attribute); set a NEW graph to redraw.
|
|
12263
|
+
* - a JS property (rich data): an object, array or function, given as it is
|
|
12264
|
+
*/
|
|
12265
|
+
graph?: unknown;
|
|
12266
|
+
/**
|
|
12267
|
+
* The graph to draw, a `GraphData`: `nodes` (`id`, `label`, `kind`, `ports`, `children`, `data`) and `edges` (`from` / `to` `{ node, port }`). An end with no `node` is the enclosing node's port. A JS property (JSON in the attribute); set a NEW graph to redraw.
|
|
12268
|
+
* - a JS property (rich data): an object, array or function, given as it is
|
|
12269
|
+
* @deprecated write `graph` -- `prop:` stays only for compiled spell
|
|
12270
|
+
*/
|
|
12271
|
+
"prop:graph"?: unknown;
|
|
12272
|
+
/**
|
|
12273
|
+
* How a node's children show when it's opened: `inline`, inside the node, which grows round them; `modal`, a graph in a modal; `drill`, the graph replaced by them, with breadcrumbs back. A node's own `childView` wins.
|
|
12274
|
+
* - takes: `inline` · `modal` · `drill`
|
|
12275
|
+
* - default: `inline`
|
|
12276
|
+
*/
|
|
12277
|
+
"child-view"?: "inline" | "modal" | "drill";
|
|
12278
|
+
/**
|
|
12279
|
+
* `child-view`, as the DOM element's property.
|
|
12280
|
+
* @deprecated write `child-view` -- `prop:` stays only for compiled spell
|
|
12281
|
+
*/
|
|
12282
|
+
"prop:childView"?: "inline" | "modal" | "drill";
|
|
12283
|
+
/**
|
|
12284
|
+
* The node whose child graph is shown, drilled to, by its ids from the top joined by `/` (`cpu/alu`); `""`: the top. Setting it drills there, loading lazy children on the way; drilling and the breadcrumbs set it back, with `ui-changed` `{ kind: 'path', path }`.
|
|
12285
|
+
* - takes: text
|
|
12286
|
+
* - default: ``
|
|
12287
|
+
*/
|
|
12288
|
+
path?: string;
|
|
12289
|
+
/**
|
|
12290
|
+
* `path`, as the DOM element's property.
|
|
12291
|
+
* @deprecated write `path` -- `prop:` stays only for compiled spell
|
|
12292
|
+
*/
|
|
12293
|
+
"prop:path"?: string;
|
|
12294
|
+
/**
|
|
12295
|
+
* PROPERTY: what's selected, `{ kind: 'node' | 'edge' | 'port', id, path }`; `undefined`: nothing. Clicks set it.
|
|
12296
|
+
* - a JS property (rich data): an object, array or function, given as it is
|
|
12297
|
+
*/
|
|
12298
|
+
selected?: unknown;
|
|
12299
|
+
/**
|
|
12300
|
+
* PROPERTY: what's selected, `{ kind: 'node' | 'edge' | 'port', id, path }`; `undefined`: nothing. Clicks set it.
|
|
12301
|
+
* - a JS property (rich data): an object, array or function, given as it is
|
|
12302
|
+
* @deprecated write `selected` -- `prop:` stays only for compiled spell
|
|
12303
|
+
*/
|
|
12304
|
+
"prop:selected"?: unknown;
|
|
12305
|
+
/**
|
|
12306
|
+
* PROPERTY: the enclosing node's ports, drawn as pins on the graph's sides, for edges with no `node`. Set by a modal's graph; a page rarely needs it.
|
|
12307
|
+
* - a JS property (rich data): an object, array or function, given as it is
|
|
12308
|
+
*/
|
|
12309
|
+
boundary?: unknown;
|
|
12310
|
+
/**
|
|
12311
|
+
* PROPERTY: the enclosing node's ports, drawn as pins on the graph's sides, for edges with no `node`. Set by a modal's graph; a page rarely needs it.
|
|
12312
|
+
* - a JS property (rich data): an object, array or function, given as it is
|
|
12313
|
+
* @deprecated write `boundary` -- `prop:` stays only for compiled spell
|
|
12314
|
+
*/
|
|
12315
|
+
"prop:boundary"?: unknown;
|
|
12316
|
+
/**
|
|
12317
|
+
* Can't be used: dimmed, out of the tab order, and everything inside it inert; `aria-disabled`. Shared by every element; a family may give it a meaning of its own (`elementSetup.disabled`).
|
|
12318
|
+
* - takes: flag (present / absent)
|
|
12319
|
+
*/
|
|
12320
|
+
disabled?: boolean | "";
|
|
12321
|
+
/**
|
|
12322
|
+
* `disabled`, as the DOM element's property.
|
|
12323
|
+
* @deprecated write `disabled` -- `prop:` stays only for compiled spell
|
|
12324
|
+
*/
|
|
12325
|
+
"prop:disabled"?: boolean | "";
|
|
12326
|
+
/**
|
|
12327
|
+
* Busy: dimmed under a loader, and inert; `aria-busy`. Shared by every element; a family may draw its own loader (`elementSetup.loading`).
|
|
12328
|
+
* - takes: flag (present / absent)
|
|
12329
|
+
*/
|
|
12330
|
+
loading?: boolean | "";
|
|
12331
|
+
/**
|
|
12332
|
+
* `loading`, as the DOM element's property.
|
|
12333
|
+
* @deprecated write `loading` -- `prop:` stays only for compiled spell
|
|
12334
|
+
*/
|
|
12335
|
+
"prop:loading"?: boolean | "";
|
|
12336
|
+
/**
|
|
12337
|
+
* Shown: the platform's `hidden`, turned round (`el.visible === !el.hidden`). Writing either one shows or hides the element with its `animation`; `visible="false"` writes `hidden`. Neither written: the family decides (a modal starts hidden, a message shown). Both written in markup and disagreeing: `hidden` wins.
|
|
12338
|
+
* - takes: flag (present / absent)
|
|
12339
|
+
*/
|
|
12340
|
+
visible?: boolean | "";
|
|
12341
|
+
/**
|
|
12342
|
+
* `visible`, as the DOM element's property.
|
|
12343
|
+
* @deprecated write `visible` -- `prop:` stays only for compiled spell
|
|
12344
|
+
*/
|
|
12345
|
+
"prop:visible"?: boolean | "";
|
|
12346
|
+
/**
|
|
12347
|
+
* How it shows and hides (Fomantic's names: `fade up`, `scale`, `fly down` ...); default its family's, else `fade`. `none` turns motion off for it and everything inside it, as the person's reduced-motion setting does; an element inside can't turn it back on.
|
|
12348
|
+
* - takes: `fade` · `fade up` · `fade down` · `fade left` · `fade right` · `scale` · `zoom` · `drop` · `browse` · `browse right` · `fly` · `fly up` · `fly down` · `fly left` · `fly right` · `slide` · `slide up` · `slide down` · `slide left` · `slide right` · `swing` · `swing up` · `swing down` · `swing left` · `swing right` · `horizontal flip` · `vertical flip` · `flash` · `shake` · `bounce` · `tada` · `pulse` · `jiggle` · `glow` · `coin` · `none`
|
|
12349
|
+
*/
|
|
12350
|
+
animation?: "fade" | "fade up" | "fade down" | "fade left" | "fade right" | "scale" | "zoom" | "drop" | "browse" | "browse right" | "fly" | "fly up" | "fly down" | "fly left" | "fly right" | "slide" | "slide up" | "slide down" | "slide left" | "slide right" | "swing" | "swing up" | "swing down" | "swing left" | "swing right" | "horizontal flip" | "vertical flip" | "flash" | "shake" | "bounce" | "tada" | "pulse" | "jiggle" | "glow" | "coin" | "none";
|
|
12351
|
+
/**
|
|
12352
|
+
* `animation`, as the DOM element's property.
|
|
12353
|
+
* @deprecated write `animation` -- `prop:` stays only for compiled spell
|
|
12354
|
+
*/
|
|
12355
|
+
"prop:animation"?: "fade" | "fade up" | "fade down" | "fade left" | "fade right" | "scale" | "zoom" | "drop" | "browse" | "browse right" | "fly" | "fly up" | "fly down" | "fly left" | "fly right" | "slide" | "slide up" | "slide down" | "slide left" | "slide right" | "swing" | "swing up" | "swing down" | "swing left" | "swing right" | "horizontal flip" | "vertical flip" | "flash" | "shake" | "bounce" | "tada" | "pulse" | "jiggle" | "glow" | "coin" | "none";
|
|
12356
|
+
/**
|
|
12357
|
+
* Where a click on it goes, as a link's `href`: `<ui-text link>` is a link in running text. A family that draws its own link (text, button, image ...) draws an `<a>`; on any other element a click goes there, except on a control of its own inside. Its old name was `href`.
|
|
12358
|
+
* - takes: text
|
|
12359
|
+
*/
|
|
12360
|
+
link?: string;
|
|
12361
|
+
/**
|
|
12362
|
+
* `link`, as the DOM element's property.
|
|
12363
|
+
* @deprecated write `link` -- `prop:` stays only for compiled spell
|
|
12364
|
+
*/
|
|
12365
|
+
"prop:link"?: string;
|
|
12366
|
+
/**
|
|
12367
|
+
* Where `link` opens: `_blank` for a new tab, or a window's name; as a link's `target`.
|
|
12368
|
+
* - takes: text
|
|
12369
|
+
*/
|
|
12370
|
+
target?: string;
|
|
12371
|
+
/**
|
|
12372
|
+
* `target`, as the DOM element's property.
|
|
12373
|
+
* @deprecated write `target` -- `prop:` stays only for compiled spell
|
|
12374
|
+
*/
|
|
12375
|
+
"prop:target"?: string;
|
|
12376
|
+
/**
|
|
12377
|
+
* How its letters look, several words at once: `bold`, `heavy`, `italic`, `underline`, `strikethrough`, `code`, `highlight`, `subscript`, `superscript`, `all-caps`, `title-caps` (`font="bold italic"`); a family from the theme, `headline`, `subhead`, `serif`, `sans-serif` or `typewriter`; and a size in pixels, `14`, or with its line height, `10/20` (`font="bold serif 10/20"`). `<ui-text>` draws each face as its HTML element (`<strong>`, `<em>` ...), so screen readers hear it, and takes each word as a bare attribute too (`<ui-text bold serif>`); every other element shows the look alone.
|
|
12378
|
+
* - takes: space-separated: `bold` · `heavy` · `italic` · `underline` · `strikethrough` · `code` · `highlight` · `subscript` · `superscript` · `all-caps` · `title-caps` · `headline` · `subhead` · `serif` · `sans-serif` · `typewriter`
|
|
12379
|
+
*/
|
|
12380
|
+
font?: string;
|
|
12381
|
+
/**
|
|
12382
|
+
* `font`, as the DOM element's property.
|
|
12383
|
+
* @deprecated write `font` -- `prop:` stays only for compiled spell
|
|
12384
|
+
*/
|
|
12385
|
+
"prop:font"?: string;
|
|
12386
|
+
/**
|
|
12387
|
+
* A hard shadow behind its letters, down and to the right, in a hue: `shadow="yellow"`, a sticker's look for a logo or a title. Its size follows the letters (0.06em).
|
|
12388
|
+
* - takes: `primary` · `secondary` · `red` · `orange` · `yellow` · `olive` · `green` · `teal` · `blue` · `violet` · `purple` · `pink` · `brown` · `grey` · `black` · `positive` · `negative`
|
|
12389
|
+
*/
|
|
12390
|
+
shadow?: "primary" | "secondary" | "red" | "orange" | "yellow" | "olive" | "green" | "teal" | "blue" | "violet" | "purple" | "pink" | "brown" | "grey" | "black" | "positive" | "negative";
|
|
12391
|
+
/**
|
|
12392
|
+
* `shadow`, as the DOM element's property.
|
|
12393
|
+
* @deprecated write `shadow` -- `prop:` stays only for compiled spell
|
|
12394
|
+
*/
|
|
12395
|
+
"prop:shadow"?: "primary" | "secondary" | "red" | "orange" | "yellow" | "olive" | "green" | "teal" | "blue" | "violet" | "purple" | "pink" | "brown" | "grey" | "black" | "positive" | "negative";
|
|
12396
|
+
/**
|
|
12397
|
+
* Its box's own width where it sits, any CSS length: `width="10em"`, `"50%"`. In a row it keeps that width, never squeezed. A family with a width of its own keeps it: a container's centres its box, an image's is its size in pixels, a column's counts columns.
|
|
12398
|
+
* - takes: text
|
|
12399
|
+
*/
|
|
12400
|
+
width?: string;
|
|
12401
|
+
/**
|
|
12402
|
+
* `width`, as the DOM element's property.
|
|
12403
|
+
* @deprecated write `width` -- `prop:` stays only for compiled spell
|
|
12404
|
+
*/
|
|
12405
|
+
"prop:width"?: string;
|
|
12406
|
+
/**
|
|
12407
|
+
* The narrowest its box gets, any CSS length: `min-width="16em"`. A `fluid` element in a row grows from there into the room left; the row wraps it onto a line of its own before it gets any narrower.
|
|
12408
|
+
* - takes: text
|
|
12409
|
+
*/
|
|
12410
|
+
"min-width"?: string;
|
|
12411
|
+
/**
|
|
12412
|
+
* `min-width`, as the DOM element's property.
|
|
12413
|
+
* @deprecated write `min-width` -- `prop:` stays only for compiled spell
|
|
12414
|
+
*/
|
|
12415
|
+
"prop:minWidth"?: string;
|
|
12416
|
+
/**
|
|
12417
|
+
* The widest its box gets, any CSS length: `max-width="36em"`, so a bar or a field stops growing on a wide screen. A family with a `max-width` of its own (`<ui-zoom>`) keeps it.
|
|
12418
|
+
* - takes: text
|
|
12419
|
+
*/
|
|
12420
|
+
"max-width"?: string;
|
|
12421
|
+
/**
|
|
12422
|
+
* `max-width`, as the DOM element's property.
|
|
12423
|
+
* @deprecated write `max-width` -- `prop:` stays only for compiled spell
|
|
12424
|
+
*/
|
|
12425
|
+
"prop:maxWidth"?: string;
|
|
12426
|
+
/**
|
|
12427
|
+
* Its tooltip: the browser's own, written as the element's `title`.
|
|
12428
|
+
* - takes: text
|
|
12429
|
+
*/
|
|
12430
|
+
tooltip?: string;
|
|
12431
|
+
/**
|
|
12432
|
+
* `tooltip`, as the DOM element's property.
|
|
12433
|
+
* @deprecated write `tooltip` -- `prop:` stays only for compiled spell
|
|
12434
|
+
*/
|
|
12435
|
+
"prop:tooltip"?: string;
|
|
12436
|
+
/**
|
|
12437
|
+
* Its name for screen readers (`aria-label`), where it has no words of its own. A family whose `label` is something else (a field's, a statistic's) keeps its own.
|
|
12438
|
+
* - takes: text
|
|
12439
|
+
*/
|
|
12440
|
+
label?: string;
|
|
12441
|
+
/**
|
|
12442
|
+
* `label`, as the DOM element's property.
|
|
12443
|
+
* @deprecated write `label` -- `prop:` stays only for compiled spell
|
|
12444
|
+
*/
|
|
12445
|
+
"prop:label"?: string;
|
|
12446
|
+
/**
|
|
12447
|
+
* People can drag it to a new place inside its container: bare or `both`, `horizontally` or `vertically` for one way only. A press on a control of its own inside (a button, a field) stays that control's. With an `id`, where each person put it is remembered.
|
|
12448
|
+
* - takes: text
|
|
12449
|
+
*/
|
|
12450
|
+
movable?: string;
|
|
12451
|
+
/**
|
|
12452
|
+
* `movable`, as the DOM element's property.
|
|
12453
|
+
* @deprecated write `movable` -- `prop:` stays only for compiled spell
|
|
12454
|
+
*/
|
|
12455
|
+
"prop:movable"?: string;
|
|
12456
|
+
/**
|
|
12457
|
+
* People can drag its corner to resize it: bare or `both`, `horizontally` or `vertically`. Limit it with plain CSS (`max-width: 50%`, `min-height: 4em`). With an `id`, the size each person gave it is remembered. A family with a `resizable` of its own keeps it (`<ui-segment resizable>` drags its height).
|
|
12458
|
+
* - takes: text
|
|
12459
|
+
*/
|
|
12460
|
+
resizable?: string;
|
|
12461
|
+
/**
|
|
12462
|
+
* `resizable`, as the DOM element's property.
|
|
12463
|
+
* @deprecated write `resizable` -- `prop:` stays only for compiled spell
|
|
12464
|
+
*/
|
|
12465
|
+
"prop:resizable"?: string;
|
|
12466
|
+
/**
|
|
12467
|
+
* Shown only on these devices, a comma list: `on-platform="desktop, tablet"` hides it on phones. `phone`: a touch screen, small on at least one side (under 600px), either way up; `tablet`: a touch screen, big both ways; `desktop`: a mouse or a trackpad. Follows a resize or a turn of the device at once. For what a device can't do (a phone has no screen capture), or has no room for.
|
|
12468
|
+
* - takes: text
|
|
12469
|
+
*/
|
|
12470
|
+
"on-platform"?: string;
|
|
12471
|
+
/**
|
|
12472
|
+
* `on-platform`, as the DOM element's property.
|
|
12473
|
+
* @deprecated write `on-platform` -- `prop:` stays only for compiled spell
|
|
12474
|
+
*/
|
|
12475
|
+
"prop:onPlatform"?: string;
|
|
12476
|
+
/**
|
|
12477
|
+
* `ui-selecting`: A node, edge or port is about to be selected by a click: cancel it to keep the selection.
|
|
12478
|
+
* - `event.detail`: `{ kind: 'node' | 'edge' | 'port', id: string, path: string, item: object, originalEvent?: Event }`
|
|
12479
|
+
* - cancelable: `preventDefault()` vetoes it
|
|
12480
|
+
*/
|
|
12481
|
+
"on-ui-selecting"?: (event: UIGraphEventMap["ui-selecting"]) => void;
|
|
12482
|
+
/**
|
|
12483
|
+
* `ui-changed`: What's selected changed: `value` is the new `selected`; `item` the node, edge or port itself. ALSO when the graph shown changes by a drill or a breadcrumb: `{ kind: 'path', path }` (`path` the new `path`), so one listener keeps a page in step with both.
|
|
12484
|
+
* - `event.detail`: `{ value: { kind: string, id: string, path: string } | undefined, kind?: string, id?: string, path?: string, item?: object, originalEvent?: Event } | { kind: 'path', path: string, originalEvent?: Event }`
|
|
12485
|
+
*/
|
|
12486
|
+
"on-ui-changed"?: (event: UIGraphEventMap["ui-changed"]) => void;
|
|
12487
|
+
/**
|
|
12488
|
+
* `ui-node-toggled`: A node with children was opened or closed, by a person or by `open()` / `close()`.
|
|
12489
|
+
* - `event.detail`: `{ node: object, path: string, open: boolean, view: 'inline' | 'modal' | 'drill', originalEvent?: Event }`
|
|
12490
|
+
*/
|
|
12491
|
+
"on-ui-node-toggled"?: (event: UIGraphEventMap["ui-node-toggled"]) => void;
|
|
12492
|
+
}
|
|
12493
|
+
/** `<ui-graph>` in JSX: its own attributes, and HTML's global ones. */
|
|
12494
|
+
export interface UIGraphJSXAttributes extends Omit<UIGlobalJSXAttributes<UIHTMLElement<UIGraphEventMap>>, keyof UIGraphAttributes>, UIGraphAttributes {
|
|
12495
|
+
}
|
|
12213
12496
|
/** `<ui-grid>`'s own attributes, from its vocabulary. */
|
|
12214
12497
|
export interface UIGridAttributes {
|
|
12215
12498
|
/**
|
|
@@ -15456,7 +15739,7 @@ export interface UIJsonEventMap {
|
|
|
15456
15739
|
content: string;
|
|
15457
15740
|
}>;
|
|
15458
15741
|
/**
|
|
15459
|
-
* `ui-changed`: The data changed: loaded from `source`, set through `value` or `content`, or its text edited. `value` is `undefined` when the text is empty or isn't JSON.
|
|
15742
|
+
* `ui-changed`: The data changed: loaded from `source`, set through `value` or `content`, edited in the outline, or its text edited. `value` is `undefined` when the text is empty or isn't JSON.
|
|
15460
15743
|
* - `event.detail`: `{ value: unknown, content: string }`
|
|
15461
15744
|
*/
|
|
15462
15745
|
"ui-changed": CustomEvent<{
|
|
@@ -15491,6 +15774,24 @@ export interface UIJsonEventMap {
|
|
|
15491
15774
|
source?: string;
|
|
15492
15775
|
error: unknown;
|
|
15493
15776
|
}>;
|
|
15777
|
+
/**
|
|
15778
|
+
* `ui-navigating`: A key or a value was clicked (not a double-click, nor the end of a text selection). `path`: the keys from the top value down to that member (`[]`: the top value); `key`: its key, an array member's index; `value`: its value (an object or array too, when its key was clicked); `part`: which was clicked. The page decides what it means (jumping to what a value names) and calls `preventDefault()`.
|
|
15779
|
+
* - `event.detail`: `{ path: (string | number)[], key: string | number | undefined, value: unknown, part: "key" | "value" }`
|
|
15780
|
+
* - cancelable: `preventDefault()` vetoes it
|
|
15781
|
+
*/
|
|
15782
|
+
"ui-navigating": CustomEvent<{
|
|
15783
|
+
path: (string | number)[];
|
|
15784
|
+
key: string | number | undefined;
|
|
15785
|
+
value: unknown;
|
|
15786
|
+
part: "key" | "value";
|
|
15787
|
+
}>;
|
|
15788
|
+
/**
|
|
15789
|
+
* `ui-copied`: The Copy button copied `content`, as JSON.
|
|
15790
|
+
* - `event.detail`: `{ content: string }`
|
|
15791
|
+
*/
|
|
15792
|
+
"ui-copied": CustomEvent<{
|
|
15793
|
+
content: string;
|
|
15794
|
+
}>;
|
|
15494
15795
|
}
|
|
15495
15796
|
/** `<ui-json>`'s own attributes, from its vocabulary. */
|
|
15496
15797
|
export interface UIJsonAttributes {
|
|
@@ -15515,6 +15816,61 @@ export interface UIJsonAttributes {
|
|
|
15515
15816
|
* @deprecated write `load` -- `prop:` stays only for compiled spell
|
|
15516
15817
|
*/
|
|
15517
15818
|
"prop:load"?: "eager" | "visible" | "idle";
|
|
15819
|
+
/**
|
|
15820
|
+
* How many levels start open: `1`, the top object or array alone; `0`, everything closed. New data opens this way again.
|
|
15821
|
+
* - takes: number
|
|
15822
|
+
* - default: `1`
|
|
15823
|
+
*/
|
|
15824
|
+
depth?: number | `${number}`;
|
|
15825
|
+
/**
|
|
15826
|
+
* `depth`, as the DOM element's property.
|
|
15827
|
+
* @deprecated write `depth` -- `prop:` stays only for compiled spell
|
|
15828
|
+
*/
|
|
15829
|
+
"prop:depth"?: number | `${number}`;
|
|
15830
|
+
/**
|
|
15831
|
+
* Keys in quotes, as JSON writes them: `"type": "optical"`. `quotes="no"`: `type: "optical"`, as JSON5 allows (a key that isn't a name keeps its quotes). The header's quotes button sets it. Copy always copies JSON.
|
|
15832
|
+
* - takes: flag (present / absent)
|
|
15833
|
+
* - default: `true`
|
|
15834
|
+
*/
|
|
15835
|
+
quotes?: boolean | "" | "false";
|
|
15836
|
+
/**
|
|
15837
|
+
* `quotes`, as the DOM element's property.
|
|
15838
|
+
* @deprecated write `quotes` -- `prop:` stays only for compiled spell
|
|
15839
|
+
*/
|
|
15840
|
+
"prop:quotes"?: boolean | "" | "false";
|
|
15841
|
+
/**
|
|
15842
|
+
* Hides the header: the Copy and quotes buttons.
|
|
15843
|
+
* - takes: flag (present / absent)
|
|
15844
|
+
* - default: `false`
|
|
15845
|
+
*/
|
|
15846
|
+
"no-header"?: boolean | "";
|
|
15847
|
+
/**
|
|
15848
|
+
* `no-header`, as the DOM element's property.
|
|
15849
|
+
* @deprecated write `no-header` -- `prop:` stays only for compiled spell
|
|
15850
|
+
*/
|
|
15851
|
+
"prop:noHeader"?: boolean | "";
|
|
15852
|
+
/**
|
|
15853
|
+
* Double-click a key or a value to edit it, in a control that fits the value: a text field for a string, a number field for a number, a date picker for an ISO date, a checkbox for `true` / `false`, a pick list for a key `editors` gives choices. Enter (or leaving it) keeps the edit, Escape drops it. `value` changes and `ui-changed` is sent; what's open stays open.
|
|
15854
|
+
* - takes: flag (present / absent)
|
|
15855
|
+
* - default: `false`
|
|
15856
|
+
*/
|
|
15857
|
+
editable?: boolean | "";
|
|
15858
|
+
/**
|
|
15859
|
+
* `editable`, as the DOM element's property.
|
|
15860
|
+
* @deprecated write `editable` -- `prop:` stays only for compiled spell
|
|
15861
|
+
*/
|
|
15862
|
+
"prop:editable"?: boolean | "";
|
|
15863
|
+
/**
|
|
15864
|
+
* With `editable`, the control for each key, as a PROPERTY: `{ direction: ["in", "out"], when: "date" }`. A list of strings makes a pick list; a word names the control: `text`, `number`, `date`, `datetime`, `boolean` or `json` (a text field read as JSON). A key it doesn't name gets the control its value's type picks.
|
|
15865
|
+
* - a JS property (rich data): an object, array or function, given as it is
|
|
15866
|
+
*/
|
|
15867
|
+
editors?: unknown;
|
|
15868
|
+
/**
|
|
15869
|
+
* With `editable`, the control for each key, as a PROPERTY: `{ direction: ["in", "out"], when: "date" }`. A list of strings makes a pick list; a word names the control: `text`, `number`, `date`, `datetime`, `boolean` or `json` (a text field read as JSON). A key it doesn't name gets the control its value's type picks.
|
|
15870
|
+
* - a JS property (rich data): an object, array or function, given as it is
|
|
15871
|
+
* @deprecated write `editors` -- `prop:` stays only for compiled spell
|
|
15872
|
+
*/
|
|
15873
|
+
"prop:editors"?: unknown;
|
|
15518
15874
|
/**
|
|
15519
15875
|
* Can't be used: dimmed, out of the tab order, and everything inside it inert; `aria-disabled`. Shared by every element; a family may give it a meaning of its own (`elementSetup.disabled`).
|
|
15520
15876
|
* - takes: flag (present / absent)
|
|
@@ -15690,7 +16046,7 @@ export interface UIJsonAttributes {
|
|
|
15690
16046
|
*/
|
|
15691
16047
|
"on-ui-loaded"?: (event: UIJsonEventMap["ui-loaded"]) => void;
|
|
15692
16048
|
/**
|
|
15693
|
-
* `ui-changed`: The data changed: loaded from `source`, set through `value` or `content`, or its text edited. `value` is `undefined` when the text is empty or isn't JSON.
|
|
16049
|
+
* `ui-changed`: The data changed: loaded from `source`, set through `value` or `content`, edited in the outline, or its text edited. `value` is `undefined` when the text is empty or isn't JSON.
|
|
15694
16050
|
* - `event.detail`: `{ value: unknown, content: string }`
|
|
15695
16051
|
*/
|
|
15696
16052
|
"on-ui-changed"?: (event: UIJsonEventMap["ui-changed"]) => void;
|
|
@@ -15711,6 +16067,17 @@ export interface UIJsonAttributes {
|
|
|
15711
16067
|
* - cancelable: `preventDefault()` vetoes it
|
|
15712
16068
|
*/
|
|
15713
16069
|
"on-ui-error"?: (event: UIJsonEventMap["ui-error"]) => void;
|
|
16070
|
+
/**
|
|
16071
|
+
* `ui-navigating`: A key or a value was clicked (not a double-click, nor the end of a text selection). `path`: the keys from the top value down to that member (`[]`: the top value); `key`: its key, an array member's index; `value`: its value (an object or array too, when its key was clicked); `part`: which was clicked. The page decides what it means (jumping to what a value names) and calls `preventDefault()`.
|
|
16072
|
+
* - `event.detail`: `{ path: (string | number)[], key: string | number | undefined, value: unknown, part: "key" | "value" }`
|
|
16073
|
+
* - cancelable: `preventDefault()` vetoes it
|
|
16074
|
+
*/
|
|
16075
|
+
"on-ui-navigating"?: (event: UIJsonEventMap["ui-navigating"]) => void;
|
|
16076
|
+
/**
|
|
16077
|
+
* `ui-copied`: The Copy button copied `content`, as JSON.
|
|
16078
|
+
* - `event.detail`: `{ content: string }`
|
|
16079
|
+
*/
|
|
16080
|
+
"on-ui-copied"?: (event: UIJsonEventMap["ui-copied"]) => void;
|
|
15714
16081
|
}
|
|
15715
16082
|
/** `<ui-json>` in JSX: its own attributes, and HTML's global ones. */
|
|
15716
16083
|
export interface UIJsonJSXAttributes extends Omit<UIGlobalJSXAttributes<UIHTMLElement<UIJsonEventMap>>, keyof UIJsonAttributes>, UIJsonAttributes {
|
|
@@ -37797,22 +38164,36 @@ export interface UITransitionJSXAttributes extends Omit<UIGlobalJSXAttributes<UI
|
|
|
37797
38164
|
/** `<ui-tree>`'s events, from its vocabulary: each one's `CustomEvent`, by name. */
|
|
37798
38165
|
export interface UITreeEventMap {
|
|
37799
38166
|
/**
|
|
37800
|
-
* `ui-selecting`: A row is about to be selected, by a click, or by Enter or Space: cancel it to decide what's selected yourself, reading the keys held from `originalEvent`.
|
|
37801
|
-
* - `event.detail`: `{ item: HTMLElement, value: string, originalEvent?: Event }`
|
|
38167
|
+
* `ui-selecting`: A row is about to be selected, by a click, or by Enter or Space: cancel it to decide what's selected yourself, reading the keys held from `originalEvent`. `appearance="columns"`: the arrow keys select as they move too; `item` is the `<ui-tree-item>`, or the `items` entry; `path`, the ids of each column's pick down to it.
|
|
38168
|
+
* - `event.detail`: `{ item: HTMLElement | TreeItemData, value: string, path?: string[], originalEvent?: Event }`
|
|
37802
38169
|
* - cancelable: `preventDefault()` vetoes it
|
|
37803
38170
|
*/
|
|
37804
38171
|
"ui-selecting": CustomEvent<{
|
|
37805
|
-
item: HTMLElement;
|
|
38172
|
+
item: HTMLElement | UIT.TreeItemData;
|
|
37806
38173
|
value: string;
|
|
38174
|
+
path?: string[];
|
|
37807
38175
|
originalEvent?: Event;
|
|
37808
38176
|
}>;
|
|
37809
38177
|
/**
|
|
37810
|
-
* `ui-changed`: What's selected changed: `value`, the row clicked; `values`, every selected row in the tree's order (each one's `value`, else its `label`).
|
|
37811
|
-
* - `event.detail`: `{ value: string, values: string[], originalEvent?: Event }`
|
|
38178
|
+
* `ui-changed`: What's selected changed: `value`, the row clicked; `values`, every selected row in the tree's order (each one's `value`, else its `label`). `appearance="columns"`: also `item` and `path`, as `ui-selecting`'s.
|
|
38179
|
+
* - `event.detail`: `{ value: string, values: string[], item?: HTMLElement | TreeItemData, path?: string[], originalEvent?: Event }`
|
|
37812
38180
|
*/
|
|
37813
38181
|
"ui-changed": CustomEvent<{
|
|
37814
38182
|
value: string;
|
|
37815
38183
|
values: string[];
|
|
38184
|
+
item?: HTMLElement | UIT.TreeItemData;
|
|
38185
|
+
path?: string[];
|
|
38186
|
+
originalEvent?: Event;
|
|
38187
|
+
}>;
|
|
38188
|
+
/**
|
|
38189
|
+
* `ui-settled`: What's selected has stayed put for a moment: `ui-changed`'s detail, once the arrow keys stop. For a page doing heavy work on each pick.
|
|
38190
|
+
* - `event.detail`: `{ value: string, values: string[], item?: HTMLElement | TreeItemData, path?: string[], originalEvent?: Event }`
|
|
38191
|
+
*/
|
|
38192
|
+
"ui-settled": CustomEvent<{
|
|
38193
|
+
value: string;
|
|
38194
|
+
values: string[];
|
|
38195
|
+
item?: HTMLElement | UIT.TreeItemData;
|
|
38196
|
+
path?: string[];
|
|
37816
38197
|
originalEvent?: Event;
|
|
37817
38198
|
}>;
|
|
37818
38199
|
}
|
|
@@ -37829,7 +38210,7 @@ export interface UITreeAttributes {
|
|
|
37829
38210
|
*/
|
|
37830
38211
|
"prop:choose"?: "one" | "many";
|
|
37831
38212
|
/**
|
|
37832
|
-
* Show only the rows whose words hold this text, whatever its case, and the rows they're inside, opened to show them. It changes no row's `open`: clearing it puts the tree back as it was. A row drawn only once its parent opens can't be found while that's closed.
|
|
38213
|
+
* Show only the rows whose words hold this text, whatever its case, and the rows they're inside, opened to show them. It changes no row's `open`: clearing it puts the tree back as it was. A row drawn only once its parent opens can't be found while that's closed. `appearance="columns"`: it filters one column, the last one on screen as the filter starts, until it's cleared; after that column's rows, it lists the matches elsewhere in the tree, at any depth, each with the rows it's inside, and a click on one opens the path to it. From `items`, it runs each `children` function to look inside, waiting for promised ones, as opening the items would, but opens no column; it lists the first 200 matches, and stops after 100,000 rows.
|
|
37833
38214
|
* - takes: text
|
|
37834
38215
|
*/
|
|
37835
38216
|
filter?: string;
|
|
@@ -37838,6 +38219,16 @@ export interface UITreeAttributes {
|
|
|
37838
38219
|
* @deprecated write `filter` -- `prop:` stays only for compiled spell
|
|
37839
38220
|
*/
|
|
37840
38221
|
"prop:filter"?: string;
|
|
38222
|
+
/**
|
|
38223
|
+
* A line of buttons above the rows: Open 2 levels, Open 3 levels and Close all. Scripts call the same methods: `openTo(levels)` and `closeAll()`. `appearance="columns"`: `openTo(2)` shows two columns, keeping each column's pick, else picking its first row that holds rows.
|
|
38224
|
+
* - takes: flag (present / absent)
|
|
38225
|
+
*/
|
|
38226
|
+
tools?: boolean | "";
|
|
38227
|
+
/**
|
|
38228
|
+
* `tools`, as the DOM element's property.
|
|
38229
|
+
* @deprecated write `tools` -- `prop:` stays only for compiled spell
|
|
38230
|
+
*/
|
|
38231
|
+
"prop:tools"?: boolean | "";
|
|
37841
38232
|
/**
|
|
37842
38233
|
* What a screen reader calls the tree.
|
|
37843
38234
|
* - takes: text
|
|
@@ -37869,7 +38260,60 @@ export interface UITreeAttributes {
|
|
|
37869
38260
|
*/
|
|
37870
38261
|
"prop:columnTitles"?: string;
|
|
37871
38262
|
/**
|
|
37872
|
-
*
|
|
38263
|
+
* `appearance="columns"`: the tree as data, given as a property, in place of `<ui-tree-item>`s: `{ id, label, icon?, which?, count?, children?, data? }[]` (`TreeItemData`), where `children` is a list, or a function run the first time the item opens, which may return a promise (a spinner shows until it comes). Only the open path's columns are drawn.
|
|
38264
|
+
* - a JS property (rich data): an object, array or function, given as it is
|
|
38265
|
+
*/
|
|
38266
|
+
items?: unknown;
|
|
38267
|
+
/**
|
|
38268
|
+
* `appearance="columns"`: the tree as data, given as a property, in place of `<ui-tree-item>`s: `{ id, label, icon?, which?, count?, children?, data? }[]` (`TreeItemData`), where `children` is a list, or a function run the first time the item opens, which may return a promise (a spinner shows until it comes). Only the open path's columns are drawn.
|
|
38269
|
+
* - a JS property (rich data): an object, array or function, given as it is
|
|
38270
|
+
* @deprecated write `items` -- `prop:` stays only for compiled spell
|
|
38271
|
+
*/
|
|
38272
|
+
"prop:items"?: unknown;
|
|
38273
|
+
/**
|
|
38274
|
+
* `appearance="columns"`: the ids of each column's pick, from the top (`string[]`; a `<ui-tree-item>`'s id is its `value`, else its `label`). The last one's rows are the next column. Set it to open a path, its last item selected; read it as people pick.
|
|
38275
|
+
* - a JS property (rich data): an object, array or function, given as it is
|
|
38276
|
+
*/
|
|
38277
|
+
path?: unknown;
|
|
38278
|
+
/**
|
|
38279
|
+
* `appearance="columns"`: the ids of each column's pick, from the top (`string[]`; a `<ui-tree-item>`'s id is its `value`, else its `label`). The last one's rows are the next column. Set it to open a path, its last item selected; read it as people pick.
|
|
38280
|
+
* - a JS property (rich data): an object, array or function, given as it is
|
|
38281
|
+
* @deprecated write `path` -- `prop:` stays only for compiled spell
|
|
38282
|
+
*/
|
|
38283
|
+
"prop:path"?: unknown;
|
|
38284
|
+
/**
|
|
38285
|
+
* `appearance="columns"`: each column's width, by level, separated by commas; the last one sizes every column deeper than the list goes. Each one a number of px (`240`, `240px`), `em`, a percent of the tree's width (`30%`), `auto` to fit the column to the rows it shows (from 80px to three times `--ui-tree-column-width`), or `*` for `--ui-tree-column-width`. So `auto` fits every column to its rows, and `12em, auto` keeps the first at 12em. None: every column is `--ui-tree-column-width` wide. A column a person resizes keeps that width instead: with an `id`, the tree remembers it in this browser.
|
|
38286
|
+
* - takes: text
|
|
38287
|
+
*/
|
|
38288
|
+
size?: string;
|
|
38289
|
+
/**
|
|
38290
|
+
* `size`, as the DOM element's property.
|
|
38291
|
+
* @deprecated write `size` -- `prop:` stays only for compiled spell
|
|
38292
|
+
*/
|
|
38293
|
+
"prop:size"?: string;
|
|
38294
|
+
/**
|
|
38295
|
+
* `appearance="columns"`: how many columns at the end never narrow. While the columns don't fit the tree's width, the ones before those narrow, from the first, as few as it takes, each to a strip with its pick's name; the pointer or the focus on one widens it again, and so does picking it from the path line. The selected row's column never narrows.
|
|
38296
|
+
* - takes: number
|
|
38297
|
+
* - default: `2`
|
|
38298
|
+
*/
|
|
38299
|
+
"narrow-before"?: number | `${number}`;
|
|
38300
|
+
/**
|
|
38301
|
+
* `narrow-before`, as the DOM element's property.
|
|
38302
|
+
* @deprecated write `narrow-before` -- `prop:` stays only for compiled spell
|
|
38303
|
+
*/
|
|
38304
|
+
"prop:narrowBefore"?: number | `${number}`;
|
|
38305
|
+
/**
|
|
38306
|
+
* `appearance="columns"`: which parts each row shows, as words: `icon which count chevron`; the label always shows. None: `icon which chevron`. `count` is how many rows a row holds, when it knows.
|
|
38307
|
+
* - takes: text
|
|
38308
|
+
*/
|
|
38309
|
+
show?: string;
|
|
38310
|
+
/**
|
|
38311
|
+
* `show`, as the DOM element's property.
|
|
38312
|
+
* @deprecated write `show` -- `prop:` stays only for compiled spell
|
|
38313
|
+
*/
|
|
38314
|
+
"prop:show"?: string;
|
|
38315
|
+
/**
|
|
38316
|
+
* While the tree scrolls, one line pinned at its top names the open rows the first row in view is inside, `Solitaire › Grid › StockPile`, shortened from the left when it doesn't fit. A click on one scrolls to its row, selecting nothing. It shows only while one of them is scrolled out of sight. `appearance="columns"`: a line above the columns naming each column's pick, shown once something is picked; a click on one picks it again, keeping the columns after it, and scrolls its column into view.
|
|
37873
38317
|
* - takes: flag (present / absent)
|
|
37874
38318
|
*/
|
|
37875
38319
|
"sticky-path"?: boolean | "";
|
|
@@ -37878,6 +38322,16 @@ export interface UITreeAttributes {
|
|
|
37878
38322
|
* @deprecated write `sticky-path` -- `prop:` stays only for compiled spell
|
|
37879
38323
|
*/
|
|
37880
38324
|
"prop:stickyPath"?: boolean | "";
|
|
38325
|
+
/**
|
|
38326
|
+
* `appearance="columns"` with a `detail` pane: the pane stays in view at the tree's end while the columns scroll sideways under it.
|
|
38327
|
+
* - takes: flag (present / absent)
|
|
38328
|
+
*/
|
|
38329
|
+
"sticky-detail"?: boolean | "";
|
|
38330
|
+
/**
|
|
38331
|
+
* `sticky-detail`, as the DOM element's property.
|
|
38332
|
+
* @deprecated write `sticky-detail` -- `prop:` stays only for compiled spell
|
|
38333
|
+
*/
|
|
38334
|
+
"prop:stickyDetail"?: boolean | "";
|
|
37881
38335
|
/**
|
|
37882
38336
|
* Can't be used: dimmed, out of the tab order, and everything inside it inert; `aria-disabled`. Shared by every element; a family may give it a meaning of its own (`elementSetup.disabled`).
|
|
37883
38337
|
* - takes: flag (present / absent)
|
|
@@ -38029,16 +38483,21 @@ export interface UITreeAttributes {
|
|
|
38029
38483
|
*/
|
|
38030
38484
|
"prop:onPlatform"?: string;
|
|
38031
38485
|
/**
|
|
38032
|
-
* `ui-selecting`: A row is about to be selected, by a click, or by Enter or Space: cancel it to decide what's selected yourself, reading the keys held from `originalEvent`.
|
|
38033
|
-
* - `event.detail`: `{ item: HTMLElement, value: string, originalEvent?: Event }`
|
|
38486
|
+
* `ui-selecting`: A row is about to be selected, by a click, or by Enter or Space: cancel it to decide what's selected yourself, reading the keys held from `originalEvent`. `appearance="columns"`: the arrow keys select as they move too; `item` is the `<ui-tree-item>`, or the `items` entry; `path`, the ids of each column's pick down to it.
|
|
38487
|
+
* - `event.detail`: `{ item: HTMLElement | TreeItemData, value: string, path?: string[], originalEvent?: Event }`
|
|
38034
38488
|
* - cancelable: `preventDefault()` vetoes it
|
|
38035
38489
|
*/
|
|
38036
38490
|
"on-ui-selecting"?: (event: UITreeEventMap["ui-selecting"]) => void;
|
|
38037
38491
|
/**
|
|
38038
|
-
* `ui-changed`: What's selected changed: `value`, the row clicked; `values`, every selected row in the tree's order (each one's `value`, else its `label`).
|
|
38039
|
-
* - `event.detail`: `{ value: string, values: string[], originalEvent?: Event }`
|
|
38492
|
+
* `ui-changed`: What's selected changed: `value`, the row clicked; `values`, every selected row in the tree's order (each one's `value`, else its `label`). `appearance="columns"`: also `item` and `path`, as `ui-selecting`'s.
|
|
38493
|
+
* - `event.detail`: `{ value: string, values: string[], item?: HTMLElement | TreeItemData, path?: string[], originalEvent?: Event }`
|
|
38040
38494
|
*/
|
|
38041
38495
|
"on-ui-changed"?: (event: UITreeEventMap["ui-changed"]) => void;
|
|
38496
|
+
/**
|
|
38497
|
+
* `ui-settled`: What's selected has stayed put for a moment: `ui-changed`'s detail, once the arrow keys stop. For a page doing heavy work on each pick.
|
|
38498
|
+
* - `event.detail`: `{ value: string, values: string[], item?: HTMLElement | TreeItemData, path?: string[], originalEvent?: Event }`
|
|
38499
|
+
*/
|
|
38500
|
+
"on-ui-settled"?: (event: UITreeEventMap["ui-settled"]) => void;
|
|
38042
38501
|
}
|
|
38043
38502
|
/** `<ui-tree>` in JSX: its own attributes, and HTML's global ones. */
|
|
38044
38503
|
export interface UITreeJSXAttributes extends Omit<UIGlobalJSXAttributes<UIHTMLElement<UITreeEventMap>>, keyof UITreeAttributes>, UITreeAttributes {
|
|
@@ -40143,6 +40602,12 @@ declare module "@solidjs/web/types/jsx.js" {
|
|
|
40143
40602
|
* - events: `ui-valid`, `ui-invalid`, `ui-saving`, `ui-save-failed`, `ui-applying`, `ui-applied`, `ui-cancelling`, `ui-cancelled`
|
|
40144
40603
|
*/
|
|
40145
40604
|
"ui-form": UIFormJSXAttributes;
|
|
40605
|
+
/**
|
|
40606
|
+
* `<ui-graph>`: A graph draws nodes joined by edges, laid out left to right. A node may hold a graph of its own, opened in place, in a modal, or in its stead.
|
|
40607
|
+
* - also known as: graph, node graph, network diagram, flow chart, dataflow, netlist, schematic, block diagram, DAG
|
|
40608
|
+
* - events: `ui-selecting`, `ui-changed`, `ui-node-toggled`
|
|
40609
|
+
*/
|
|
40610
|
+
"ui-graph": UIGraphJSXAttributes;
|
|
40146
40611
|
/**
|
|
40147
40612
|
* `<ui-grid>`: A grid is used to harmonize negative space in a layout.
|
|
40148
40613
|
* - also known as: columns, row, flex grid, layout grid, responsive grid
|
|
@@ -40224,9 +40689,9 @@ declare module "@solidjs/web/types/jsx.js" {
|
|
|
40224
40689
|
*/
|
|
40225
40690
|
"ui-items": UIItemsJSXAttributes;
|
|
40226
40691
|
/**
|
|
40227
|
-
* `<ui-json>`: JSON data holds data in a page, as its text or from a file with `source
|
|
40228
|
-
* - also known as: data, data island, json script, application/json, data block, datos
|
|
40229
|
-
* - events: `ui-loaded`, `ui-changed`, `ui-saving`, `ui-saved`, `ui-error`
|
|
40692
|
+
* `<ui-json>`: JSON data holds data in a page, as its text or from a file with `source`, and shows it as an outline whose objects and arrays open and close. `value` is the parsed data, and an element it sits inside may read it.
|
|
40693
|
+
* - also known as: data, data island, json script, application/json, data block, json viewer, json tree, object inspector, pretty print, datos
|
|
40694
|
+
* - events: `ui-loaded`, `ui-changed`, `ui-saving`, `ui-saved`, `ui-error`, `ui-navigating`, `ui-copied`
|
|
40230
40695
|
*/
|
|
40231
40696
|
"ui-json": UIJsonJSXAttributes;
|
|
40232
40697
|
/**
|
|
@@ -40835,7 +41300,9 @@ declare module "@solidjs/web/types/jsx.js" {
|
|
|
40835
41300
|
* - slots:
|
|
40836
41301
|
* - default: The top rows: `<ui-tree-item>`s.
|
|
40837
41302
|
* - `empty`: Shown when `filter` matches no row.
|
|
40838
|
-
*
|
|
41303
|
+
* - `tools`: At the end of the line above the rows, after `tools`' buttons: a filter field, say. On a narrow tree it drops to a line of its own; slotted without `tools`, the line holds it alone.
|
|
41304
|
+
* - `detail`: `appearance="columns"`: a pane after the last column, showing what's picked: any element, which the tree hands the picked row as its `item` property (the `<ui-tree-item>`, or the `items` entry), and the page can fill from `ui-changed`. Drawn only while something is slotted and something is picked, tight against the last column, as wide as its content (up to `--ui-tree-detail-max-width`) until its line is dragged.
|
|
41305
|
+
* - events: `ui-selecting`, `ui-changed`, `ui-settled`
|
|
40839
41306
|
*/
|
|
40840
41307
|
"ui-tree": UITreeJSXAttributes;
|
|
40841
41308
|
/**
|
|
@@ -40936,8 +41403,11 @@ export interface UIEventMap {
|
|
|
40936
41403
|
"ui-applied": CustomEvent<unknown>;
|
|
40937
41404
|
"ui-cancelling": CustomEvent<unknown>;
|
|
40938
41405
|
"ui-cancelled": CustomEvent<unknown>;
|
|
41406
|
+
"ui-selecting": CustomEvent<unknown>;
|
|
41407
|
+
"ui-node-toggled": CustomEvent<unknown>;
|
|
40939
41408
|
"ui-drawing": CustomEvent<unknown>;
|
|
40940
41409
|
"ui-typed": CustomEvent<unknown>;
|
|
41410
|
+
"ui-navigating": CustomEvent<unknown>;
|
|
40941
41411
|
"ui-removing": CustomEvent<unknown>;
|
|
40942
41412
|
"ui-chosen": CustomEvent<unknown>;
|
|
40943
41413
|
"ui-drawn": CustomEvent<unknown>;
|
|
@@ -40947,7 +41417,6 @@ export interface UIEventMap {
|
|
|
40947
41417
|
"ui-show-code": CustomEvent<unknown>;
|
|
40948
41418
|
"ui-replied": CustomEvent<unknown>;
|
|
40949
41419
|
"ui-animated": CustomEvent<unknown>;
|
|
40950
|
-
"ui-navigating": CustomEvent<unknown>;
|
|
40951
41420
|
"ui-starred": CustomEvent<unknown>;
|
|
40952
41421
|
"ui-moved": CustomEvent<unknown>;
|
|
40953
41422
|
"ui-stuck": CustomEvent<unknown>;
|
|
@@ -40957,8 +41426,7 @@ export interface UIEventMap {
|
|
|
40957
41426
|
"ui-send": CustomEvent<unknown>;
|
|
40958
41427
|
"ui-command": CustomEvent<unknown>;
|
|
40959
41428
|
"ui-scrolled-to": CustomEvent<unknown>;
|
|
40960
|
-
"ui-
|
|
40961
|
-
"ui-node-toggled": CustomEvent<unknown>;
|
|
41429
|
+
"ui-settled": CustomEvent<unknown>;
|
|
40962
41430
|
"ui-in-view": CustomEvent<unknown>;
|
|
40963
41431
|
"ui-out-of-view": CustomEvent<unknown>;
|
|
40964
41432
|
"ui-top-in-view": CustomEvent<unknown>;
|
|
@@ -41015,6 +41483,7 @@ declare global {
|
|
|
41015
41483
|
"ui-flag": HTMLElement;
|
|
41016
41484
|
"ui-flyout": UIHTMLElement<UIFlyoutEventMap>;
|
|
41017
41485
|
"ui-form": UIHTMLElement<UIFormEventMap>;
|
|
41486
|
+
"ui-graph": UIHTMLElement<UIGraphEventMap>;
|
|
41018
41487
|
"ui-grid": HTMLElement;
|
|
41019
41488
|
"ui-header": HTMLElement;
|
|
41020
41489
|
"ui-icon": HTMLElement;
|