@1337exp/taoui 5.37.3 → 5.38.2

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.38.2",
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? }`,
@@ -379,6 +379,22 @@ Showcase section: `#combobox`
379
379
 
380
380
  **Slots, events, notes.** create — an event when a new value is typed: the parent extends options itself.
381
381
 
382
+ ## TaoDocTabs
383
+
384
+ Showcase section: `#doc-tabs`
385
+
386
+ | Prop | Type | Default | Notes |
387
+ |---|---|---|---|
388
+ | `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 |
389
+ | `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 |
390
+ | `controls` | `string` | — | The id of the element the active tab controls (the document view): aria-controls |
391
+ | `label` | `string` | 'Open documents' | The name of the row for a screen reader |
392
+ | `closeLabel` | `string` | 'Close' | The label of the cross (the tab name follows it) |
393
+ | `dirtyLabel` | `string` | 'unsaved changes' | What is read instead of the dot |
394
+ | `size` | `'small' \| 'medium' \| 'large'` | inherited | Size, same scale as TaoButton |
395
+
396
+ **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.
397
+
382
398
  ## TaoCommandList
383
399
 
384
400
  Showcase section: `#command-palette`