@1337exp/taoui 5.22.0 → 5.23.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 +18 -2
- package/README.md +13 -4
- package/README.ru.md +13 -4
- package/dist/index.d.ts +171 -8
- package/dist/index.js +1359 -1206
- package/dist/index.js.map +1 -1
- package/dist/styles.css +1 -1
- package/package.json +1 -1
- package/skills/taoui/SKILL.md +3 -0
- package/skills/taoui/references/components.md +17 -3
- package/src/styles/contexts/frames.css +35 -0
- package/src/styles/index.css +2 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,11 +1,27 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
-
## 5.
|
|
3
|
+
## 5.23.0
|
|
4
4
|
|
|
5
5
|
Nothing to migrate; the defaults do not change.
|
|
6
6
|
|
|
7
|
-
- **`TaoPinCode` `bordered
|
|
7
|
+
- **`TaoPinCode` `bordered=false` has no frame in any state.** In 5.22.0 the plain cells still showed a frame for focus and result; now the focus, an error and a success are told by the fill and the digit only (an accent / danger / success tint), and the cells do not jump.
|
|
8
|
+
- **Showcase: a section "Layers & theming".** The real files of the kit (`primitives` → `semantic` → `themes` → `contexts` → `base`) in the order `src/styles/index.css` imports them, each with a note whether it is yours to touch (only the themes are), taken from the source by `?raw`, so the page cannot drift from the library. Below it an own theme by hand: an accent, a page and the corners make a `[data-tao-theme]` file, a preview wears it, and the ratios are rated with the promises of the palettes. `tests/showcase.layers.test.ts` keeps the order equal to `index.css` and the theme's roles real.
|
|
9
|
+
- **`TaoSlider` / `TaoRangeSlider` `zones`: the scale in colour.** `:zones="[{ to: 40, tone: 'info', dot: true }, { to: 70, tone: 'warning', dot: true }, { to: 100, tone: 'danger' }]"`. Each zone runs to its `to` (the first from `min`, the last to `max`), so there are no gaps and no overlaps. `tone` is a colour role of the theme, `color` any CSS colour (it wins; its contrast is yours to keep), `dot` puts a bead where the zone ends, `reveal` keeps the zone clear until the value gets there (the field looks plain and is painted as it fills; its dot shows once the fill has reached it). The bar shows the zones dimmed, the filled part in full colour, and the thumb wears the colour of the zone it stands in. Works with `vertical`, `flat`, `variant="thin"` and a range; marks and `discrete` are untouched. Colour is not a message: say the state in words too. The logic is `normalizeZones` / `zoneAt` / `zoneGradient` in `src/slider.ts`; the types `TaoSliderZone` and `TaoSliderZoneTone` are exported.
|
|
10
|
+
- **`TaoDrawer` (bottom sheet): a graze no longer closes it.** The sheet closed at 30% of its height, or on any flick faster than 0.5 px/ms that went 24 px: a finger that touched it by accident was enough. Now it closes when pulled half of its height, or flung hard (1.2 px/ms or more, a light swipe is not enough: 0.8 px/ms closed it before) after a path of at least 15% of the height; otherwise it comes back. `swipeThreshold` (0.05–1, default `0.5`) sets the share for your sheet. The backdrop already lets go as the sheet is pulled, so the finger sees what releasing now will do.
|
|
11
|
+
- **The mark of the project, and a settings bar in the showcase.** `showcase/public/logo/`: `logo-mark-dark.svg` (a white T for a dark background), `logo-mark-light.svg` (a dark T for a light one) and `favicon.svg` (a tile, with no road markings: at 16px they are only noise), drawn as paths from the design layout; the yellow is `--tao-orange-300`. The READMEs show it with `<picture>`, so GitHub picks the file by its own theme. The showcase wears it in its title (it follows the mode) and as a favicon. The options of the header moved into a one-line bar that sticks to the top while you scroll, made of the kit itself: language, palette and mode are inline (`TaoSegmented`, `TaoSelect`), the rare ones, density and frames, sit in a «View» popover (`TaoPopover`) whose button shows a dot while one of them is off the default. The brand, with the version tag of the build, shows in the bar once it has stuck, the section list sits below it, and on a phone it scrolls away with the page.
|
|
12
|
+
- **A third context: frames (`.tao-frames-soft`).** A light look for the whole app, or for one panel, with one class. `tao-frames-soft` on `<html>` or a container lets the decorative frames of `TaoAlert`, `TaoSpoiler`, `TaoTable`, `TaoList`, `TaoToolbar` and `TaoMenubar` go clear, and the panel is held by its fill: an alert gets a little more tint, a table sits on the raised fill. Nothing moves, the 1px border stays in the box, only unseen. `tao-frames-framed` puts the frames back inside a soft area. `TaoAlert`, `TaoSpoiler`, `TaoTable`, `TaoToolbar` and `TaoMenubar` get `bordered` (not set: follows the context; `true` / `false`: for this panel); `TaoList` keeps its own `bordered`. Not touched on purpose: the frame of a field, the focus ring, and the lines between rows: they say where a control is and what belongs together, and WCAG 1.4.11 asks 3:1 of them. The tokens are `--tao-frame-alpha`, `--tao-frame-tint` and `--tao-frame-fill` (`src/styles/contexts/frames.css`, a new file in the layer order). The showcase has a switch «Frames» in the header. Fields have `variant="filled"` already; its fill is gentle (about 1.1:1 with the page), so use it knowing that.
|
|
13
|
+
- **`TaoScrollTop`: the caption has an outline.** The hover caption (`label`, and the text mode) over a page of text kept only a soft halo, and the words under it still showed through. It now has a crisp outline in the page colour as well (`-webkit-text-stroke` with `paint-order: stroke fill`, so only the outer half of the stroke shows and the letters stay whole): the text under the caption is cut clear, in both themes, with no backing and no colour. Where `paint-order` is not supported for HTML text (before Chrome 123) the halo is all there is, as before; `@supports` keeps a stroke from eating the letters there.
|
|
14
|
+
- **`TaoStages`: the icons stand on the middle of the label, and the spinner turns about its own centre.** The icon box was a block span, so the svg sat on the text baseline and the box grew by the line gap under it (14 px became 17): every icon was 1.5 px above the middle of its label, and the `work` mark turned about the centre of that taller box and wobbled. The box is now exactly the svg. A test keeps the mark from becoming a block again.
|
|
15
|
+
- **`TaoCarousel`: the track keeps the browser's own cursor.** The `grab` / `grabbing` cursors are gone: system cursors differ much between browsers (Opera showed a big black arrow), and which cursor a carousel wants is the app's decision, set on `.tao-carousel__track`. The drag itself is unchanged. (`TaoSplit` keeps its resize cursors and `TaoColorPicker` its crosshair: there the cursor is part of the meaning.)
|
|
16
|
+
- **`TaoSlider` / `TaoRangeSlider` `bubble`: the value in a bubble at the thumb.** Off by default, so nothing that exists changes. `bubble`: it shows while the thumb is dragged, hovered or has the keyboard focus (a touch drag shows it above the finger); `bubble="always"`: it stays. The text is `format` of the value, or the `#bubble="{ value, zone }"` slot (an icon, a word). It wears the colour of the zone the thumb stands in (the accent without zones) with a label that reads on it: the `on-` role of the tone, black or white by contrast for a colour of your own, the browser picks for a colour the script cannot read. A screen reader already has `aria-valuetext`, so the bubble is `aria-hidden`. It sits above a horizontal bar and to the right of a vertical one: leave room for it.
|
|
17
|
+
- **`TaoLoader`: three looks, a voice, a colour role.** `variant`: `dots` (the four dots, still the default, same size and motion), `ring` (a turning arc) and `pulse` (ripples from a core). `tone` is a colour role of the theme (`color` stays and wins; `currentColor` takes the text around it), `size` is a number or `small` / `medium` / `large`, the sizes come from one number in CSS. It is a `role="status"` with a text for a screen reader (`label`, «Loading» / «Загрузка» from the locale), or `decorative` when the wait is said elsewhere. Under «reduce motion» nothing travels or turns: the picture breathes. `TaoButton loading` wears the same ring in its text colour and says `aria-busy` by itself. The showcase gets «Which wait to choose»: loader, skeleton or progress.
|
|
8
18
|
- **`TaoPinCode`: an error paints the digits red**, as a success always painted them green (`--tao-color-danger-text`).
|
|
19
|
+
|
|
20
|
+
## 5.22.0
|
|
21
|
+
|
|
22
|
+
Nothing to migrate; the defaults do not change.
|
|
23
|
+
|
|
24
|
+
- **`TaoPinCode` `bordered`.** `:bordered="false"` is a light style: the cells have a soft fill and no frame at rest. The frame is still in the box (the cells do not jump) and is only clear; focus, the active cell, an error and a result paint it, so a state is never left to a fill colour alone.
|
|
9
25
|
- **`TaoDrawer`: the pull of a sheet no longer selects the title.** While the sheet is in the hand the panel has `user-select: none`, and it is given back at the end.
|
|
10
26
|
- **`TaoDrawer`: a pointer that vanishes lets go.** The blur of the window, a tab that goes to the background, `pagehide` and a taken capture (`lostpointercapture`) end the pull as a cancel: the sheet settles back and does not close, and the next pull starts clean. The same guard `TaoCarousel` has had.
|
|
11
27
|
|
package/README.md
CHANGED
|
@@ -1,3 +1,10 @@
|
|
|
1
|
+
<p align="center">
|
|
2
|
+
<picture>
|
|
3
|
+
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/1337exp/taoui/master/showcase/public/logo/logo-mark-dark.svg">
|
|
4
|
+
<img src="https://raw.githubusercontent.com/1337exp/taoui/master/showcase/public/logo/logo-mark-light.svg" alt="Tao UI" width="96" height="94">
|
|
5
|
+
</picture>
|
|
6
|
+
</p>
|
|
7
|
+
|
|
1
8
|
<h1 align="center">Tao UI</h1>
|
|
2
9
|
|
|
3
10
|
<p align="center">
|
|
@@ -28,7 +35,7 @@
|
|
|
28
35
|
|
|
29
36
|
- **Tokens first.** Colours, radii, spacing and type come from CSS variables in three layers (primitives, semantic, theme). Re-theme the kit, or one panel of it, without touching a component. Size and density are contexts too: set them once on a panel and everything inside follows.
|
|
30
37
|
- **Palettes.** Seven ready palettes built from four colours each, or your own at run time (`applyTaoPalette`). The status colours step away from the accent by themselves, and the charts recolour with the theme.
|
|
31
|
-
- **Contrast you can trust.** The colour pairs of the themes and palettes are checked by tests against WCAG 2 (4.5:1 for text, 3:1 for a label on a fill); APCA picks whether a label is dark or white. The showcase section **Contrast & keyboard** measures the page you are on, lets you build a palette from four stops with `applyTaoPalette()`, and lists what the keys do.
|
|
38
|
+
- **Contrast you can trust.** The colour pairs of the themes and palettes are checked by tests against WCAG 2 (4.5:1 for text, 3:1 for a label on a fill); APCA picks whether a label is dark or white. The showcase section **Contrast & keyboard** measures the page you are on, lets you build a palette from four stops with `applyTaoPalette()`, and lists what the keys do. **Layers & theming** shows the real style files in the order the kit imports them and builds an own theme by hand.
|
|
32
39
|
- **Adapts without JS.** `TaoNav` turns from a bottom bar into a rail and a side panel, the bento grid reflows, the main action moves with the navigation — by the width of their own container (container queries), not of the window. Nothing jumps after hydration.
|
|
33
40
|
- **Keyboard and screen readers.** Menus, the menu bar, the toolbar, the tree and the navigation follow the WAI-ARIA patterns: one Tab stop and arrows inside (roving tabindex), `aria-pressed` toggles, `role="meter"`, focus traps in overlays.
|
|
34
41
|
- **Charts the honest way.** Small `TaoSparkline` / `TaoMeter` / `TaoDonut` / `TaoHeatmap` for cards and lines of text; for real charts `taoChartTheme()` hands the theme colours to Chart.js, ECharts or uPlot.
|
|
@@ -95,7 +102,7 @@
|
|
|
95
102
|
- **TaoQuantity** — cart quantity: `− | field | +`, integers, stock; minus at the minimum can remove the row
|
|
96
103
|
- **TaoTextarea** — autosizing multiline. `maxlength` caps input, `count` shows “entered / max”. `variant`: `bar` (default) / `outline` (frame like Input) / `filled` / `plain`; `readonly`; `align`; `blurOnEnter`
|
|
97
104
|
- **TaoPinCode** — N cells. By default a click clears the cell and everything to the right (`clear-on="focus"`); `clear-on="input"` replaces the digit only when typing. `format="#-##-##"` draws visual separators (not part of the value; a paste in that shape or as a clean code is split into cells). The last cell blurs and emits `complete`; `status="success | error"` (set after `complete`) glows or shakes the cells and says it to a screen reader; `bordered="false"` is a light style with no frame
|
|
98
|
-
- **TaoSlider** / **TaoRangeSlider** — one thumb (`v-model` is a number) or two (`[from, to]`, `minGap`). Mouse, touch, arrows. `marks` (ticks, numbers, `{ value, label }`), `discrete` for stepped scales, `vertical`, `flat`, `format
|
|
105
|
+
- **TaoSlider** / **TaoRangeSlider** — one thumb (`v-model` is a number) or two (`[from, to]`, `minGap`). Mouse, touch, arrows. `marks` (ticks, numbers, `{ value, label }`), `discrete` for stepped scales, `vertical`, `flat`, `format`, `bubble` (the value in a bubble at the thumb, off by default), `zones` (the scale in colour, a dot where a zone ends, `reveal` to paint it as it fills); `variant="thin"` is a thin track for seek / volume
|
|
99
106
|
- **TaoColorPicker** — saturation / brightness square, hue and opacity strips, swatches, eyedropper (where the browser has `EyeDropper`), HEX / RGB / HSL input modes. `v-model` is a hex string; `colorModel()` adapts your own colour storage
|
|
100
107
|
- **TaoColorInput** — a field with a swatch and the hex text; the picker opens in a popover
|
|
101
108
|
- **TaoFileDrop** — drop zone (drag & drop + click). File names listed under the zone, `v-model` is `File[]`. Clearing the whole batch is the parent’s job (`clear-request`); a file that does not fit `accept` comes back in `reject`
|
|
@@ -119,7 +126,7 @@
|
|
|
119
126
|
- **TaoAlert** — inline page/form banner (success / error / warning / info); `collapsible` folds the body under the title (find-in-page still finds it)
|
|
120
127
|
- **TaoProgress** — static bar (`progress` in %). Percent centered on top, or `showPercentage="right"`; `#left` / `#right` slots are captions, then the percent sits in parentheses on the right. `false` hides it. Width is `minWidth` / `maxWidth`, not the value domain
|
|
121
128
|
- **TaoScrubber** — play / pause, a slider over time with event marks, a “time / length” label. Does not advance time by itself: drive `v-model` with your own clock
|
|
122
|
-
- **TaoLoader** —
|
|
129
|
+
- **TaoLoader** — the wait whose end is unknown: `variant` `dots` (default) / `ring` / `pulse`, `tone`, `size` (a number or small / medium / large), says "Loading" to a screen reader (`label`), breathes under reduced motion; `TaoButton loading` wears the same ring
|
|
123
130
|
- **TaoImage** — `<img>` wrapper: fade-in and placeholder. `lazy` turns on native `loading="lazy"`
|
|
124
131
|
- **TaoIcon** — SVG icons (40 built in, your own via `registerTaoIcons`) or an icon font (see Icons below)
|
|
125
132
|
|
|
@@ -162,6 +169,8 @@ Container lives on another axis — width: `width="wide" | "slim" | "ultra-slim"
|
|
|
162
169
|
<html class="tao-density-auto">
|
|
163
170
|
```
|
|
164
171
|
|
|
172
|
+
**Frames** are the third context, for the decorative frames of panels: `tao-frames-soft` on a container (or on `<html>`) lets the frames of `TaoAlert`, `TaoSpoiler`, `TaoTable`, `TaoList`, `TaoToolbar` and `TaoMenubar` go clear and holds the panel by its fill instead (an alert gets a little more tint); nothing moves, the 1px border stays in the box. `tao-frames-framed` puts them back inside a soft area, and `bordered` on a panel (`true` / `false`) overrides the context for that panel. The frame of a field, the focus ring and the lines between rows are not touched: they tell where a control is, and WCAG 1.4.11 asks 3:1 of them. Tokens `--tao-frame-alpha` / `--tao-frame-tint` / `--tao-frame-fill`.
|
|
173
|
+
|
|
165
174
|
|
|
166
175
|
Surfaces — what a panel is made of: `flat` fill (default), `grain` (static film grain), `glass` (translucent, blurs what is
|
|
167
176
|
behind). Use `surface` on TaoCard / TaoBlock or the class `tao-surface-grain` / `-glass` on any element — a game HUD, a
|
|
@@ -638,7 +647,7 @@ tokens/primitives.css → tokens/semantic.css → themes/*.css → contexts/*.cs
|
|
|
638
647
|
| `tokens/semantic.css` | Theme-independent roles: radii, shadows, type, motion | Rarely |
|
|
639
648
|
| `themes/dark.css` | The colour roles of the default (dark) theme: `--tao-color-accent`, `--tao-color-surface`, … | **Yes — this is the theming API** |
|
|
640
649
|
| `themes/light.css` | The same roles under `[data-tao-mode="light"]` (or the old `[data-tao-theme="light"]`) | Yes, as a sample |
|
|
641
|
-
| `contexts/size.css`, `tone.css`, `surface.css` | `.tao-size-*` and `.tao-density-*`, `.tao-tone-*`, `.tao-surface-*`: what a control reads to know its size, colour and
|
|
650
|
+
| `contexts/size.css`, `tone.css`, `surface.css`, `frames.css` | `.tao-size-*` and `.tao-density-*`, `.tao-tone-*`, `.tao-surface-*`, `.tao-frames-*`: what a control reads to know its size, colour, material and how loud its frames are | Rarely |
|
|
642
651
|
| `base.css` | Global reset (scrollbar, links, box-sizing) | Rarely |
|
|
643
652
|
|
|
644
653
|
Everything comes in through `@1337exp/taoui/styles.css` (dark and light both: light turns on with `data-tao-mode="light"`).
|
package/README.ru.md
CHANGED
|
@@ -1,3 +1,10 @@
|
|
|
1
|
+
<p align="center">
|
|
2
|
+
<picture>
|
|
3
|
+
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/1337exp/taoui/master/showcase/public/logo/logo-mark-dark.svg">
|
|
4
|
+
<img src="https://raw.githubusercontent.com/1337exp/taoui/master/showcase/public/logo/logo-mark-light.svg" alt="Tao UI" width="96" height="94">
|
|
5
|
+
</picture>
|
|
6
|
+
</p>
|
|
7
|
+
|
|
1
8
|
<h1 align="center">Tao UI</h1>
|
|
2
9
|
|
|
3
10
|
<p align="center">
|
|
@@ -28,7 +35,7 @@
|
|
|
28
35
|
|
|
29
36
|
- **Сначала токены.** Цвета, радиусы, отступы и шрифты — CSS-переменные в три слоя (примитивы, семантика, тема). Перекрасить набор или одну панель можно, не трогая компоненты. Размер и плотность — тоже контексты: задайте их один раз на панели, и всё внутри последует.
|
|
30
37
|
- **Палитры.** Семь готовых палитр, каждая из четырёх цветов, или своя в рантайме (`applyTaoPalette`). Статусные цвета сами отходят от акцента, а графики перекрашиваются вместе с темой.
|
|
31
|
-
- **Контраст, которому можно верить.** Цветовые пары тем и палитр проверяются тестами по WCAG 2 (4.5:1 для текста, 3:1 для подписи на заливке); тёмной или белой быть подписи, решает APCA. Раздел витрины **Контраст и клавиатура** измеряет страницу, на которой вы стоите, собирает палитру из четырёх стопов через `applyTaoPalette()` и перечисляет, что делают клавиши.
|
|
38
|
+
- **Контраст, которому можно верить.** Цветовые пары тем и палитр проверяются тестами по WCAG 2 (4.5:1 для текста, 3:1 для подписи на заливке); тёмной или белой быть подписи, решает APCA. Раздел витрины **Контраст и клавиатура** измеряет страницу, на которой вы стоите, собирает палитру из четырёх стопов через `applyTaoPalette()` и перечисляет, что делают клавиши. **Слои и темизация** показывает настоящие файлы стилей в том порядке, в каком набор их подключает, и собирает свою тему руками.
|
|
32
39
|
- **Подстраивается без JS.** `TaoNav` превращается из нижней панели в рейку и боковую панель, bento-сетка перестраивается, главное действие переезжает вместе с навигацией — по ширине своего контейнера (container queries), а не окна. После гидратации ничего не прыгает.
|
|
33
40
|
- **Клавиатура и скринридеры.** Меню, полоса меню, панель инструментов, дерево и навигация сделаны по шаблонам WAI-ARIA: одна остановка Tab и стрелки внутри (roving tabindex), переключатели с `aria-pressed`, `role="meter"`, ловушки фокуса в оверлеях.
|
|
34
41
|
- **Графики по-честному.** Маленькие `TaoSparkline` / `TaoMeter` / `TaoDonut` / `TaoHeatmap` для карточек и строк текста; для настоящих графиков `taoChartTheme()` отдаёт цвета темы в Chart.js, ECharts или uPlot.
|
|
@@ -95,7 +102,7 @@
|
|
|
95
102
|
- **TaoQuantity** — количество в корзине: `− | поле | +`, целые штуки, сток, минус на минимуме может убрать строку
|
|
96
103
|
- **TaoTextarea** — многострочное поле с авто-высотой. `maxlength` ограничивает ввод, `count` показывает «введено / максимум». `variant`: `bar` (по умолчанию) / `outline` (рамка как у Input) / `filled` / `plain`; `readonly`; `align`; `blurOnEnter`
|
|
97
104
|
- **TaoPinCode** — пин-код из N полей. По умолчанию клик стирает ячейку и все справа (`clear-on="focus"`); `clear-on="input"` заменяет цифру только при вводе. `format="#-##-##"` рисует визуальные разделители (в значение не входят; вставка в таком виде или чистым кодом раскладывается по ячейкам). Последняя ячейка снимает фокус и эмитит `complete`; `status="success | error"` (после `complete`) подсвечивает или встряхивает ячейки и говорит об этом скринридеру; `bordered="false"` — лёгкий стиль без рамки
|
|
98
|
-
- **TaoSlider** / **TaoRangeSlider** — один бегунок (`v-model` — число) или два (`[от, до]`, `minGap`). Мышь, тач, стрелки. `marks` (деления, числа, `{ value, label }`), `discrete` для ступенчатых шкал, `vertical`, `flat`, `format
|
|
105
|
+
- **TaoSlider** / **TaoRangeSlider** — один бегунок (`v-model` — число) или два (`[от, до]`, `minGap`). Мышь, тач, стрелки. `marks` (деления, числа, `{ value, label }`), `discrete` для ступенчатых шкал, `vertical`, `flat`, `format`, `bubble` (значение плашкой у ручки, по умолчанию выключена), `zones` (шкала цветом, точка там, где зона кончается, `reveal` — красить по мере заполнения); `variant="thin"` — тонкий трек для seek / громкости
|
|
99
106
|
- **TaoColorPicker** — квадрат насыщенности и яркости, полосы тона и прозрачности, образцы, пипетка (где есть `EyeDropper`), режимы ввода HEX / RGB / HSL. `v-model` — строка hex; `colorModel()` подключает ваше собственное хранилище цвета
|
|
100
107
|
- **TaoColorInput** — поле с образцом и hex-текстом; палитра открывается в поповере
|
|
101
108
|
- **TaoFileDrop** — зона загрузки (drag & drop + клик). Список имён под зоной, `v-model` — `File[]`. Очистку всей пачки решает родитель (`clear-request`); файл, не подошедший под `accept`, приходит в `reject`
|
|
@@ -119,7 +126,7 @@
|
|
|
119
126
|
- **TaoAlert** — инлайн-баннер страницы или ошибки формы (success / error / warning / info); `collapsible` сворачивает тело под заголовок (поиск по странице его всё равно находит)
|
|
120
127
|
- **TaoProgress** — статичная полоса (`progress` в %). Проценты сверху по центру или `showPercentage="right"` справа; слоты `#left` / `#right` — подписи, тогда процент справа в скобках. `false` прячет. Ширина — `minWidth` / `maxWidth`, не диапазон значения
|
|
121
128
|
- **TaoScrubber** — play / pause, слайдер по времени с метками событий, подпись «время / длина». Время сама не двигает: ведите `v-model` своими часами
|
|
122
|
-
- **TaoLoader** —
|
|
129
|
+
- **TaoLoader** — ожидание, конца которого не знаем: `variant` `dots` (по умолчанию) / `ring` / `pulse`, `tone`, `size` (число или small / medium / large), говорит «Загрузка» скринридеру (`label`), при «уменьшить движение» дышит; `TaoButton loading` носит то же кольцо
|
|
123
130
|
- **TaoImage** — обёртка над `<img>`: fade-in и плейсхолдер. `lazy` включает нативный `loading="lazy"`
|
|
124
131
|
- **TaoIcon** — SVG-иконки (40 встроенных, свои через `registerTaoIcons`) или icon-шрифт (см. раздел «Иконки» ниже)
|
|
125
132
|
|
|
@@ -162,6 +169,8 @@ Container живёт на другой оси — ширина: `width="wide" |
|
|
|
162
169
|
<html class="tao-density-auto">
|
|
163
170
|
```
|
|
164
171
|
|
|
172
|
+
**Рамки** — третий контекст, для декоративных рамок панелей: `tao-frames-soft` на контейнере (или на `<html>`) делает прозрачными рамки `TaoAlert`, `TaoSpoiler`, `TaoTable`, `TaoList`, `TaoToolbar` и `TaoMenubar`, и панель держит заливка (у алерта чуть гуще тон); ничего не двигается, рамка в 1px остаётся в боксе. `tao-frames-framed` возвращает их внутри мягкой области, а `bordered` на панели (`true` / `false`) переопределяет контекст для неё. Рамки полей, кольцо фокуса и линии между рядами не затрагиваются: они показывают, где контрол, и WCAG 1.4.11 требует от них 3:1. Токены `--tao-frame-alpha` / `--tao-frame-tint` / `--tao-frame-fill`.
|
|
173
|
+
|
|
165
174
|
|
|
166
175
|
Поверхности — из чего «сделана» панель: `flat` — заливка (по умолчанию), `grain` — статичное плёночное зерно, `glass` —
|
|
167
176
|
полупрозрачное стекло с размытием того, что позади. Проп `surface` у TaoCard / TaoBlock или класс `tao-surface-grain` /
|
|
@@ -639,7 +648,7 @@ tokens/primitives.css → tokens/semantic.css → themes/*.css → contexts/*.cs
|
|
|
639
648
|
| `tokens/semantic.css` | Роли, не зависящие от темы: скругления, тени, шрифт, движение | Редко |
|
|
640
649
|
| `themes/dark.css` | Цветовые роли темы по умолчанию (dark): `--tao-color-accent`, `--tao-color-surface`, ... | **Да — это и есть API темизации** |
|
|
641
650
|
| `themes/light.css` | Те же роли под `[data-tao-mode="light"]` (или старым `[data-tao-theme="light"]`) | Да, как образец |
|
|
642
|
-
| `contexts/size.css`, `tone.css`, `surface.css` | `.tao-size-*` и `.tao-density-*`, `.tao-tone-*`, `.tao-surface-*`: что контрол читает, чтобы знать размер,
|
|
651
|
+
| `contexts/size.css`, `tone.css`, `surface.css`, `frames.css` | `.tao-size-*` и `.tao-density-*`, `.tao-tone-*`, `.tao-surface-*`, `.tao-frames-*`: что контрол читает, чтобы знать размер, цвет, материал и насколько громки его рамки | Редко |
|
|
643
652
|
| `base.css` | Глобальный reset (скроллбар, ссылки, box-sizing) | Редко |
|
|
644
653
|
|
|
645
654
|
Всё подключается одним файлом `@1337exp/taoui/styles.css` (и dark, и light: light включается атрибутом `data-tao-mode="light"`).
|
package/dist/index.d.ts
CHANGED
|
@@ -202,11 +202,14 @@ defaultOpen?: boolean;
|
|
|
202
202
|
modelValue?: boolean;
|
|
203
203
|
/** Ключ панели в `TaoSpoilerGroup`. Без группы не используется. */
|
|
204
204
|
name?: string | number;
|
|
205
|
+
/** The outer frame; not set, it follows the frames context (`.tao-frames-soft`); `false`: the header fill alone sets the panel off. / Внешняя рамка; не задан — идёт за контекстом рамок; `false`: панель выделяет одна заливка шапки. */
|
|
206
|
+
bordered?: boolean;
|
|
205
207
|
}>, {
|
|
206
208
|
title: string;
|
|
207
209
|
defaultOpen: boolean;
|
|
208
210
|
modelValue: undefined;
|
|
209
211
|
name: undefined;
|
|
212
|
+
bordered: undefined;
|
|
210
213
|
}>>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
|
|
211
214
|
change: (value: boolean) => void;
|
|
212
215
|
"update:modelValue": (value: boolean) => void;
|
|
@@ -216,17 +219,21 @@ defaultOpen?: boolean;
|
|
|
216
219
|
modelValue?: boolean;
|
|
217
220
|
/** Ключ панели в `TaoSpoilerGroup`. Без группы не используется. */
|
|
218
221
|
name?: string | number;
|
|
222
|
+
/** The outer frame; not set, it follows the frames context (`.tao-frames-soft`); `false`: the header fill alone sets the panel off. / Внешняя рамка; не задан — идёт за контекстом рамок; `false`: панель выделяет одна заливка шапки. */
|
|
223
|
+
bordered?: boolean;
|
|
219
224
|
}>, {
|
|
220
225
|
title: string;
|
|
221
226
|
defaultOpen: boolean;
|
|
222
227
|
modelValue: undefined;
|
|
223
228
|
name: undefined;
|
|
229
|
+
bordered: undefined;
|
|
224
230
|
}>>> & Readonly<{
|
|
225
231
|
onChange?: ((value: boolean) => any) | undefined;
|
|
226
232
|
"onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
|
|
227
233
|
}>, {
|
|
228
234
|
name: string | number;
|
|
229
235
|
title: string;
|
|
236
|
+
bordered: boolean;
|
|
230
237
|
modelValue: boolean;
|
|
231
238
|
defaultOpen: boolean;
|
|
232
239
|
}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
|
|
@@ -963,10 +970,13 @@ size?: TaoSize;
|
|
|
963
970
|
ariaLabel?: string;
|
|
964
971
|
/** Close an open menu when the page scrolls (otherwise it follows its entry). / Закрывать меню при прокрутке (иначе оно едет за пунктом). */
|
|
965
972
|
closeOnScroll?: boolean;
|
|
973
|
+
/** The outer frame; not set, it follows the frames context (`.tao-frames-soft`). / Внешняя рамка; не задан — идёт за контекстом рамок. */
|
|
974
|
+
bordered?: boolean;
|
|
966
975
|
}>, {
|
|
967
976
|
size: undefined;
|
|
968
977
|
ariaLabel: undefined;
|
|
969
978
|
closeOnScroll: boolean;
|
|
979
|
+
bordered: undefined;
|
|
970
980
|
}>>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
|
|
971
981
|
select: (id: string) => void;
|
|
972
982
|
}, string, PublicProps, Readonly<ExtractPropTypes<__VLS_WithDefaults_34<__VLS_TypePropsToRuntimeProps_38<{
|
|
@@ -978,14 +988,18 @@ size?: TaoSize;
|
|
|
978
988
|
ariaLabel?: string;
|
|
979
989
|
/** Close an open menu when the page scrolls (otherwise it follows its entry). / Закрывать меню при прокрутке (иначе оно едет за пунктом). */
|
|
980
990
|
closeOnScroll?: boolean;
|
|
991
|
+
/** The outer frame; not set, it follows the frames context (`.tao-frames-soft`). / Внешняя рамка; не задан — идёт за контекстом рамок. */
|
|
992
|
+
bordered?: boolean;
|
|
981
993
|
}>, {
|
|
982
994
|
size: undefined;
|
|
983
995
|
ariaLabel: undefined;
|
|
984
996
|
closeOnScroll: boolean;
|
|
997
|
+
bordered: undefined;
|
|
985
998
|
}>>> & Readonly<{
|
|
986
999
|
onSelect?: ((id: string) => any) | undefined;
|
|
987
1000
|
}>, {
|
|
988
1001
|
size: TaoSize;
|
|
1002
|
+
bordered: boolean;
|
|
989
1003
|
ariaLabel: string;
|
|
990
1004
|
closeOnScroll: boolean;
|
|
991
1005
|
}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
|
|
@@ -999,11 +1013,14 @@ size?: TaoSize;
|
|
|
999
1013
|
orientation?: TaoToolbarOrientation;
|
|
1000
1014
|
/** `panel` — a raised bar of its own; `plain` — only the layout, for a toolbar inside a header. */
|
|
1001
1015
|
variant?: "panel" | "plain";
|
|
1016
|
+
/** The frame of a `panel`; not set, it follows the frames context (`.tao-frames-soft`). / Рамка `panel`; не задан — идёт за контекстом рамок. */
|
|
1017
|
+
bordered?: boolean;
|
|
1002
1018
|
}>, {
|
|
1003
1019
|
label: undefined;
|
|
1004
1020
|
size: undefined;
|
|
1005
1021
|
orientation: string;
|
|
1006
1022
|
variant: string;
|
|
1023
|
+
bordered: undefined;
|
|
1007
1024
|
}>>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<ExtractPropTypes<__VLS_WithDefaults_35<__VLS_TypePropsToRuntimeProps_39<{
|
|
1008
1025
|
/** Accessible name: «Formatting», «Tools». / Доступное имя: «Форматирование», «Инструменты». */
|
|
1009
1026
|
label?: string;
|
|
@@ -1013,14 +1030,18 @@ size?: TaoSize;
|
|
|
1013
1030
|
orientation?: TaoToolbarOrientation;
|
|
1014
1031
|
/** `panel` — a raised bar of its own; `plain` — only the layout, for a toolbar inside a header. */
|
|
1015
1032
|
variant?: "panel" | "plain";
|
|
1033
|
+
/** The frame of a `panel`; not set, it follows the frames context (`.tao-frames-soft`). / Рамка `panel`; не задан — идёт за контекстом рамок. */
|
|
1034
|
+
bordered?: boolean;
|
|
1016
1035
|
}>, {
|
|
1017
1036
|
label: undefined;
|
|
1018
1037
|
size: undefined;
|
|
1019
1038
|
orientation: string;
|
|
1020
1039
|
variant: string;
|
|
1040
|
+
bordered: undefined;
|
|
1021
1041
|
}>>> & Readonly<{}>, {
|
|
1022
1042
|
size: TaoSize;
|
|
1023
1043
|
label: string;
|
|
1044
|
+
bordered: boolean;
|
|
1024
1045
|
variant: "panel" | "plain";
|
|
1025
1046
|
orientation: TaoToolbarOrientation;
|
|
1026
1047
|
}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
|
|
@@ -1617,12 +1638,12 @@ paused: boolean;
|
|
|
1617
1638
|
}>>> & Readonly<{}>, {
|
|
1618
1639
|
text: string;
|
|
1619
1640
|
speed: number;
|
|
1641
|
+
decorative: boolean;
|
|
1620
1642
|
gap: number;
|
|
1621
1643
|
paused: boolean;
|
|
1622
1644
|
fade: number;
|
|
1623
1645
|
pauseOnHover: boolean;
|
|
1624
1646
|
roundPause: boolean;
|
|
1625
|
-
decorative: boolean;
|
|
1626
1647
|
}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
|
|
1627
1648
|
|
|
1628
1649
|
declare const __VLS_component_46: DefineComponent<ExtractPropTypes<__VLS_WithDefaults_46<__VLS_TypePropsToRuntimeProps_50<{
|
|
@@ -2362,6 +2383,11 @@ collapsible?: boolean;
|
|
|
2362
2383
|
collapsed?: boolean;
|
|
2363
2384
|
/** The toggle text when there is no title. / Текст переключателя, когда нет заголовка. */
|
|
2364
2385
|
detailsLabel?: string;
|
|
2386
|
+
/**
|
|
2387
|
+
* Not set, it follows the frames context (`.tao-frames-soft`). `false` is a light style: no frame, a stronger tint of the tone instead (the border stays in the box, so nothing moves); `true` keeps the frame.
|
|
2388
|
+
* Не задан — идёт за контекстом рамок (`.tao-frames-soft`). `false` — лёгкий стиль: рамки нет, вместо неё гуще тон заливки (рамка остаётся в боксе); `true` — рамка остаётся.
|
|
2389
|
+
*/
|
|
2390
|
+
bordered?: boolean;
|
|
2365
2391
|
}>, {
|
|
2366
2392
|
tone: string;
|
|
2367
2393
|
title: string;
|
|
@@ -2369,6 +2395,7 @@ closable: boolean;
|
|
|
2369
2395
|
collapsible: boolean;
|
|
2370
2396
|
collapsed: undefined;
|
|
2371
2397
|
detailsLabel: undefined;
|
|
2398
|
+
bordered: undefined;
|
|
2372
2399
|
}>>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
|
|
2373
2400
|
close: () => void;
|
|
2374
2401
|
"update:collapsed": (value: boolean) => void;
|
|
@@ -2387,6 +2414,11 @@ collapsible?: boolean;
|
|
|
2387
2414
|
collapsed?: boolean;
|
|
2388
2415
|
/** The toggle text when there is no title. / Текст переключателя, когда нет заголовка. */
|
|
2389
2416
|
detailsLabel?: string;
|
|
2417
|
+
/**
|
|
2418
|
+
* Not set, it follows the frames context (`.tao-frames-soft`). `false` is a light style: no frame, a stronger tint of the tone instead (the border stays in the box, so nothing moves); `true` keeps the frame.
|
|
2419
|
+
* Не задан — идёт за контекстом рамок (`.tao-frames-soft`). `false` — лёгкий стиль: рамки нет, вместо неё гуще тон заливки (рамка остаётся в боксе); `true` — рамка остаётся.
|
|
2420
|
+
*/
|
|
2421
|
+
bordered?: boolean;
|
|
2390
2422
|
}>, {
|
|
2391
2423
|
tone: string;
|
|
2392
2424
|
title: string;
|
|
@@ -2394,6 +2426,7 @@ closable: boolean;
|
|
|
2394
2426
|
collapsible: boolean;
|
|
2395
2427
|
collapsed: undefined;
|
|
2396
2428
|
detailsLabel: undefined;
|
|
2429
|
+
bordered: undefined;
|
|
2397
2430
|
}>>> & Readonly<{
|
|
2398
2431
|
onClose?: (() => any) | undefined;
|
|
2399
2432
|
"onUpdate:collapsed"?: ((value: boolean) => any) | undefined;
|
|
@@ -2404,6 +2437,7 @@ detailsLabel: string;
|
|
|
2404
2437
|
tone: TaoTone;
|
|
2405
2438
|
collapsible: boolean;
|
|
2406
2439
|
collapsed: boolean;
|
|
2440
|
+
bordered: boolean;
|
|
2407
2441
|
}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
|
|
2408
2442
|
|
|
2409
2443
|
declare const __VLS_component_6: DefineComponent<ExtractPropTypes<__VLS_WithDefaults_5<__VLS_TypePropsToRuntimeProps_6<{
|
|
@@ -2496,6 +2530,8 @@ maxHeight?: TaoLength;
|
|
|
2496
2530
|
clickable?: boolean;
|
|
2497
2531
|
sort?: TaoTableSort | null;
|
|
2498
2532
|
caption?: string;
|
|
2533
|
+
/** The outer frame; not set, it follows the frames context (`.tao-frames-soft`). / Внешняя рамка; не задан — идёт за контекстом рамок. */
|
|
2534
|
+
bordered?: boolean;
|
|
2499
2535
|
}>, {
|
|
2500
2536
|
rows: () => never[];
|
|
2501
2537
|
rowKey: string;
|
|
@@ -2509,6 +2545,7 @@ maxHeight: string;
|
|
|
2509
2545
|
clickable: boolean;
|
|
2510
2546
|
sort: null;
|
|
2511
2547
|
caption: string;
|
|
2548
|
+
bordered: undefined;
|
|
2512
2549
|
}>>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
|
|
2513
2550
|
change: (value: TaoTableSort | null) => void;
|
|
2514
2551
|
"update:sort": (value: TaoTableSort | null) => void;
|
|
@@ -2534,6 +2571,8 @@ maxHeight?: TaoLength;
|
|
|
2534
2571
|
clickable?: boolean;
|
|
2535
2572
|
sort?: TaoTableSort | null;
|
|
2536
2573
|
caption?: string;
|
|
2574
|
+
/** The outer frame; not set, it follows the frames context (`.tao-frames-soft`). / Внешняя рамка; не задан — идёт за контекстом рамок. */
|
|
2575
|
+
bordered?: boolean;
|
|
2537
2576
|
}>, {
|
|
2538
2577
|
rows: () => never[];
|
|
2539
2578
|
rowKey: string;
|
|
@@ -2547,6 +2586,7 @@ maxHeight: string;
|
|
|
2547
2586
|
clickable: boolean;
|
|
2548
2587
|
sort: null;
|
|
2549
2588
|
caption: string;
|
|
2589
|
+
bordered: undefined;
|
|
2550
2590
|
}>>> & Readonly<{
|
|
2551
2591
|
onChange?: ((value: TaoTableSort | null) => any) | undefined;
|
|
2552
2592
|
"onUpdate:sort"?: ((value: TaoTableSort | null) => any) | undefined;
|
|
@@ -2556,6 +2596,7 @@ sort: TaoTableSort | null;
|
|
|
2556
2596
|
caption: string;
|
|
2557
2597
|
head: boolean;
|
|
2558
2598
|
loading: boolean;
|
|
2599
|
+
bordered: boolean;
|
|
2559
2600
|
hover: boolean;
|
|
2560
2601
|
sticky: boolean;
|
|
2561
2602
|
rows: Record<string, unknown>[];
|
|
@@ -2737,8 +2778,8 @@ ariaLabel: string;
|
|
|
2737
2778
|
roving: boolean;
|
|
2738
2779
|
}>>> & Readonly<{}>, {
|
|
2739
2780
|
empty: boolean;
|
|
2740
|
-
ariaLabel: string;
|
|
2741
2781
|
bordered: boolean;
|
|
2782
|
+
ariaLabel: string;
|
|
2742
2783
|
divided: boolean;
|
|
2743
2784
|
roving: boolean;
|
|
2744
2785
|
}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
|
|
@@ -2833,6 +2874,13 @@ showClose?: boolean;
|
|
|
2833
2874
|
* `side="bottom"`: лист тянут вниз за ручку и шапку; он закрывается, если утянут далеко или брошен, иначе возвращается. Нужен `closable`.
|
|
2834
2875
|
*/
|
|
2835
2876
|
swipeToClose?: boolean;
|
|
2877
|
+
/**
|
|
2878
|
+
* How far a pulled sheet must go to close, as a share of its height (0.05–1). Default `0.5`: a touch that only grazes it
|
|
2879
|
+
* does not close it. A fast fling needs 15% of the height at least.
|
|
2880
|
+
* Как далеко надо утянуть лист, чтобы он закрылся, долей его высоты (0,05–1). По умолчанию `0.5`: случайное касание его
|
|
2881
|
+
* не закрывает. Быстрому рывку нужно не меньше 15% высоты.
|
|
2882
|
+
*/
|
|
2883
|
+
swipeThreshold?: number;
|
|
2836
2884
|
closeLabel?: string;
|
|
2837
2885
|
}>, {
|
|
2838
2886
|
title: string;
|
|
@@ -2841,6 +2889,7 @@ surface: string;
|
|
|
2841
2889
|
closable: boolean;
|
|
2842
2890
|
showClose: boolean;
|
|
2843
2891
|
swipeToClose: boolean;
|
|
2892
|
+
swipeThreshold: number;
|
|
2844
2893
|
}>>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
|
|
2845
2894
|
close: (...args: any[]) => void;
|
|
2846
2895
|
"update:modelValue": (...args: any[]) => void;
|
|
@@ -2878,6 +2927,13 @@ showClose?: boolean;
|
|
|
2878
2927
|
* `side="bottom"`: лист тянут вниз за ручку и шапку; он закрывается, если утянут далеко или брошен, иначе возвращается. Нужен `closable`.
|
|
2879
2928
|
*/
|
|
2880
2929
|
swipeToClose?: boolean;
|
|
2930
|
+
/**
|
|
2931
|
+
* How far a pulled sheet must go to close, as a share of its height (0.05–1). Default `0.5`: a touch that only grazes it
|
|
2932
|
+
* does not close it. A fast fling needs 15% of the height at least.
|
|
2933
|
+
* Как далеко надо утянуть лист, чтобы он закрылся, долей его высоты (0,05–1). По умолчанию `0.5`: случайное касание его
|
|
2934
|
+
* не закрывает. Быстрому рывку нужно не меньше 15% высоты.
|
|
2935
|
+
*/
|
|
2936
|
+
swipeThreshold?: number;
|
|
2881
2937
|
closeLabel?: string;
|
|
2882
2938
|
}>, {
|
|
2883
2939
|
title: string;
|
|
@@ -2886,6 +2942,7 @@ surface: string;
|
|
|
2886
2942
|
closable: boolean;
|
|
2887
2943
|
showClose: boolean;
|
|
2888
2944
|
swipeToClose: boolean;
|
|
2945
|
+
swipeThreshold: number;
|
|
2889
2946
|
}>>> & Readonly<{
|
|
2890
2947
|
onClose?: ((...args: any[]) => any) | undefined;
|
|
2891
2948
|
"onUpdate:modelValue"?: ((...args: any[]) => any) | undefined;
|
|
@@ -2896,6 +2953,7 @@ closable: boolean;
|
|
|
2896
2953
|
side: "left" | "right" | "bottom";
|
|
2897
2954
|
showClose: boolean;
|
|
2898
2955
|
swipeToClose: boolean;
|
|
2956
|
+
swipeThreshold: number;
|
|
2899
2957
|
}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
|
|
2900
2958
|
|
|
2901
2959
|
declare const __VLS_component_66: DefineComponent<ExtractPropTypes<__VLS_WithDefaults_72<__VLS_TypePropsToRuntimeProps_77<{
|
|
@@ -3711,6 +3769,15 @@ declare function __VLS_template_31(): Readonly<{
|
|
|
3711
3769
|
mark: TaoSliderMark;
|
|
3712
3770
|
active: boolean;
|
|
3713
3771
|
}): unknown;
|
|
3772
|
+
/** The bubble beside a thumb (with `bubble`): its text; `zone` is the zone the thumb stands in. / Плашка у ручки (с `bubble`): её текст; `zone` — зона, в которой стоит ручка. */
|
|
3773
|
+
bubble?(props: {
|
|
3774
|
+
value: number;
|
|
3775
|
+
zone: {
|
|
3776
|
+
from: number;
|
|
3777
|
+
to: number;
|
|
3778
|
+
color: string;
|
|
3779
|
+
} | undefined;
|
|
3780
|
+
}): unknown;
|
|
3714
3781
|
'pre-value'?(): unknown;
|
|
3715
3782
|
'post-value'?(): unknown;
|
|
3716
3783
|
}> & {
|
|
@@ -3719,6 +3786,15 @@ declare function __VLS_template_31(): Readonly<{
|
|
|
3719
3786
|
mark: TaoSliderMark;
|
|
3720
3787
|
active: boolean;
|
|
3721
3788
|
}): unknown;
|
|
3789
|
+
/** The bubble beside a thumb (with `bubble`): its text; `zone` is the zone the thumb stands in. / Плашка у ручки (с `bubble`): её текст; `zone` — зона, в которой стоит ручка. */
|
|
3790
|
+
bubble?(props: {
|
|
3791
|
+
value: number;
|
|
3792
|
+
zone: {
|
|
3793
|
+
from: number;
|
|
3794
|
+
to: number;
|
|
3795
|
+
color: string;
|
|
3796
|
+
} | undefined;
|
|
3797
|
+
}): unknown;
|
|
3722
3798
|
'pre-value'?(): unknown;
|
|
3723
3799
|
'post-value'?(): unknown;
|
|
3724
3800
|
};
|
|
@@ -3729,6 +3805,15 @@ declare function __VLS_template_32(): Readonly<{
|
|
|
3729
3805
|
mark: TaoSliderMark;
|
|
3730
3806
|
active: boolean;
|
|
3731
3807
|
}): unknown;
|
|
3808
|
+
/** The bubble beside a thumb (with `bubble`): its text; `zone` is the zone the thumb stands in. / Плашка у ручки (с `bubble`): её текст; `zone` — зона, в которой стоит ручка. */
|
|
3809
|
+
bubble?(props: {
|
|
3810
|
+
value: number;
|
|
3811
|
+
zone: {
|
|
3812
|
+
from: number;
|
|
3813
|
+
to: number;
|
|
3814
|
+
color: string;
|
|
3815
|
+
} | undefined;
|
|
3816
|
+
}): unknown;
|
|
3732
3817
|
'pre-value'?(): unknown;
|
|
3733
3818
|
'post-value'?(): unknown;
|
|
3734
3819
|
}> & {
|
|
@@ -3737,6 +3822,15 @@ declare function __VLS_template_32(): Readonly<{
|
|
|
3737
3822
|
mark: TaoSliderMark;
|
|
3738
3823
|
active: boolean;
|
|
3739
3824
|
}): unknown;
|
|
3825
|
+
/** The bubble beside a thumb (with `bubble`): its text; `zone` is the zone the thumb stands in. / Плашка у ручки (с `bubble`): её текст; `zone` — зона, в которой стоит ручка. */
|
|
3826
|
+
bubble?(props: {
|
|
3827
|
+
value: number;
|
|
3828
|
+
zone: {
|
|
3829
|
+
from: number;
|
|
3830
|
+
to: number;
|
|
3831
|
+
color: string;
|
|
3832
|
+
} | undefined;
|
|
3833
|
+
}): unknown;
|
|
3740
3834
|
'pre-value'?(): unknown;
|
|
3741
3835
|
'post-value'?(): unknown;
|
|
3742
3836
|
};
|
|
@@ -5941,9 +6035,23 @@ declare interface Props {
|
|
|
5941
6035
|
}
|
|
5942
6036
|
|
|
5943
6037
|
declare interface Props_10 {
|
|
5944
|
-
|
|
6038
|
+
/** The look of the wait: `dots` (the four jumping dots), `ring` (a turning arc), `pulse` (a ripple). / Вид ожидания. */
|
|
6039
|
+
variant?: 'dots' | 'ring' | 'pulse';
|
|
6040
|
+
/**
|
|
6041
|
+
* The size: a number is px, `'40px'` works, or `small` / `medium` / `large` (24 / 40 / 64 px).
|
|
6042
|
+
* Without it: 80 for `dots` (as it always was), 40 for the others.
|
|
6043
|
+
* Размер: число — px, `'40px'` тоже, либо `small` / `medium` / `large` (24 / 40 / 64 px). Без него: 80 у `dots`, 40 у остальных.
|
|
6044
|
+
*/
|
|
5945
6045
|
size?: number | string;
|
|
6046
|
+
/** A colour role of the theme (default: the accent). / Роль цвета темы (по умолчанию акцент). */
|
|
6047
|
+
tone?: TaoToneName;
|
|
6048
|
+
/** Any CSS colour; wins over `tone`. `currentColor` takes the text colour around it. / Любой CSS-цвет; главнее `tone`. */
|
|
6049
|
+
color?: string;
|
|
5946
6050
|
inline?: boolean;
|
|
6051
|
+
/** What a screen reader says (default: the text of the locale). / Что скажет скринридер (по умолчанию текст локали). */
|
|
6052
|
+
label?: string;
|
|
6053
|
+
/** Only a picture: hidden from a screen reader (the wait is said elsewhere, a button says it by itself). / Только картинка: скрыт от скринридера. */
|
|
6054
|
+
decorative?: boolean;
|
|
5947
6055
|
}
|
|
5948
6056
|
|
|
5949
6057
|
declare interface Props_11 {
|
|
@@ -6710,17 +6818,29 @@ export declare const TaoList: __VLS_WithTemplateSlots_63<typeof __VLS_component_
|
|
|
6710
6818
|
export declare const TaoListItem: __VLS_WithTemplateSlots_64<typeof __VLS_component_64, ReturnType<typeof __VLS_template_64>>;
|
|
6711
6819
|
|
|
6712
6820
|
export declare const TaoLoader: DefineComponent<ExtractPropTypes<__VLS_WithDefaults_21<__VLS_TypePropsToRuntimeProps_23<Props_10>, {
|
|
6713
|
-
|
|
6714
|
-
size:
|
|
6821
|
+
variant: string;
|
|
6822
|
+
size: undefined;
|
|
6823
|
+
tone: undefined;
|
|
6824
|
+
color: undefined;
|
|
6715
6825
|
inline: boolean;
|
|
6826
|
+
label: undefined;
|
|
6827
|
+
decorative: boolean;
|
|
6716
6828
|
}>>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<ExtractPropTypes<__VLS_WithDefaults_21<__VLS_TypePropsToRuntimeProps_23<Props_10>, {
|
|
6717
|
-
|
|
6718
|
-
size:
|
|
6829
|
+
variant: string;
|
|
6830
|
+
size: undefined;
|
|
6831
|
+
tone: undefined;
|
|
6832
|
+
color: undefined;
|
|
6719
6833
|
inline: boolean;
|
|
6834
|
+
label: undefined;
|
|
6835
|
+
decorative: boolean;
|
|
6720
6836
|
}>>> & Readonly<{}>, {
|
|
6721
6837
|
size: number | string;
|
|
6838
|
+
label: string;
|
|
6839
|
+
tone: TaoToneName;
|
|
6840
|
+
variant: "dots" | "ring" | "pulse";
|
|
6722
6841
|
color: string;
|
|
6723
6842
|
inline: boolean;
|
|
6843
|
+
decorative: boolean;
|
|
6724
6844
|
}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
|
|
6725
6845
|
|
|
6726
6846
|
/**
|
|
@@ -6781,6 +6901,9 @@ export declare interface TaoLocale {
|
|
|
6781
6901
|
copyLabel: string;
|
|
6782
6902
|
successText: string;
|
|
6783
6903
|
};
|
|
6904
|
+
loader: {
|
|
6905
|
+
label: string;
|
|
6906
|
+
};
|
|
6784
6907
|
date: {
|
|
6785
6908
|
placeholder: string;
|
|
6786
6909
|
todayText: string;
|
|
@@ -7233,12 +7356,12 @@ onActive?: ((el: HTMLInputElement | null, index: number) => any) | undefined;
|
|
|
7233
7356
|
onComplete?: ((value: string) => any) | undefined;
|
|
7234
7357
|
}>, {
|
|
7235
7358
|
status: "idle" | "success" | "error";
|
|
7359
|
+
bordered: boolean;
|
|
7236
7360
|
disabled: boolean;
|
|
7237
7361
|
placeholder: string;
|
|
7238
7362
|
error: boolean;
|
|
7239
7363
|
modelValue: string;
|
|
7240
7364
|
successText: string;
|
|
7241
|
-
bordered: boolean;
|
|
7242
7365
|
masked: boolean;
|
|
7243
7366
|
numbersOnly: boolean;
|
|
7244
7367
|
clearOn: "focus" | "input";
|
|
@@ -7351,6 +7474,22 @@ declare interface TaoSliderBaseProps {
|
|
|
7351
7474
|
* Диапазон, сведённый в точку, показывает там короткий штрих.
|
|
7352
7475
|
*/
|
|
7353
7476
|
flat?: boolean;
|
|
7477
|
+
/**
|
|
7478
|
+
* Zones of the scale in colour: `{ to, tone?, color?, dot? }`, each runs to its `to`. The bar shows them dimmed, the filled
|
|
7479
|
+
* part in full colour, and the thumb takes the colour of the zone it stands in.
|
|
7480
|
+
* Зоны шкалы цветом: `{ to, tone?, color?, dot? }`, каждая идёт до своего `to`. Полоса показывает их приглушённо,
|
|
7481
|
+
* закрашенная часть полным цветом, а ручка берёт цвет зоны, в которой стоит.
|
|
7482
|
+
*/
|
|
7483
|
+
zones?: readonly TaoSliderZone[];
|
|
7484
|
+
/**
|
|
7485
|
+
* A bubble with the value beside the thumb, in the colour of its zone (the accent without zones). Off by default.
|
|
7486
|
+
* `true`: it shows while the thumb is dragged, hovered or has the keyboard focus; `'always'`: it stays. The text is the
|
|
7487
|
+
* `format` of the value, or the `#bubble` slot. Leave room for it above a horizontal bar (to the right of a vertical one).
|
|
7488
|
+
* Плашка со значением у ручки, цвета её зоны (без зон — акцент). По умолчанию выключена. `true`: видна, пока ручку тянут,
|
|
7489
|
+
* на неё наведён указатель или у неё фокус клавиатуры; `'always'`: видна всегда. Текст — `format` значения или слот `#bubble`.
|
|
7490
|
+
* Оставьте ей место над горизонтальной полосой (справа от вертикальной).
|
|
7491
|
+
*/
|
|
7492
|
+
bubble?: boolean | 'always';
|
|
7354
7493
|
/** Vertical: the maximum is at the top. / Вертикальный: максимум сверху. */
|
|
7355
7494
|
vertical?: boolean;
|
|
7356
7495
|
disabled?: boolean;
|
|
@@ -7375,6 +7514,30 @@ export declare interface TaoSliderMark {
|
|
|
7375
7514
|
/** Значение слайдера: число (одна ручка) или пара [от, до] (диапазон). */
|
|
7376
7515
|
export declare type TaoSliderValue = number | [number, number];
|
|
7377
7516
|
|
|
7517
|
+
/**
|
|
7518
|
+
* A zone of the scale: it runs from the end of the previous one to `to` (the first from `min`, the last to `max`), so zones
|
|
7519
|
+
* never overlap and leave no gap. / Зона шкалы: идёт от конца предыдущей до `to` (первая от `min`, последняя до `max`), поэтому
|
|
7520
|
+
* зоны не пересекаются и не оставляют дыр.
|
|
7521
|
+
*/
|
|
7522
|
+
export declare interface TaoSliderZone {
|
|
7523
|
+
to: number;
|
|
7524
|
+
/** A colour role of the theme (default `accent`). / Роль цвета темы (по умолчанию `accent`). */
|
|
7525
|
+
tone?: TaoSliderZoneTone;
|
|
7526
|
+
/** Any CSS colour; wins over `tone`. Its contrast is yours to keep. / Любой CSS-цвет; главнее `tone`. Контраст — на вас. */
|
|
7527
|
+
color?: string;
|
|
7528
|
+
/** A dot on the scale where the zone ends (not at `max`). / Точка на шкале там, где зона кончается (не на `max`). */
|
|
7529
|
+
dot?: boolean;
|
|
7530
|
+
/**
|
|
7531
|
+
* The zone has no colour until the value reaches it: the bar looks plain and is painted as it fills; its dot shows when
|
|
7532
|
+
* the fill gets there. / У зоны нет цвета, пока значение до неё не дошло: полоса выглядит обычной и красится по мере
|
|
7533
|
+
* заполнения; её точка видна, когда заливка дошла.
|
|
7534
|
+
*/
|
|
7535
|
+
reveal?: boolean;
|
|
7536
|
+
}
|
|
7537
|
+
|
|
7538
|
+
/** The colour roles a zone can wear. / Цветовые роли, в которые можно красить зону. */
|
|
7539
|
+
export declare type TaoSliderZoneTone = 'accent' | 'success' | 'warning' | 'danger' | 'info' | 'neutral';
|
|
7540
|
+
|
|
7378
7541
|
export declare const TaoSpace: __VLS_WithTemplateSlots_18<typeof __VLS_component_18, ReturnType<typeof __VLS_template_18>>;
|
|
7379
7542
|
|
|
7380
7543
|
export declare const TaoSparkline: DefineComponent<ExtractPropTypes<__VLS_WithDefaults_37<__VLS_TypePropsToRuntimeProps_41<{
|