@1337exp/taoui 5.9.0 → 5.11.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 +20 -0
- package/README.md +3 -3
- package/README.ru.md +3 -3
- package/dist/index.d.ts +72 -1
- package/dist/index.js +27 -13
- package/dist/index.js.map +1 -1
- package/dist/styles.css +1 -1
- package/package.json +1 -1
- package/skills/taoui/SKILL.md +5 -2
- package/skills/taoui/references/components.md +6 -1
- package/src/styles/tokens/semantic.css +7 -0
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@1337exp/taoui",
|
|
3
|
-
"version": "5.
|
|
3
|
+
"version": "5.11.0",
|
|
4
4
|
"description": "Design-token driven Vue 3 / Nuxt component library: palettes with tested contrast, accessible menus and toolbars, navigation that adapts without JS, small charts, built-in locales.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"vue",
|
package/skills/taoui/SKILL.md
CHANGED
|
@@ -70,7 +70,9 @@ choose a text colour, WCAG 2 to promise a number.
|
|
|
70
70
|
number is one column on compact. `rowHeight` is the exact row height (a mosaic: pictures are cropped).
|
|
71
71
|
- `TaoNav` — app navigation from one list: a bottom bar, a rail or a drawer, `layout="auto"` by its own width; put the page
|
|
72
72
|
in its default slot and it lays it out. `floating` makes the bar a detached pill (the FAB is your own button beside
|
|
73
|
-
it). `select(id, event)` + `event.preventDefault()` to route with a router.
|
|
73
|
+
it). `select(id, event)` + `event.preventDefault()` to route with a router. Widths `--tao-nav-rail-width` /
|
|
74
|
+
`--tao-nav-drawer-width`; the action button may take `shortcut="N"` (shown in the side panel, hidden when round). `surface="glass"` for a
|
|
75
|
+
translucent bar over the page (as on TaoCard; it turns solid where blur is off).
|
|
74
76
|
|
|
75
77
|
## Forms
|
|
76
78
|
|
|
@@ -82,7 +84,8 @@ choose a text colour, WCAG 2 to promise a number.
|
|
|
82
84
|
`TaoRangeSlider`, `TaoPinCode` (`status="success | error"` after `complete`), `TaoColorInput` / `TaoColorPicker`,
|
|
83
85
|
`TaoFileDrop`. A form is a plain `<form>`; there is no TaoForm.
|
|
84
86
|
- Attributes given to a field (`aria-label`, `name`, `autocomplete`, `inputmode`, `data-*`, listeners) reach its control
|
|
85
|
-
(the input, the trigger button, the checkbox); `class` and `style` stay on its wrapper.
|
|
87
|
+
(the input, the trigger button, the checkbox); `class` and `style` stay on its wrapper. A field that reads as text
|
|
88
|
+
(an item of a list being edited): `<TaoInput variant="plain">` (`TaoInputNumber`, `TaoCombobox` and `TaoTextarea` take the same `variant`). On `TaoColorInput` the
|
|
86
89
|
`aria-label` is followed by the colour («Background: #ff8800»); `TaoColorPicker` is a group it names.
|
|
87
90
|
|
|
88
91
|
## Overlays and feedback
|
|
@@ -36,6 +36,7 @@ Showcase section: `#button`
|
|
|
36
36
|
| `icon` | `string` | '' | An icon before the text: a name for TaoIcon (tao-plus, your own or a font one). Without text and slot the button is a square of the control height and needs aria-label |
|
|
37
37
|
| `iconEnd` | `string` | '' | An icon after the text |
|
|
38
38
|
| `v-model:pressed` | `boolean` | — | A toggle button (Bold, a filter): aria-pressed and the tone tint while pressed. Without it the button is an ordinary one |
|
|
39
|
+
| `shortcut` | `string` | — | The key that does the same (N, Ctrl+K): shown at the end of the button, given as aria-keyshortcuts. It only shows the key; listening to it is the app's job |
|
|
39
40
|
|
|
40
41
|
**Slots, events, notes.** default — the button caption.
|
|
41
42
|
|
|
@@ -126,6 +127,7 @@ Showcase section: `#input`
|
|
|
126
127
|
| `size` | `'small' \| 'medium' \| 'large'` | inherited | Size, the same scale as TaoButton. Without it — the size of the ancestors (tao-size-* or size on FormField / InputGroup), otherwise medium |
|
|
127
128
|
| `disabled` | `boolean` | false | Disabled |
|
|
128
129
|
| `error` | `boolean` | false | A red border. The error text is error on TaoFormField |
|
|
130
|
+
| `variant` | `'outline' \| 'filled' \| 'plain'` | 'outline' | A frame / a fill only / nothing: plain reads as text (an item of a list being edited): no inset, the caret shows the focus, an error is a red line under the text. The height does not change |
|
|
129
131
|
| `id` | `string` | auto | The input id; otherwise taken from FormField or useId |
|
|
130
132
|
|
|
131
133
|
**Slots, events, notes.** #prefix and #suffix — inside the frame, left/right (an icon, text).
|
|
@@ -155,6 +157,7 @@ Showcase section: `#input-number`
|
|
|
155
157
|
| `size` | `'small' \| 'medium' \| 'large'` | inherited | Size, the same scale as TaoButton. Without it — the size of the ancestors (tao-size-* or size on FormField / InputGroup), otherwise medium |
|
|
156
158
|
| `disabled` | `boolean` | false | Disabled |
|
|
157
159
|
| `error` | `boolean` | false | A red border. The error text is error on TaoFormField |
|
|
160
|
+
| `variant` | `'outline' \| 'filled' \| 'plain'` | 'outline' | As on TaoInput: a frame / a fill only / nothing (the field reads as text, an error is a red line under the text) |
|
|
158
161
|
| `placeholder` | `string` | '' | The hint when null |
|
|
159
162
|
|
|
160
163
|
## TaoQuantity
|
|
@@ -332,6 +335,7 @@ Showcase section: `#combobox`
|
|
|
332
335
|
| `clearable` | `boolean` | true | Clear row in the list. Turn off when null is not valid. |
|
|
333
336
|
| `clearText` | `string` | 'Clear' | Label of the clear row; slot #clear replaces it. |
|
|
334
337
|
| `disabled / error` | `boolean` | false | Disabled / a red border |
|
|
338
|
+
| `variant` | `'outline' \| 'filled' \| 'plain'` | 'outline' | As on TaoInput: a frame / a fill only / nothing (the field reads as text, an error is a red line under the text) |
|
|
335
339
|
|
|
336
340
|
**Slots, events, notes.** create — an event when a new value is typed: the parent extends options itself.
|
|
337
341
|
|
|
@@ -1061,8 +1065,9 @@ Showcase section: `#tao-nav`
|
|
|
1061
1065
|
| `moreLabel` | `string` | 'More' | The label of «More» |
|
|
1062
1066
|
| `indicator` | `'pill' \| 'line'` | 'pill' | How the current section is marked: a tint behind the item, or the accent colour and a short line (under the item in the bar, along its start edge on the side; auto moves it) |
|
|
1063
1067
|
| `floating` | `boolean` | false | In the bar look, a detached pill above the page: inset from the edges and above the safe area, round, with a shadow; the active item is a pill too. The rail and the side panel do not change. The main action of the screen goes beside it as your own round button, not into the bar |
|
|
1068
|
+
| `surface` | `'flat' \| 'glass' \| 'grain'` | 'flat' | What the panel is made of, as on TaoCard: glass lets the page show blurred through the bar as it scrolls under it (solid where blur is not supported or less transparency is asked) |
|
|
1064
1069
|
|
|
1065
|
-
**Slots, events, notes.** default — the page: TaoNav lays it out next to the navigation (the bar sticks to the bottom, on the side the list sticks to the top; env(safe-area-inset-bottom) is kept). Without the slot it is a standalone panel with a border. #label — your own item label ({ item, active }). #action — the main action of the screen: a TaoButton with icon and its text in <span class="tao-nav__action-label">; the bar puts it round above itself at the end side (above the pill with floating), the rail round at the top, the side panel extended with the text at the top; in the round looks the text is hidden but stays the name of the button. Events: update:modelValue, select(id, event) — event.preventDefault() keeps a link from navigating, to route it yourself.
|
|
1070
|
+
**Slots, events, notes.** default — the page: TaoNav lays it out next to the navigation (the bar sticks to the bottom, on the side the list sticks to the top; env(safe-area-inset-bottom) is kept). Without the slot it is a standalone panel with a border. #label — your own item label ({ item, active }). #action — the main action of the screen: a TaoButton with icon and its text in <span class="tao-nav__action-label">; the bar puts it round above itself at the end side (above the pill with floating), the rail round at the top, the side panel extended with the text at the top; in the round looks the text is hidden but stays the name of the button (a shortcut on it too). The side panel gives the button its own corners; --tao-nav-action-radius: var(--tao-radius-full) makes it a pill. --tao-nav-rail-width (80px) and --tao-nav-drawer-width (240px) set the widths. Events: update:modelValue, select(id, event) — event.preventDefault() keeps a link from navigating, to route it yourself.
|
|
1066
1071
|
|
|
1067
1072
|
## TaoTabs
|
|
1068
1073
|
|
|
@@ -30,4 +30,11 @@
|
|
|
30
30
|
transform var(--tao-duration-hover) var(--tao-ease-base),
|
|
31
31
|
fill var(--tao-duration-hover) var(--tao-ease-base),
|
|
32
32
|
stroke var(--tao-duration-hover) var(--tao-ease-base);
|
|
33
|
+
|
|
34
|
+
/* ---------- TaoNav ---------- */
|
|
35
|
+
/* The rail and the side panel widths, the corners of the action in the side panel (round in the compact looks).
|
|
36
|
+
Ширины рейки и боковой панели, углы действия в боковой панели (в компактных видах оно круглое). */
|
|
37
|
+
--tao-nav-rail-width: 80px;
|
|
38
|
+
--tao-nav-drawer-width: 240px;
|
|
39
|
+
--tao-nav-action-radius: var(--tao-radius-control);
|
|
33
40
|
}
|