@1337exp/taoui 5.37.3 → 5.39.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +36 -0
- package/README.md +2 -1
- package/README.ru.md +2 -1
- package/dist/index.d.ts +310 -180
- package/dist/index.js +714 -479
- package/dist/index.js.map +1 -1
- package/dist/styles.css +1 -1
- package/package.json +1 -1
- package/skills/taoui/SKILL.md +1 -1
- package/skills/taoui/references/components.md +19 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,41 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 5.39.1
|
|
4
|
+
|
|
5
|
+
Nothing to migrate; the demo and the docs of `TaoMarquee`, no change in the component.
|
|
6
|
+
|
|
7
|
+
- **The ticker of the demo no longer twitches.** The quotes of the showcase were bare text: a price that got longer or shorter moved everything after it, and the strip twitched back and forth, and the quotes had no space between them. Every quote is a block of fixed width now (the symbol, the price and the change each in a column of `ch`, `tabular-nums`, prices with a fixed count of decimals) with a gap after it. The docs of `TaoMarquee` say it: the line is as wide as its content, so live parts should have a fixed width.
|
|
8
|
+
|
|
9
|
+
## 5.39.0
|
|
10
|
+
|
|
11
|
+
Nothing to migrate: `fill` and `reverse` are off by default, and a marquee without them runs as before. One fix: it now follows its content.
|
|
12
|
+
|
|
13
|
+
- **`TaoMarquee` follows its content.** It measured the line when the text or the gap changed and when its box was resized, but not when the content of the slot changed (a new price, a font that came late, an image): the line kept the old width, so a line that had grown stood still, or one that had shrunk ran with a hole. The hidden copy that measures the natural width is watched now (`ResizeObserver`), so nobody has to call `measure()`; it stays for the rare case.
|
|
14
|
+
- **`TaoMarquee` `fill`: a short line runs too.** A line that fits stood still; with `fill` it is repeated, with `gap` between the copies, until the copies cover the whole width (and one more, since the strip moves by one round), so there is never a hole in the strip. A ticker of quotes, a row of logos. A line wider than the box still has two copies as before; an empty one has nothing to repeat and stands; with «reduce motion» it stands still, as every marquee does. The extra copies are hidden from a screen reader and inert, like the second one always was.
|
|
15
|
+
- **`TaoMarquee` `reverse`: to the right.** The same round backwards (the pause at the start of a round goes with it).
|
|
16
|
+
|
|
17
|
+
## 5.38.2
|
|
18
|
+
|
|
19
|
+
Nothing to migrate; a fix to the look.
|
|
20
|
+
|
|
21
|
+
- **`TaoDocTabs`: one place between two tabs is one mark.** While a tab was dragged, the drop mark stood on the right edge of the tab A when the pointer was in its right half, and on the left edge of the next tab B when the pointer was in the left half of B: two marks for one place between A and B, and a mark that jumped across the gap, so it looked as if there were two places to drop. Now both are drawn once, at the left edge of B (after the last tab, at its right edge). A place where the tab would stay as it is (next to its own place) is no place to drop and has no mark.
|
|
22
|
+
|
|
23
|
+
## 5.38.1
|
|
24
|
+
|
|
25
|
+
Nothing to migrate; a polish of 5.38.0. One thing changes: tabs are draggable (and Alt + ← → moves them) only when you listen to `reorder`.
|
|
26
|
+
|
|
27
|
+
- **`TaoDocTabs`: icons instead of glyphs.** The cross is `TaoIcon` (`tao-close`) and the unsaved dot is a circle drawn by the CSS, no `×` or `●` is in the text of a tab; the hidden text for a screen reader is the shared `tao-sr-only`.
|
|
28
|
+
- **`TaoDocTabs`: the active tab is brought into view by scrolling the row, not the page.** `scrollIntoView` scrolled every ancestor too: with the row partly off the screen, switching a tab pulled the page. The row now sets its own `scrollLeft`.
|
|
29
|
+
- **`TaoDocTabs`: the sideways swipe at the end of the row stays in the row** (`overscroll-behavior-x: contain`), it no longer turns into the back gesture of the browser.
|
|
30
|
+
- **`TaoDocTabs`: the cross is always visible on a touch screen** (`hover: none`); before it showed on hover and on the active tab only, so a tab that was not open could not be closed by a finger.
|
|
31
|
+
- **`TaoDocTabs`: a tab that cannot be moved is not draggable.** `draggable` and Alt + ← → work only when the app listens to `reorder` and there is more than one tab: a tab dragged nowhere showed a drop mark that did nothing, and Alt + ← was taken from the browser («back») for nothing. A touch screen has no dragging: the app's own menu (`menu`) is the way there.
|
|
32
|
+
|
|
33
|
+
## 5.38.0
|
|
34
|
+
|
|
35
|
+
Nothing to migrate: a new component.
|
|
36
|
+
|
|
37
|
+
- **`TaoDocTabs`: the tabs of open documents.** The row of an editor with several documents: a tab per document (`items`: `{ value, label, title?, dirty?, preview?, closable? }`), a cross to close it, a dot while it has unsaved changes (read aloud as `dirtyLabel`), a **preview** tab in italics (the next preview replaces it: that rule is the app's, the tab only shows it) that a double click or Enter pins, and tabs that can be dragged into another order. The component draws the row and asks, the app does: a close, a pin, a move, a menu are events (`close`, `pin`, `reorder(from, to)`, `menu(value, event)`), because the list and what closing a document means (a question, a save) are the app's. `reorder`'s `to` is the place once the tab is taken out and put back, so `list.splice(to, 0, ...list.splice(from, 1))` is the whole handler (`moveTarget` is exported for your own lists). Keys: ← → walk the tabs and open them (the ends join), Home End, Delete closes (a tab with `closable: false` ignores it and has no cross), Enter pins a preview, Alt + ← → moves the tab itself (the keyboard way to the drag), the menu key or Shift + F10 and a right click ask for the app's menu; the middle button closes. Tabs that do not fit scroll sideways (the wheel scrolls the row when it overflows) and the active one is always brought into view. A tab is a `div role="tab"` with the cross inside it (`aria-hidden`, no Tab stop): the cross is for the pointer, the keyboard has Delete. Slot `#label` for the content of a tab; texts in the locale (`docTabs`) and as props.
|
|
38
|
+
|
|
3
39
|
## 5.37.3
|
|
4
40
|
|
|
5
41
|
Nothing to migrate; a fix to the look.
|
package/README.md
CHANGED
|
@@ -61,10 +61,11 @@
|
|
|
61
61
|
- **TaoCopy** — clipboard icon. After a click, a “Copied” tooltip; if the trigger is gone, the tooltip is too
|
|
62
62
|
- **TaoThemeToggle** — the light / dark switch as one icon button (a sun or a moon); reads and flips `data-tao-mode` of `<html>`, or works from `v-model`; `system` adds a third, «follow the system» state (a monitor)
|
|
63
63
|
- **TaoTour** — a guided tour: the page goes dim, the target stays lit, a card with an arrow says what it is (a step without a target is a card in the middle; `interactive` lets the user press the target). It only draws: the steps come from you or from TaoUX `tour`
|
|
64
|
-
- **TaoMarquee** — one line that never wraps: when it does not fit it runs round with fading edges and a pause at the start of every round, when it fits it stands still. Stops on hover, on focus and on a tap (WCAG 2.2.2); wraps with «reduce motion»; a screen reader reads it once. `text` or inline content in the slot, `speed`, `gap`, `fade` (the left fade takes that much room left of the text: give the parent the padding), `paused`, `pauseOnHover`, `roundPause` (`false`: no rest at the start of a round), `decorative` (a ghost for a background line: hidden from a screen reader, no tab stop, no reaction to a cursor or a tap, no selection, no pause between rounds)
|
|
64
|
+
- **TaoMarquee** — one line that never wraps: when it does not fit it runs round with fading edges and a pause at the start of every round, when it fits it stands still. Stops on hover, on focus and on a tap (WCAG 2.2.2); wraps with «reduce motion»; a screen reader reads it once. `text` or inline content in the slot, `speed`, `gap`, `fade` (the left fade takes that much room left of the text: give the parent the padding), `paused`, `pauseOnHover`, `roundPause` (`false`: no rest at the start of a round), `fill` (a line that fits is repeated and runs too: a ticker of quotes) and `reverse`, the content is watched (a new price measures the line again), `decorative` (a ghost for a background line: hidden from a screen reader, no tab stop, no reaction to a cursor or a tap, no selection, no pause between rounds)
|
|
65
65
|
- **TaoInput** — text field with v-model, validation, and `#prefix` / `#suffix` slots (icon or text inside the frame); `variant` `outline` / `filled` / `plain` (no frame: an item of a list being edited; `TaoInputNumber`, `TaoCombobox` and `TaoTextarea` take it too)
|
|
66
66
|
- **TaoInputGroup** — outer glue: `#before` | field | `#after` (protocol, unit, button)
|
|
67
67
|
- **TaoCommandList** — the field and the list of the palette with no window around them, for a page, a side panel or a `TaoPopover`: the same search, keys and rows, `@select` picks and closes nothing, `autofocus`, `focus()`, `reset()`
|
|
68
|
+
- **TaoDocTabs** — the tabs of open documents: a cross to close (`@close`: the app closes), a dot for unsaved changes, a preview tab in italics that a double click pins, dragging and Alt + arrows to reorder (`@reorder(from, to)`), the menu key and a right click ask for the app's menu; arrows, Home, End, Delete; a row that does not fit scrolls sideways and keeps the active tab in view
|
|
68
69
|
- **TaoCommandPalette** — a dialog (`TaoCommandList` in a window; `modal="false"` is a panel over a living page, the whole screen on a phone) that searches a list of commands (`Ctrl+K`): `items` with `group`, `shortcut`, `keywords`, `disabled`; every word of the query must fit (start of the label, start of a word, any place, letters in order), the matched letters are lit; the arrows, Home, End, Enter, Esc, the focus stays in the field; `@select` runs the pick, the palette listens to no key itself. The search is exported as `matchCommands`
|
|
69
70
|
- **TaoModal** — modal with animation and slots; `fullscreen` (or `fullscreen="narrow"`: a page on a phone, a dialog on a computer); `surface="grain"` / `"glass"`, class and attributes on the dialog panel; the content scrolls under a header and a footer that stay
|
|
70
71
|
- **TaoDrawer** — side panel (filters, settings), or a bottom sheet with `side="bottom"`. Esc, backdrop click, focus trap — same as the modal; `surface`, class and attributes on the panel. The sheet is pulled down by its grip and header (`swipeToClose`); `show-close="false"` hides only the cross, `#header` is a header of your own
|
package/README.ru.md
CHANGED
|
@@ -61,10 +61,11 @@
|
|
|
61
61
|
- **TaoCopy** — иконка копирования в буфер. После клика сверху тултип «Скопировано»; если кнопку убрали — тултип тоже
|
|
62
62
|
- **TaoThemeToggle** — переключатель светлой / тёмной темы одной кнопкой-иконкой (солнце или луна); читает и переворачивает `data-tao-mode` у `<html>` либо работает от `v-model`; `system` добавляет третье состояние «как в системе» (монитор)
|
|
63
63
|
- **TaoTour** — тур по странице: страница затемняется, цель остаётся освещённой, карточка со стрелкой говорит, что это (шаг без цели — карточка посередине; `interactive` даёт нажать на цель). Только рисует: шаги ваши или из TaoUX `tour`
|
|
64
|
-
- **TaoMarquee** — одна строка без переносов: не помещается — бежит по кругу с гаснущими краями и паузой в начале каждого круга, помещается — стоит. Останавливается при наведении, фокусе и тапе (WCAG 2.2.2); при «уменьшить движение» переносится; скринридер читает один раз. `text` или строчное содержимое в слоте, `speed`, `gap`, `fade` (левое затухание занимает столько места слева от текста: дайте родителю такой padding), `paused`, `pauseOnHover`, `roundPause` (`false`: без паузы в начале круга), `decorative` (призрак для строки-фона: скрыта от скринридера, не остановка Tab, не реагирует на курсор и тап, не выделяется, без пауз между кругами)
|
|
64
|
+
- **TaoMarquee** — одна строка без переносов: не помещается — бежит по кругу с гаснущими краями и паузой в начале каждого круга, помещается — стоит. Останавливается при наведении, фокусе и тапе (WCAG 2.2.2); при «уменьшить движение» переносится; скринридер читает один раз. `text` или строчное содержимое в слоте, `speed`, `gap`, `fade` (левое затухание занимает столько места слева от текста: дайте родителю такой padding), `paused`, `pauseOnHover`, `roundPause` (`false`: без паузы в начале круга), `fill` (помещающаяся строка повторяется и тоже бежит: биржевая лента) и `reverse`, содержимое отслеживается (новая цена перемеряет строку), `decorative` (призрак для строки-фона: скрыта от скринридера, не остановка Tab, не реагирует на курсор и тап, не выделяется, без пауз между кругами)
|
|
65
65
|
- **TaoInput** — поле ввода с поддержкой v-model, валидации и слотов `#prefix` / `#suffix` (иконка или текст внутри рамки); `variant` `outline` / `filled` / `plain` (без рамки: пункт списка в правке; его берут и `TaoInputNumber`, `TaoCombobox`, `TaoTextarea`)
|
|
66
66
|
- **TaoInputGroup** — склейка снаружи: `#before` | поле | `#after` (протокол, единица, кнопка)
|
|
67
67
|
- **TaoCommandList** — поле и список палитры без окна вокруг, для страницы, боковой панели или `TaoPopover`: тот же поиск, клавиши и строки, `@select` выбирает и ничего не закрывает, `autofocus`, `focus()`, `reset()`
|
|
68
|
+
- **TaoDocTabs** — вкладки открытых документов: крестик (`@close`: закрывает приложение), точка «не сохранено», предпросмотр курсивом, который закрепляет двойной клик, перетаскивание и Alt + стрелки для порядка (`@reorder(from, to)`), клавиша меню и правый клик просят меню приложения; стрелки, Home, End, Delete; ряд, который не влез, прокручивается вбок и держит активную вкладку на виду
|
|
68
69
|
- **TaoCommandPalette** — окно (`TaoCommandList` в диалоге; `modal="false"` — панель поверх живой страницы, на телефоне во весь экран), которое ищет по списку команд (`Ctrl+K`): `items` с `group`, `shortcut`, `keywords`, `disabled`; подойти должно каждое слово запроса (начало подписи, начало слова, любое место, буквы по порядку), найденные буквы подсвечены; стрелки, Home, End, Enter, Esc, фокус остаётся в поле; `@select` запускает выбранную, сама палитра клавиш не слушает. Поиск экспортируется как `matchCommands`
|
|
69
70
|
- **TaoModal** — модальное окно с анимацией и слотами; `fullscreen` (или `fullscreen="narrow"`: страница на телефоне, окно на компьютере); `surface="grain"` / `"glass"`, класс и атрибуты — на панели окна; прокручивается содержимое под шапкой и подвалом, которые на месте
|
|
70
71
|
- **TaoDrawer** — боковая панель (фильтры, настройки) или нижний лист с `side="bottom"`. Esc, клик по фону, ловушка фокуса — как у модалки; `surface`, класс и атрибуты — на панели. Лист тянут вниз за ручку и шапку (`swipeToClose`); `show-close="false"` прячет только крестик, `#header` — своя шапка
|