@konce-pt/angular 0.11.2 → 0.14.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/CHANGELOG.md +792 -333
- package/README.md +111 -55
- package/charts/src/lib/llms.txt +23 -15
- package/chat/src/lib/llms.txt +68 -33
- package/fesm2022/konce-pt-angular-charts.mjs +149 -68
- package/fesm2022/konce-pt-angular-charts.mjs.map +1 -1
- package/fesm2022/konce-pt-angular-chat.mjs +296 -135
- package/fesm2022/konce-pt-angular-chat.mjs.map +1 -1
- package/fesm2022/konce-pt-angular-grid.mjs +16 -16
- package/fesm2022/konce-pt-angular-grid.mjs.map +1 -1
- package/fesm2022/konce-pt-angular-icons.mjs +5 -5
- package/fesm2022/konce-pt-angular-icons.mjs.map +1 -1
- package/fesm2022/konce-pt-angular-map.mjs +360 -293
- package/fesm2022/konce-pt-angular-map.mjs.map +1 -1
- package/fesm2022/konce-pt-angular-roadmap.mjs +120 -34
- package/fesm2022/konce-pt-angular-roadmap.mjs.map +1 -1
- package/fesm2022/konce-pt-angular.mjs +7117 -3373
- package/fesm2022/konce-pt-angular.mjs.map +1 -1
- package/grid/src/lib/llms.txt +18 -18
- package/map/src/lib/llms.txt +142 -140
- package/package.json +14 -12
- package/roadmap/src/lib/llms.txt +37 -27
- package/src/lib/accordion/llms.txt +18 -6
- package/src/lib/alert/llms.txt +5 -4
- package/src/lib/app-shell/llms.txt +25 -22
- package/src/lib/auth/llms.txt +26 -22
- package/src/lib/autocomplete/llms.txt +18 -4
- package/src/lib/avatar/llms.txt +3 -3
- package/src/lib/avatar-group/llms.txt +5 -5
- package/src/lib/backdrop/llms.txt +35 -35
- package/src/lib/badge/llms.txt +7 -7
- package/src/lib/bottom-sheet/llms.txt +6 -3
- package/src/lib/breadcrumb/llms.txt +9 -1
- package/src/lib/breakpoint/llms.txt +8 -8
- package/src/lib/button/llms.txt +26 -18
- package/src/lib/button-group/llms.txt +40 -31
- package/src/lib/card/llms.txt +19 -19
- package/src/lib/carousel/llms.txt +6 -6
- package/src/lib/checkbox/llms.txt +17 -2
- package/src/lib/chip/llms.txt +6 -6
- package/src/lib/chips-input/llms.txt +14 -4
- package/src/lib/color-picker/llms.txt +7 -4
- package/src/lib/confirm/llms.txt +9 -3
- package/src/lib/context-menu/llms.txt +7 -4
- package/src/lib/data-table/llms.txt +280 -227
- package/src/lib/data-view/llms.txt +25 -4
- package/src/lib/date-range/llms.txt +37 -18
- package/src/lib/datepicker/llms.txt +46 -29
- package/src/lib/dialog/llms.txt +29 -26
- package/src/lib/divider/llms.txt +2 -1
- package/src/lib/drawer/llms.txt +9 -6
- package/src/lib/empty/llms.txt +4 -4
- package/src/lib/fab/llms.txt +6 -2
- package/src/lib/fieldset/llms.txt +22 -4
- package/src/lib/file-upload/llms.txt +3 -0
- package/src/lib/form-field/llms.txt +33 -19
- package/src/lib/galleria/llms.txt +3 -3
- package/src/lib/i18n/llms.txt +15 -8
- package/src/lib/icon/llms.txt +9 -9
- package/src/lib/icon-button/llms.txt +8 -3
- package/src/lib/image/llms.txt +4 -4
- package/src/lib/input/llms.txt +21 -7
- package/src/lib/input-mask/llms.txt +5 -2
- package/src/lib/input-number/llms.txt +18 -15
- package/src/lib/input-otp/llms.txt +15 -4
- package/src/lib/knob/llms.txt +14 -7
- package/src/lib/listbox/llms.txt +8 -5
- package/src/lib/loader/llms.txt +72 -0
- package/src/lib/megamenu/llms.txt +16 -5
- package/src/lib/mention/llms.txt +15 -15
- package/src/lib/menu/llms.txt +12 -12
- package/src/lib/menubar/llms.txt +16 -5
- package/src/lib/meter-group/llms.txt +7 -7
- package/src/lib/order-list/llms.txt +20 -5
- package/src/lib/paginator/llms.txt +5 -5
- package/src/lib/panel/llms.txt +20 -8
- package/src/lib/password/llms.txt +17 -5
- package/src/lib/peek/llms.txt +11 -11
- package/src/lib/pick-list/llms.txt +28 -5
- package/src/lib/popover/llms.txt +9 -6
- package/src/lib/progress/llms.txt +16 -16
- package/src/lib/radio-group/llms.txt +13 -3
- package/src/lib/rating/llms.txt +13 -6
- package/src/lib/rich-text/llms.txt +42 -24
- package/src/lib/scroll-top/llms.txt +3 -3
- package/src/lib/select/llms.txt +23 -13
- package/src/lib/sidenav/llms.txt +8 -8
- package/src/lib/slider/llms.txt +23 -7
- package/src/lib/speech/llms.txt +108 -0
- package/src/lib/speed-dial/llms.txt +9 -3
- package/src/lib/spinner/llms.txt +2 -2
- package/src/lib/split-button/llms.txt +14 -8
- package/src/lib/splitter/llms.txt +8 -8
- package/src/lib/stepper/llms.txt +26 -7
- package/src/lib/switch/llms.txt +13 -3
- package/src/lib/switch-group/llms.txt +12 -9
- package/src/lib/tabs/llms.txt +7 -4
- package/src/lib/textarea/llms.txt +16 -5
- package/src/lib/timeline/llms.txt +1 -1
- package/src/lib/toast/llms.txt +36 -5
- package/src/lib/toolbar/llms.txt +3 -3
- package/src/lib/tooltip/llms.txt +13 -10
- package/src/lib/tree/llms.txt +19 -5
- package/src/lib/update/llms.txt +52 -0
- package/types/konce-pt-angular-charts.d.ts +11 -0
- package/types/konce-pt-angular-charts.d.ts.map +1 -1
- package/types/konce-pt-angular-chat.d.ts +98 -40
- package/types/konce-pt-angular-chat.d.ts.map +1 -1
- package/types/konce-pt-angular-grid.d.ts +14 -14
- package/types/konce-pt-angular-icons.d.ts +3 -3
- package/types/konce-pt-angular-map.d.ts +147 -119
- package/types/konce-pt-angular-map.d.ts.map +1 -1
- package/types/konce-pt-angular-roadmap.d.ts +34 -9
- package/types/konce-pt-angular-roadmap.d.ts.map +1 -1
- package/types/konce-pt-angular.d.ts +1774 -651
- package/types/konce-pt-angular.d.ts.map +1 -1
|
@@ -7,12 +7,13 @@ Import: `import { KptDataView } from '@konce-pt/angular';`
|
|
|
7
7
|
## Inputs / model
|
|
8
8
|
- `items`: T[]
|
|
9
9
|
- `layout`: model<'list' | 'grid'> (the toggle in the bar)
|
|
10
|
-
- `pageSize`: model<number> (0 = no pagination)
|
|
10
|
+
- `pageSize`: model<number> (0 = no pagination) - two-way, because the paginator's select writes to it
|
|
11
11
|
- `pageSizeOptions`: number[] (empty = the select offers the current size only)
|
|
12
|
-
- `gridColumns`: model<number> (0 = as many as fit)
|
|
12
|
+
- `gridColumns`: model<number> (0 = as many as fit) - two-way, the density bar writes to it
|
|
13
13
|
- `gridColumnsOptions`: number[] (fewer than two = no density bar)
|
|
14
|
-
- `gridMinWidth`: string (default `10rem`)
|
|
14
|
+
- `gridMinWidth`: string (default `10rem`) - the narrowest card worth rendering
|
|
15
15
|
- `paginated`: boolean
|
|
16
|
+
- `layoutMotion`: `'spring' | 'arc' | 'morph' | 'none'` (default from `provideKptMotion`, else `spring`) - see below
|
|
16
17
|
|
|
17
18
|
## Example
|
|
18
19
|
<kpt-data-view [items]="products" [(pageSize)]="size" [pageSizeOptions]="[3, 6, 9]">
|
|
@@ -22,7 +23,7 @@ Import: `import { KptDataView } from '@konce-pt/angular';`
|
|
|
22
23
|
## The column count is a ceiling
|
|
23
24
|
`gridColumns` caps the grid, it does not pin it: the track minimum grows to the width of one of
|
|
24
25
|
N columns, so a narrow container drops to two or one column instead of squeezing cards below
|
|
25
|
-
`gridMinWidth`. Set `gridColumns` to one of `gridColumnsOptions`
|
|
26
|
+
`gridMinWidth`. Set `gridColumns` to one of `gridColumnsOptions` - with a value outside the list
|
|
26
27
|
no density button reads as active.
|
|
27
28
|
|
|
28
29
|
## The pager stays while there is a choice
|
|
@@ -30,5 +31,25 @@ It shows up when the items outgrow one page, and also when `pageSizeOptions` hol
|
|
|
30
31
|
size. Otherwise picking the largest size would hide the very select that was just used, with no
|
|
31
32
|
way back to a smaller one.
|
|
32
33
|
|
|
34
|
+
## Layout motion
|
|
35
|
+
`layoutMotion` animates a layout or density change made from the built-in bar:
|
|
36
|
+
- `spring` - each card glides from its old place to the new one on a spring and resizes; the
|
|
37
|
+
content is counter-scaled, so it never stretches. A light cascade from the first item.
|
|
38
|
+
- `arc` - cards lift (shadow, slight zoom), fly along an arc tilted toward the move and land
|
|
39
|
+
softly; the wave starts at the clicked button.
|
|
40
|
+
- `morph` - the browser's own morph (View Transitions): frames morph, old and new content
|
|
41
|
+
cross-fade, clipped rather than stretched. Without browser support the change is instant. A view
|
|
42
|
+
transition covers the whole document and blocks clicks for ~0.6 s.
|
|
43
|
+
- `none` - no motion.
|
|
44
|
+
|
|
45
|
+
With no value it takes `layout` from `provideKptMotion` (default `spring`); `enabled: false` there and
|
|
46
|
+
the system "reduce motion" setting always win. A click in the middle of a flight starts the next
|
|
47
|
+
one from where the cards are on screen. A layout set from outside (`[layout]`, `[gridColumns]`) switches instantly - the
|
|
48
|
+
old state has to be measured before the DOM changes.
|
|
49
|
+
|
|
50
|
+
<kpt-data-view [items]="products" layoutMotion="arc" [gridColumnsOptions]="[2, 3, 4]">
|
|
51
|
+
<ng-template let-p><div>{{ p.name }}</div></ng-template>
|
|
52
|
+
</kpt-data-view>
|
|
53
|
+
|
|
33
54
|
## Tokens
|
|
34
55
|
Item cards `--kpt-color-surface-raised`; the toggle `--kpt-color-primary`.
|
|
@@ -9,36 +9,38 @@ Requires `import '@angular/cdk/overlay-prebuilt.css';`
|
|
|
9
9
|
## Inputs / model
|
|
10
10
|
- `value`: model<KptDateRangeValue> (or `formField`)
|
|
11
11
|
- `mode`: 'date' | 'datetime' | 'time' (default 'date')
|
|
12
|
-
- `visibleMonths`: number (default 1, clamped to 1
|
|
13
|
-
The
|
|
14
|
-
Ignored in 'time' mode. With more than one, days from adjacent months are hidden (empty slots)
|
|
12
|
+
- `visibleMonths`: number (default 1, clamped to 1-3) - how many months sit side by side.
|
|
13
|
+
The < > arrows stand on the outermost panels and move the whole set by one month.
|
|
14
|
+
Ignored in 'time' mode. With more than one, days from adjacent months are hidden (empty slots) -
|
|
15
15
|
otherwise the same date would be clickable in two panels at once.
|
|
16
|
-
- `hourFormat`: 12 | 24 (default 24)
|
|
17
|
-
- `minuteStep`: number (default 1)
|
|
18
|
-
- `placeholder`: string
|
|
19
|
-
- `displayFormat`: 'pl' | 'iso' (default 'pl')
|
|
20
|
-
- `
|
|
21
|
-
- `
|
|
22
|
-
- `
|
|
16
|
+
- `hourFormat`: 12 | 24 (default 24) - an AM/PM or a 24h dial; the value is always 24h
|
|
17
|
+
- `minuteStep`: number (default 1) - minute snapping on the dial
|
|
18
|
+
- `placeholder`: string - with no value it uses i18n (`dateRange.placeholder`); the input takes priority
|
|
19
|
+
- `displayFormat`: 'pl' | 'iso' | 'locale' (default 'pl') - the display format for start/end
|
|
20
|
+
- `open`: model<boolean> - two-way `[(open)]`, as in `kpt-datepicker`
|
|
21
|
+
- `readonly`/`required`, `firstDayOfWeek` - see "Week start, display format and field state"
|
|
22
|
+
- `minDate`/`maxDate`: string|null - 'YYYY-MM-DD' bounds (inclusive); days outside are disabled
|
|
23
|
+
- `ariaLabel`: string|null - the accessible name when no `<label for>` describes the field
|
|
24
|
+
- `disabled`/`invalid`/`touched`: boolean; `touch`: output - fires when the panel closes and when
|
|
23
25
|
focus leaves the closed trigger
|
|
24
26
|
|
|
25
27
|
## Behavior
|
|
26
|
-
The first click sets `start`, the second `end` (the order is normalized). The "
|
|
28
|
+
The first click sets `start`, the second `end` (the order is normalized). The "x" clears it.
|
|
27
29
|
The range highlights one continuous band running across every panel: the end days carry the selection
|
|
28
30
|
blob, and the band leaves their center, rounding off at the ends of a grid row.
|
|
29
31
|
The datetime/time modes: a "From / To" toggle + the clock dial, confirmed with the "Done" button.
|
|
30
32
|
|
|
31
33
|
## Keyboard
|
|
32
34
|
As in the date picker: the trigger has `aria-haspopup="dialog"` and `aria-expanded`; `Enter`, `Space`
|
|
33
|
-
and
|
|
34
|
-
or today. The arrows, `Home`/`End` and `PageUp`/`PageDown` (with `Shift`
|
|
35
|
+
and `ArrowDown` open the panel (a `role="dialog"` named "Choose a date range") with focus on the range start,
|
|
36
|
+
or today. The arrows, `Home`/`End` and `PageUp`/`PageDown` (with `Shift` - a year) walk the days across
|
|
35
37
|
every panel, shifting the set of months when focus leaves it. `Tab` cycles inside the panel, `Escape`
|
|
36
38
|
closes it, and picking the end (or "Done") returns focus to the trigger. `Delete`/`Backspace` on the
|
|
37
39
|
trigger clears the range.
|
|
38
40
|
|
|
39
|
-
Each day is named with the full date and its role in the range ("
|
|
40
|
-
"
|
|
41
|
-
`aria-current="date"`. After the first pick a polite live region says "Start:
|
|
41
|
+
Each day is named with the full date and its role in the range ("..., start of range", "..., end of range",
|
|
42
|
+
"..., in range") - the band colour is not the only carrier. The ends have `aria-pressed`, today has
|
|
43
|
+
`aria-current="date"`. After the first pick a polite live region says "Start: ... Choose the end date.".
|
|
42
44
|
|
|
43
45
|
## Example
|
|
44
46
|
<kpt-date-range [formField]="f.period" />
|
|
@@ -50,10 +52,27 @@ Each day is named with the full date and its role in the range ("…, start of r
|
|
|
50
52
|
## i18n
|
|
51
53
|
Day and month names come from `Intl` per locale; the labels ("From/To", navigation, "Done", the placeholder) come from i18n
|
|
52
54
|
(the `dateRange` namespace + `datepicker`/`common`), and so do the dialog name, the range roles of
|
|
53
|
-
the days and the live announcements. English by default
|
|
55
|
+
the days and the live announcements. English by default - see `i18n/llms.txt`.
|
|
56
|
+
|
|
57
|
+
## Week start, display format and field state
|
|
58
|
+
- The week starts by the `KptI18n` language (`Intl.Locale#getWeekInfo`, with a fallback list of regions):
|
|
59
|
+
en / en-US on Sunday, pl, de, en-GB on Monday. `firstDayOfWeek` (1 = Monday ... 7 = Sunday) overrides it;
|
|
60
|
+
the headers, the grid and `Home`/`End` follow it.
|
|
61
|
+
- `displayFormat`: `'pl'` (DD.MM.YYYY, default), `'iso'` (YYYY-MM-DD) or `'locale'` - order and separators
|
|
62
|
+
from `Intl` (en-US: MM/DD/YYYY). The placeholder follows the format and its letters follow the language
|
|
63
|
+
(EN `YYYY`, PL `RRRR`, the `datepicker.yearToken`/`monthToken`/`dayToken` keys). AM/PM come from `Intl`.
|
|
64
|
+
- The field is `role="combobox"` with `aria-haspopup="dialog"` (the APG select-only combobox), so it carries
|
|
65
|
+
`aria-required` (`required`), `aria-readonly` (`readonly` - the value shows, the panel does not open,
|
|
66
|
+
there is no clear button) and `aria-invalid`.
|
|
67
|
+
- Turning the page with < > is announced (`aria-live="polite"`); the title buttons are named
|
|
68
|
+
"October, Choose month" - the visible text first (WCAG 2.5.3). Clearing the value counts as a touch.
|
|
69
|
+
- "Today" is computed on every open, so a panel opened after midnight marks the right day.
|
|
70
|
+
- The clock (`kpt-clock`): the hour and minute segments are `role="spinbutton"` - `ArrowUp`/`ArrowDown` by one (minutes by
|
|
71
|
+
`minuteStep`), `PageUp`/`PageDown` by five, `Home`/`End` to the bounds - so every minute is reachable from
|
|
72
|
+
the keyboard, not only the five-minute marks.
|
|
54
73
|
|
|
55
74
|
## Label and description
|
|
56
|
-
`id` goes to the focusable element
|
|
75
|
+
`id` goes to the focusable element - the host never carries it; without one it is generated. A `div`
|
|
57
76
|
with a role is not named by `label[for]`, so inside `kpt-form-field` it gets `aria-labelledby`
|
|
58
77
|
pointing at the wrapper's label (unless `ariaLabel` is set), and the hint or error is added to
|
|
59
78
|
`aria-describedby`. No `controlId` needed. New: `id`; the trigger is the element that carries it.
|
|
@@ -2,11 +2,11 @@
|
|
|
2
2
|
|
|
3
3
|
Picking a date/time with a custom calendar (CDK Overlay), Signal Forms. The granularity comes from
|
|
4
4
|
`selectionMode`: date (the default), month+year, year, month, date+time, time only.
|
|
5
|
-
The panel is a stack of views
|
|
6
|
-
clicking the title goes one level up. The starting level is set by `startView`
|
|
7
|
-
`startView="decade"` (decade
|
|
8
|
-
The time is picked on a clock dial (two stages: hours
|
|
9
|
-
Display follows `displayFormat` ('pl'/'iso'). The week starts
|
|
5
|
+
The panel is a stack of views - **decade -> years -> months -> days**: clicking a cell goes one level down,
|
|
6
|
+
clicking the title goes one level up. The starting level is set by `startView` - for a date of birth use
|
|
7
|
+
`startView="decade"` (decade -> year -> month -> day, four clicks instead of hundreds of arrow presses).
|
|
8
|
+
The time is picked on a clock dial (two stages: hours -> minutes, click or drag), in 12/24h format.
|
|
9
|
+
Display follows `displayFormat` ('pl'/'iso'/'locale'). The week starts by the language (see below), today is marked, min/max range supported.
|
|
10
10
|
Requires the CDK overlay styles: `import '@angular/cdk/overlay-prebuilt.css';`
|
|
11
11
|
Import: `import { KptDatepicker } from '@konce-pt/angular';`
|
|
12
12
|
|
|
@@ -22,30 +22,30 @@ Import: `import { KptDatepicker } from '@konce-pt/angular';`
|
|
|
22
22
|
- `value`: model<string>; `minDate`/`maxDate`: string|null; `placeholder`: string
|
|
23
23
|
- `selectionMode`: 'date' | 'monthYear' | 'year' | 'month' | 'datetime' | 'time' (default 'date').
|
|
24
24
|
The value format depends on the mode: 'YYYY-MM-DD' / 'YYYY-MM' / 'YYYY' / 'MM' / 'YYYY-MM-DDTHH:mm' (datetime) / 'HH:mm' (time).
|
|
25
|
-
- `startView`: 'day' | 'month' | 'year' | 'decade' | null (default null)
|
|
25
|
+
- `startView`: 'day' | 'month' | 'year' | 'decade' | null (default null) - the level the panel
|
|
26
26
|
opens at. `null` = the level at which the mode commits a value: 'day' for 'date'/'datetime',
|
|
27
|
-
'month' for 'monthYear'/'month', 'year' for 'year'. It will not go below that level
|
|
27
|
+
'month' for 'monthYear'/'month', 'year' for 'year'. It will not go below that level -
|
|
28
28
|
`startView="day"` in 'year' mode is raised to 'year'. The 'month' mode stays on 'month'
|
|
29
29
|
(the value is just 'MM', there is nothing to navigate), and the 'time' mode ignores the input.
|
|
30
|
-
- `hourFormat`: 12 | 24 (default 24)
|
|
31
|
-
- `minuteStep`: number (default 1)
|
|
32
|
-
- `monthDisplay`: 'long' | 'number' (default 'long')
|
|
33
|
-
- `displayFormat`: 'pl' | 'iso' (default 'pl')
|
|
30
|
+
- `hourFormat`: 12 | 24 (default 24) - an AM/PM dial (12) or one with a 13-00 ring (24); the value is always 24h.
|
|
31
|
+
- `minuteStep`: number (default 1) - minute snapping on the dial.
|
|
32
|
+
- `monthDisplay`: 'long' | 'number' (default 'long') - in 'month' mode and in month labels: as a word (January) or a number (01)
|
|
33
|
+
- `displayFormat`: 'pl' | 'iso' | 'locale' (default 'pl') - the display format and the default placeholder
|
|
34
34
|
- `disabled`/`invalid`/`touched`: boolean; the `touch` output.
|
|
35
|
-
- `open`: model (two-way `[(open)]`, the `(openChange)` output)
|
|
36
|
-
it from outside and know when the user is done choosing
|
|
35
|
+
- `open`: model (two-way `[(open)]`, the `(openChange)` output) - the calendar state. It lets you open
|
|
36
|
+
it from outside and know when the user is done choosing - that is what inline editing
|
|
37
37
|
in `kpt-data-table` does, see `data-table/llms.txt`. `touch` fires when the panel closes and when
|
|
38
38
|
focus leaves the closed trigger; focus moving into the calendar does not count as leaving.
|
|
39
|
-
- `ariaLabel`: string|null
|
|
39
|
+
- `ariaLabel`: string|null - the accessible name when no `<label for>` describes the field
|
|
40
40
|
(two times in one editor row, for instance). Without it a screen reader announces the value alone.
|
|
41
41
|
- The icon in the field: a calendar, and a clock in 'time' mode.
|
|
42
|
-
- The panel: a clear button (
|
|
42
|
+
- The panel: a clear button (x), the clock dial with "Done".
|
|
43
43
|
|
|
44
44
|
## Keyboard
|
|
45
45
|
The date picker dialog pattern. The trigger has `aria-haspopup="dialog"` and `aria-expanded`;
|
|
46
|
-
`Enter`, `Space` and
|
|
46
|
+
`Enter`, `Space` and `ArrowDown` open the panel - a `role="dialog"` named "Choose a date" - and move focus to
|
|
47
47
|
the selected day, or today, clamped to `minDate`/`maxDate`.
|
|
48
|
-
- Day grid:
|
|
48
|
+
- Day grid: `ArrowLeft`/`ArrowRight` one day, `ArrowUp`/`ArrowDown` one week, `Home`/`End` Monday and Sunday of the week,
|
|
49
49
|
`PageUp`/`PageDown` one month, with `Shift` one year (the day is clamped to the month length).
|
|
50
50
|
Crossing a month edge turns the page. Each day is named with the full date from `Intl`
|
|
51
51
|
("Thursday, October 8, 2026"), today has `aria-current="date"`, and only the focused day is
|
|
@@ -53,36 +53,53 @@ the selected day, or today, clamped to `minDate`/`maxDate`.
|
|
|
53
53
|
- Month, year and decade grids: the arrows move between cells (three columns), `Home`/`End` to the ends.
|
|
54
54
|
Clicking a title moves focus to the new grid.
|
|
55
55
|
- `Tab` cycles inside the panel; `Escape` closes it. Picking a value (or "Done") closes the panel
|
|
56
|
-
and returns focus to the trigger. `Delete`/`Backspace` on the trigger clears the value; the "
|
|
56
|
+
and returns focus to the trigger. `Delete`/`Backspace` on the trigger clears the value; the "x" button
|
|
57
57
|
sits outside the Tab order.
|
|
58
58
|
|
|
59
59
|
## Behavior (the view stack)
|
|
60
|
-
The panel header always has the shape
|
|
60
|
+
The panel header always has the shape `< title >`; the arrows move the current level's page,
|
|
61
61
|
and the title is a button that goes one level up:
|
|
62
62
|
|
|
63
|
-
day
|
|
64
|
-
month
|
|
65
|
-
year
|
|
66
|
-
decade
|
|
63
|
+
day < [June] [1979] > arrows +/-1 month; the chips -> months / years
|
|
64
|
+
month < [1979] > arrows +/-1 year; the chip -> years
|
|
65
|
+
year < [1970 - 1979] > arrows +/-10 years; the chip -> decades
|
|
66
|
+
decade < 1920 - 2039 > arrows +/-120 years; the top of the stack, the title is not clickable
|
|
67
67
|
|
|
68
|
-
A year page is a **full decade** (10 cells, 1970
|
|
68
|
+
A year page is a **full decade** (10 cells, 1970-1979), a decade page holds 12 decades (1920-2039).
|
|
69
69
|
Clicking a cell above the committing level goes down; on the committing level it sets
|
|
70
70
|
the value and closes the panel. The cell containing today gets an outline (like "today" in the day grid).
|
|
71
71
|
An arrow dims (`disabled`) when the whole neighboring page falls outside `minDate`/`maxDate`.
|
|
72
72
|
|
|
73
73
|
## i18n
|
|
74
74
|
Weekday and month names are derived from `Intl` per the active i18n locale (not from the dictionary).
|
|
75
|
-
The navigation/aria labels ("previous decades", "choose a year", the dialog name
|
|
75
|
+
The navigation/aria labels ("previous decades", "choose a year", the dialog name...) and "Done" come from i18n
|
|
76
76
|
(the `datepicker` + `common` namespaces). English by default;
|
|
77
|
-
configured through `provideKptI18n`
|
|
78
|
-
controls the date format only and is independent of the label language.
|
|
77
|
+
configured through `provideKptI18n` - see `i18n/llms.txt`. Note: `displayFormat` 'pl'/'iso'
|
|
78
|
+
controls the date format only and is independent of the label language; 'locale' follows it.
|
|
79
79
|
|
|
80
80
|
## Core
|
|
81
|
-
The grids, bounds, paging and formats come from `@konce-pt/datetime`
|
|
81
|
+
The grids, bounds, paging and formats come from `@konce-pt/datetime` - the same framework-free
|
|
82
82
|
package the React port uses, with its own tests. The component holds signals and markup only.
|
|
83
83
|
|
|
84
|
+
## Week start, display format and field state
|
|
85
|
+
- The week starts by the `KptI18n` language (`Intl.Locale#getWeekInfo`, with a fallback list of regions):
|
|
86
|
+
en / en-US on Sunday, pl, de, en-GB on Monday. `firstDayOfWeek` (1 = Monday ... 7 = Sunday) overrides it;
|
|
87
|
+
the headers, the grid and `Home`/`End` follow it.
|
|
88
|
+
- `displayFormat`: `'pl'` (DD.MM.YYYY, default), `'iso'` (YYYY-MM-DD) or `'locale'` - order and separators
|
|
89
|
+
from `Intl` (en-US: MM/DD/YYYY). The placeholder follows the format and its letters follow the language
|
|
90
|
+
(EN `YYYY`, PL `RRRR`, the `datepicker.yearToken`/`monthToken`/`dayToken` keys). AM/PM come from `Intl`.
|
|
91
|
+
- The field is `role="combobox"` with `aria-haspopup="dialog"` (the APG select-only combobox), so it carries
|
|
92
|
+
`aria-required` (`required`), `aria-readonly` (`readonly` - the value shows, the panel does not open,
|
|
93
|
+
there is no clear button) and `aria-invalid`.
|
|
94
|
+
- Turning the page with < > is announced (`aria-live="polite"`); the title buttons are named
|
|
95
|
+
"October, Choose month" - the visible text first (WCAG 2.5.3). Clearing the value counts as a touch.
|
|
96
|
+
- "Today" is computed on every open, so a panel opened after midnight marks the right day.
|
|
97
|
+
- The clock (`kpt-clock`): the hour and minute segments are `role="spinbutton"` - `ArrowUp`/`ArrowDown` by one (minutes by
|
|
98
|
+
`minuteStep`), `PageUp`/`PageDown` by five, `Home`/`End` to the bounds - so every minute is reachable from
|
|
99
|
+
the keyboard, not only the five-minute marks.
|
|
100
|
+
|
|
84
101
|
## Label and description
|
|
85
|
-
`id` goes to the focusable element
|
|
102
|
+
`id` goes to the focusable element - the host never carries it; without one it is generated. A `div`
|
|
86
103
|
with a role is not named by `label[for]`, so inside `kpt-form-field` it gets `aria-labelledby`
|
|
87
104
|
pointing at the wrapper's label (unless `ariaLabel` is set), and the hint or error is added to
|
|
88
105
|
`aria-describedby`. No `controlId` needed. New: `id`; the trigger is the element that carries it.
|
package/src/lib/dialog/llms.txt
CHANGED
|
@@ -7,26 +7,26 @@ Import: `import { KptDialog } from '@konce-pt/angular';`
|
|
|
7
7
|
`kpt-dialog`
|
|
8
8
|
|
|
9
9
|
## Inputs
|
|
10
|
-
- `open`: model<boolean>
|
|
11
|
-
- `header`: string; `dismissible`: boolean (Esc
|
|
12
|
-
- `size`: 'sm' | 'md' | 'lg' (default 'md')
|
|
10
|
+
- `open`: model<boolean> - two-way `[(open)]`
|
|
11
|
+
- `header`: string; `dismissible`: boolean (Esc/x closes it; default true)
|
|
12
|
+
- `size`: 'sm' | 'md' | 'lg' (default 'md') - 24rem / 32rem / 48rem, always capped at the viewport
|
|
13
13
|
(`min(var(--_width), calc(100vw - 2rem))`). Reach for `lg` when the content cannot sensibly be
|
|
14
14
|
narrowed: code, a table, two columns side by side.
|
|
15
|
-
- `ariaLabel`: string
|
|
16
|
-
- `ariaDescribedby`: string | null
|
|
17
|
-
- `alert`: boolean
|
|
18
|
-
- `ariaLabel`: string
|
|
19
|
-
- `ariaDescribedby`: string | null
|
|
20
|
-
- `alert`: boolean
|
|
21
|
-
- `ariaLabel`: string
|
|
22
|
-
- `ariaDescribedby`: string | null
|
|
23
|
-
- `alert`: boolean
|
|
24
|
-
- `ariaLabel`: string
|
|
25
|
-
- `ariaDescribedby`: string | null
|
|
26
|
-
- `alert`: boolean
|
|
15
|
+
- `ariaLabel`: string - the name of a dialog with no `header` (with one, the header names it)
|
|
16
|
+
- `ariaDescribedby`: string | null - the `id` of the element that describes the dialog
|
|
17
|
+
- `alert`: boolean - `role="alertdialog"`, for a window that interrupts and demands an answer
|
|
18
|
+
- `ariaLabel`: string - the name of a dialog with no `header` (with one, the header names it)
|
|
19
|
+
- `ariaDescribedby`: string | null - the `id` of the element that describes the dialog
|
|
20
|
+
- `alert`: boolean - `role="alertdialog"`, for a window that interrupts and demands an answer
|
|
21
|
+
- `ariaLabel`: string - the name of a dialog with no `header` (with one, the header names it)
|
|
22
|
+
- `ariaDescribedby`: string | null - the `id` of the element that describes the dialog
|
|
23
|
+
- `alert`: boolean - `role="alertdialog"`, for a window that interrupts and demands an answer
|
|
24
|
+
- `ariaLabel`: string - the name of a dialog with no `header` (with one, the header names it)
|
|
25
|
+
- `ariaDescribedby`: string | null - the `id` of the element that describes the dialog
|
|
26
|
+
- `alert`: boolean - `role="alertdialog"`, for a window that interrupts and demands an answer
|
|
27
27
|
|
|
28
28
|
## Slots
|
|
29
|
-
- the default content
|
|
29
|
+
- the default content -> the body; an element with the `kptDialogFooter` attribute -> the footer
|
|
30
30
|
|
|
31
31
|
## Example
|
|
32
32
|
<kpt-dialog [(open)]="confirmOpen" header="Delete this?">
|
|
@@ -39,19 +39,19 @@ Import: `import { KptDialog } from '@konce-pt/angular';`
|
|
|
39
39
|
|
|
40
40
|
## Tokens
|
|
41
41
|
`--kpt-color-surface-raised`, `--kpt-color-overlay-scrim` (::backdrop), `--kpt-elevation-4`.
|
|
42
|
-
Note: the global reset zeroes the margin
|
|
42
|
+
Note: the global reset zeroes the margin - the component restores `margin:auto` (centering).
|
|
43
43
|
|
|
44
44
|
## CDK Overlay controls inside the dialog
|
|
45
45
|
|
|
46
46
|
`kpt-dialog` stands on the native `<dialog>` and opens through `showModal()`, which lifts it
|
|
47
|
-
into the browser's **top layer**
|
|
47
|
+
into the browser's **top layer** - and that sits above the entire document tree, where no
|
|
48
48
|
`z-index` can reach it. The CDK Overlay container hangs off `<body>` by default, so the panels of
|
|
49
49
|
`kpt-select`, `kpt-datepicker`, `kpt-autocomplete` and `kpt-menu` would open inside the
|
|
50
50
|
dialog INVISIBLE, hidden behind its background.
|
|
51
51
|
|
|
52
52
|
That is why, while it is open, `kpt-dialog` moves the overlay container inside the `<dialog>`
|
|
53
53
|
and puts it back on close (including when the component is destroyed
|
|
54
|
-
with the dialog open). Nothing needs configuring
|
|
54
|
+
with the dialog open). Nothing needs configuring - overlay controls behave inside the dialog
|
|
55
55
|
exactly as they do outside it.
|
|
56
56
|
|
|
57
57
|
## Layout and scrolling
|
|
@@ -62,15 +62,15 @@ The scrollbar therefore runs alongside the content, not alongside the whole dial
|
|
|
62
62
|
|
|
63
63
|
The content gets `flex: 0 1 auto` (the default) + `min-height: 0`, deliberately **not** `flex: 1`
|
|
64
64
|
as in `kpt-drawer`. A drawer fills the height of the screen, a dialog is meant to shrink to its content:
|
|
65
|
-
a short one (`kpt-confirm`
|
|
65
|
+
a short one (`kpt-confirm` - two sentences and two buttons) stays short, a long one stops
|
|
66
66
|
at `max-height: calc(100vh - 4rem)` and scrolls the content alone.
|
|
67
67
|
|
|
68
68
|
The `display: flex` declaration is scoped with `&[open]` and has to stay that way. The
|
|
69
69
|
`dialog:not([open]) { display: none }` rule comes from the browser stylesheet, and any author
|
|
70
|
-
declaration beats it
|
|
70
|
+
declaration beats it - including one inside `@layer`. An unscoped `display: flex` would leave every
|
|
71
71
|
closed dialog visible on the page.
|
|
72
72
|
|
|
73
|
-
`.kpt-dialog` does not get `overflow: hidden`
|
|
73
|
+
`.kpt-dialog` does not get `overflow: hidden` - while it is open the CDK Overlay container is
|
|
74
74
|
moved inside the `<dialog>` (see the section above), so clipping the dialog would cut off the
|
|
75
75
|
panels of `kpt-select` or `kpt-datepicker`. It is not needed for scrolling either:
|
|
76
76
|
once it is a flex column, nothing sticks out of the dialog.
|
|
@@ -78,19 +78,22 @@ once it is a flex column, nothing sticks out of the dialog.
|
|
|
78
78
|
## The footer wraps
|
|
79
79
|
|
|
80
80
|
`[kptDialogFooter]` is a flex row with `flex-wrap: wrap`, and the wrapping is not cosmetic.
|
|
81
|
-
A dialog that does not fit its buttons does not let them stick out
|
|
81
|
+
A dialog that does not fit its buttons does not let them stick out - they get **clipped**, because
|
|
82
82
|
the browser gives `<dialog>` its own scrolling box. Four buttons in an `sm` dialog are enough for
|
|
83
83
|
the first one to become unreadable with no way to reach it. Wrapping turns that into a second row.
|
|
84
84
|
|
|
85
85
|
A pinned action bar inside the content (say "Cancel / Save" in `kpt-map-create-dialog`)
|
|
86
|
-
is done with `position: sticky`
|
|
86
|
+
is done with `position: sticky` - the scrolling container is `.kpt-dialog__body`.
|
|
87
87
|
The negative side margins have to match its padding (`--kpt-space-6`),
|
|
88
88
|
and the `bottom` offset has to mirror the negative bottom margin
|
|
89
|
-
(`bottom: calc(var(--kpt-space-6) * -1)`)
|
|
89
|
+
(`bottom: calc(var(--kpt-space-6) * -1)`) - stickiness is computed for the margin
|
|
90
90
|
box, so with `bottom: 0` a sliver of content would slide underneath the bar.
|
|
91
91
|
|
|
92
92
|
## Accessibility
|
|
93
93
|
`showModal()` gives the focus trap, Escape and the inert page; focus returns to the opener on
|
|
94
94
|
close. With `header` the dialog is named by its `<h2>` (`aria-labelledby`); without it pass
|
|
95
95
|
`ariaLabel`. `alert` + `ariaDescribedby` make it an alert dialog whose message is read out on
|
|
96
|
-
open
|
|
96
|
+
open - `kpt-confirm-container` uses exactly that.
|
|
97
|
+
|
|
98
|
+
## Scrolling and non-dismissible windows
|
|
99
|
+
An open window locks page scrolling underneath (a shared counter with drawers and bottom sheets, so nested windows do not release each other). With `dismissible` off the window gets `closedby="none"`, and if a browser still closes it on a gesture (Chromium lets the second Escape in a row through `cancel`), it is reopened - only code can close it.
|
package/src/lib/divider/llms.txt
CHANGED
|
@@ -8,7 +8,8 @@ Import: `import { KptDivider } from '@konce-pt/angular';`
|
|
|
8
8
|
|
|
9
9
|
## Inputs
|
|
10
10
|
- `orientation`: 'horizontal' | 'vertical' (default 'horizontal')
|
|
11
|
-
- `inset`: boolean
|
|
11
|
+
- `inset`: boolean - inset from the container edges
|
|
12
|
+
- `decorative`: boolean - a purely ornamental line (e.g. between cards that are regions anyway): no `role="separator"`, hidden from screen readers
|
|
12
13
|
|
|
13
14
|
## Example
|
|
14
15
|
<kpt-divider />
|
package/src/lib/drawer/llms.txt
CHANGED
|
@@ -6,27 +6,30 @@ A sliding panel (drawer / off-canvas) driven by the `open` signal. Independent o
|
|
|
6
6
|
## Inputs / model
|
|
7
7
|
- `open`: model<boolean> (two-way)
|
|
8
8
|
- `position`: 'left' | 'right' | 'top' | 'bottom' (KptDrawerPosition)
|
|
9
|
-
- `header`: string; `dismissible`: boolean (
|
|
9
|
+
- `header`: string; `dismissible`: boolean (x and Esc); `closeOnBackdrop`: boolean
|
|
10
10
|
- Content through the `<ng-content>` projection.
|
|
11
11
|
|
|
12
12
|
## Example
|
|
13
13
|
<kpt-button (click)="menuOpen.set(true)">Menu</kpt-button>
|
|
14
|
-
<kpt-drawer [(open)]="menuOpen" position="right" header="Filters"
|
|
14
|
+
<kpt-drawer [(open)]="menuOpen" position="right" header="Filters">...</kpt-drawer>
|
|
15
15
|
|
|
16
16
|
## The closed state / a11y
|
|
17
|
-
The panel is always in the DOM (no `@if`), hidden with `transform` **and** `visibility: hidden`
|
|
17
|
+
The panel is always in the DOM (no `@if`), hidden with `transform` **and** `visibility: hidden` - never
|
|
18
18
|
`display: none`, so that the slide-in and slide-out animations survive. `visibility` takes the closed panel
|
|
19
19
|
out of the tab order and out of the accessibility tree without `inert`, and it does so on the very first frame,
|
|
20
20
|
without waiting for JavaScript. Both closed-state declarations live in the **base** rule, not in
|
|
21
|
-
`[data-position]`
|
|
21
|
+
`[data-position]` - Angular only sets the position attribute during the update pass, so a panel gated on that
|
|
22
22
|
attribute would flash on screen and then animate away. `prefers-reduced-motion: reduce`
|
|
23
23
|
drops the transitions.
|
|
24
24
|
|
|
25
25
|
## Focus and keyboard
|
|
26
26
|
Opening moves focus into the panel (`cdkFocusInitial`, else its first focusable element, else the
|
|
27
|
-
panel itself) and traps it there
|
|
28
|
-
Closing returns focus to the element that had it before. `Escape` closes the panel
|
|
27
|
+
panel itself) and traps it there - `Tab` / `Shift+Tab` wrap inside, as `aria-modal="true"` promises.
|
|
28
|
+
Closing returns focus to the element that had it before. `Escape` closes the panel - only when `dismissible`, like the `x` button. The panel
|
|
29
29
|
is named by its `header` through `aria-labelledby`. The shared helper is `shared/modal-focus.ts` (on the CDK focus trap; the React port has a twin hook).
|
|
30
30
|
|
|
31
31
|
## Tokens
|
|
32
32
|
The panel `--kpt-color-surface-raised`, `--kpt-elevation-4`; the backdrop `--kpt-color-overlay-scrim`.
|
|
33
|
+
|
|
34
|
+
## Name and scrolling
|
|
35
|
+
Without `header` give the panel `ariaLabel` - a `role="dialog"` without a name is announced as a bare "dialog". An open drawer locks page scrolling underneath.
|
package/src/lib/empty/llms.txt
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
# KptEmpty (kpt-empty)
|
|
2
2
|
|
|
3
|
-
An empty state
|
|
3
|
+
An empty state - an icon, a title, a description and optional actions (content projection).
|
|
4
4
|
Import: `import { KptEmpty } from '@konce-pt/angular';`
|
|
5
5
|
|
|
6
6
|
## Inputs
|
|
7
7
|
- `icon`: string | null (default 'info-circle')
|
|
8
8
|
- `title`: string; `description`: string
|
|
9
|
-
- `headingLevel`: 1
|
|
9
|
+
- `headingLevel`: 1-6 | null (default null) - makes the title a heading (`role="heading"` + `aria-level`)
|
|
10
10
|
- Actions: `<ng-content>` (buttons, for instance).
|
|
11
11
|
|
|
12
12
|
## Example
|
|
@@ -18,6 +18,6 @@ Import: `import { KptEmpty } from '@konce-pt/angular';`
|
|
|
18
18
|
The icon sits in a `--kpt-color-muted` circle; text `--kpt-color-on-surface(-muted)`.
|
|
19
19
|
|
|
20
20
|
## Accessibility
|
|
21
|
-
The icon is decorative. The title is a styled paragraph unless `headingLevel` makes it a heading
|
|
21
|
+
The icon is decorative. The title is a styled paragraph unless `headingLevel` makes it a heading -
|
|
22
22
|
use that when the empty state stands in for a whole section. Replacing results with an empty state
|
|
23
|
-
is not announced; report
|
|
23
|
+
is not announced; report "0 results" in a live region of your own.
|
package/src/lib/fab/llms.txt
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# KptFab (kpt-fab)
|
|
2
2
|
|
|
3
|
-
A floating action button
|
|
3
|
+
A floating action button - a raised action button (a rounded square; `extended` is a pill). Import: `import { KptFab } from '@konce-pt/angular';`
|
|
4
4
|
|
|
5
5
|
## Inputs
|
|
6
6
|
- `variant`: 'filled' | 'tonal' (default 'filled')
|
|
@@ -8,7 +8,7 @@ A floating action button — a raised action button (a rounded square; `extended
|
|
|
8
8
|
- `extended`: boolean (a pill with text)
|
|
9
9
|
- `disabled`: boolean; `type`: 'button' | 'submit' | 'reset'
|
|
10
10
|
- `ariaLabel`: string (required for the round, textless variant)
|
|
11
|
-
- `ariaExpanded`: `boolean | null` = `null`, `ariaControls`: `string | null` = `null`
|
|
11
|
+
- `ariaExpanded`: `boolean | null` = `null`, `ariaControls`: `string | null` = `null` - for a FAB that opens
|
|
12
12
|
a panel (`kpt-speed-dial` uses them); they land on the inner `<button>`, the host has no button role
|
|
13
13
|
|
|
14
14
|
## Example
|
|
@@ -16,6 +16,10 @@ A floating action button — a raised action button (a rounded square; `extended
|
|
|
16
16
|
<kpt-fab extended><kpt-icon name="plus" /> New</kpt-fab>
|
|
17
17
|
<kpt-fab variant="tonal" size="mini" ariaLabel="Edit"><kpt-icon name="copy" /></kpt-fab>
|
|
18
18
|
|
|
19
|
+
## Motion
|
|
20
|
+
Pressed, it squeezes slightly and springs back on release (shared mixin `styles/_press.scss`). Pure CSS; durations follow `--kpt-motion-scale`, so `enabled: false` turns it off, and it drops out
|
|
21
|
+
under "reduce motion".
|
|
22
|
+
|
|
19
23
|
## Tokens
|
|
20
24
|
Background `--kpt-color-primary` / `--kpt-color-muted` (tonal); shadow `--kpt-elevation-3`, `--kpt-elevation-4` on hover;
|
|
21
25
|
shape `--kpt-radius-lg` (md), `--kpt-radius-md` (mini), `--kpt-radius-full` (extended).
|
|
@@ -5,13 +5,31 @@ Import: `import { KptFieldset } from '@konce-pt/angular';`
|
|
|
5
5
|
|
|
6
6
|
## Inputs / model
|
|
7
7
|
- `legend`: string
|
|
8
|
+
- `variant`: 'outlined' | 'filled' (default 'outlined') - `outlined` is just the frame on the parent's
|
|
9
|
+
background; `filled` puts the group on the surface colour (sections inside a grey panel, say).
|
|
10
|
+
The legend takes the group's background with rounded ends, so where it crosses the frame it reads
|
|
11
|
+
as one element, never as a strip in two colours
|
|
8
12
|
- `toggleable`: boolean; `collapsed`: model<boolean>
|
|
9
|
-
- `animated`: boolean (default true)
|
|
10
|
-
- `animationDuration`: number (default 500)
|
|
13
|
+
- `animated`: boolean (default true) - the collapse animation (CSS grid, pure CSS)
|
|
14
|
+
- `animationDuration`: number (default 500) - animation time in ms
|
|
15
|
+
- `collapseMotion`: `'spring' | 'fade' | 'none'` (default from `provideKptMotion`, else `spring`) - see "Collapse motion"
|
|
11
16
|
- Content: `<ng-content>`.
|
|
12
17
|
|
|
13
18
|
## Example
|
|
14
|
-
<kpt-fieldset legend="Personal details" toggleable
|
|
19
|
+
<kpt-fieldset legend="Personal details" toggleable>...</kpt-fieldset>
|
|
20
|
+
<kpt-fieldset legend="Scrolling" variant="filled">...</kpt-fieldset>
|
|
21
|
+
|
|
22
|
+
## Collapse motion
|
|
23
|
+
- `spring` - the height opens on a soft spring, the content slides in from above and sharpens out
|
|
24
|
+
of a blur; when collapsing, the content fades first and only then the section closes. The chevron
|
|
25
|
+
turns on a spring.
|
|
26
|
+
- `fade` - the height on the standard curve, the content cross-fades.
|
|
27
|
+
- `none` - the state changes without motion.
|
|
28
|
+
|
|
29
|
+
With no value it takes `collapse` from `provideKptMotion` (default `spring`). `animated: false`, `enabled: false`
|
|
30
|
+
in the config and the system "reduce motion" setting always turn it off. `animationDuration` sets
|
|
31
|
+
the time of every kind. Pure CSS: the kind sits in `data-motion` on the component root.
|
|
15
32
|
|
|
16
33
|
## Tokens
|
|
17
|
-
Border `--kpt-color-border`; radius `--kpt-radius-md
|
|
34
|
+
Border `--kpt-color-border`; radius `--kpt-radius-md`; `filled` background `--kpt-color-surface`;
|
|
35
|
+
legend corners `--kpt-radius-full`.
|
|
@@ -32,3 +32,6 @@ The file list shows the name, the size and a remove button.
|
|
|
32
32
|
## Tokens
|
|
33
33
|
The zone `--kpt-color-border-strong` (dashed), hover / dragover `--kpt-color-primary`, error `--kpt-color-danger`,
|
|
34
34
|
focus ring `--kpt-color-focus-ring`.
|
|
35
|
+
|
|
36
|
+
## Read-only and required
|
|
37
|
+
`readonly` shows the list without the remove buttons and does not open the picker nor accept a drop. The zone takes `id` and `ariaLabel` and is linked to `kpt-form-field` (label and description); `button` accepts neither `aria-invalid` nor `aria-required`, so the error is the linked message. The hint is plain text: `fileUpload.hint` with `{action}` and `fileUpload.hintAction` (bold) - dictionaries no longer carry HTML. The remove button names the file.
|