@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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@1337exp/taoui",
3
- "version": "5.37.3",
3
+ "version": "5.39.1",
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",
@@ -100,7 +100,7 @@ choose a text colour, WCAG 2 to promise a number.
100
100
 
101
101
  ## Overlays and feedback
102
102
 
103
- - `TaoCommandList` (the field and the list of the palette with no window, for a page, a panel or a `TaoPopover`; `@select` closes nothing), `TaoCommandPalette` (a dialog, `modal="false"` for a panel with no dimming, the whole screen on a phone by default, that searches `items` `{ id, label, group?, shortcut?, keywords?, disabled? }`, `Ctrl+K` style: you open it from your own key with `v-model`, `@select` runs the pick; the search alone is `matchCommands`), `TaoModal` (`fullscreen`, `fullscreen="narrow"` for a page on a phone), `TaoDrawer` (`side="bottom"` is the phone's
103
+ - `TaoDocTabs` (the tabs of open documents: `items` `{ value, label, dirty?, preview?, closable? }`, `v-model` the active one; it only draws the row: `@close`, `@pin`, `@reorder(from, to)`, `@menu` are requests the app carries out), `TaoCommandList` (the field and the list of the palette with no window, for a page, a panel or a `TaoPopover`; `@select` closes nothing), `TaoCommandPalette` (a dialog, `modal="false"` for a panel with no dimming, the whole screen on a phone by default, that searches `items` `{ id, label, group?, shortcut?, keywords?, disabled? }`, `Ctrl+K` style: you open it from your own key with `v-model`, `@select` runs the pick; the search alone is `matchCommands`), `TaoModal` (`fullscreen`, `fullscreen="narrow"` for a page on a phone), `TaoDrawer` (`side="bottom"` is the phone's
104
104
  bottom sheet) — v-model; Escape closes the top layer only. `TaoPopover`, `TaoTooltip` (`placement`).
105
105
  - Menus share one engine: `TaoDropdownMenu`, `TaoMenubar`, `TaoContextMenu`, `TaoMenu` (the panel for your own shell).
106
106
  Items are a data tree `TaoMenuItem[]`: `{ id, label, icon?, shortcut?, disabled?, items? }`,
@@ -103,8 +103,10 @@ Showcase section: `#marquee`
103
103
  | `roundPause` | `boolean` | true | A pause at the start of every round, to read the beginning. false — the line runs without a stop, like a looped picture. Not set: a decorative line has no pause, an ordinary one has |
104
104
  | `decorative` | `boolean` | false | The line is only decoration (a background, a design feature) with no meaning: a ghost. Hidden from a screen reader, not a tab stop, a cursor and a tap are nothing to it, the text cannot be selected, it runs without pauses. Only for text nobody needs to read. With «reduce motion» it stands still, clipped |
105
105
  | `paused` | `boolean` | false | Stopped by the app |
106
+ | `fill` | `boolean` | false | Run also when the line fits: it is repeated, with gap between the copies, until the copies cover the whole width (a ticker of quotes, a row of logos). Without it a line that fits stands still |
107
+ | `reverse` | `boolean` | false | Run to the right instead of to the left |
106
108
 
107
- **Slots, events, notes.** default — the content of the line; its copies for the second round are hidden from a screen reader and inert. It runs only when it does not fit; it stops on hover, on focus (a running line is a tab stop) and on a tap; with «reduce motion» it wraps. measure() — measure again by hand.
109
+ **Slots, events, notes.** default — the content of the line; its copies for the next rounds are hidden from a screen reader and inert. It runs only when it does not fit (always with fill); it stops on hover, on focus (a running line is a tab stop) and on a tap; with «reduce motion» it wraps. The line is as wide as its content: when the width of a part changes (live prices), everything after it moves and the strip twitches, so give live items a block of fixed width (columns in ch, tabular-nums). The content of the slot is watched: a new price, a font that came or an image measure the line again by themselves, measure() is only for rare cases (measure again by hand).
108
110
 
109
111
  ## TaoCopy
110
112
 
@@ -379,6 +381,22 @@ Showcase section: `#combobox`
379
381
 
380
382
  **Slots, events, notes.** create — an event when a new value is typed: the parent extends options itself.
381
383
 
384
+ ## TaoDocTabs
385
+
386
+ Showcase section: `#doc-tabs`
387
+
388
+ | Prop | Type | Default | Notes |
389
+ |---|---|---|---|
390
+ | `v-model` | `string` | — | The value of the active tab. It may be none of them (no document open): then the first one is the way in by Tab |
391
+ | `items` | `{ value, label, title?, dirty?, preview?, closable? }[]` | [] | The tabs. value is the id of the document; title the full name for a hint; dirty the unsaved dot; preview a preview (italics, pinned by a double click or Enter); closable: false has no cross and cannot be closed |
392
+ | `controls` | `string` | — | The id of the element the active tab controls (the document view): aria-controls |
393
+ | `label` | `string` | 'Open documents' | The name of the row for a screen reader |
394
+ | `closeLabel` | `string` | 'Close' | The label of the cross (the tab name follows it) |
395
+ | `dirtyLabel` | `string` | 'unsaved changes' | What is read instead of the dot |
396
+ | `size` | `'small' \| 'medium' \| 'large'` | inherited | Size, same scale as TaoButton |
397
+
398
+ **Slots, events, notes.** #label="{ tab }" — your own content of a tab instead of the label. update:modelValue and change — a tab was picked (a click, the arrows, Home, End). close(value) — a request to close (the cross, the middle button, Delete): the app closes it. pin(value) — a preview was pinned (a double click, Enter). reorder(from, to) — a tab was moved (by dragging or Alt + arrows; the tabs can be dragged only when you listen to reorder and there is more than one tab; there is no dragging on a touch screen, use the menu of your app there): to is the place once the tab is taken out and put back (splice(to, 0, ...splice(from, 1))). menu(value, event) — a right click or the menu key: the app draws the menu. Tabs that do not fit scroll sideways, the wheel too; the active one is always in view. The cross is for the pointer only (aria-hidden), a keyboard user closes with Delete.
399
+
382
400
  ## TaoCommandList
383
401
 
384
402
  Showcase section: `#command-palette`