@ixfx/components 0.18.0 → 0.18.1
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/bundle/index.d.ts +209 -4
- package/bundle/index.js +359 -319
- package/dist/ac-text.js +1 -1
- package/dist/ac-token.js +2 -2
- package/dist/{checked-select-DsQ-o9lI.js → checked-select-CC-qSO1P.js} +2 -2
- package/dist/checked-select.js +1 -1
- package/dist/{crumb-navigation-09YFje6W.js → crumb-navigation-C78edQGt.js} +3 -3
- package/dist/crumbs.js +1 -1
- package/dist/{data-grid-BQWmVYg0.d.ts → data-grid-BYMZZbNc.d.ts} +25 -2
- package/dist/{data-grid-BGmJbMCb.js → data-grid-CJrbLzLr.js} +79 -18
- package/dist/data-grid.d.ts +1 -1
- package/dist/data-grid.js +1 -1
- package/dist/{detail-list-CfjoIl2N.d.ts → detail-list-CBgnKkEm.d.ts} +29 -3
- package/dist/{detail-list-CrHASoAx.js → detail-list-Dk9oSvAZ.js} +74 -10
- package/dist/detail-list.d.ts +2 -2
- package/dist/detail-list.js +1 -1
- package/dist/{flat-list-C2z81bK6.d.ts → flat-list-D5glF_vD.d.ts} +1 -1
- package/dist/flat-list.d.ts +1 -1
- package/dist/flat-list.js +3 -3
- package/dist/{grid-list-DYU_z2K9.js → grid-list-0wC2xGBS.js} +103 -14
- package/dist/{grid-list-Crv-hFJL.d.ts → grid-list-B3T_2N0N.d.ts} +26 -2
- package/dist/grid-list.d.ts +1 -1
- package/dist/grid-list.js +1 -1
- package/dist/{incr-search-C5114RxZ.js → incr-search-Bk4acsCM.js} +14 -6
- package/dist/incr-search.d.ts +1 -1
- package/dist/incr-search.js +1 -1
- package/dist/{index-BymYKGY-.d.ts → index-BIv_Hu7C.d.ts} +2 -2
- package/dist/{index-Db5VGFR1.d.ts → index-BuvySJEc.d.ts} +4 -0
- package/dist/{index-BE0hk8xS.d.ts → index-fhZCKSY6.d.ts} +2 -2
- package/dist/index.d.ts +63 -17
- package/dist/index.js +200 -37
- package/dist/interaction-DNuFnTm0.js +3 -0
- package/dist/item-tags-Dz-jQq-4.d.ts +65 -0
- package/dist/{list-native-drag-controller-Brk30s5d.js → list-native-drag-controller-B_INa6_G.js} +106 -1
- package/dist/{menu-B6NFqEtm.js → menu-CgT60B3-.js} +2 -2
- package/dist/{menu-item-D0zy1yax.js → menu-item-CbywH4Xo.js} +2 -2
- package/dist/menu.js +2 -2
- package/dist/{miller-B0qbnWwe.js → miller-Dyv4UM7k.js} +3 -3
- package/dist/miller.d.ts +1 -1
- package/dist/miller.js +1 -1
- package/dist/narrowed-text.js +3 -3
- package/dist/{node-graph-D9iovxQp.js → node-graph-yrbOLbYo.js} +1 -1
- package/dist/node-graph.js +1 -1
- package/dist/select-horiz.js +2 -2
- package/dist/sunburst-tree.d.ts +1 -1
- package/dist/sunburst-tree.js +1 -1
- package/dist/{sunbursttree-list-C-FuZB5z.js → sunbursttree-list-CJdznPzN.js} +2 -2
- package/dist/{sunbursttree-list-XF7gBKod.d.ts → sunbursttree-list-CmydFG66.d.ts} +1 -1
- package/dist/{tickled-controller-BVhGKzjZ.js → tickled-controller-BsFFr_1N.js} +1 -1
- package/dist/{tickled-controller-DSPoG551.d.ts → tickled-controller-Dz0UqwlQ.d.ts} +5 -0
- package/dist/{tree-1CSNgw72.js → tree-C3rgEEmm.js} +4 -4
- package/dist/tree.d.ts +1 -1
- package/dist/tree.js +1 -1
- package/dist/{vertical-list-BNCRA_zy.js → vertical-list-By-yuhkw.js} +60 -6
- package/dist/{vertical-list-Dyc5azxv.d.ts → vertical-list-C4z3La0C.d.ts} +20 -2
- package/dist/vertical-list.d.ts +1 -1
- package/dist/vertical-list.js +1 -1
- package/docs-user/README.md +1 -0
- package/docs-user/button.md +31 -1
- package/docs-user/data-grid.md +3 -0
- package/docs-user/detail-list.md +3 -0
- package/docs-user/grid-list.md +3 -0
- package/docs-user/index.json +6 -2
- package/docs-user/llms.txt +1 -0
- package/docs-user/multicol-list.md +3 -0
- package/docs-user/user-item-tags.md +68 -0
- package/llms.txt +1 -0
- package/package.json +1 -1
- package/dist/interaction-BEcBIY0d.js +0 -3
package/bundle/index.d.ts
CHANGED
|
@@ -850,7 +850,10 @@ declare global {
|
|
|
850
850
|
}
|
|
851
851
|
}
|
|
852
852
|
export type SplitButtonMode = `default` | `switcher`;
|
|
853
|
+
/** Fills the popover (panel or target) just before it is shown. */
|
|
854
|
+
export type PopoverProvider = (popover: HTMLElement) => void | Promise<void>;
|
|
853
855
|
export declare class SplitButton extends ButtonElement {
|
|
856
|
+
#private;
|
|
854
857
|
registry?: CommandRegistry<unknown>;
|
|
855
858
|
keyboardManager?: KeyboardManager;
|
|
856
859
|
mode: SplitButtonMode;
|
|
@@ -859,7 +862,24 @@ export declare class SplitButton extends ButtonElement {
|
|
|
859
862
|
itemsProvider?: ItemsProvider;
|
|
860
863
|
/** Directly set popup items. Ignored when itemsProvider is also set. */
|
|
861
864
|
items?: PopupItem[];
|
|
862
|
-
|
|
865
|
+
/**
|
|
866
|
+
* Id of a `popover` element elsewhere in the same tree (or shadow root) that the
|
|
867
|
+
* caret toggles instead of opening the menu, like the native `popovertarget`.
|
|
868
|
+
* The caret is passed as the popover's `source`, so it anchors implicitly.
|
|
869
|
+
*/
|
|
870
|
+
popoverTarget: string;
|
|
871
|
+
/**
|
|
872
|
+
* Builds popover content just in time. Called each time the popover is about to be
|
|
873
|
+
* shown (awaited if it returns a promise) with the popover element — the built-in
|
|
874
|
+
* panel, or the `popover-target` element — so it can fill it in before it appears.
|
|
875
|
+
* Setting this (without `popover-target`) makes the caret open the built-in panel.
|
|
876
|
+
*/
|
|
877
|
+
popoverProvider?: PopoverProvider;
|
|
878
|
+
private _menuTrigger?;
|
|
879
|
+
private _popoverPanel?;
|
|
880
|
+
private _caretEl?;
|
|
881
|
+
private _hasPopoverSlot;
|
|
882
|
+
private _popoverOpen;
|
|
863
883
|
private _selectedCommand;
|
|
864
884
|
private _selectedLabel;
|
|
865
885
|
private _selectedIcon;
|
|
@@ -867,8 +887,6 @@ export declare class SplitButton extends ButtonElement {
|
|
|
867
887
|
private _dynamicItems;
|
|
868
888
|
private _loadingItems;
|
|
869
889
|
private _menuHasItems;
|
|
870
|
-
disconnectedCallback(): void;
|
|
871
|
-
firstUpdated(): void;
|
|
872
890
|
updated(changedProperties: Map<string, unknown>): void;
|
|
873
891
|
private _applyItems;
|
|
874
892
|
/** In switcher mode, programmatically select the active command. Returns false if not found. */
|
|
@@ -877,16 +895,27 @@ export declare class SplitButton extends ButtonElement {
|
|
|
877
895
|
invoke(): boolean;
|
|
878
896
|
/** True when there is (or will be) popup content. Used to dim the caret visually. */
|
|
879
897
|
private get _caretHasContent();
|
|
898
|
+
/** The caret toggles a popover (slotted content, `popover-target` or `popoverProvider`) rather than the menu. */
|
|
899
|
+
private get _popoverMode();
|
|
900
|
+
private _resolvePopover;
|
|
901
|
+
private _onPopoverSlotChange;
|
|
902
|
+
private _onPopoverToggle;
|
|
903
|
+
/** Show the popover (building its content first). `toggle`: hide it instead when already open. */
|
|
904
|
+
private _showPopover;
|
|
880
905
|
private _onDefaultMenuSlotChange;
|
|
881
906
|
private _onSwitcherSlotChange;
|
|
882
907
|
private _applySwitcherItems;
|
|
883
908
|
private _handleSwitcherMenuCommand;
|
|
884
909
|
private _handleSwitcherPrimaryClick;
|
|
885
910
|
private _handleCaretClick;
|
|
911
|
+
private _openOverlay;
|
|
886
912
|
private _handlePrimaryKeyDown;
|
|
887
913
|
private _handleCaretKeyDown;
|
|
914
|
+
private _handleCaretPointerDown;
|
|
888
915
|
protected render(): import("lit").TemplateResult<1>;
|
|
889
916
|
private _renderCaret;
|
|
917
|
+
/** The caret with its overlay: the popover panel in popover mode, otherwise the menu trigger + menu. */
|
|
918
|
+
private _renderCaretArea;
|
|
890
919
|
private _renderLoadingOrItems;
|
|
891
920
|
private _renderDefault;
|
|
892
921
|
private _renderSwitcher;
|
|
@@ -4714,6 +4743,70 @@ declare global {
|
|
|
4714
4743
|
'ixfx-data-display': DataDisplayComponent;
|
|
4715
4744
|
}
|
|
4716
4745
|
}
|
|
4746
|
+
/**
|
|
4747
|
+
* Caller-assigned item tags, shared by every list-like component
|
|
4748
|
+
* (`ixfx-grid-list`, `ixfx-detail-list`, `ixfx-data-grid`, `ixfx-multicol-list`).
|
|
4749
|
+
*
|
|
4750
|
+
* What a tag *means* belongs to the caller. The component only
|
|
4751
|
+
*
|
|
4752
|
+
* 1. exposes it for styling: a `tag-<name>` token in the item's `part`, and
|
|
4753
|
+
* `data-tags` (space-separated, so `[data-tags~="foo"]` matches);
|
|
4754
|
+
* 2. applies the generic interaction flags declared for it in `tagBehaviour`.
|
|
4755
|
+
*
|
|
4756
|
+
* Tokens are prefixed so a caller tag called `selected` cannot collide with
|
|
4757
|
+
* the built-in state token.
|
|
4758
|
+
*/
|
|
4759
|
+
/** Generic interaction flags a tag can switch off. Omitted flags keep the default (`true`). */
|
|
4760
|
+
type ItemTagBehaviourFlags = {
|
|
4761
|
+
/** `false`: no selection or tickle, no `list-select-intent`; range and select-all skip the item. */
|
|
4762
|
+
selectable?: boolean;
|
|
4763
|
+
/** `false`: keyboard cursor movement skips the item. */
|
|
4764
|
+
focusable?: boolean;
|
|
4765
|
+
/** `false`: no drag starts from the item. */
|
|
4766
|
+
draggable?: boolean;
|
|
4767
|
+
/** `false`: the item is left out of incremental search. */
|
|
4768
|
+
searchable?: boolean;
|
|
4769
|
+
};
|
|
4770
|
+
/** Behaviour declarations keyed by tag name. */
|
|
4771
|
+
type ItemTagBehaviour = Readonly<Record<string, ItemTagBehaviourFlags>>;
|
|
4772
|
+
/** Tag assignment by key set: tag name → keys that carry it. Like `partialKeys`, for tags kept apart from the data. */
|
|
4773
|
+
type ItemTagKeys = ReadonlyMap<string, ReadonlySet<string>>;
|
|
4774
|
+
/** The effective flags for an item: every flag is explicit. */
|
|
4775
|
+
type ResolvedItemTagFlags = Required<ItemTagBehaviourFlags>;
|
|
4776
|
+
export declare const DEFAULT_ITEM_TAG_FLAGS: ResolvedItemTagFlags;
|
|
4777
|
+
/** Prefix of a tag's `part` token. */
|
|
4778
|
+
export declare const TAG_PART_PREFIX = "tag-";
|
|
4779
|
+
/**
|
|
4780
|
+
* Merge the tags from the per-item hook and from `tagKeys`, de-duplicated,
|
|
4781
|
+
* in first-seen order. Empty and whitespace-containing names are dropped
|
|
4782
|
+
* (they could not be a single `part` token).
|
|
4783
|
+
*/
|
|
4784
|
+
export declare function collectTags(key: string | undefined, fromHook: readonly string[] | undefined, tagKeys: ItemTagKeys | undefined): readonly string[];
|
|
4785
|
+
/** Most restrictive wins: any `false` among the item's tags beats the default and any `true`. */
|
|
4786
|
+
export declare function resolveTagFlags(tags: readonly string[], behaviour: ItemTagBehaviour | undefined): ResolvedItemTagFlags;
|
|
4787
|
+
/** ` tag-foo tag-bar` — append to a `part` value. Empty string when there are no tags. */
|
|
4788
|
+
export declare function tagPartTokens(tags: readonly string[]): string;
|
|
4789
|
+
/** Value for `data-tags` (`"foo bar"`), or `undefined` when there are no tags. */
|
|
4790
|
+
export declare function tagsAttribute(tags: readonly string[]): string | undefined;
|
|
4791
|
+
/** Reflect tags onto an element (element mode / light DOM): `data-tags`, and `tag-*` tokens in `part` it didn't set. */
|
|
4792
|
+
export declare function applyTagAttributes(el: Element, tags: readonly string[], basePart?: string): void;
|
|
4793
|
+
/** Whether two tag lists are identical (order matters; lists are tiny). */
|
|
4794
|
+
export declare function sameTags(a: readonly string[], b: readonly string[]): boolean;
|
|
4795
|
+
/** Whether two `tagKeys` maps hold the same tags with the same keys. */
|
|
4796
|
+
export declare function sameTagKeys(a: ItemTagKeys | undefined, b: ItemTagKeys | undefined): boolean;
|
|
4797
|
+
/**
|
|
4798
|
+
* Per-component holder for the two assignment forms and `tagBehaviour`.
|
|
4799
|
+
* Resolves an item's tags and flags; caches nothing (callers re-render on change).
|
|
4800
|
+
*/
|
|
4801
|
+
export declare class ItemTagResolver {
|
|
4802
|
+
tagKeys: ItemTagKeys | undefined;
|
|
4803
|
+
behaviour: ItemTagBehaviour | undefined;
|
|
4804
|
+
/** Tags for an item, merging the hook's result with `tagKeys`. */
|
|
4805
|
+
tagsFor(key: string | undefined, fromHook?: readonly string[]): readonly string[];
|
|
4806
|
+
flagsFor(tags: readonly string[]): ResolvedItemTagFlags;
|
|
4807
|
+
/** Convenience: flags for an item straight from its key and hook result. */
|
|
4808
|
+
flagsForItem(key: string | undefined, fromHook?: readonly string[]): ResolvedItemTagFlags;
|
|
4809
|
+
}
|
|
4717
4810
|
/**
|
|
4718
4811
|
* Shared list viewport-change types.
|
|
4719
4812
|
*
|
|
@@ -5389,6 +5482,8 @@ interface DataListSearchAdapterOptions {
|
|
|
5389
5482
|
rawKeyAt: (index: number) => string;
|
|
5390
5483
|
/** Raw (unfiltered) index → text matched against the query. */
|
|
5391
5484
|
rawSearchTextAt: (index: number) => string;
|
|
5485
|
+
/** Raw index → whether the item takes part in search. Default: all do. */
|
|
5486
|
+
isSearchable?: (index: number) => boolean;
|
|
5392
5487
|
/** `filter` mode: the host hides items whose key is not in `matchedKeys` (`undefined` clears). */
|
|
5393
5488
|
onFilterChange?: (matchedKeys: ReadonlySet<string> | undefined) => void;
|
|
5394
5489
|
/** `navigate` + Enter: activate the item with this key. Falls back to `focusKey`. */
|
|
@@ -5425,6 +5520,8 @@ interface ElementListSearchAdapterOptions {
|
|
|
5425
5520
|
highlightKey?: string;
|
|
5426
5521
|
/** Full ordered item set, including rows not currently in the DOM (virtualised hosts). Defaults to querying `itemSelector`. */
|
|
5427
5522
|
getAllItems?: () => Element[];
|
|
5523
|
+
/** Items for which this returns `false` take no part in search. Default: all do. */
|
|
5524
|
+
isSearchable?: (el: Element) => boolean;
|
|
5428
5525
|
/** Observe host child-list mutations to refresh the item set. Default true. */
|
|
5429
5526
|
observeContainer?: boolean;
|
|
5430
5527
|
}
|
|
@@ -5971,6 +6068,28 @@ export declare class DataGridElement extends LitElement {
|
|
|
5971
6068
|
*/
|
|
5972
6069
|
get partialKeys(): ReadonlySet<string>;
|
|
5973
6070
|
set partialKeys(keys: Iterable<string>);
|
|
6071
|
+
/**
|
|
6072
|
+
* Caller-assigned tags for a row (`undefined` ⇒ none). Each tag is exposed on
|
|
6073
|
+
* the row as a `tag-<name>` `part` token (`::part(item tag-foo)`) and in
|
|
6074
|
+
* `data-tags` (`[data-tags~="foo"]`); `tagBehaviour` can switch off selection,
|
|
6075
|
+
* focus, drag or search per tag. `index` is the row's position in the sorted
|
|
6076
|
+
* order. Re-read on every render; call {@link refreshTags} after mutating
|
|
6077
|
+
* data the hook reads.
|
|
6078
|
+
*/
|
|
6079
|
+
tags: ((row: unknown, index: number) => readonly string[] | undefined) | undefined;
|
|
6080
|
+
/** Tags by row key, apart from the row data (like {@link partialKeys}): tag name → keys. Merged with the `tags` hook. */
|
|
6081
|
+
get tagKeys(): ItemTagKeys | undefined;
|
|
6082
|
+
set tagKeys(value: ItemTagKeys | undefined);
|
|
6083
|
+
/**
|
|
6084
|
+
* Interaction flags per tag name: `selectable`, `focusable`, `draggable`,
|
|
6085
|
+
* `searchable` (`false` switches one off; omitted keeps the default). With
|
|
6086
|
+
* several tags the most restrictive wins. Rows stay rendered and keep their
|
|
6087
|
+
* place in layout and scroll.
|
|
6088
|
+
*/
|
|
6089
|
+
get tagBehaviour(): ItemTagBehaviour | undefined;
|
|
6090
|
+
set tagBehaviour(value: ItemTagBehaviour | undefined);
|
|
6091
|
+
/** Re-evaluate tags and re-render (the `tags` hook is read live; this drops cached cursor state). */
|
|
6092
|
+
refreshTags(): void;
|
|
5974
6093
|
/** Replace the selection with these row keys (clamped to known rows). */
|
|
5975
6094
|
set selectedKeys(keys: Iterable<string>);
|
|
5976
6095
|
/**
|
|
@@ -6591,6 +6710,23 @@ export declare class VerticalListElement extends LitElement {
|
|
|
6591
6710
|
selectAll(): void;
|
|
6592
6711
|
/** The selection as stable `data-key` / `data-value` strings. */
|
|
6593
6712
|
get selectedKeys(): ReadonlySet<string>;
|
|
6713
|
+
/**
|
|
6714
|
+
* Tags assigned by key, apart from the item data (like {@link partialKeys}):
|
|
6715
|
+
* tag name → keys carrying it. Each tag is mirrored on the row as `data-tags`
|
|
6716
|
+
* (`li[data-tags~="foo"]`); `tagBehaviour` can switch off selection, focus,
|
|
6717
|
+
* drag or search per tag.
|
|
6718
|
+
*/
|
|
6719
|
+
get tagKeys(): ItemTagKeys | undefined;
|
|
6720
|
+
set tagKeys(value: ItemTagKeys | undefined);
|
|
6721
|
+
/**
|
|
6722
|
+
* Interaction flags per tag name: `selectable`, `focusable`, `draggable`,
|
|
6723
|
+
* `searchable` (`false` switches one off; omitted keeps the default). With
|
|
6724
|
+
* several tags the most restrictive wins. Rows stay rendered.
|
|
6725
|
+
*/
|
|
6726
|
+
get tagBehaviour(): ItemTagBehaviour | undefined;
|
|
6727
|
+
set tagBehaviour(value: ItemTagBehaviour | undefined);
|
|
6728
|
+
/** Re-apply `data-tags` to the rows and refresh drag state. Called automatically on change and after each update. */
|
|
6729
|
+
refreshTags(): void;
|
|
6594
6730
|
/**
|
|
6595
6731
|
* Rows shown as *partially* selected (a part of the resource is selected):
|
|
6596
6732
|
* `data-partial`, an indeterminate checkbox in `checked` mode, and an
|
|
@@ -6814,6 +6950,31 @@ export declare class DetailListElement extends LitElement {
|
|
|
6814
6950
|
*/
|
|
6815
6951
|
badgeProperty: string;
|
|
6816
6952
|
keyProperty: string;
|
|
6953
|
+
/**
|
|
6954
|
+
* Caller-assigned tags for an object item (`undefined` ⇒ none). Each tag is
|
|
6955
|
+
* mirrored on the row as `data-tags` (style with `li[data-tags~="foo"]`), and
|
|
6956
|
+
* `tagBehaviour` can switch off selection, focus, drag or search per tag.
|
|
6957
|
+
* Re-evaluated when `items`, `tags`, `tagKeys` or `tagBehaviour` change, or on
|
|
6958
|
+
* {@link refreshTags}.
|
|
6959
|
+
*/
|
|
6960
|
+
tags: ((item: unknown, index: number) => readonly string[] | undefined) | undefined;
|
|
6961
|
+
/**
|
|
6962
|
+
* Tags assigned by key, apart from the item data (like `partialKeys`):
|
|
6963
|
+
* tag name → keys carrying it. Merged with the `tags` hook; works for
|
|
6964
|
+
* declarative rows too.
|
|
6965
|
+
*/
|
|
6966
|
+
get tagKeys(): ItemTagKeys | undefined;
|
|
6967
|
+
set tagKeys(value: ItemTagKeys | undefined);
|
|
6968
|
+
/**
|
|
6969
|
+
* Interaction flags per tag name: `selectable`, `focusable`, `draggable`,
|
|
6970
|
+
* `searchable` (`false` switches one off; omitted keeps the default). With
|
|
6971
|
+
* several tags the most restrictive wins. Rows stay rendered and keep their
|
|
6972
|
+
* place in layout.
|
|
6973
|
+
*/
|
|
6974
|
+
get tagBehaviour(): ItemTagBehaviour | undefined;
|
|
6975
|
+
set tagBehaviour(value: ItemTagBehaviour | undefined);
|
|
6976
|
+
/** Re-evaluate every row's tags (call after mutating data the `tags` hook reads). */
|
|
6977
|
+
refreshTags(): void;
|
|
6817
6978
|
filterPredicate: ((el: Element) => boolean) | undefined;
|
|
6818
6979
|
/**
|
|
6819
6980
|
* Whether keyboard navigation wraps from last to first and vice versa.
|
|
@@ -9243,6 +9404,11 @@ type TickledItem<T = unknown> = {
|
|
|
9243
9404
|
* Whether the item is currently enabled/interactive
|
|
9244
9405
|
*/
|
|
9245
9406
|
readonly enabled?: boolean;
|
|
9407
|
+
/**
|
|
9408
|
+
* `false`: hover may still tickle the item, but keyboard cursor movement
|
|
9409
|
+
* skips it. Independent of `enabled` (which blocks both).
|
|
9410
|
+
*/
|
|
9411
|
+
readonly focusable?: boolean;
|
|
9246
9412
|
};
|
|
9247
9413
|
/**
|
|
9248
9414
|
* Input mode determines which mechanism controls the tickled state
|
|
@@ -9532,6 +9698,13 @@ type GridListDataAdapter<T> = {
|
|
|
9532
9698
|
label?: (item: T, index: number) => string;
|
|
9533
9699
|
render: (item: T, index: number) => unknown;
|
|
9534
9700
|
disabled?: (item: T, index: number) => boolean;
|
|
9701
|
+
/**
|
|
9702
|
+
* Caller-assigned tags for the item (`undefined` ⇒ none). Each tag is exposed as a
|
|
9703
|
+
* `tag-<name>` token in the cell's `part` and in `data-tags`; `tagBehaviour` can
|
|
9704
|
+
* switch off selection, focus, drag or search per tag. Re-read on every render, so
|
|
9705
|
+
* `updateItem` / `updateItems` pick up changes.
|
|
9706
|
+
*/
|
|
9707
|
+
tags?: (item: T, index: number) => readonly string[] | undefined;
|
|
9535
9708
|
searchableText?: (item: T, index: number) => string;
|
|
9536
9709
|
/**
|
|
9537
9710
|
* Per-item icon, rendered above `render`'s output inside the cell's content
|
|
@@ -10001,6 +10174,22 @@ export declare class GridListElement<T = unknown> extends LitElement {
|
|
|
10001
10174
|
* Auto-assigned keyless-item keys are omitted.
|
|
10002
10175
|
*/
|
|
10003
10176
|
visibleKeys(): string[];
|
|
10177
|
+
/**
|
|
10178
|
+
* Tags assigned by key, for callers who keep them apart from the item data
|
|
10179
|
+
* (like {@link partialKeys}): tag name → keys carrying it. Merged with the
|
|
10180
|
+
* adapter's `tags` hook. Each tag shows as a `tag-<name>` `part` token and in
|
|
10181
|
+
* `data-tags`. Works in element mode too.
|
|
10182
|
+
*/
|
|
10183
|
+
get tagKeys(): ItemTagKeys | undefined;
|
|
10184
|
+
set tagKeys(value: ItemTagKeys | undefined);
|
|
10185
|
+
/**
|
|
10186
|
+
* Interaction flags per tag name: `selectable`, `focusable`, `draggable`,
|
|
10187
|
+
* `searchable` (each `false` to switch off; omitted keeps the default). With
|
|
10188
|
+
* several tags the most restrictive wins. Items stay rendered and keep their
|
|
10189
|
+
* place in layout and scroll.
|
|
10190
|
+
*/
|
|
10191
|
+
get tagBehaviour(): ItemTagBehaviour | undefined;
|
|
10192
|
+
set tagBehaviour(value: ItemTagBehaviour | undefined);
|
|
10004
10193
|
/**
|
|
10005
10194
|
* Cells shown as *partially* selected (a part of the resource is selected):
|
|
10006
10195
|
* `data-partial` / `part="item partial"` and an accessible description.
|
|
@@ -12587,6 +12776,22 @@ export declare class MulticolListElement extends LitElement {
|
|
|
12587
12776
|
private _getCategoryLabel;
|
|
12588
12777
|
/** Category description if present, else the default 'Change category' hint. */
|
|
12589
12778
|
private _getCategoryTooltip;
|
|
12779
|
+
/**
|
|
12780
|
+
* Caller-assigned tags for an item (`undefined` ⇒ none), given the column it
|
|
12781
|
+
* is shown in. Each tag is mirrored on the item as `data-tags`
|
|
12782
|
+
* (`li[data-tags~="foo"]`); `tagBehaviour` can switch off selection, focus,
|
|
12783
|
+
* drag or search per tag. Merged with {@link tagKeys}. Call {@link refreshTags}
|
|
12784
|
+
* after changing what the hook reads.
|
|
12785
|
+
*/
|
|
12786
|
+
tags: ((item: MulticolItem, columnId: string) => readonly string[] | undefined) | undefined;
|
|
12787
|
+
/** Tags by item key, in every column with an item of that key: tag name → keys. */
|
|
12788
|
+
get tagKeys(): ItemTagKeys | undefined;
|
|
12789
|
+
set tagKeys(value: ItemTagKeys | undefined);
|
|
12790
|
+
/** Interaction flags per tag name (`selectable`, `focusable`, `draggable`, `searchable`); the most restrictive flag wins. */
|
|
12791
|
+
get tagBehaviour(): ItemTagBehaviour | undefined;
|
|
12792
|
+
set tagBehaviour(value: ItemTagBehaviour | undefined);
|
|
12793
|
+
/** Re-evaluate every column's tags. */
|
|
12794
|
+
refreshTags(): void;
|
|
12590
12795
|
/**
|
|
12591
12796
|
* Item keys shown as *partially* selected in every column that has an item
|
|
12592
12797
|
* with that key (see `ixfx-vertical-list`'s `partialKeys`). Independent of
|
|
@@ -17199,4 +17404,4 @@ export interface XyPad {
|
|
|
17199
17404
|
addEventListener: (<K extends keyof XyPadEventMap>(type: K, listener: (this: XyPad, event: XyPadEventMap[K]) => void, options?: boolean | AddEventListenerOptions) => void) & ((type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions) => void);
|
|
17200
17405
|
}
|
|
17201
17406
|
export declare function init(): void;
|
|
17202
|
-
export { type AcTokenAddDetail, type AcTokenAddEvent, type AcTokenElementEventMap, type AcTokenItem, type AcTokenRemoveDetail, type AcTokenRemoveEvent, type AcTokenStyle, type AcTokenStyleFn, type AcTokenizerFn, type AcTokensChangeDetail, type AcTokensChangeEvent, type AddedNode, type BridgeDeps, type BridgeResult, type BuiltInFormatterName, type BuiltInFormatterOptions, type CheckState, type CheckedSelectItem, type ColourPickerChangeEvent, type ColourPickerEventDetail, type ColourPickerInputEvent, type ComputeHyperbolicLayoutOptions, type ComputeTreemapLayoutOptions, type ContextKind, type ContextTarget, type CrumbNavigationViewState, type CssVars, type DataGridColumn, type DataGridColumnMenu, type DataGridColumnViewState, type DataGridDataType, type DataGridEditability, type DataGridEditorContext, type DataGridEditorFactory, type DataGridEditorType, type DataGridGetRowKey, type DataGridGroupBy, type DataGridGroupLabel, type DataGridInteractionMode, type DataGridRowLook, type DataGridSelectionMode, type DataGridSortDirection, type DataGridSortState, type DataGridViewState, type DataListSearchAdapterOptions, type DataListSearchItem, type DetailFormatter, type DetailGroupBy, type DetailListViewState, type DetailSortComparator, type DetailSortItem, type DetailSortMode, type DockDropZone, type DragSelectRect, type DraggableNode, type ElementIncrSearch, type ElementIncrSearchOptions, type ElementListSearchAdapterOptions, type ElementListSearchHost, type FlatListActivateDetail, type FlatListActivateEvent, type FlatListBranchOrder, type FlatListContextMenuDetail, type FlatListContextMenuEvent, type FlatListDropDetail, type FlatListDropEvent, type FlatListEditCancelDetail, type FlatListEditCancelEvent, type FlatListEditCommitDetail, type FlatListEditCommitEvent, type FlatListElementEventMap, type FlatListNavigateDetail, type FlatListNavigateEvent, type FlatListSelectDetail, type FlatListSelectEvent, type FlatListViewState, type FuzzySearch, type FuzzySearchOptions, type GlobalFormatter, type GridListActivateDetail, type GridListActivateEvent, type GridListCaptionAlign, type GridListCaptionBackdrop, type GridListCaptionPosition, type GridListCaptionStyle, type GridListDataAdapter, type GridListElementEventMap, type GridListFullElementEventMap, type GridListItemClickDetail, type GridListItemClickEvent, type GridListItemEventDetail, type GridListItemUpdate, type GridListOrientation, type GridListSelectDetail, type GridListSelectEvent, type GridListTickleDetail, type GridListTickleEvent, type GridListViewState, type GridListViewportChangeDetail, type GridListViewportChangeEvent, type GroupedItemListerElementEventMap, type GroupedSelectDetail, type GroupedSelectEvent, type HighlightOptions, type HighlightTarget, type HyperbolicEdgeRenderContext, type HyperbolicEdgeRenderer, type HyperbolicFocusDetail, type HyperbolicFocusEvent, type HyperbolicInteractionMode, type HyperbolicLayoutEdge, type HyperbolicLayoutNode, type HyperbolicNodeShape, type Point as HyperbolicPoint, type HyperbolicTreeListViewState, type IGroupedSubComponent, type IGroupedSubComponentEventMap, type IcicleViewState, type IconChangedDetail, type IconChangedEvent, type IconEntry, type IncrSearch, type IncrSearchChangeCallback, IncrSearchTreeController as IncrSearchMillerController, type IncrSearchTreeOptions as IncrSearchMillerOptions, type IncrSearchTreeOptions, type IncrSearchOptions, type IncrSearchResult, type IncrSearchState, type InputMode, type ItemDisplay, type ItemOrientation, type ListActivateDetail, type ListActivateEvent, type ListContextMenuDetail, type ListContextMenuEvent, type ListDragDataTransferWriter, type ListDragEntry, type ListDragLeaveDetail, type ListDragLeaveEvent, type ListDragOverEvent, type ListDragPreview, type ListDragPreviewContext, type ListDragPreviewRenderer, type ListDragPreviewSourceResolver, type ListDragSelectControllerConfig, type ListDragSource, type ListDropDetail, type ListDropEvent, type ListEditCancelDetail, type ListEditCancelEvent, type ListEditCommitDetail, type ListEditCommitEvent, type ListElementEventMap, type ListGroupBy, type ListGroupChangeDetail, type ListGroupChangeEvent, type ListGroupEventMap, type ListGroupInfo, type ListGroupLabel, type ListGroupPartition, type ListGroupToggleDetail, type ListGroupToggleEvent, type ListInteractionMode, type ListItemClickDetail, type ListItemClickEvent, type ListItemMotionOptions, type ListItemOutResult, type ListMarqueeMode, type ListNativeDragControllerConfig, type ListNativeDragStartDetail, type ListNativeDragStartEvent, type ListSearchAdapter, type ListSearchControllerOptions, type ListSearchHost, type ListSearchMode, type ListSelectDetail, type ListSelectEvent, type ListSelectIntentDetail, type ListSelectIntentEvent, type ListSelectIntentKind, type ListSelectIntentSource, type ListSelectKeysDetail, type ListSelectionControllerConfig, type ListSelectionGesture, type ListSelectionMode, type ListSelectionModes, type ListTickleDetail, type ListTickleEvent, type ListViewportChangeDetail, type ListViewportChangeEvent, type MarqueeConfig, index_d_exports as Menu, type TreeActivateDetail as MillerActivateDetail, type TreeActivateEvent as MillerActivateEvent, type TreeCollapseDetail as MillerCollapseDetail, type TreeCollapseEvent as MillerCollapseEvent, type TreeExpandDetail as MillerExpandDetail, type TreeExpandEvent as MillerExpandEvent, type TreeItem as MillerItem, type TreeItemClickDetail as MillerItemClickDetail, type TreeItemClickEvent as MillerItemClickEvent, type MillerListViewState, type TreeNode as MillerNode, type TreeSelectDetail as MillerSelectDetail, type TreeSelectEvent as MillerSelectEvent, type TreeTickleDetail as MillerTickleDetail, type TreeTickleEvent as MillerTickleEvent, type MulticolCategory, type MulticolColumnState, type MulticolColumnsChangeReason, type MulticolItem, type MulticolListViewState, type MulticolQuery, type MulticolSelectDetail, type NodeDragConfig, type NodeFactory, type NodeFactoryContext, type OklchValue, type OpenableMenu, type PanZoomConfig, Point$1 as Point, type ProximityPair, type ProximityQuery, type Rect, type RegisterListSearchCommandsOptions, type ScrollHoverGuard, type ScrollHoverGuardConfig, type SortDirection, type SubComponentActivateDetail, type SubComponentActivateEvent, type SubComponentFactory, type SubComponentItemClickDetail, type SubComponentItemClickEvent, type SubComponentSelectDetail, type SubComponentSelectEvent, type SubComponentTickleDetail, type SubComponentTickleEvent, type SunburstViewState, type TickledControllerConfig, type TickledItem, type TreeCheckboxState, type TreeKeyboardNavCallbacks, type TreeKeyboardNavControllerConfig, type TreeKeyboardNavItemId, type TreeListSearchAdapterOptions, type TreeListViewState, type TreemapInteractionMode, type TreemapListViewState, type TreemapRect, type TreemapTilingMethod, type TreemapValueAccessor, type VerticalListViewState, type WheelMode, type WireDragConfig, type WireDragMode, type WireDragPort, type WirePath };
|
|
17407
|
+
export { type AcTokenAddDetail, type AcTokenAddEvent, type AcTokenElementEventMap, type AcTokenItem, type AcTokenRemoveDetail, type AcTokenRemoveEvent, type AcTokenStyle, type AcTokenStyleFn, type AcTokenizerFn, type AcTokensChangeDetail, type AcTokensChangeEvent, type AddedNode, type BridgeDeps, type BridgeResult, type BuiltInFormatterName, type BuiltInFormatterOptions, type CheckState, type CheckedSelectItem, type ColourPickerChangeEvent, type ColourPickerEventDetail, type ColourPickerInputEvent, type ComputeHyperbolicLayoutOptions, type ComputeTreemapLayoutOptions, type ContextKind, type ContextTarget, type CrumbNavigationViewState, type CssVars, type DataGridColumn, type DataGridColumnMenu, type DataGridColumnViewState, type DataGridDataType, type DataGridEditability, type DataGridEditorContext, type DataGridEditorFactory, type DataGridEditorType, type DataGridGetRowKey, type DataGridGroupBy, type DataGridGroupLabel, type DataGridInteractionMode, type DataGridRowLook, type DataGridSelectionMode, type DataGridSortDirection, type DataGridSortState, type DataGridViewState, type DataListSearchAdapterOptions, type DataListSearchItem, type DetailFormatter, type DetailGroupBy, type DetailListViewState, type DetailSortComparator, type DetailSortItem, type DetailSortMode, type DockDropZone, type DragSelectRect, type DraggableNode, type ElementIncrSearch, type ElementIncrSearchOptions, type ElementListSearchAdapterOptions, type ElementListSearchHost, type FlatListActivateDetail, type FlatListActivateEvent, type FlatListBranchOrder, type FlatListContextMenuDetail, type FlatListContextMenuEvent, type FlatListDropDetail, type FlatListDropEvent, type FlatListEditCancelDetail, type FlatListEditCancelEvent, type FlatListEditCommitDetail, type FlatListEditCommitEvent, type FlatListElementEventMap, type FlatListNavigateDetail, type FlatListNavigateEvent, type FlatListSelectDetail, type FlatListSelectEvent, type FlatListViewState, type FuzzySearch, type FuzzySearchOptions, type GlobalFormatter, type GridListActivateDetail, type GridListActivateEvent, type GridListCaptionAlign, type GridListCaptionBackdrop, type GridListCaptionPosition, type GridListCaptionStyle, type GridListDataAdapter, type GridListElementEventMap, type GridListFullElementEventMap, type GridListItemClickDetail, type GridListItemClickEvent, type GridListItemEventDetail, type GridListItemUpdate, type GridListOrientation, type GridListSelectDetail, type GridListSelectEvent, type GridListTickleDetail, type GridListTickleEvent, type GridListViewState, type GridListViewportChangeDetail, type GridListViewportChangeEvent, type GroupedItemListerElementEventMap, type GroupedSelectDetail, type GroupedSelectEvent, type HighlightOptions, type HighlightTarget, type HyperbolicEdgeRenderContext, type HyperbolicEdgeRenderer, type HyperbolicFocusDetail, type HyperbolicFocusEvent, type HyperbolicInteractionMode, type HyperbolicLayoutEdge, type HyperbolicLayoutNode, type HyperbolicNodeShape, type Point as HyperbolicPoint, type HyperbolicTreeListViewState, type IGroupedSubComponent, type IGroupedSubComponentEventMap, type IcicleViewState, type IconChangedDetail, type IconChangedEvent, type IconEntry, type IncrSearch, type IncrSearchChangeCallback, IncrSearchTreeController as IncrSearchMillerController, type IncrSearchTreeOptions as IncrSearchMillerOptions, type IncrSearchTreeOptions, type IncrSearchOptions, type IncrSearchResult, type IncrSearchState, type InputMode, type ItemDisplay, type ItemOrientation, type ItemTagBehaviour, type ItemTagBehaviourFlags, type ItemTagKeys, type ListActivateDetail, type ListActivateEvent, type ListContextMenuDetail, type ListContextMenuEvent, type ListDragDataTransferWriter, type ListDragEntry, type ListDragLeaveDetail, type ListDragLeaveEvent, type ListDragOverEvent, type ListDragPreview, type ListDragPreviewContext, type ListDragPreviewRenderer, type ListDragPreviewSourceResolver, type ListDragSelectControllerConfig, type ListDragSource, type ListDropDetail, type ListDropEvent, type ListEditCancelDetail, type ListEditCancelEvent, type ListEditCommitDetail, type ListEditCommitEvent, type ListElementEventMap, type ListGroupBy, type ListGroupChangeDetail, type ListGroupChangeEvent, type ListGroupEventMap, type ListGroupInfo, type ListGroupLabel, type ListGroupPartition, type ListGroupToggleDetail, type ListGroupToggleEvent, type ListInteractionMode, type ListItemClickDetail, type ListItemClickEvent, type ListItemMotionOptions, type ListItemOutResult, type ListMarqueeMode, type ListNativeDragControllerConfig, type ListNativeDragStartDetail, type ListNativeDragStartEvent, type ListSearchAdapter, type ListSearchControllerOptions, type ListSearchHost, type ListSearchMode, type ListSelectDetail, type ListSelectEvent, type ListSelectIntentDetail, type ListSelectIntentEvent, type ListSelectIntentKind, type ListSelectIntentSource, type ListSelectKeysDetail, type ListSelectionControllerConfig, type ListSelectionGesture, type ListSelectionMode, type ListSelectionModes, type ListTickleDetail, type ListTickleEvent, type ListViewportChangeDetail, type ListViewportChangeEvent, type MarqueeConfig, index_d_exports as Menu, type TreeActivateDetail as MillerActivateDetail, type TreeActivateEvent as MillerActivateEvent, type TreeCollapseDetail as MillerCollapseDetail, type TreeCollapseEvent as MillerCollapseEvent, type TreeExpandDetail as MillerExpandDetail, type TreeExpandEvent as MillerExpandEvent, type TreeItem as MillerItem, type TreeItemClickDetail as MillerItemClickDetail, type TreeItemClickEvent as MillerItemClickEvent, type MillerListViewState, type TreeNode as MillerNode, type TreeSelectDetail as MillerSelectDetail, type TreeSelectEvent as MillerSelectEvent, type TreeTickleDetail as MillerTickleDetail, type TreeTickleEvent as MillerTickleEvent, type MulticolCategory, type MulticolColumnState, type MulticolColumnsChangeReason, type MulticolItem, type MulticolListViewState, type MulticolQuery, type MulticolSelectDetail, type NodeDragConfig, type NodeFactory, type NodeFactoryContext, type OklchValue, type OpenableMenu, type PanZoomConfig, Point$1 as Point, type ProximityPair, type ProximityQuery, type Rect, type RegisterListSearchCommandsOptions, type ResolvedItemTagFlags, type ScrollHoverGuard, type ScrollHoverGuardConfig, type SortDirection, type SubComponentActivateDetail, type SubComponentActivateEvent, type SubComponentFactory, type SubComponentItemClickDetail, type SubComponentItemClickEvent, type SubComponentSelectDetail, type SubComponentSelectEvent, type SubComponentTickleDetail, type SubComponentTickleEvent, type SunburstViewState, type TickledControllerConfig, type TickledItem, type TreeCheckboxState, type TreeKeyboardNavCallbacks, type TreeKeyboardNavControllerConfig, type TreeKeyboardNavItemId, type TreeListSearchAdapterOptions, type TreeListViewState, type TreemapInteractionMode, type TreemapListViewState, type TreemapRect, type TreemapTilingMethod, type TreemapValueAccessor, type VerticalListViewState, type WheelMode, type WireDragConfig, type WireDragMode, type WireDragPort, type WirePath };
|