@fusion.dev/helix 0.156.0 → 0.158.0
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/custom-elements.json +1514 -50
- package/dist/command/root/command-root.js +2 -1
- package/dist/element-events.generated.js +1 -1
- package/dist/menu/item/menu-item.css.js +1 -1
- package/dist/menu/item/menu-item.js +3 -1
- package/dist/toast/item/toast-item.css.js +1 -1
- package/lint.json +1 -1
- package/package.json +6 -6
- package/types/jsx.d.ts +416 -17
- package/types/vue.d.ts +120 -3
- package/types/words.d.ts +14 -0
package/types/jsx.d.ts
CHANGED
|
@@ -10051,6 +10051,13 @@ how many are left, written in the locale, and each language writes the
|
|
|
10051
10051
|
forms it has: `{count, plural, one {# polecenie} few {# polecenia} many
|
|
10052
10052
|
{# poleceń} other {# polecenia}}`. */
|
|
10053
10053
|
resultsLabel?: (HelixCommand["resultsLabel"]) | undefined;
|
|
10054
|
+
/** Whether a command is kept by the filter: a function given the command's
|
|
10055
|
+
words and the filter, trimmed, that returns `true` to keep it showing, as
|
|
10056
|
+
React Aria's `Autocomplete` takes `filter`. See Listbox's `filterMatch`.
|
|
10057
|
+
|
|
10058
|
+
Absent, a command is kept where its words hold the filter, in any case. A
|
|
10059
|
+
property only, there being no way to write a function in markup. */
|
|
10060
|
+
filterMatch?: (HelixCommand["filterMatch"]) | undefined;
|
|
10054
10061
|
/** The commands as data, for a palette too long to draw whole: each a value,
|
|
10055
10062
|
which is also its words, or a record with a `value`, a `label` and
|
|
10056
10063
|
`disabled`. Handed to the list, which draws only the commands in sight and
|
|
@@ -10176,6 +10183,13 @@ how many are left, written in the locale, and each language writes the
|
|
|
10176
10183
|
forms it has: `{count, plural, one {# polecenie} few {# polecenia} many
|
|
10177
10184
|
{# poleceń} other {# polecenia}}`. */
|
|
10178
10185
|
"prop:resultsLabel"?: (HelixCommand["resultsLabel"]) | undefined;
|
|
10186
|
+
/** Whether a command is kept by the filter: a function given the command's
|
|
10187
|
+
words and the filter, trimmed, that returns `true` to keep it showing, as
|
|
10188
|
+
React Aria's `Autocomplete` takes `filter`. See Listbox's `filterMatch`.
|
|
10189
|
+
|
|
10190
|
+
Absent, a command is kept where its words hold the filter, in any case. A
|
|
10191
|
+
property only, there being no way to write a function in markup. */
|
|
10192
|
+
"prop:filterMatch"?: (HelixCommand["filterMatch"]) | undefined;
|
|
10179
10193
|
/** The commands as data, for a palette too long to draw whole: each a value,
|
|
10180
10194
|
which is also its words, or a record with a `value`, a `label` and
|
|
10181
10195
|
`disabled`. Handed to the list, which draws only the commands in sight and
|
|
@@ -14228,6 +14242,16 @@ export type HelixDrilldownItemHelixSelectElementEvent =
|
|
|
14228
14242
|
export type HelixDrilldownItemProps = {
|
|
14229
14243
|
/** Whether the row can be reached at all. */
|
|
14230
14244
|
disabled?: (HelixDrilldownItem["disabled"]) | undefined;
|
|
14245
|
+
/** Whether the link downloads the file when the row is chosen. Only
|
|
14246
|
+
meaningful beside an `href`, and only for a file served from this origin. */
|
|
14247
|
+
download?: (HelixDrilldownItem["download"]) | undefined;
|
|
14248
|
+
/** The URL the row links to. Setting it renders the row as a link, unless the
|
|
14249
|
+
row opens a page or is disabled. */
|
|
14250
|
+
href?: (HelixDrilldownItem["href"]) | undefined;
|
|
14251
|
+
/** The link's `rel`. Set it whenever you set `target="_blank"`. */
|
|
14252
|
+
rel?: (HelixDrilldownItem["rel"]) | undefined;
|
|
14253
|
+
/** Where the link opens, for rows that should open outside the current page. */
|
|
14254
|
+
target?: (HelixDrilldownItem["target"]) | undefined;
|
|
14231
14255
|
/** Identifies the row to your event listeners. */
|
|
14232
14256
|
value?: (HelixDrilldownItem["value"]) | undefined;
|
|
14233
14257
|
/** Whether this row holds the region's tab stop. Set by the drill-down.
|
|
@@ -14250,6 +14274,16 @@ lands inside this shadow root instead. */
|
|
|
14250
14274
|
export type HelixDrilldownItemSolidJsProps = {
|
|
14251
14275
|
/** Whether the row can be reached at all. */
|
|
14252
14276
|
"prop:disabled"?: (HelixDrilldownItem["disabled"]) | undefined;
|
|
14277
|
+
/** Whether the link downloads the file when the row is chosen. Only
|
|
14278
|
+
meaningful beside an `href`, and only for a file served from this origin. */
|
|
14279
|
+
"prop:download"?: (HelixDrilldownItem["download"]) | undefined;
|
|
14280
|
+
/** The URL the row links to. Setting it renders the row as a link, unless the
|
|
14281
|
+
row opens a page or is disabled. */
|
|
14282
|
+
"prop:href"?: (HelixDrilldownItem["href"]) | undefined;
|
|
14283
|
+
/** The link's `rel`. Set it whenever you set `target="_blank"`. */
|
|
14284
|
+
"prop:rel"?: (HelixDrilldownItem["rel"]) | undefined;
|
|
14285
|
+
/** Where the link opens, for rows that should open outside the current page. */
|
|
14286
|
+
"prop:target"?: (HelixDrilldownItem["target"]) | undefined;
|
|
14253
14287
|
/** Identifies the row to your event listeners. */
|
|
14254
14288
|
"prop:value"?: (HelixDrilldownItem["value"]) | undefined;
|
|
14255
14289
|
/** Whether this row holds the region's tab stop. Set by the drill-down.
|
|
@@ -14278,6 +14312,9 @@ export type HelixDrilldownElementEvent<E = Event> = TypedEvent<
|
|
|
14278
14312
|
HelixDrilldown,
|
|
14279
14313
|
E
|
|
14280
14314
|
>;
|
|
14315
|
+
/** `helix-navigate` event type */
|
|
14316
|
+
export type HelixDrilldownHelixNavigateElementEvent =
|
|
14317
|
+
HelixDrilldownElementEvent<HelixNavigateEvent>;
|
|
14281
14318
|
/** `helix-select` event type */
|
|
14282
14319
|
export type HelixDrilldownHelixSelectElementEvent =
|
|
14283
14320
|
HelixDrilldownElementEvent<HelixSelectEvent>;
|
|
@@ -14307,7 +14344,17 @@ and wins over this. */
|
|
|
14307
14344
|
"back-label"?: (HelixDrilldown["backLabel"]) | undefined;
|
|
14308
14345
|
/** The text of the back button. */
|
|
14309
14346
|
backLabel?: (HelixDrilldown["backLabel"]) | undefined;
|
|
14310
|
-
|
|
14347
|
+
/** Whether the drilldown is a site's navigation: a `navigation` landmark
|
|
14348
|
+
named by `label`, whose pages are lists of links. Without it, each page is
|
|
14349
|
+
a `menu`. */
|
|
14350
|
+
navigation?: (HelixDrilldown["navigation"]) | undefined;
|
|
14351
|
+
/** The page showing, as the `value` of the row that opens it. Empty is the
|
|
14352
|
+
top page. Setting it shows that page, and a value no row with a page has
|
|
14353
|
+
shows the top page. */
|
|
14354
|
+
page?: (HelixDrilldown["page"]) | undefined;
|
|
14355
|
+
|
|
14356
|
+
/** Fired before a reader moves into a page or back out of one. `detail.value` is the `value` of the row whose page is about to show, empty for the top page. Cancelable: cancel it to stay on the page showing. */
|
|
14357
|
+
"onhelix-navigate"?: ((e: HelixDrilldownHelixNavigateElementEvent) => void) | undefined;
|
|
14311
14358
|
/** Fired when a row with no page is chosen. Cancelable: canceling it stops the change and leaves the decision to you. */
|
|
14312
14359
|
"onhelix-select"?: ((e: HelixDrilldownHelixSelectElementEvent) => void) | undefined;
|
|
14313
14360
|
};
|
|
@@ -14337,6 +14384,16 @@ and wins over this. */
|
|
|
14337
14384
|
"attr:back-label"?: (HelixDrilldown["backLabel"]) | undefined;
|
|
14338
14385
|
/** The text of the back button. */
|
|
14339
14386
|
"prop:backLabel"?: (HelixDrilldown["backLabel"]) | undefined;
|
|
14387
|
+
/** Whether the drilldown is a site's navigation: a `navigation` landmark
|
|
14388
|
+
named by `label`, whose pages are lists of links. Without it, each page is
|
|
14389
|
+
a `menu`. */
|
|
14390
|
+
"prop:navigation"?: (HelixDrilldown["navigation"]) | undefined;
|
|
14391
|
+
/** The page showing, as the `value` of the row that opens it. Empty is the
|
|
14392
|
+
top page. Setting it shows that page, and a value no row with a page has
|
|
14393
|
+
shows the top page. */
|
|
14394
|
+
"prop:page"?: (HelixDrilldown["page"]) | undefined;
|
|
14395
|
+
/** Fired before a reader moves into a page or back out of one. `detail.value` is the `value` of the row whose page is about to show, empty for the top page. Cancelable: cancel it to stay on the page showing. */
|
|
14396
|
+
"on:helix-navigate"?: ((e: HelixDrilldownHelixNavigateElementEvent) => void) | undefined;
|
|
14340
14397
|
/** Fired when a row with no page is chosen. Cancelable: canceling it stops the change and leaves the decision to you. */
|
|
14341
14398
|
"on:helix-select"?: ((e: HelixDrilldownHelixSelectElementEvent) => void) | undefined;
|
|
14342
14399
|
|
|
@@ -19945,7 +20002,9 @@ Not reflected, as a state never is. `row-current` is the part a
|
|
|
19945
20002
|
stylesheet draws it from. */
|
|
19946
20003
|
current?: (HelixListItem["current"]) | undefined;
|
|
19947
20004
|
/** Takes the row out of reach in a list with `selection-mode`: the arrow keys
|
|
19948
|
-
pass over it and it cannot be selected or acted on.
|
|
20005
|
+
pass over it and it cannot be selected or acted on. In a list with
|
|
20006
|
+
`disabled-behavior="selection"`, it cannot be selected and is reached and
|
|
20007
|
+
acted on as any row is. */
|
|
19949
20008
|
disabled?: (HelixListItem["disabled"]) | undefined;
|
|
19950
20009
|
/** The URL the row links to. Leave it empty for a row that is not a link.
|
|
19951
20010
|
|
|
@@ -19981,6 +20040,10 @@ being moved, or the one the drop indicator is beside. Unset otherwise. */
|
|
|
19981
20040
|
Written by the list from its own `value`, and unset where nothing can be
|
|
19982
20041
|
selected, which keeps `aria-selected` off a list that does not select. */
|
|
19983
20042
|
selected?: (HelixListItem["selected"]) | undefined;
|
|
20043
|
+
/** Whether `disabled` takes the row out of selection alone, written by a list
|
|
20044
|
+
with `disabled-behavior="selection"`. No attribute: it is coordination
|
|
20045
|
+
between elements, as `focusable` is. */
|
|
20046
|
+
selectionOnly?: (HelixListItem["selectionOnly"]) | undefined;
|
|
19984
20047
|
|
|
19985
20048
|
/** The reader pressed Enter on the row, or pressed the row in a list that selects nothing, in a list with `selection-mode`. Read the row from `target`. A row with `href` follows its link instead. */
|
|
19986
20049
|
"onhelix-action"?: ((e: HelixListItemHelixActionElementEvent) => void) | undefined;
|
|
@@ -19996,7 +20059,9 @@ Not reflected, as a state never is. `row-current` is the part a
|
|
|
19996
20059
|
stylesheet draws it from. */
|
|
19997
20060
|
"prop:current"?: (HelixListItem["current"]) | undefined;
|
|
19998
20061
|
/** Takes the row out of reach in a list with `selection-mode`: the arrow keys
|
|
19999
|
-
pass over it and it cannot be selected or acted on.
|
|
20062
|
+
pass over it and it cannot be selected or acted on. In a list with
|
|
20063
|
+
`disabled-behavior="selection"`, it cannot be selected and is reached and
|
|
20064
|
+
acted on as any row is. */
|
|
20000
20065
|
"prop:disabled"?: (HelixListItem["disabled"]) | undefined;
|
|
20001
20066
|
/** The URL the row links to. Leave it empty for a row that is not a link.
|
|
20002
20067
|
|
|
@@ -20032,6 +20097,10 @@ being moved, or the one the drop indicator is beside. Unset otherwise. */
|
|
|
20032
20097
|
Written by the list from its own `value`, and unset where nothing can be
|
|
20033
20098
|
selected, which keeps `aria-selected` off a list that does not select. */
|
|
20034
20099
|
"prop:selected"?: (HelixListItem["selected"]) | undefined;
|
|
20100
|
+
/** Whether `disabled` takes the row out of selection alone, written by a list
|
|
20101
|
+
with `disabled-behavior="selection"`. No attribute: it is coordination
|
|
20102
|
+
between elements, as `focusable` is. */
|
|
20103
|
+
"prop:selectionOnly"?: (HelixListItem["selectionOnly"]) | undefined;
|
|
20035
20104
|
/** The reader pressed Enter on the row, or pressed the row in a list that selects nothing, in a list with `selection-mode`. Read the row from `target`. A row with `href` follows its link instead. */
|
|
20036
20105
|
"on:helix-action"?: ((e: HelixListItemHelixActionElementEvent) => void) | undefined;
|
|
20037
20106
|
|
|
@@ -20083,6 +20152,20 @@ refused, in a `reorderable` list. */
|
|
|
20083
20152
|
/** What screen readers hear when a held row is put back, or a move is
|
|
20084
20153
|
refused, in a `reorderable` list. */
|
|
20085
20154
|
canceledLabel?: (HelixList["canceledLabel"]) | undefined;
|
|
20155
|
+
/** What `disabled` takes from a row, in a list that selects: `all`, which
|
|
20156
|
+
passes over the row, or `selection`, which keeps the row out of the
|
|
20157
|
+
selection and lets the keys reach it and Enter or a press act on it, as
|
|
20158
|
+
React Aria's GridList takes `disabledBehavior`.
|
|
20159
|
+
|
|
20160
|
+
Absent is `all`. */
|
|
20161
|
+
"disabled-behavior"?: (HelixList["disabledBehavior"]) | undefined;
|
|
20162
|
+
/** What `disabled` takes from a row, in a list that selects: `all`, which
|
|
20163
|
+
passes over the row, or `selection`, which keeps the row out of the
|
|
20164
|
+
selection and lets the keys reach it and Enter or a press act on it, as
|
|
20165
|
+
React Aria's GridList takes `disabledBehavior`.
|
|
20166
|
+
|
|
20167
|
+
Absent is `all`. */
|
|
20168
|
+
disabledBehavior?: (HelixList["disabledBehavior"]) | undefined;
|
|
20086
20169
|
/** What screen readers hear when a row is dropped, in a `reorderable` list. */
|
|
20087
20170
|
"dropped-label"?: (HelixList["droppedLabel"]) | undefined;
|
|
20088
20171
|
/** What screen readers hear when a row is dropped, in a `reorderable` list. */
|
|
@@ -20230,6 +20313,20 @@ refused, in a `reorderable` list. */
|
|
|
20230
20313
|
/** What screen readers hear when a held row is put back, or a move is
|
|
20231
20314
|
refused, in a `reorderable` list. */
|
|
20232
20315
|
"prop:canceledLabel"?: (HelixList["canceledLabel"]) | undefined;
|
|
20316
|
+
/** What `disabled` takes from a row, in a list that selects: `all`, which
|
|
20317
|
+
passes over the row, or `selection`, which keeps the row out of the
|
|
20318
|
+
selection and lets the keys reach it and Enter or a press act on it, as
|
|
20319
|
+
React Aria's GridList takes `disabledBehavior`.
|
|
20320
|
+
|
|
20321
|
+
Absent is `all`. */
|
|
20322
|
+
"attr:disabled-behavior"?: (HelixList["disabledBehavior"]) | undefined;
|
|
20323
|
+
/** What `disabled` takes from a row, in a list that selects: `all`, which
|
|
20324
|
+
passes over the row, or `selection`, which keeps the row out of the
|
|
20325
|
+
selection and lets the keys reach it and Enter or a press act on it, as
|
|
20326
|
+
React Aria's GridList takes `disabledBehavior`.
|
|
20327
|
+
|
|
20328
|
+
Absent is `all`. */
|
|
20329
|
+
"prop:disabledBehavior"?: (HelixList["disabledBehavior"]) | undefined;
|
|
20233
20330
|
/** What screen readers hear when a row is dropped, in a `reorderable` list. */
|
|
20234
20331
|
"attr:dropped-label"?: (HelixList["droppedLabel"]) | undefined;
|
|
20235
20332
|
/** What screen readers hear when a row is dropped, in a `reorderable` list. */
|
|
@@ -20620,6 +20717,14 @@ imperatively later, and nothing is hydrating by then.
|
|
|
20620
20717
|
|
|
20621
20718
|
Here rather than on each control. */
|
|
20622
20719
|
name?: (HelixListbox["name"]) | undefined;
|
|
20720
|
+
/** Whether an option is kept by the filter: a function given the option's
|
|
20721
|
+
words and the filter, trimmed, that returns `true` to keep it showing, as
|
|
20722
|
+
React Aria's `Autocomplete` takes `filter`. For matching that ignores
|
|
20723
|
+
accents, matches the start of each word, or matches out of order.
|
|
20724
|
+
|
|
20725
|
+
Absent, an option is kept where its words hold the filter, in any case. A
|
|
20726
|
+
property only, there being no way to write a function in markup. */
|
|
20727
|
+
filterMatch?: (HelixListbox["filterMatch"]) | undefined;
|
|
20623
20728
|
/** The options as data, for a list too long to draw whole: each a value,
|
|
20624
20729
|
which is also its words, or a record with a `value`, a `label` and
|
|
20625
20730
|
`disabled`. Set, the list draws only the options in sight, and the ones
|
|
@@ -20912,6 +21017,14 @@ imperatively later, and nothing is hydrating by then.
|
|
|
20912
21017
|
|
|
20913
21018
|
Here rather than on each control. */
|
|
20914
21019
|
"prop:name"?: (HelixListbox["name"]) | undefined;
|
|
21020
|
+
/** Whether an option is kept by the filter: a function given the option's
|
|
21021
|
+
words and the filter, trimmed, that returns `true` to keep it showing, as
|
|
21022
|
+
React Aria's `Autocomplete` takes `filter`. For matching that ignores
|
|
21023
|
+
accents, matches the start of each word, or matches out of order.
|
|
21024
|
+
|
|
21025
|
+
Absent, an option is kept where its words hold the filter, in any case. A
|
|
21026
|
+
property only, there being no way to write a function in markup. */
|
|
21027
|
+
"prop:filterMatch"?: (HelixListbox["filterMatch"]) | undefined;
|
|
20915
21028
|
/** The options as data, for a list too long to draw whole: each a value,
|
|
20916
21029
|
which is also its words, or a record with a `value`, a `label` and
|
|
20917
21030
|
`disabled`. Set, the list draws only the options in sight, and the ones
|
|
@@ -22595,8 +22708,24 @@ narrow exception the server specs describe covers a mirror that can only
|
|
|
22595
22708
|
become true long after hydration, and a viewport measured before the first
|
|
22596
22709
|
paint is the opposite case. See `MixinControllerOpen` on `open`. */
|
|
22597
22710
|
bandBelow?: (HelixMegamenu["bandBelow"]) | undefined;
|
|
22711
|
+
/** How long a pointer leaving the trigger and the panel waits before the panel
|
|
22712
|
+
closes, in milliseconds. The pointer needs the time to cross from the
|
|
22713
|
+
trigger to the panel. */
|
|
22714
|
+
"close-delay"?: (HelixMegamenu["closeDelay"] | `${number}`) | undefined;
|
|
22715
|
+
/** How long a pointer leaving the trigger and the panel waits before the panel
|
|
22716
|
+
closes, in milliseconds. The pointer needs the time to cross from the
|
|
22717
|
+
trigger to the panel. */
|
|
22718
|
+
closeDelay?: (HelixMegamenu["closeDelay"]) | undefined;
|
|
22598
22719
|
/** The section's name, used for the default trigger and the panel. */
|
|
22599
22720
|
label?: (HelixMegamenu["label"]) | undefined;
|
|
22721
|
+
/** How long a pointer rests on the trigger before the panel opens, in
|
|
22722
|
+
milliseconds, under `open-on="hover"`. A pointer crossing the bar on its
|
|
22723
|
+
way somewhere else opens nothing. */
|
|
22724
|
+
"open-delay"?: (HelixMegamenu["openDelay"] | `${number}`) | undefined;
|
|
22725
|
+
/** How long a pointer rests on the trigger before the panel opens, in
|
|
22726
|
+
milliseconds, under `open-on="hover"`. A pointer crossing the bar on its
|
|
22727
|
+
way somewhere else opens nothing. */
|
|
22728
|
+
openDelay?: (HelixMegamenu["openDelay"]) | undefined;
|
|
22600
22729
|
/** Whether hovering over the trigger opens the panel (`hover`), or only a press
|
|
22601
22730
|
does (`click`).
|
|
22602
22731
|
|
|
@@ -22613,6 +22742,10 @@ the trigger, and it is the default because that is what a navigation bar
|
|
|
22613
22742
|
does. `click` is for a trigger that does something else as well, or a panel
|
|
22614
22743
|
heavy enough that opening it on the way past is rude. */
|
|
22615
22744
|
openOn?: (HelixMegamenu["openOn"]) | undefined;
|
|
22745
|
+
/** The side of the trigger a card panel opens on, when there is room. It
|
|
22746
|
+
moves if that side does not fit. A band ignores it, since a band spans the
|
|
22747
|
+
page under its bar. */
|
|
22748
|
+
placement?: (HelixMegamenu["placement"]) | undefined;
|
|
22616
22749
|
/** Whether the panel is a card under the trigger or a band across the page.
|
|
22617
22750
|
|
|
22618
22751
|
The resting one is the card, hanging off the trigger and as wide as it
|
|
@@ -22713,8 +22846,24 @@ narrow exception the server specs describe covers a mirror that can only
|
|
|
22713
22846
|
become true long after hydration, and a viewport measured before the first
|
|
22714
22847
|
paint is the opposite case. See `MixinControllerOpen` on `open`. */
|
|
22715
22848
|
"prop:bandBelow"?: (HelixMegamenu["bandBelow"]) | undefined;
|
|
22849
|
+
/** How long a pointer leaving the trigger and the panel waits before the panel
|
|
22850
|
+
closes, in milliseconds. The pointer needs the time to cross from the
|
|
22851
|
+
trigger to the panel. */
|
|
22852
|
+
"attr:close-delay"?: (HelixMegamenu["closeDelay"] | `${number}`) | undefined;
|
|
22853
|
+
/** How long a pointer leaving the trigger and the panel waits before the panel
|
|
22854
|
+
closes, in milliseconds. The pointer needs the time to cross from the
|
|
22855
|
+
trigger to the panel. */
|
|
22856
|
+
"prop:closeDelay"?: (HelixMegamenu["closeDelay"]) | undefined;
|
|
22716
22857
|
/** The section's name, used for the default trigger and the panel. */
|
|
22717
22858
|
"prop:label"?: (HelixMegamenu["label"]) | undefined;
|
|
22859
|
+
/** How long a pointer rests on the trigger before the panel opens, in
|
|
22860
|
+
milliseconds, under `open-on="hover"`. A pointer crossing the bar on its
|
|
22861
|
+
way somewhere else opens nothing. */
|
|
22862
|
+
"attr:open-delay"?: (HelixMegamenu["openDelay"] | `${number}`) | undefined;
|
|
22863
|
+
/** How long a pointer rests on the trigger before the panel opens, in
|
|
22864
|
+
milliseconds, under `open-on="hover"`. A pointer crossing the bar on its
|
|
22865
|
+
way somewhere else opens nothing. */
|
|
22866
|
+
"prop:openDelay"?: (HelixMegamenu["openDelay"]) | undefined;
|
|
22718
22867
|
/** Whether hovering over the trigger opens the panel (`hover`), or only a press
|
|
22719
22868
|
does (`click`).
|
|
22720
22869
|
|
|
@@ -22731,6 +22880,10 @@ the trigger, and it is the default because that is what a navigation bar
|
|
|
22731
22880
|
does. `click` is for a trigger that does something else as well, or a panel
|
|
22732
22881
|
heavy enough that opening it on the way past is rude. */
|
|
22733
22882
|
"prop:openOn"?: (HelixMegamenu["openOn"]) | undefined;
|
|
22883
|
+
/** The side of the trigger a card panel opens on, when there is room. It
|
|
22884
|
+
moves if that side does not fit. A band ignores it, since a band spans the
|
|
22885
|
+
page under its bar. */
|
|
22886
|
+
"prop:placement"?: (HelixMegamenu["placement"]) | undefined;
|
|
22734
22887
|
/** Whether the panel is a card under the trigger or a band across the page.
|
|
22735
22888
|
|
|
22736
22889
|
The resting one is the card, hanging off the trigger and as wide as it
|
|
@@ -22989,12 +23142,29 @@ Empty by default, which names the surface by its trigger, so a menu opened
|
|
|
22989
23142
|
from "Actions" is announced as "Actions". An `aria-label` or
|
|
22990
23143
|
`aria-labelledby` on the host names it too, and wins over both. */
|
|
22991
23144
|
label?: (HelixMenu["label"]) | undefined;
|
|
23145
|
+
/** The description a trigger gives under `open-on="long-press"`, saying how
|
|
23146
|
+
to open the menu. Translate it with the rest of your interface. */
|
|
23147
|
+
"long-press-label"?: (HelixMenu["longPressLabel"]) | undefined;
|
|
23148
|
+
/** The description a trigger gives under `open-on="long-press"`, saying how
|
|
23149
|
+
to open the menu. Translate it with the rest of your interface. */
|
|
23150
|
+
longPressLabel?: (HelixMenu["longPressLabel"]) | undefined;
|
|
22992
23151
|
/** Space between the trigger and the surface, in pixels. */
|
|
22993
23152
|
offset?: (HelixMenu["offset"]) | undefined;
|
|
23153
|
+
/** What opens the menu from its trigger. `long-press` leaves a press to the
|
|
23154
|
+
trigger's own action and opens the menu on a press held for half a second,
|
|
23155
|
+
or on Alt+Down or Alt+Up. */
|
|
23156
|
+
"open-on"?: (HelixMenu["openOn"]) | undefined;
|
|
23157
|
+
/** What opens the menu from its trigger. `long-press` leaves a press to the
|
|
23158
|
+
trigger's own action and opens the menu on a press held for half a second,
|
|
23159
|
+
or on Alt+Down or Alt+Up. */
|
|
23160
|
+
openOn?: (HelixMenu["openOn"]) | undefined;
|
|
22994
23161
|
/** The side the menu opens on, when there is room.
|
|
22995
23162
|
|
|
22996
23163
|
It moves if that side does not fit. */
|
|
22997
23164
|
placement?: (HelixMenu["placement"]) | undefined;
|
|
23165
|
+
/** How a submenu opens. `drill` shows it in place of the page showing, with
|
|
23166
|
+
a way back. `flyout` opens it in a panel of its own beside its row. */
|
|
23167
|
+
submenus?: (HelixMenu["submenus"]) | undefined;
|
|
22998
23168
|
|
|
22999
23169
|
/** The menu opened or closed. The event carries `newState` and `oldState`. */
|
|
23000
23170
|
ontoggle?: ((e: HelixMenuToggleElementEvent) => void) | undefined;
|
|
@@ -23051,12 +23221,29 @@ Empty by default, which names the surface by its trigger, so a menu opened
|
|
|
23051
23221
|
from "Actions" is announced as "Actions". An `aria-label` or
|
|
23052
23222
|
`aria-labelledby` on the host names it too, and wins over both. */
|
|
23053
23223
|
"prop:label"?: (HelixMenu["label"]) | undefined;
|
|
23224
|
+
/** The description a trigger gives under `open-on="long-press"`, saying how
|
|
23225
|
+
to open the menu. Translate it with the rest of your interface. */
|
|
23226
|
+
"attr:long-press-label"?: (HelixMenu["longPressLabel"]) | undefined;
|
|
23227
|
+
/** The description a trigger gives under `open-on="long-press"`, saying how
|
|
23228
|
+
to open the menu. Translate it with the rest of your interface. */
|
|
23229
|
+
"prop:longPressLabel"?: (HelixMenu["longPressLabel"]) | undefined;
|
|
23054
23230
|
/** Space between the trigger and the surface, in pixels. */
|
|
23055
23231
|
"prop:offset"?: (HelixMenu["offset"]) | undefined;
|
|
23232
|
+
/** What opens the menu from its trigger. `long-press` leaves a press to the
|
|
23233
|
+
trigger's own action and opens the menu on a press held for half a second,
|
|
23234
|
+
or on Alt+Down or Alt+Up. */
|
|
23235
|
+
"attr:open-on"?: (HelixMenu["openOn"]) | undefined;
|
|
23236
|
+
/** What opens the menu from its trigger. `long-press` leaves a press to the
|
|
23237
|
+
trigger's own action and opens the menu on a press held for half a second,
|
|
23238
|
+
or on Alt+Down or Alt+Up. */
|
|
23239
|
+
"prop:openOn"?: (HelixMenu["openOn"]) | undefined;
|
|
23056
23240
|
/** The side the menu opens on, when there is room.
|
|
23057
23241
|
|
|
23058
23242
|
It moves if that side does not fit. */
|
|
23059
23243
|
"prop:placement"?: (HelixMenu["placement"]) | undefined;
|
|
23244
|
+
/** How a submenu opens. `drill` shows it in place of the page showing, with
|
|
23245
|
+
a way back. `flyout` opens it in a panel of its own beside its row. */
|
|
23246
|
+
"prop:submenus"?: (HelixMenu["submenus"]) | undefined;
|
|
23060
23247
|
/** The menu opened or closed. The event carries `newState` and `oldState`. */
|
|
23061
23248
|
"on:toggle"?: ((e: HelixMenuToggleElementEvent) => void) | undefined;
|
|
23062
23249
|
/** The menu is about to close. Cancelable: cancel it to keep it open. */
|
|
@@ -23850,6 +24037,12 @@ say that without the component knowing what a row looks like. */
|
|
|
23850
24037
|
"loading-text"?: (HelixNotifications["loadingText"]) | undefined;
|
|
23851
24038
|
/** The text shown and announced while the rows load. */
|
|
23852
24039
|
loadingText?: (HelixNotifications["loadingText"]) | undefined;
|
|
24040
|
+
/** What the feed says when unread notifications arrive, with `{count}` the
|
|
24041
|
+
number of them. Empty it to say nothing. */
|
|
24042
|
+
"arrived-label"?: (HelixNotifications["arrivedLabel"]) | undefined;
|
|
24043
|
+
/** What the feed says when unread notifications arrive, with `{count}` the
|
|
24044
|
+
number of them. Empty it to say nothing. */
|
|
24045
|
+
arrivedLabel?: (HelixNotifications["arrivedLabel"]) | undefined;
|
|
23853
24046
|
/** The region's name where `label` is empty. */
|
|
23854
24047
|
"fallback-label"?: (HelixNotifications["fallbackLabel"]) | undefined;
|
|
23855
24048
|
/** The region's name where `label` is empty. */
|
|
@@ -23931,6 +24124,12 @@ say that without the component knowing what a row looks like. */
|
|
|
23931
24124
|
"attr:loading-text"?: (HelixNotifications["loadingText"]) | undefined;
|
|
23932
24125
|
/** The text shown and announced while the rows load. */
|
|
23933
24126
|
"prop:loadingText"?: (HelixNotifications["loadingText"]) | undefined;
|
|
24127
|
+
/** What the feed says when unread notifications arrive, with `{count}` the
|
|
24128
|
+
number of them. Empty it to say nothing. */
|
|
24129
|
+
"attr:arrived-label"?: (HelixNotifications["arrivedLabel"]) | undefined;
|
|
24130
|
+
/** What the feed says when unread notifications arrive, with `{count}` the
|
|
24131
|
+
number of them. Empty it to say nothing. */
|
|
24132
|
+
"prop:arrivedLabel"?: (HelixNotifications["arrivedLabel"]) | undefined;
|
|
23934
24133
|
/** The region's name where `label` is empty. */
|
|
23935
24134
|
"attr:fallback-label"?: (HelixNotifications["fallbackLabel"]) | undefined;
|
|
23936
24135
|
/** The region's name where `label` is empty. */
|
|
@@ -24257,8 +24456,11 @@ imperatively later, and nothing is hydrating by then.
|
|
|
24257
24456
|
|
|
24258
24457
|
Here rather than on each control. */
|
|
24259
24458
|
name?: (HelixNumberInput["name"]) | undefined;
|
|
24260
|
-
/** The value as a number, or `NaN` while the control is empty
|
|
24459
|
+
/** The value as a number, or `NaN` while the control is empty or does not
|
|
24460
|
+
hold a number.
|
|
24261
24461
|
|
|
24462
|
+
Read in the locale and the format, as the form reads it, so `1,5` typed
|
|
24463
|
+
in a locale with a decimal comma is 1.5 here while the form holds 1.5.
|
|
24262
24464
|
`NaN` and not zero, which is the trap the platform already avoids: `Number('')`
|
|
24263
24465
|
is zero, so an empty control would report a number it does not hold and a
|
|
24264
24466
|
form would submit it. */
|
|
@@ -24532,8 +24734,11 @@ imperatively later, and nothing is hydrating by then.
|
|
|
24532
24734
|
|
|
24533
24735
|
Here rather than on each control. */
|
|
24534
24736
|
"prop:name"?: (HelixNumberInput["name"]) | undefined;
|
|
24535
|
-
/** The value as a number, or `NaN` while the control is empty
|
|
24737
|
+
/** The value as a number, or `NaN` while the control is empty or does not
|
|
24738
|
+
hold a number.
|
|
24536
24739
|
|
|
24740
|
+
Read in the locale and the format, as the form reads it, so `1,5` typed
|
|
24741
|
+
in a locale with a decimal comma is 1.5 here while the form holds 1.5.
|
|
24537
24742
|
`NaN` and not zero, which is the trap the platform already avoids: `Number('')`
|
|
24538
24743
|
is zero, so an empty control would report a number it does not hold and a
|
|
24539
24744
|
form would submit it. */
|
|
@@ -29880,7 +30085,8 @@ control height until you size it, with a height on the element or
|
|
|
29880
30085
|
/** What is loading, read out as the placeholder's name, such as "Loading
|
|
29881
30086
|
profile".
|
|
29882
30087
|
|
|
29883
|
-
Absent hides the placeholder from screen readers.
|
|
30088
|
+
Absent hides the placeholder from screen readers. Around content, the name
|
|
30089
|
+
is read while `loading` is set, and the loaded content is read as it is. */
|
|
29884
30090
|
label?: (HelixSkeleton["label"]) | undefined;
|
|
29885
30091
|
/** Whether the content inside is still loading, which keeps it inert and
|
|
29886
30092
|
draws the placeholder over it.
|
|
@@ -29910,7 +30116,8 @@ control height until you size it, with a height on the element or
|
|
|
29910
30116
|
/** What is loading, read out as the placeholder's name, such as "Loading
|
|
29911
30117
|
profile".
|
|
29912
30118
|
|
|
29913
|
-
Absent hides the placeholder from screen readers.
|
|
30119
|
+
Absent hides the placeholder from screen readers. Around content, the name
|
|
30120
|
+
is read while `loading` is set, and the loaded content is read as it is. */
|
|
29914
30121
|
"prop:label"?: (HelixSkeleton["label"]) | undefined;
|
|
29915
30122
|
/** Whether the content inside is still loading, which keeps it inert and
|
|
29916
30123
|
draws the placeholder over it.
|
|
@@ -35822,6 +36029,10 @@ attribute nobody can use. */
|
|
|
35822
36029
|
|
|
35823
36030
|
A subset of the tone axis: a toast reports a status and never a brand role. */
|
|
35824
36031
|
tone?: (HelixToastItem["tone"]) | undefined;
|
|
36032
|
+
/** Whether the region holds the message back, because more messages are
|
|
36033
|
+
showing than its `max-visible`. The region sets it. A waiting message is
|
|
36034
|
+
hidden, its timer has not started, and it is said once it shows. */
|
|
36035
|
+
waiting?: (HelixToastItem["waiting"]) | undefined;
|
|
35825
36036
|
|
|
35826
36037
|
/** Fired when the message is dismissed, by the control or by its timer, and cancelable. Canceling it keeps the message. */
|
|
35827
36038
|
"onhelix-dismiss"?: ((e: HelixToastItemHelixDismissElementEvent) => void) | undefined;
|
|
@@ -35874,6 +36085,10 @@ attribute nobody can use. */
|
|
|
35874
36085
|
|
|
35875
36086
|
A subset of the tone axis: a toast reports a status and never a brand role. */
|
|
35876
36087
|
"prop:tone"?: (HelixToastItem["tone"]) | undefined;
|
|
36088
|
+
/** Whether the region holds the message back, because more messages are
|
|
36089
|
+
showing than its `max-visible`. The region sets it. A waiting message is
|
|
36090
|
+
hidden, its timer has not started, and it is said once it shows. */
|
|
36091
|
+
"prop:waiting"?: (HelixToastItem["waiting"]) | undefined;
|
|
35877
36092
|
/** Fired when the message is dismissed, by the control or by its timer, and cancelable. Canceling it keeps the message. */
|
|
35878
36093
|
"on:helix-dismiss"?: ((e: HelixToastItemHelixDismissElementEvent) => void) | undefined;
|
|
35879
36094
|
|
|
@@ -35898,6 +36113,14 @@ Empty turns it off. */
|
|
|
35898
36113
|
/** Accessible name for the region, with `{hotkey}` filled in. Translate it with
|
|
35899
36114
|
the rest of your interface. */
|
|
35900
36115
|
label?: (HelixToast["label"]) | undefined;
|
|
36116
|
+
/** How many messages show at once. The messages after that many wait, hidden
|
|
36117
|
+
and with their timers stopped, until a message before them goes. Unset,
|
|
36118
|
+
every message shows. */
|
|
36119
|
+
"max-visible"?: (HelixToast["maxVisible"] | `${number}`) | undefined;
|
|
36120
|
+
/** How many messages show at once. The messages after that many wait, hidden
|
|
36121
|
+
and with their timers stopped, until a message before them goes. Unset,
|
|
36122
|
+
every message shows. */
|
|
36123
|
+
maxVisible?: (HelixToast["maxVisible"]) | undefined;
|
|
35901
36124
|
/** Which corner or edge the stack sits at.
|
|
35902
36125
|
|
|
35903
36126
|
Named here rather than on each message, because where a page puts its
|
|
@@ -35937,6 +36160,14 @@ Empty turns it off. */
|
|
|
35937
36160
|
/** Accessible name for the region, with `{hotkey}` filled in. Translate it with
|
|
35938
36161
|
the rest of your interface. */
|
|
35939
36162
|
"prop:label"?: (HelixToast["label"]) | undefined;
|
|
36163
|
+
/** How many messages show at once. The messages after that many wait, hidden
|
|
36164
|
+
and with their timers stopped, until a message before them goes. Unset,
|
|
36165
|
+
every message shows. */
|
|
36166
|
+
"attr:max-visible"?: (HelixToast["maxVisible"] | `${number}`) | undefined;
|
|
36167
|
+
/** How many messages show at once. The messages after that many wait, hidden
|
|
36168
|
+
and with their timers stopped, until a message before them goes. Unset,
|
|
36169
|
+
every message shows. */
|
|
36170
|
+
"prop:maxVisible"?: (HelixToast["maxVisible"]) | undefined;
|
|
35940
36171
|
/** Which corner or edge the stack sits at.
|
|
35941
36172
|
|
|
35942
36173
|
Named here rather than on each message, because where a page puts its
|
|
@@ -45905,6 +46136,12 @@ export type CustomElements = {
|
|
|
45905
46136
|
* how many are left, written in the locale, and each language writes the
|
|
45906
46137
|
* forms it has: `{count, plural, one {# polecenie} few {# polecenia} many
|
|
45907
46138
|
* {# poleceń} other {# polecenia}}`.
|
|
46139
|
+
* - `filterMatch`: Whether a command is kept by the filter: a function given the command's
|
|
46140
|
+
* words and the filter, trimmed, that returns `true` to keep it showing, as
|
|
46141
|
+
* React Aria's `Autocomplete` takes `filter`. See Listbox's `filterMatch`.
|
|
46142
|
+
*
|
|
46143
|
+
* Absent, a command is kept where its words hold the filter, in any case. A
|
|
46144
|
+
* property only, there being no way to write a function in markup. (property only)
|
|
45908
46145
|
* - `items`: The commands as data, for a palette too long to draw whole: each a value,
|
|
45909
46146
|
* which is also its words, or a record with a `value`, a `label` and
|
|
45910
46147
|
* `disabled`. Handed to the list, which draws only the commands in sight and
|
|
@@ -46003,6 +46240,7 @@ export type CustomElements = {
|
|
|
46003
46240
|
* - `listbox-loading`: The text shown while the commands are loading.
|
|
46004
46241
|
* - `listbox-search`: The region that holds the filter field.
|
|
46005
46242
|
* - `listbox-search-field`: The filter field.
|
|
46243
|
+
* - `live`: The region a screen reader announces the page shown from, by the words of the command that opens it, drawn once there is one to say. Visually hidden in the styled tier.
|
|
46006
46244
|
*
|
|
46007
46245
|
* ## CSS States
|
|
46008
46246
|
*
|
|
@@ -48542,6 +48780,12 @@ export type CustomElements = {
|
|
|
48542
48780
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
48543
48781
|
*
|
|
48544
48782
|
* - `disabled`: Whether the row can be reached at all.
|
|
48783
|
+
* - `download`: Whether the link downloads the file when the row is chosen. Only
|
|
48784
|
+
* meaningful beside an `href`, and only for a file served from this origin.
|
|
48785
|
+
* - `href`: The URL the row links to. Setting it renders the row as a link, unless the
|
|
48786
|
+
* row opens a page or is disabled.
|
|
48787
|
+
* - `rel`: The link's `rel`. Set it whenever you set `target="_blank"`.
|
|
48788
|
+
* - `target`: Where the link opens, for rows that should open outside the current page.
|
|
48545
48789
|
* - `value`: Identifies the row to your event listeners.
|
|
48546
48790
|
* - `focusable`: Whether this row holds the region's tab stop. Set by the drill-down.
|
|
48547
48791
|
*
|
|
@@ -48628,7 +48872,7 @@ export type CustomElements = {
|
|
|
48628
48872
|
*
|
|
48629
48873
|
* Custom selectors for styling elements within the component.
|
|
48630
48874
|
*
|
|
48631
|
-
* - `item`: The row itself.
|
|
48875
|
+
* - `item`: The row itself, which is an `<a>` where `href` is set.
|
|
48632
48876
|
* - `label`: The row's label.
|
|
48633
48877
|
* - `mark`: The caret at the end of a row that opens a page, after the `end` slot. The caret points, so a stylesheet mirrors it in a right-to-left document.
|
|
48634
48878
|
*
|
|
@@ -48667,6 +48911,12 @@ export type CustomElements = {
|
|
|
48667
48911
|
* An `aria-label` or `aria-labelledby` on the host names the top page too,
|
|
48668
48912
|
* and wins over this.
|
|
48669
48913
|
* - `back-label`/`backLabel`: The text of the back button.
|
|
48914
|
+
* - `navigation`: Whether the drilldown is a site's navigation: a `navigation` landmark
|
|
48915
|
+
* named by `label`, whose pages are lists of links. Without it, each page is
|
|
48916
|
+
* a `menu`.
|
|
48917
|
+
* - `page`: The page showing, as the `value` of the row that opens it. Empty is the
|
|
48918
|
+
* top page. Setting it shows that page, and a value no row with a page has
|
|
48919
|
+
* shows the top page.
|
|
48670
48920
|
* - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
|
|
48671
48921
|
*
|
|
48672
48922
|
* **Named `whenSettled` because `settled` is taken four times over**, by
|
|
@@ -48692,6 +48942,7 @@ export type CustomElements = {
|
|
|
48692
48942
|
*
|
|
48693
48943
|
* Events that will be emitted by the component.
|
|
48694
48944
|
*
|
|
48945
|
+
* - `helix-navigate`: Fired before a reader moves into a page or back out of one. `detail.value` is the `value` of the row whose page is about to show, empty for the top page. Cancelable: cancel it to stay on the page showing.
|
|
48695
48946
|
* - `helix-select`: Fired when a row with no page is chosen. Cancelable: canceling it stops the change and leaves the decision to you.
|
|
48696
48947
|
*
|
|
48697
48948
|
* ## Slots
|
|
@@ -49468,6 +49719,7 @@ export type CustomElements = {
|
|
|
49468
49719
|
* - `entry-shortcut-key`: One key of the shortcut's chord.
|
|
49469
49720
|
* - `entry-shortcut-separator`: The `+` between two keys of the shortcut, where the platform writes one.
|
|
49470
49721
|
* - `entry-start`: The leading column.
|
|
49722
|
+
* - `entry-surface`: The panel a row's submenu opens in beside it. The filter menu's rows have none.
|
|
49471
49723
|
* - `menu`: The menu the fields are offered in.
|
|
49472
49724
|
* - `menu-back`: The button that goes back from a field's page.
|
|
49473
49725
|
* - `menu-back-mark`: The icon on the back button.
|
|
@@ -52830,7 +53082,9 @@ export type CustomElements = {
|
|
|
52830
53082
|
* Not reflected, as a state never is. `row-current` is the part a
|
|
52831
53083
|
* stylesheet draws it from.
|
|
52832
53084
|
* - `disabled`: Takes the row out of reach in a list with `selection-mode`: the arrow keys
|
|
52833
|
-
* pass over it and it cannot be selected or acted on.
|
|
53085
|
+
* pass over it and it cannot be selected or acted on. In a list with
|
|
53086
|
+
* `disabled-behavior="selection"`, it cannot be selected and is reached and
|
|
53087
|
+
* acted on as any row is.
|
|
52834
53088
|
* - `href`: The URL the row links to. Leave it empty for a row that is not a link.
|
|
52835
53089
|
*
|
|
52836
53090
|
* Empty rather than optional, and unset by default: a list is not always a
|
|
@@ -52857,6 +53111,9 @@ export type CustomElements = {
|
|
|
52857
53111
|
*
|
|
52858
53112
|
* Written by the list from its own `value`, and unset where nothing can be
|
|
52859
53113
|
* selected, which keeps `aria-selected` off a list that does not select. (property only)
|
|
53114
|
+
* - `selectionOnly`: Whether `disabled` takes the row out of selection alone, written by a list
|
|
53115
|
+
* with `disabled-behavior="selection"`. No attribute: it is coordination
|
|
53116
|
+
* between elements, as `focusable` is. (property only)
|
|
52860
53117
|
* - `words`: The row's words, or none where the children are not known yet. (property only) (readonly)
|
|
52861
53118
|
* - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
|
|
52862
53119
|
*
|
|
@@ -52934,6 +53191,7 @@ export type CustomElements = {
|
|
|
52934
53191
|
* - `dragging`: The row is being moved, in a `reorderable` list.
|
|
52935
53192
|
* - `drop-after`: The row being moved goes after this one when it is dropped.
|
|
52936
53193
|
* - `drop-before`: The row being moved goes before this one when it is dropped.
|
|
53194
|
+
* - `focus-visible`: The row's cell has keyboard focus that the browser shows, in a list with `selection-mode`.
|
|
52937
53195
|
* - `selected`: The row is selected, in a list that selects.
|
|
52938
53196
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
52939
53197
|
*/
|
|
@@ -52966,6 +53224,12 @@ export type CustomElements = {
|
|
|
52966
53224
|
* `unordered` too, where it numbers what a bullet did not.
|
|
52967
53225
|
* - `canceled-label`/`canceledLabel`: What screen readers hear when a held row is put back, or a move is
|
|
52968
53226
|
* refused, in a `reorderable` list.
|
|
53227
|
+
* - `disabled-behavior`/`disabledBehavior`: What `disabled` takes from a row, in a list that selects: `all`, which
|
|
53228
|
+
* passes over the row, or `selection`, which keeps the row out of the
|
|
53229
|
+
* selection and lets the keys reach it and Enter or a press act on it, as
|
|
53230
|
+
* React Aria's GridList takes `disabledBehavior`.
|
|
53231
|
+
*
|
|
53232
|
+
* Absent is `all`.
|
|
52969
53233
|
* - `dropped-label`/`droppedLabel`: What screen readers hear when a row is dropped, in a `reorderable` list.
|
|
52970
53234
|
* - `empty-label`/`emptyLabel`: The text of the row shown while the list has no rows, where the `empty`
|
|
52971
53235
|
* slot is empty. Empty, the default, shows no row.
|
|
@@ -53265,6 +53529,13 @@ export type CustomElements = {
|
|
|
53265
53529
|
* imperatively later, and nothing is hydrating by then.
|
|
53266
53530
|
*
|
|
53267
53531
|
* Here rather than on each control.
|
|
53532
|
+
* - `filterMatch`: Whether an option is kept by the filter: a function given the option's
|
|
53533
|
+
* words and the filter, trimmed, that returns `true` to keep it showing, as
|
|
53534
|
+
* React Aria's `Autocomplete` takes `filter`. For matching that ignores
|
|
53535
|
+
* accents, matches the start of each word, or matches out of order.
|
|
53536
|
+
*
|
|
53537
|
+
* Absent, an option is kept where its words hold the filter, in any case. A
|
|
53538
|
+
* property only, there being no way to write a function in markup. (property only)
|
|
53268
53539
|
* - `items`: The options as data, for a list too long to draw whole: each a value,
|
|
53269
53540
|
* which is also its words, or a record with a `value`, a `label` and
|
|
53270
53541
|
* `disabled`. Set, the list draws only the options in sight, and the ones
|
|
@@ -53301,7 +53572,10 @@ export type CustomElements = {
|
|
|
53301
53572
|
* Descendants rather than children, because a group puts a level between the
|
|
53302
53573
|
* list and its options and the keyboard has to move through a grouped list
|
|
53303
53574
|
* exactly as it moves through a flat one. (property only) (readonly)
|
|
53304
|
-
* - `values`: The chosen values, as an array whether or not `multiple` is set.
|
|
53575
|
+
* - `values`: The chosen values, as an array whether or not `multiple` is set.
|
|
53576
|
+
*
|
|
53577
|
+
* Read against the options' values, so an option whose value holds a comma
|
|
53578
|
+
* is one value. See `chosenValues`. (property only) (readonly)
|
|
53305
53579
|
* - `validity`: Whether the control meets its constraints, and why not. (property only) (readonly)
|
|
53306
53580
|
* - `validationMessage`: The message the browser would show for the control, or an empty string. (property only) (readonly)
|
|
53307
53581
|
* - `willValidate`: Whether the control is checked when its form is submitted. (property only) (readonly)
|
|
@@ -54683,7 +54957,13 @@ export type CustomElements = {
|
|
|
54683
54957
|
* narrow exception the server specs describe covers a mirror that can only
|
|
54684
54958
|
* become true long after hydration, and a viewport measured before the first
|
|
54685
54959
|
* paint is the opposite case. See `MixinControllerOpen` on `open`.
|
|
54960
|
+
* - `close-delay`/`closeDelay`: How long a pointer leaving the trigger and the panel waits before the panel
|
|
54961
|
+
* closes, in milliseconds. The pointer needs the time to cross from the
|
|
54962
|
+
* trigger to the panel.
|
|
54686
54963
|
* - `label`: The section's name, used for the default trigger and the panel.
|
|
54964
|
+
* - `open-delay`/`openDelay`: How long a pointer rests on the trigger before the panel opens, in
|
|
54965
|
+
* milliseconds, under `open-on="hover"`. A pointer crossing the bar on its
|
|
54966
|
+
* way somewhere else opens nothing.
|
|
54687
54967
|
* - `open-on`/`openOn`: Whether hovering over the trigger opens the panel (`hover`), or only a press
|
|
54688
54968
|
* does (`click`).
|
|
54689
54969
|
*
|
|
@@ -54691,6 +54971,9 @@ export type CustomElements = {
|
|
|
54691
54971
|
* the trigger, and it is the default because that is what a navigation bar
|
|
54692
54972
|
* does. `click` is for a trigger that does something else as well, or a panel
|
|
54693
54973
|
* heavy enough that opening it on the way past is rude.
|
|
54974
|
+
* - `placement`: The side of the trigger a card panel opens on, when there is room. It
|
|
54975
|
+
* moves if that side does not fit. A band ignores it, since a band spans the
|
|
54976
|
+
* page under its bar.
|
|
54694
54977
|
* - `variant`: Whether the panel is a card under the trigger or a band across the page.
|
|
54695
54978
|
*
|
|
54696
54979
|
* The resting one is the card, hanging off the trigger and as wide as it
|
|
@@ -54803,6 +55086,7 @@ export type CustomElements = {
|
|
|
54803
55086
|
*
|
|
54804
55087
|
* These can be used to apply styling when a component is in a given state.
|
|
54805
55088
|
*
|
|
55089
|
+
* - `current`: A link in the panel carries `aria-current="page"`, so the trigger can show the section you are in.
|
|
54806
55090
|
* - `from-end`: The panel opened in place of one earlier in the bar, so it can enter from the end side.
|
|
54807
55091
|
* - `from-start`: The panel opened in place of one later in the bar, so it can enter from the start side.
|
|
54808
55092
|
* - `narrow`: The page is narrower than `band-below`, so the panel is shown as a band whatever its variant.
|
|
@@ -54973,12 +55257,15 @@ export type CustomElements = {
|
|
|
54973
55257
|
* - `shortcut-key`: One key of the shortcut's chord, such as `Ctrl`.
|
|
54974
55258
|
* - `shortcut-separator`: The `+` between two keys of the shortcut, where the platform writes one.
|
|
54975
55259
|
* - `start`: The leading column that holds the `start` slot. It is always rendered.
|
|
55260
|
+
* - `surface`: The panel a submenu opens in beside the row, under the menu's `submenus="flyout"`.
|
|
54976
55261
|
*
|
|
54977
55262
|
* ## CSS States
|
|
54978
55263
|
*
|
|
54979
55264
|
* These can be used to apply styling when a component is in a given state.
|
|
54980
55265
|
*
|
|
54981
55266
|
* - `checked`: The row is checked.
|
|
55267
|
+
* - `submenu-mark`: Under `submenus="flyout"`, a row in this row's submenu can be ticked or opens a submenu, so the submenu keeps its trailing column.
|
|
55268
|
+
* - `submenu-start`: Under `submenus="flyout"`, a row in this row's submenu has content before its label, so the submenu keeps its leading column.
|
|
54982
55269
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
54983
55270
|
*/
|
|
54984
55271
|
"helix-menu-item": Partial<
|
|
@@ -55024,10 +55311,17 @@ export type CustomElements = {
|
|
|
55024
55311
|
* Empty by default, which names the surface by its trigger, so a menu opened
|
|
55025
55312
|
* from "Actions" is announced as "Actions". An `aria-label` or
|
|
55026
55313
|
* `aria-labelledby` on the host names it too, and wins over both.
|
|
55314
|
+
* - `long-press-label`/`longPressLabel`: The description a trigger gives under `open-on="long-press"`, saying how
|
|
55315
|
+
* to open the menu. Translate it with the rest of your interface.
|
|
55027
55316
|
* - `offset`: Space between the trigger and the surface, in pixels.
|
|
55317
|
+
* - `open-on`/`openOn`: What opens the menu from its trigger. `long-press` leaves a press to the
|
|
55318
|
+
* trigger's own action and opens the menu on a press held for half a second,
|
|
55319
|
+
* or on Alt+Down or Alt+Up.
|
|
55028
55320
|
* - `placement`: The side the menu opens on, when there is room.
|
|
55029
55321
|
*
|
|
55030
55322
|
* It moves if that side does not fit.
|
|
55323
|
+
* - `submenus`: How a submenu opens. `drill` shows it in place of the page showing, with
|
|
55324
|
+
* a way back. `flyout` opens it in a panel of its own beside its row.
|
|
55031
55325
|
* - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
|
|
55032
55326
|
*
|
|
55033
55327
|
* **Named `whenSettled` because `settled` is taken four times over**, by
|
|
@@ -55114,6 +55408,10 @@ export type CustomElements = {
|
|
|
55114
55408
|
* - `drilled`: A submenu's page is showing, so content that is not a row can hide with the top page.
|
|
55115
55409
|
* - `mark`: A row on the current page has a checkbox or a link, so every row keeps the trailing column.
|
|
55116
55410
|
* - `open`: While the menu is open.
|
|
55411
|
+
* - `placed-bottom`: While the open panel sits below its trigger.
|
|
55412
|
+
* - `placed-left`: While the open panel sits to the left of its trigger.
|
|
55413
|
+
* - `placed-right`: While the open panel sits to the right of its trigger.
|
|
55414
|
+
* - `placed-top`: While the open panel sits above its trigger.
|
|
55117
55415
|
* - `start`: A row on the current page has content in its leading column, so every row keeps that column.
|
|
55118
55416
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
55119
55417
|
*/
|
|
@@ -55837,6 +56135,8 @@ export type CustomElements = {
|
|
|
55837
56135
|
* are dimmed rather than removed while a new set arrives, and only CSS can
|
|
55838
56136
|
* say that without the component knowing what a row looks like.
|
|
55839
56137
|
* - `loading-text`/`loadingText`: The text shown and announced while the rows load.
|
|
56138
|
+
* - `arrived-label`/`arrivedLabel`: What the feed says when unread notifications arrive, with `{count}` the
|
|
56139
|
+
* number of them. Empty it to say nothing.
|
|
55840
56140
|
* - `fallback-label`/`fallbackLabel`: The region's name where `label` is empty.
|
|
55841
56141
|
* - `label`: The feed's name, read by screen readers.
|
|
55842
56142
|
* - `load-error`/`loadError`: What the feed says when a page of it could not be loaded, such as after a
|
|
@@ -56162,8 +56462,11 @@ export type CustomElements = {
|
|
|
56162
56462
|
* imperatively later, and nothing is hydrating by then.
|
|
56163
56463
|
*
|
|
56164
56464
|
* Here rather than on each control.
|
|
56165
|
-
* - `valueAsNumber`: The value as a number, or `NaN` while the control is empty
|
|
56465
|
+
* - `valueAsNumber`: The value as a number, or `NaN` while the control is empty or does not
|
|
56466
|
+
* hold a number.
|
|
56166
56467
|
*
|
|
56468
|
+
* Read in the locale and the format, as the form reads it, so `1,5` typed
|
|
56469
|
+
* in a locale with a decimal comma is 1.5 here while the form holds 1.5.
|
|
56167
56470
|
* `NaN` and not zero, which is the trap the platform already avoids: `Number('')`
|
|
56168
56471
|
* is zero, so an empty control would report a number it does not hold and a
|
|
56169
56472
|
* form would submit it. (property only)
|
|
@@ -60607,7 +60910,8 @@ export type CustomElements = {
|
|
|
60607
60910
|
* - `label`: What is loading, read out as the placeholder's name, such as "Loading
|
|
60608
60911
|
* profile".
|
|
60609
60912
|
*
|
|
60610
|
-
* Absent hides the placeholder from screen readers.
|
|
60913
|
+
* Absent hides the placeholder from screen readers. Around content, the name
|
|
60914
|
+
* is read while `loading` is set, and the loaded content is read as it is.
|
|
60611
60915
|
* - `loading`: Whether the content inside is still loading, which keeps it inert and
|
|
60612
60916
|
* draws the placeholder over it.
|
|
60613
60917
|
*
|
|
@@ -65157,6 +65461,9 @@ export type CustomElements = {
|
|
|
65157
65461
|
* - `tone`: The kind of message, which sets its mark and the mark's accessible name.
|
|
65158
65462
|
*
|
|
65159
65463
|
* A subset of the tone axis: a toast reports a status and never a brand role.
|
|
65464
|
+
* - `waiting`: Whether the region holds the message back, because more messages are
|
|
65465
|
+
* showing than its `max-visible`. The region sets it. A waiting message is
|
|
65466
|
+
* hidden, its timer has not started, and it is said once it shows. (property only)
|
|
65160
65467
|
* - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
|
|
65161
65468
|
*
|
|
65162
65469
|
* **Named `whenSettled` because `settled` is taken four times over**, by
|
|
@@ -65242,6 +65549,9 @@ export type CustomElements = {
|
|
|
65242
65549
|
*
|
|
65243
65550
|
* These can be used to apply styling when a component is in a given state.
|
|
65244
65551
|
*
|
|
65552
|
+
* - `closed`: The message has been dismissed and is hidden, or leaving.
|
|
65553
|
+
* - `paused`: The dismiss timer is paused, while a pointer or focus is on the message, or while the page is hidden.
|
|
65554
|
+
* - `waiting`: The region holds the message back, past its `max-visible`, until a message before it goes.
|
|
65245
65555
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
65246
65556
|
*/
|
|
65247
65557
|
"helix-toast-item": Partial<
|
|
@@ -65267,6 +65577,9 @@ export type CustomElements = {
|
|
|
65267
65577
|
* Empty turns it off.
|
|
65268
65578
|
* - `label`: Accessible name for the region, with `{hotkey}` filled in. Translate it with
|
|
65269
65579
|
* the rest of your interface.
|
|
65580
|
+
* - `max-visible`/`maxVisible`: How many messages show at once. The messages after that many wait, hidden
|
|
65581
|
+
* and with their timers stopped, until a message before them goes. Unset,
|
|
65582
|
+
* every message shows.
|
|
65270
65583
|
* - `placement`: Which corner or edge the stack sits at.
|
|
65271
65584
|
*
|
|
65272
65585
|
* Named here rather than on each message, because where a page puts its
|
|
@@ -67088,6 +67401,7 @@ export type CustomElements = {
|
|
|
67088
67401
|
* - `entry-shortcut-key`: One key of an entry's shortcut chord, inside `entry-shortcut`. The playlist's entries set none.
|
|
67089
67402
|
* - `entry-shortcut-separator`: The `+` between two keys of an entry's shortcut, where the platform writes one.
|
|
67090
67403
|
* - `entry-start`: The column at the start of an entry. It is a slot and is always present.
|
|
67404
|
+
* - `entry-surface`: The panel an entry's submenu opens in beside it. The playlist's entries have none.
|
|
67091
67405
|
* - `menu`: The menu that holds the entries.
|
|
67092
67406
|
* - `menu-back`: The button that goes back from a submenu.
|
|
67093
67407
|
* - `menu-back-mark`: The icon on a submenu's back button.
|
|
@@ -67621,6 +67935,7 @@ export type CustomElements = {
|
|
|
67621
67935
|
* - `entry-shortcut-key`: One key of a row's shortcut chord, inside `entry-shortcut`. The player's rows set none.
|
|
67622
67936
|
* - `entry-shortcut-separator`: The `+` between two keys of a row's shortcut, where the platform writes one.
|
|
67623
67937
|
* - `entry-start`: The leading column that holds the `start` slot. It is always rendered.
|
|
67938
|
+
* - `entry-surface`: The panel a row's submenu opens in beside it. The player's rows have none.
|
|
67624
67939
|
* - `failure`: The message shown when the source cannot be played.
|
|
67625
67940
|
* - `forward`: The button that skips forward ten seconds.
|
|
67626
67941
|
* - `fullscreen`: The button that enters and leaves fullscreen.
|
|
@@ -74342,6 +74657,12 @@ export type CustomElementsSolidJs = {
|
|
|
74342
74657
|
* how many are left, written in the locale, and each language writes the
|
|
74343
74658
|
* forms it has: `{count, plural, one {# polecenie} few {# polecenia} many
|
|
74344
74659
|
* {# poleceń} other {# polecenia}}`.
|
|
74660
|
+
* - `filterMatch`: Whether a command is kept by the filter: a function given the command's
|
|
74661
|
+
* words and the filter, trimmed, that returns `true` to keep it showing, as
|
|
74662
|
+
* React Aria's `Autocomplete` takes `filter`. See Listbox's `filterMatch`.
|
|
74663
|
+
*
|
|
74664
|
+
* Absent, a command is kept where its words hold the filter, in any case. A
|
|
74665
|
+
* property only, there being no way to write a function in markup. (property only)
|
|
74345
74666
|
* - `items`: The commands as data, for a palette too long to draw whole: each a value,
|
|
74346
74667
|
* which is also its words, or a record with a `value`, a `label` and
|
|
74347
74668
|
* `disabled`. Handed to the list, which draws only the commands in sight and
|
|
@@ -74440,6 +74761,7 @@ export type CustomElementsSolidJs = {
|
|
|
74440
74761
|
* - `listbox-loading`: The text shown while the commands are loading.
|
|
74441
74762
|
* - `listbox-search`: The region that holds the filter field.
|
|
74442
74763
|
* - `listbox-search-field`: The filter field.
|
|
74764
|
+
* - `live`: The region a screen reader announces the page shown from, by the words of the command that opens it, drawn once there is one to say. Visually hidden in the styled tier.
|
|
74443
74765
|
*
|
|
74444
74766
|
* ## CSS States
|
|
74445
74767
|
*
|
|
@@ -77010,6 +77332,12 @@ export type CustomElementsSolidJs = {
|
|
|
77010
77332
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
77011
77333
|
*
|
|
77012
77334
|
* - `disabled`: Whether the row can be reached at all.
|
|
77335
|
+
* - `download`: Whether the link downloads the file when the row is chosen. Only
|
|
77336
|
+
* meaningful beside an `href`, and only for a file served from this origin.
|
|
77337
|
+
* - `href`: The URL the row links to. Setting it renders the row as a link, unless the
|
|
77338
|
+
* row opens a page or is disabled.
|
|
77339
|
+
* - `rel`: The link's `rel`. Set it whenever you set `target="_blank"`.
|
|
77340
|
+
* - `target`: Where the link opens, for rows that should open outside the current page.
|
|
77013
77341
|
* - `value`: Identifies the row to your event listeners.
|
|
77014
77342
|
* - `focusable`: Whether this row holds the region's tab stop. Set by the drill-down.
|
|
77015
77343
|
*
|
|
@@ -77096,7 +77424,7 @@ export type CustomElementsSolidJs = {
|
|
|
77096
77424
|
*
|
|
77097
77425
|
* Custom selectors for styling elements within the component.
|
|
77098
77426
|
*
|
|
77099
|
-
* - `item`: The row itself.
|
|
77427
|
+
* - `item`: The row itself, which is an `<a>` where `href` is set.
|
|
77100
77428
|
* - `label`: The row's label.
|
|
77101
77429
|
* - `mark`: The caret at the end of a row that opens a page, after the `end` slot. The caret points, so a stylesheet mirrors it in a right-to-left document.
|
|
77102
77430
|
*
|
|
@@ -77138,6 +77466,12 @@ export type CustomElementsSolidJs = {
|
|
|
77138
77466
|
* An `aria-label` or `aria-labelledby` on the host names the top page too,
|
|
77139
77467
|
* and wins over this.
|
|
77140
77468
|
* - `back-label`/`backLabel`: The text of the back button.
|
|
77469
|
+
* - `navigation`: Whether the drilldown is a site's navigation: a `navigation` landmark
|
|
77470
|
+
* named by `label`, whose pages are lists of links. Without it, each page is
|
|
77471
|
+
* a `menu`.
|
|
77472
|
+
* - `page`: The page showing, as the `value` of the row that opens it. Empty is the
|
|
77473
|
+
* top page. Setting it shows that page, and a value no row with a page has
|
|
77474
|
+
* shows the top page.
|
|
77141
77475
|
* - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
|
|
77142
77476
|
*
|
|
77143
77477
|
* **Named `whenSettled` because `settled` is taken four times over**, by
|
|
@@ -77163,6 +77497,7 @@ export type CustomElementsSolidJs = {
|
|
|
77163
77497
|
*
|
|
77164
77498
|
* Events that will be emitted by the component.
|
|
77165
77499
|
*
|
|
77500
|
+
* - `helix-navigate`: Fired before a reader moves into a page or back out of one. `detail.value` is the `value` of the row whose page is about to show, empty for the top page. Cancelable: cancel it to stay on the page showing.
|
|
77166
77501
|
* - `helix-select`: Fired when a row with no page is chosen. Cancelable: canceling it stops the change and leaves the decision to you.
|
|
77167
77502
|
*
|
|
77168
77503
|
* ## Slots
|
|
@@ -77956,6 +78291,7 @@ export type CustomElementsSolidJs = {
|
|
|
77956
78291
|
* - `entry-shortcut-key`: One key of the shortcut's chord.
|
|
77957
78292
|
* - `entry-shortcut-separator`: The `+` between two keys of the shortcut, where the platform writes one.
|
|
77958
78293
|
* - `entry-start`: The leading column.
|
|
78294
|
+
* - `entry-surface`: The panel a row's submenu opens in beside it. The filter menu's rows have none.
|
|
77959
78295
|
* - `menu`: The menu the fields are offered in.
|
|
77960
78296
|
* - `menu-back`: The button that goes back from a field's page.
|
|
77961
78297
|
* - `menu-back-mark`: The icon on the back button.
|
|
@@ -81371,7 +81707,9 @@ export type CustomElementsSolidJs = {
|
|
|
81371
81707
|
* Not reflected, as a state never is. `row-current` is the part a
|
|
81372
81708
|
* stylesheet draws it from.
|
|
81373
81709
|
* - `disabled`: Takes the row out of reach in a list with `selection-mode`: the arrow keys
|
|
81374
|
-
* pass over it and it cannot be selected or acted on.
|
|
81710
|
+
* pass over it and it cannot be selected or acted on. In a list with
|
|
81711
|
+
* `disabled-behavior="selection"`, it cannot be selected and is reached and
|
|
81712
|
+
* acted on as any row is.
|
|
81375
81713
|
* - `href`: The URL the row links to. Leave it empty for a row that is not a link.
|
|
81376
81714
|
*
|
|
81377
81715
|
* Empty rather than optional, and unset by default: a list is not always a
|
|
@@ -81398,6 +81736,9 @@ export type CustomElementsSolidJs = {
|
|
|
81398
81736
|
*
|
|
81399
81737
|
* Written by the list from its own `value`, and unset where nothing can be
|
|
81400
81738
|
* selected, which keeps `aria-selected` off a list that does not select. (property only)
|
|
81739
|
+
* - `selectionOnly`: Whether `disabled` takes the row out of selection alone, written by a list
|
|
81740
|
+
* with `disabled-behavior="selection"`. No attribute: it is coordination
|
|
81741
|
+
* between elements, as `focusable` is. (property only)
|
|
81401
81742
|
* - `words`: The row's words, or none where the children are not known yet. (property only) (readonly)
|
|
81402
81743
|
* - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
|
|
81403
81744
|
*
|
|
@@ -81475,6 +81816,7 @@ export type CustomElementsSolidJs = {
|
|
|
81475
81816
|
* - `dragging`: The row is being moved, in a `reorderable` list.
|
|
81476
81817
|
* - `drop-after`: The row being moved goes after this one when it is dropped.
|
|
81477
81818
|
* - `drop-before`: The row being moved goes before this one when it is dropped.
|
|
81819
|
+
* - `focus-visible`: The row's cell has keyboard focus that the browser shows, in a list with `selection-mode`.
|
|
81478
81820
|
* - `selected`: The row is selected, in a list that selects.
|
|
81479
81821
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
81480
81822
|
*/
|
|
@@ -81510,6 +81852,12 @@ export type CustomElementsSolidJs = {
|
|
|
81510
81852
|
* `unordered` too, where it numbers what a bullet did not.
|
|
81511
81853
|
* - `canceled-label`/`canceledLabel`: What screen readers hear when a held row is put back, or a move is
|
|
81512
81854
|
* refused, in a `reorderable` list.
|
|
81855
|
+
* - `disabled-behavior`/`disabledBehavior`: What `disabled` takes from a row, in a list that selects: `all`, which
|
|
81856
|
+
* passes over the row, or `selection`, which keeps the row out of the
|
|
81857
|
+
* selection and lets the keys reach it and Enter or a press act on it, as
|
|
81858
|
+
* React Aria's GridList takes `disabledBehavior`.
|
|
81859
|
+
*
|
|
81860
|
+
* Absent is `all`.
|
|
81513
81861
|
* - `dropped-label`/`droppedLabel`: What screen readers hear when a row is dropped, in a `reorderable` list.
|
|
81514
81862
|
* - `empty-label`/`emptyLabel`: The text of the row shown while the list has no rows, where the `empty`
|
|
81515
81863
|
* slot is empty. Empty, the default, shows no row.
|
|
@@ -81811,6 +82159,13 @@ export type CustomElementsSolidJs = {
|
|
|
81811
82159
|
* imperatively later, and nothing is hydrating by then.
|
|
81812
82160
|
*
|
|
81813
82161
|
* Here rather than on each control.
|
|
82162
|
+
* - `filterMatch`: Whether an option is kept by the filter: a function given the option's
|
|
82163
|
+
* words and the filter, trimmed, that returns `true` to keep it showing, as
|
|
82164
|
+
* React Aria's `Autocomplete` takes `filter`. For matching that ignores
|
|
82165
|
+
* accents, matches the start of each word, or matches out of order.
|
|
82166
|
+
*
|
|
82167
|
+
* Absent, an option is kept where its words hold the filter, in any case. A
|
|
82168
|
+
* property only, there being no way to write a function in markup. (property only)
|
|
81814
82169
|
* - `items`: The options as data, for a list too long to draw whole: each a value,
|
|
81815
82170
|
* which is also its words, or a record with a `value`, a `label` and
|
|
81816
82171
|
* `disabled`. Set, the list draws only the options in sight, and the ones
|
|
@@ -81847,7 +82202,10 @@ export type CustomElementsSolidJs = {
|
|
|
81847
82202
|
* Descendants rather than children, because a group puts a level between the
|
|
81848
82203
|
* list and its options and the keyboard has to move through a grouped list
|
|
81849
82204
|
* exactly as it moves through a flat one. (property only) (readonly)
|
|
81850
|
-
* - `values`: The chosen values, as an array whether or not `multiple` is set.
|
|
82205
|
+
* - `values`: The chosen values, as an array whether or not `multiple` is set.
|
|
82206
|
+
*
|
|
82207
|
+
* Read against the options' values, so an option whose value holds a comma
|
|
82208
|
+
* is one value. See `chosenValues`. (property only) (readonly)
|
|
81851
82209
|
* - `validity`: Whether the control meets its constraints, and why not. (property only) (readonly)
|
|
81852
82210
|
* - `validationMessage`: The message the browser would show for the control, or an empty string. (property only) (readonly)
|
|
81853
82211
|
* - `willValidate`: Whether the control is checked when its form is submitted. (property only) (readonly)
|
|
@@ -83267,7 +83625,13 @@ export type CustomElementsSolidJs = {
|
|
|
83267
83625
|
* narrow exception the server specs describe covers a mirror that can only
|
|
83268
83626
|
* become true long after hydration, and a viewport measured before the first
|
|
83269
83627
|
* paint is the opposite case. See `MixinControllerOpen` on `open`.
|
|
83628
|
+
* - `close-delay`/`closeDelay`: How long a pointer leaving the trigger and the panel waits before the panel
|
|
83629
|
+
* closes, in milliseconds. The pointer needs the time to cross from the
|
|
83630
|
+
* trigger to the panel.
|
|
83270
83631
|
* - `label`: The section's name, used for the default trigger and the panel.
|
|
83632
|
+
* - `open-delay`/`openDelay`: How long a pointer rests on the trigger before the panel opens, in
|
|
83633
|
+
* milliseconds, under `open-on="hover"`. A pointer crossing the bar on its
|
|
83634
|
+
* way somewhere else opens nothing.
|
|
83271
83635
|
* - `open-on`/`openOn`: Whether hovering over the trigger opens the panel (`hover`), or only a press
|
|
83272
83636
|
* does (`click`).
|
|
83273
83637
|
*
|
|
@@ -83275,6 +83639,9 @@ export type CustomElementsSolidJs = {
|
|
|
83275
83639
|
* the trigger, and it is the default because that is what a navigation bar
|
|
83276
83640
|
* does. `click` is for a trigger that does something else as well, or a panel
|
|
83277
83641
|
* heavy enough that opening it on the way past is rude.
|
|
83642
|
+
* - `placement`: The side of the trigger a card panel opens on, when there is room. It
|
|
83643
|
+
* moves if that side does not fit. A band ignores it, since a band spans the
|
|
83644
|
+
* page under its bar.
|
|
83278
83645
|
* - `variant`: Whether the panel is a card under the trigger or a band across the page.
|
|
83279
83646
|
*
|
|
83280
83647
|
* The resting one is the card, hanging off the trigger and as wide as it
|
|
@@ -83387,6 +83754,7 @@ export type CustomElementsSolidJs = {
|
|
|
83387
83754
|
*
|
|
83388
83755
|
* These can be used to apply styling when a component is in a given state.
|
|
83389
83756
|
*
|
|
83757
|
+
* - `current`: A link in the panel carries `aria-current="page"`, so the trigger can show the section you are in.
|
|
83390
83758
|
* - `from-end`: The panel opened in place of one earlier in the bar, so it can enter from the end side.
|
|
83391
83759
|
* - `from-start`: The panel opened in place of one later in the bar, so it can enter from the start side.
|
|
83392
83760
|
* - `narrow`: The page is narrower than `band-below`, so the panel is shown as a band whatever its variant.
|
|
@@ -83560,12 +83928,15 @@ export type CustomElementsSolidJs = {
|
|
|
83560
83928
|
* - `shortcut-key`: One key of the shortcut's chord, such as `Ctrl`.
|
|
83561
83929
|
* - `shortcut-separator`: The `+` between two keys of the shortcut, where the platform writes one.
|
|
83562
83930
|
* - `start`: The leading column that holds the `start` slot. It is always rendered.
|
|
83931
|
+
* - `surface`: The panel a submenu opens in beside the row, under the menu's `submenus="flyout"`.
|
|
83563
83932
|
*
|
|
83564
83933
|
* ## CSS States
|
|
83565
83934
|
*
|
|
83566
83935
|
* These can be used to apply styling when a component is in a given state.
|
|
83567
83936
|
*
|
|
83568
83937
|
* - `checked`: The row is checked.
|
|
83938
|
+
* - `submenu-mark`: Under `submenus="flyout"`, a row in this row's submenu can be ticked or opens a submenu, so the submenu keeps its trailing column.
|
|
83939
|
+
* - `submenu-start`: Under `submenus="flyout"`, a row in this row's submenu has content before its label, so the submenu keeps its leading column.
|
|
83569
83940
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
83570
83941
|
*/
|
|
83571
83942
|
"helix-menu-item": Partial<
|
|
@@ -83614,10 +83985,17 @@ export type CustomElementsSolidJs = {
|
|
|
83614
83985
|
* Empty by default, which names the surface by its trigger, so a menu opened
|
|
83615
83986
|
* from "Actions" is announced as "Actions". An `aria-label` or
|
|
83616
83987
|
* `aria-labelledby` on the host names it too, and wins over both.
|
|
83988
|
+
* - `long-press-label`/`longPressLabel`: The description a trigger gives under `open-on="long-press"`, saying how
|
|
83989
|
+
* to open the menu. Translate it with the rest of your interface.
|
|
83617
83990
|
* - `offset`: Space between the trigger and the surface, in pixels.
|
|
83991
|
+
* - `open-on`/`openOn`: What opens the menu from its trigger. `long-press` leaves a press to the
|
|
83992
|
+
* trigger's own action and opens the menu on a press held for half a second,
|
|
83993
|
+
* or on Alt+Down or Alt+Up.
|
|
83618
83994
|
* - `placement`: The side the menu opens on, when there is room.
|
|
83619
83995
|
*
|
|
83620
83996
|
* It moves if that side does not fit.
|
|
83997
|
+
* - `submenus`: How a submenu opens. `drill` shows it in place of the page showing, with
|
|
83998
|
+
* a way back. `flyout` opens it in a panel of its own beside its row.
|
|
83621
83999
|
* - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
|
|
83622
84000
|
*
|
|
83623
84001
|
* **Named `whenSettled` because `settled` is taken four times over**, by
|
|
@@ -83704,6 +84082,10 @@ export type CustomElementsSolidJs = {
|
|
|
83704
84082
|
* - `drilled`: A submenu's page is showing, so content that is not a row can hide with the top page.
|
|
83705
84083
|
* - `mark`: A row on the current page has a checkbox or a link, so every row keeps the trailing column.
|
|
83706
84084
|
* - `open`: While the menu is open.
|
|
84085
|
+
* - `placed-bottom`: While the open panel sits below its trigger.
|
|
84086
|
+
* - `placed-left`: While the open panel sits to the left of its trigger.
|
|
84087
|
+
* - `placed-right`: While the open panel sits to the right of its trigger.
|
|
84088
|
+
* - `placed-top`: While the open panel sits above its trigger.
|
|
83707
84089
|
* - `start`: A row on the current page has content in its leading column, so every row keeps that column.
|
|
83708
84090
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
83709
84091
|
*/
|
|
@@ -84446,6 +84828,8 @@ export type CustomElementsSolidJs = {
|
|
|
84446
84828
|
* are dimmed rather than removed while a new set arrives, and only CSS can
|
|
84447
84829
|
* say that without the component knowing what a row looks like.
|
|
84448
84830
|
* - `loading-text`/`loadingText`: The text shown and announced while the rows load.
|
|
84831
|
+
* - `arrived-label`/`arrivedLabel`: What the feed says when unread notifications arrive, with `{count}` the
|
|
84832
|
+
* number of them. Empty it to say nothing.
|
|
84449
84833
|
* - `fallback-label`/`fallbackLabel`: The region's name where `label` is empty.
|
|
84450
84834
|
* - `label`: The feed's name, read by screen readers.
|
|
84451
84835
|
* - `load-error`/`loadError`: What the feed says when a page of it could not be loaded, such as after a
|
|
@@ -84774,8 +85158,11 @@ export type CustomElementsSolidJs = {
|
|
|
84774
85158
|
* imperatively later, and nothing is hydrating by then.
|
|
84775
85159
|
*
|
|
84776
85160
|
* Here rather than on each control.
|
|
84777
|
-
* - `valueAsNumber`: The value as a number, or `NaN` while the control is empty
|
|
85161
|
+
* - `valueAsNumber`: The value as a number, or `NaN` while the control is empty or does not
|
|
85162
|
+
* hold a number.
|
|
84778
85163
|
*
|
|
85164
|
+
* Read in the locale and the format, as the form reads it, so `1,5` typed
|
|
85165
|
+
* in a locale with a decimal comma is 1.5 here while the form holds 1.5.
|
|
84779
85166
|
* `NaN` and not zero, which is the trap the platform already avoids: `Number('')`
|
|
84780
85167
|
* is zero, so an empty control would report a number it does not hold and a
|
|
84781
85168
|
* form would submit it. (property only)
|
|
@@ -89303,7 +89690,8 @@ export type CustomElementsSolidJs = {
|
|
|
89303
89690
|
* - `label`: What is loading, read out as the placeholder's name, such as "Loading
|
|
89304
89691
|
* profile".
|
|
89305
89692
|
*
|
|
89306
|
-
* Absent hides the placeholder from screen readers.
|
|
89693
|
+
* Absent hides the placeholder from screen readers. Around content, the name
|
|
89694
|
+
* is read while `loading` is set, and the loaded content is read as it is.
|
|
89307
89695
|
* - `loading`: Whether the content inside is still loading, which keeps it inert and
|
|
89308
89696
|
* draws the placeholder over it.
|
|
89309
89697
|
*
|
|
@@ -93938,6 +94326,9 @@ export type CustomElementsSolidJs = {
|
|
|
93938
94326
|
* - `tone`: The kind of message, which sets its mark and the mark's accessible name.
|
|
93939
94327
|
*
|
|
93940
94328
|
* A subset of the tone axis: a toast reports a status and never a brand role.
|
|
94329
|
+
* - `waiting`: Whether the region holds the message back, because more messages are
|
|
94330
|
+
* showing than its `max-visible`. The region sets it. A waiting message is
|
|
94331
|
+
* hidden, its timer has not started, and it is said once it shows. (property only)
|
|
93941
94332
|
* - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
|
|
93942
94333
|
*
|
|
93943
94334
|
* **Named `whenSettled` because `settled` is taken four times over**, by
|
|
@@ -94023,6 +94414,9 @@ export type CustomElementsSolidJs = {
|
|
|
94023
94414
|
*
|
|
94024
94415
|
* These can be used to apply styling when a component is in a given state.
|
|
94025
94416
|
*
|
|
94417
|
+
* - `closed`: The message has been dismissed and is hidden, or leaving.
|
|
94418
|
+
* - `paused`: The dismiss timer is paused, while a pointer or focus is on the message, or while the page is hidden.
|
|
94419
|
+
* - `waiting`: The region holds the message back, past its `max-visible`, until a message before it goes.
|
|
94026
94420
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
94027
94421
|
*/
|
|
94028
94422
|
"helix-toast-item": Partial<
|
|
@@ -94051,6 +94445,9 @@ export type CustomElementsSolidJs = {
|
|
|
94051
94445
|
* Empty turns it off.
|
|
94052
94446
|
* - `label`: Accessible name for the region, with `{hotkey}` filled in. Translate it with
|
|
94053
94447
|
* the rest of your interface.
|
|
94448
|
+
* - `max-visible`/`maxVisible`: How many messages show at once. The messages after that many wait, hidden
|
|
94449
|
+
* and with their timers stopped, until a message before them goes. Unset,
|
|
94450
|
+
* every message shows.
|
|
94054
94451
|
* - `placement`: Which corner or edge the stack sits at.
|
|
94055
94452
|
*
|
|
94056
94453
|
* Named here rather than on each message, because where a page puts its
|
|
@@ -95907,6 +96304,7 @@ export type CustomElementsSolidJs = {
|
|
|
95907
96304
|
* - `entry-shortcut-key`: One key of an entry's shortcut chord, inside `entry-shortcut`. The playlist's entries set none.
|
|
95908
96305
|
* - `entry-shortcut-separator`: The `+` between two keys of an entry's shortcut, where the platform writes one.
|
|
95909
96306
|
* - `entry-start`: The column at the start of an entry. It is a slot and is always present.
|
|
96307
|
+
* - `entry-surface`: The panel an entry's submenu opens in beside it. The playlist's entries have none.
|
|
95910
96308
|
* - `menu`: The menu that holds the entries.
|
|
95911
96309
|
* - `menu-back`: The button that goes back from a submenu.
|
|
95912
96310
|
* - `menu-back-mark`: The icon on a submenu's back button.
|
|
@@ -96446,6 +96844,7 @@ export type CustomElementsSolidJs = {
|
|
|
96446
96844
|
* - `entry-shortcut-key`: One key of a row's shortcut chord, inside `entry-shortcut`. The player's rows set none.
|
|
96447
96845
|
* - `entry-shortcut-separator`: The `+` between two keys of a row's shortcut, where the platform writes one.
|
|
96448
96846
|
* - `entry-start`: The leading column that holds the `start` slot. It is always rendered.
|
|
96847
|
+
* - `entry-surface`: The panel a row's submenu opens in beside it. The player's rows have none.
|
|
96449
96848
|
* - `failure`: The message shown when the source cannot be played.
|
|
96450
96849
|
* - `forward`: The button that skips forward ten seconds.
|
|
96451
96850
|
* - `fullscreen`: The button that enters and leaves fullscreen.
|