You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
998 lines
34 KiB
998 lines
34 KiB
<script lang="ts">
|
|
import { Tooltip, type TooltipSize, type TooltipVariant } from '$uix/eidos/components/tooltip';
|
|
import { compileMorfo } from '$uix/morfo';
|
|
import { tooltipMorfo } from '@/uix/morfo/components/tooltip';
|
|
import { getActiveUix } from '$active-uix';
|
|
import type { Side, Align } from '$soma/layers/floating';
|
|
import { page } from '$app/state';
|
|
|
|
const uix = getActiveUix();
|
|
|
|
const params = page.url.searchParams;
|
|
|
|
type Tab = 'live' | 'api' | 'morfo' | 'sema' | 'recipe' | 'a11y';
|
|
type TraceEntry = { event: string; family: string; intent?: string; at: number };
|
|
let tab = $state<Tab>('live');
|
|
let trace = $state<TraceEntry[]>([]);
|
|
let stageRef = $state<HTMLElement | null>(null);
|
|
|
|
// ── Group state ───────────────────────────────────────────────────────
|
|
let groupDelay = $state(700);
|
|
let groupSkipDelay = $state(300);
|
|
let groupDisableHoverable = $state(false);
|
|
let groupDisabled = $state(false);
|
|
|
|
// ── Provider state ────────────────────────────────────────────────────
|
|
let open = $state(false);
|
|
let providerDelay = $state<number | undefined>(undefined);
|
|
let closeDelay = $state(150);
|
|
let providerDisabled = $state(params.get('perm.disabled') === 'true');
|
|
|
|
// ── Content state ─────────────────────────────────────────────────────
|
|
let size = $state<TooltipSize>('md');
|
|
let variant = $state<TooltipVariant>('solid');
|
|
let side = $state<Side>('top');
|
|
let sideOffset = $state(8);
|
|
let align = $state<Align>('center');
|
|
let alignOffset = $state(0);
|
|
let avoidCollisions = $state(true);
|
|
let sticky = $state<'partial' | 'always'>('partial');
|
|
let hideWhenDetached = $state(true);
|
|
let forceMount = $state(false);
|
|
let ariaLabel = $state('');
|
|
let dir = $state<'' | 'ltr' | 'rtl'>((params.get('perm.dir') as 'ltr' | 'rtl' | null) ?? '');
|
|
|
|
// ── Arrow state ───────────────────────────────────────────────────────
|
|
let showArrow = $state(true);
|
|
let arrowWidth = $state(10);
|
|
let arrowHeight = $state(5);
|
|
let arrowPadding = $state(0);
|
|
|
|
// ── Content text ──────────────────────────────────────────────────────
|
|
let triggerLabel = $state('Hover or focus me');
|
|
let contentText = $state(
|
|
'Short, glance-able help. Appears on hover or focus, dismisses on blur or Escape.'
|
|
);
|
|
|
|
// ── Compiled morfo ────────────────────────────────────────────────────
|
|
const compiled = compileMorfo(tooltipMorfo);
|
|
const partsList = $derived([...compiled.parts.byKebab.values()]);
|
|
const events = $derived([...compiled.actions.byName.values()]);
|
|
|
|
$effect(() => {
|
|
const el = stageRef;
|
|
if (!el) return;
|
|
const obs = new MutationObserver((mutations) => {
|
|
for (const m of mutations) {
|
|
if (m.attributeName !== 'data-event') continue;
|
|
const target = m.target as Element;
|
|
const ev = target.getAttribute('data-event');
|
|
if (!ev) continue;
|
|
trace = [
|
|
{
|
|
event: ev,
|
|
family: target.getAttribute('data-event-family') ?? '—',
|
|
intent: target.getAttribute('data-event-intent') ?? undefined,
|
|
at: Date.now()
|
|
},
|
|
...trace
|
|
].slice(0, 6);
|
|
}
|
|
});
|
|
obs.observe(el, { attributes: true, subtree: true, attributeFilter: ['data-event'] });
|
|
return () => obs.disconnect();
|
|
});
|
|
|
|
// ── Soma snippet ──────────────────────────────────────────────────────
|
|
const somaSnippet = $derived(
|
|
[
|
|
"<script lang='ts'>",
|
|
" import * as Tooltip from '$soma/components/tooltip';",
|
|
'</' + 'script>',
|
|
'',
|
|
'<Tooltip.Group',
|
|
groupDelay !== 700 && ` delayDuration={${groupDelay}}`,
|
|
groupSkipDelay !== 300 && ` skipDelayDuration={${groupSkipDelay}}`,
|
|
groupDisableHoverable && ' disableHoverableContent',
|
|
groupDisabled && ' disabled',
|
|
'>',
|
|
' <Tooltip.Provider',
|
|
providerDelay !== undefined && ` delayDuration={${providerDelay}}`,
|
|
closeDelay !== 150 && ` closeDelay={${closeDelay}}`,
|
|
providerDisabled && ' disabled',
|
|
' >',
|
|
` <Tooltip.Trigger>${triggerLabel}</Tooltip.Trigger>`,
|
|
' <Tooltip.Content',
|
|
side !== 'top' && ` side="${side}"`,
|
|
sideOffset !== 0 && ` sideOffset={${sideOffset}}`,
|
|
align !== 'center' && ` align="${align}"`,
|
|
alignOffset !== 0 && ` alignOffset={${alignOffset}}`,
|
|
!avoidCollisions && ' avoidCollisions={false}',
|
|
sticky !== 'partial' && ` sticky="${sticky}"`,
|
|
!hideWhenDetached && ' hideWhenDetached={false}',
|
|
forceMount && ' forceMount',
|
|
ariaLabel && ` ariaLabel="${ariaLabel}"`,
|
|
dir && ` dir="${dir}"`,
|
|
' >',
|
|
` ${contentText}`,
|
|
showArrow &&
|
|
' <Tooltip.Arrow' +
|
|
(arrowWidth !== 10 ? ` width={${arrowWidth}}` : '') +
|
|
(arrowHeight !== 5 ? ` height={${arrowHeight}}` : '') +
|
|
' />',
|
|
' </Tooltip.Content>',
|
|
' </Tooltip.Provider>',
|
|
'</Tooltip.Group>'
|
|
]
|
|
.filter(Boolean)
|
|
.join('\n')
|
|
);
|
|
|
|
// ── Eidos snippet ─────────────────────────────────────────────────────
|
|
const eidosSnippet = $derived(
|
|
[
|
|
"<script lang='ts'>",
|
|
" import { Tooltip } from '$uix/eidos/components/tooltip';",
|
|
'</' + 'script>',
|
|
'',
|
|
'<Tooltip.Group',
|
|
groupDelay !== 700 && ` delayDuration={${groupDelay}}`,
|
|
groupSkipDelay !== 300 && ` skipDelayDuration={${groupSkipDelay}}`,
|
|
groupDisableHoverable && ' disableHoverableContent',
|
|
groupDisabled && ' disabled',
|
|
'>',
|
|
' <Tooltip',
|
|
providerDelay !== undefined && ` delayDuration={${providerDelay}}`,
|
|
closeDelay !== 150 && ` closeDelay={${closeDelay}}`,
|
|
providerDisabled && ' disabled',
|
|
' >',
|
|
` <Tooltip.Trigger>${triggerLabel}</Tooltip.Trigger>`,
|
|
' <Tooltip.Content',
|
|
variant !== 'solid' && ` variant="${variant}"`,
|
|
size !== 'md' && ` size="${size}"`,
|
|
side !== 'top' && ` side="${side}"`,
|
|
sideOffset !== 0 && ` sideOffset={${sideOffset}}`,
|
|
align !== 'center' && ` align="${align}"`,
|
|
' >',
|
|
` ${contentText}`,
|
|
showArrow && ' <Tooltip.Arrow />',
|
|
' </Tooltip.Content>',
|
|
' </Tooltip>',
|
|
'</Tooltip.Group>'
|
|
]
|
|
.filter(Boolean)
|
|
.join('\n')
|
|
);
|
|
</script>
|
|
|
|
<svelte:head>
|
|
<meta name="perm-axes" content="dir,disabled" />
|
|
</svelte:head>
|
|
|
|
<div data-uix-canvas-inner>
|
|
<header>
|
|
<div data-uix-eyebrow>Overlays · Tooltip</div>
|
|
<h1 data-uix-page-title>Tooltip</h1>
|
|
<p data-uix-page-lede>
|
|
Short, contextual help anchored to a trigger. Appears on hover or focus, dismisses on blur or
|
|
Escape. Three variants — <code>solid</code>, <code>outline</code>, <code>ghost</code>. Group
|
|
coordinates instant re-open across siblings. Honours <code>prefers-reduced-motion</code>.
|
|
Presence-driven — open / close / close-dismiss edges are surfaced as sema events.
|
|
</p>
|
|
<div data-uix-page-meta>
|
|
<span data-uix-meta-pill
|
|
><span data-uix-meta-key>parts</span>{compiled.parts.order.length}</span
|
|
>
|
|
<span data-uix-meta-pill><span data-uix-meta-key>variants</span>3</span>
|
|
<span data-uix-meta-pill><span data-uix-meta-key>sizes</span>3</span>
|
|
<span data-uix-meta-pill><span data-uix-meta-key>events</span>{events.length}</span>
|
|
<span data-uix-meta-pill>
|
|
<span data-uix-meta-key>apg</span>
|
|
<a href={tooltipMorfo.apg} target="_blank" rel="noreferrer">tooltip ↗</a>
|
|
</span>
|
|
</div>
|
|
</header>
|
|
|
|
<div data-uix-stage>
|
|
<div data-uix-stage-area bind:this={stageRef}>
|
|
<Tooltip.Group
|
|
delayDuration={groupDelay}
|
|
skipDelayDuration={groupSkipDelay}
|
|
disableHoverableContent={groupDisableHoverable}
|
|
disabled={groupDisabled}
|
|
>
|
|
<Tooltip bind:open delayDuration={providerDelay} {closeDelay} disabled={providerDisabled}>
|
|
<Tooltip.Trigger
|
|
data-perm-step={providerDisabled ? undefined : '0'}
|
|
data-perm-label={providerDisabled ? undefined : 'focus tooltip'}
|
|
data-perm-mode={providerDisabled ? undefined : 'focus'}
|
|
data-perm-settle="900">{triggerLabel}</Tooltip.Trigger
|
|
>
|
|
<Tooltip.Content
|
|
{size}
|
|
{variant}
|
|
{side}
|
|
{sideOffset}
|
|
{align}
|
|
{alignOffset}
|
|
{avoidCollisions}
|
|
{sticky}
|
|
{hideWhenDetached}
|
|
{forceMount}
|
|
{arrowPadding}
|
|
ariaLabel={ariaLabel || undefined}
|
|
dir={dir || undefined}
|
|
>
|
|
{contentText}
|
|
{#if showArrow}
|
|
<Tooltip.Arrow width={arrowWidth} height={arrowHeight} />
|
|
{/if}
|
|
</Tooltip.Content>
|
|
</Tooltip>
|
|
</Tooltip.Group>
|
|
</div>
|
|
<div data-uix-stage-trace>
|
|
<span data-uix-stage-trace-key>trace</span>
|
|
<span>{trace.length === 0 ? 'no semantic events' : `${trace.length} event(s)`}</span>
|
|
<span style="color: var(--uix-text-faint)">·</span>
|
|
<span data-uix-stage-trace-key>state</span>
|
|
<span data-uix-stage-trace-event>{open ? 'open' : 'closed'}</span>
|
|
<span style="color: var(--uix-text-faint)">·</span>
|
|
<span data-uix-stage-trace-key>side</span>
|
|
<span>{side}</span>
|
|
<span style="color: var(--uix-text-faint)">·</span>
|
|
<span data-uix-stage-trace-key>variant</span>
|
|
<span>{variant}</span>
|
|
<span style="margin-inline-start: auto;">
|
|
<span data-uix-stage-trace-key>delay</span>
|
|
{providerDelay ?? groupDelay}ms
|
|
</span>
|
|
</div>
|
|
</div>
|
|
|
|
<div data-uix-tabs role="tablist">
|
|
<button data-uix-tab data-active={tab === 'live'} onclick={() => (tab = 'live')}>Live</button>
|
|
<button data-uix-tab data-active={tab === 'api'} onclick={() => (tab = 'api')}
|
|
>API <span data-uix-tab-count>22</span></button
|
|
>
|
|
<button data-uix-tab data-active={tab === 'morfo'} onclick={() => (tab = 'morfo')}>
|
|
<span data-uix-layer-badge="morfo">morfo</span>
|
|
<span data-uix-tab-count>{partsList.length}p</span>
|
|
</button>
|
|
<button data-uix-tab data-active={tab === 'sema'} onclick={() => (tab = 'sema')}>
|
|
<span data-uix-layer-badge="sema">sema</span>
|
|
<span data-uix-tab-count>{events.length}</span>
|
|
</button>
|
|
<button data-uix-tab data-active={tab === 'recipe'} onclick={() => (tab = 'recipe')}
|
|
>Recipe</button
|
|
>
|
|
<button data-uix-tab data-active={tab === 'a11y'} onclick={() => (tab = 'a11y')}>A11y</button>
|
|
</div>
|
|
|
|
{#if tab === 'live'}
|
|
<section data-uix-section>
|
|
<h2 data-uix-section-title>Controls</h2>
|
|
<p data-uix-section-desc>
|
|
Props grouped by layer: <span data-uix-layer-badge="soma">soma</span> headless behavior +
|
|
Floating layer positioning, <span data-uix-layer-badge="eidos">eidos</span> visual treatment.
|
|
Tooltip's presence-driven events (open / close / close-dismiss) live in the morfo;
|
|
see the Morfo and Sema tabs for the table + Play buttons.
|
|
</p>
|
|
|
|
<div data-uix-subsection-head>
|
|
<span data-uix-layer-badge="soma">soma</span> props · headless behavior
|
|
</div>
|
|
<div data-uix-controls>
|
|
<label data-uix-control>
|
|
<span data-uix-control-label>open <span data-uix-control-hint>bindable</span></span>
|
|
<span data-uix-switch
|
|
><input type="checkbox" bind:checked={open} /><span data-uix-switch-label
|
|
>{open ? 'open' : 'closed'}</span
|
|
></span
|
|
>
|
|
</label>
|
|
<label data-uix-control>
|
|
<span data-uix-control-label
|
|
>Group · delayDuration <span data-uix-control-hint>{groupDelay}ms</span></span
|
|
>
|
|
<input type="range" min="0" max="2000" step="50" bind:value={groupDelay} />
|
|
</label>
|
|
<label data-uix-control>
|
|
<span data-uix-control-label
|
|
>Group · skipDelayDuration <span data-uix-control-hint>{groupSkipDelay}ms</span></span
|
|
>
|
|
<input type="range" min="0" max="1000" step="50" bind:value={groupSkipDelay} />
|
|
</label>
|
|
<label data-uix-control>
|
|
<span data-uix-control-label>Group · disableHoverableContent</span>
|
|
<span data-uix-switch
|
|
><input type="checkbox" bind:checked={groupDisableHoverable} /><span
|
|
data-uix-switch-label>{groupDisableHoverable ? 'on' : 'off'}</span
|
|
></span
|
|
>
|
|
</label>
|
|
<label data-uix-control>
|
|
<span data-uix-control-label>Group · disabled</span>
|
|
<span data-uix-switch
|
|
><input type="checkbox" bind:checked={groupDisabled} /><span data-uix-switch-label
|
|
>{groupDisabled ? 'on' : 'off'}</span
|
|
></span
|
|
>
|
|
</label>
|
|
<label data-uix-control>
|
|
<span data-uix-control-label
|
|
>Provider · delayDuration <span data-uix-control-hint
|
|
>{providerDelay === undefined ? 'inherit' : providerDelay + 'ms'}</span
|
|
></span
|
|
>
|
|
<span data-uix-chips role="radiogroup">
|
|
{#each [undefined, 0, 250, 500, 1000] as d}
|
|
<button
|
|
data-uix-chip
|
|
data-active={providerDelay === d}
|
|
onclick={() => (providerDelay = d)}>{d === undefined ? 'inherit' : d + 'ms'}</button
|
|
>
|
|
{/each}
|
|
</span>
|
|
</label>
|
|
<label data-uix-control>
|
|
<span data-uix-control-label
|
|
>Provider · closeDelay <span data-uix-control-hint>{closeDelay}ms</span></span
|
|
>
|
|
<input type="range" min="0" max="1000" step="50" bind:value={closeDelay} />
|
|
</label>
|
|
<label data-uix-control>
|
|
<span data-uix-control-label>Provider · disabled</span>
|
|
<span data-uix-switch
|
|
><input type="checkbox" bind:checked={providerDisabled} /><span data-uix-switch-label
|
|
>{providerDisabled ? 'on' : 'off'}</span
|
|
></span
|
|
>
|
|
</label>
|
|
<label data-uix-control>
|
|
<span data-uix-control-label>Content · side</span>
|
|
<span data-uix-chips role="radiogroup">
|
|
{#each ['top', 'right', 'bottom', 'left'] as s}
|
|
<button data-uix-chip data-active={side === s} onclick={() => (side = s as Side)}
|
|
>{s}</button
|
|
>
|
|
{/each}
|
|
</span>
|
|
</label>
|
|
<label data-uix-control>
|
|
<span data-uix-control-label
|
|
>Content · sideOffset <span data-uix-control-hint>{sideOffset}px</span></span
|
|
>
|
|
<input type="range" min="0" max="40" step="1" bind:value={sideOffset} />
|
|
</label>
|
|
<label data-uix-control>
|
|
<span data-uix-control-label>Content · align</span>
|
|
<span data-uix-chips role="radiogroup">
|
|
{#each ['start', 'center', 'end'] as a}
|
|
<button data-uix-chip data-active={align === a} onclick={() => (align = a as Align)}
|
|
>{a}</button
|
|
>
|
|
{/each}
|
|
</span>
|
|
</label>
|
|
<label data-uix-control>
|
|
<span data-uix-control-label
|
|
>Content · alignOffset <span data-uix-control-hint>{alignOffset}px</span></span
|
|
>
|
|
<input type="range" min="-40" max="40" step="1" bind:value={alignOffset} />
|
|
</label>
|
|
<label data-uix-control>
|
|
<span data-uix-control-label>Content · avoidCollisions</span>
|
|
<span data-uix-switch
|
|
><input type="checkbox" bind:checked={avoidCollisions} /><span data-uix-switch-label
|
|
>{avoidCollisions ? 'on' : 'off'}</span
|
|
></span
|
|
>
|
|
</label>
|
|
<label data-uix-control>
|
|
<span data-uix-control-label>Content · sticky</span>
|
|
<span data-uix-chips role="radiogroup">
|
|
{#each ['partial', 'always'] as s}
|
|
<button
|
|
data-uix-chip
|
|
data-active={sticky === s}
|
|
onclick={() => (sticky = s as 'partial' | 'always')}>{s}</button
|
|
>
|
|
{/each}
|
|
</span>
|
|
</label>
|
|
<label data-uix-control>
|
|
<span data-uix-control-label>Content · hideWhenDetached</span>
|
|
<span data-uix-switch
|
|
><input type="checkbox" bind:checked={hideWhenDetached} /><span data-uix-switch-label
|
|
>{hideWhenDetached ? 'on' : 'off'}</span
|
|
></span
|
|
>
|
|
</label>
|
|
<label data-uix-control>
|
|
<span data-uix-control-label>Content · forceMount</span>
|
|
<span data-uix-switch
|
|
><input type="checkbox" bind:checked={forceMount} /><span data-uix-switch-label
|
|
>{forceMount ? 'on' : 'off'}</span
|
|
></span
|
|
>
|
|
</label>
|
|
<label data-uix-control>
|
|
<span data-uix-control-label>Content · dir</span>
|
|
<span data-uix-chips role="radiogroup">
|
|
{#each ['', 'ltr', 'rtl'] as d}
|
|
<button
|
|
data-uix-chip
|
|
data-active={dir === d}
|
|
onclick={() => (dir = d as '' | 'ltr' | 'rtl')}>{d || 'inherit'}</button
|
|
>
|
|
{/each}
|
|
</span>
|
|
</label>
|
|
<label data-uix-control>
|
|
<span data-uix-control-label>Content · ariaLabel</span>
|
|
<input type="text" bind:value={ariaLabel} placeholder="(visual content speaks)" />
|
|
</label>
|
|
<label data-uix-control>
|
|
<span data-uix-control-label
|
|
>Arrow · width <span data-uix-control-hint>{arrowWidth}px</span></span
|
|
>
|
|
<input
|
|
type="range"
|
|
min="6"
|
|
max="24"
|
|
step="1"
|
|
bind:value={arrowWidth}
|
|
disabled={!showArrow}
|
|
/>
|
|
</label>
|
|
<label data-uix-control>
|
|
<span data-uix-control-label
|
|
>Arrow · height <span data-uix-control-hint>{arrowHeight}px</span></span
|
|
>
|
|
<input
|
|
type="range"
|
|
min="3"
|
|
max="16"
|
|
step="1"
|
|
bind:value={arrowHeight}
|
|
disabled={!showArrow}
|
|
/>
|
|
</label>
|
|
<label data-uix-control>
|
|
<span data-uix-control-label
|
|
>Arrow · padding <span data-uix-control-hint>{arrowPadding}px</span></span
|
|
>
|
|
<input type="range" min="0" max="20" step="1" bind:value={arrowPadding} />
|
|
</label>
|
|
<label data-uix-control>
|
|
<span data-uix-control-label>render Arrow part</span>
|
|
<span data-uix-switch
|
|
><input type="checkbox" bind:checked={showArrow} /><span data-uix-switch-label
|
|
>{showArrow ? 'on' : 'off'}</span
|
|
></span
|
|
>
|
|
</label>
|
|
</div>
|
|
|
|
<div data-uix-subsection-head>
|
|
<span data-uix-layer-badge="eidos">eidos</span> props · visual treatment
|
|
</div>
|
|
<div data-uix-controls>
|
|
<label data-uix-control>
|
|
<span data-uix-control-label>variant</span>
|
|
<span data-uix-chips role="radiogroup">
|
|
{#each ['solid', 'outline', 'ghost'] as v}
|
|
<button
|
|
data-uix-chip
|
|
data-active={variant === v}
|
|
onclick={() => (variant = v as TooltipVariant)}>{v}</button
|
|
>
|
|
{/each}
|
|
</span>
|
|
</label>
|
|
<label data-uix-control>
|
|
<span data-uix-control-label>size</span>
|
|
<span data-uix-chips role="radiogroup">
|
|
{#each ['sm', 'md', 'lg'] as s}
|
|
<button
|
|
data-uix-chip
|
|
data-active={size === s}
|
|
onclick={() => (size = s as TooltipSize)}>{s}</button
|
|
>
|
|
{/each}
|
|
</span>
|
|
</label>
|
|
</div>
|
|
|
|
<div data-uix-subsection-head>
|
|
Demo content <span style="font-weight: normal; color: var(--uix-text-muted);"
|
|
>· literal text</span
|
|
>
|
|
</div>
|
|
<div data-uix-controls>
|
|
<label data-uix-control>
|
|
<span data-uix-control-label>trigger label</span>
|
|
<input type="text" bind:value={triggerLabel} />
|
|
</label>
|
|
<label data-uix-control>
|
|
<span data-uix-control-label>tooltip text</span>
|
|
<input type="text" bind:value={contentText} />
|
|
</label>
|
|
</div>
|
|
|
|
<div data-uix-code>
|
|
<div data-uix-code-head>
|
|
<span data-uix-layer-badge="soma">soma</span>
|
|
<span>headless · ARIA + behavior only</span>
|
|
<span data-uix-code-lang>svelte</span>
|
|
</div>
|
|
<pre><code>{somaSnippet}</code></pre>
|
|
</div>
|
|
|
|
<div data-uix-code style="margin-top: var(--uix-space-3);">
|
|
<div data-uix-code-head>
|
|
<span data-uix-layer-badge="eidos">eidos</span>
|
|
<span>visual · adds size, variant tokens</span>
|
|
<span data-uix-code-lang>svelte</span>
|
|
</div>
|
|
<pre><code>{eidosSnippet}</code></pre>
|
|
</div>
|
|
</section>
|
|
{/if}
|
|
|
|
{#if tab === 'api'}
|
|
<section data-uix-section>
|
|
<h2 data-uix-section-title>API reference</h2>
|
|
<p data-uix-section-desc>All public props on every part. Eidos additions tagged.</p>
|
|
<div data-uix-subsection-head>Group</div>
|
|
<div data-uix-table-wrap>
|
|
<table data-uix-table>
|
|
<thead><tr><th>Prop</th><th>Type</th><th>Default</th><th>Description</th></tr></thead>
|
|
<tbody>
|
|
<tr
|
|
><td class="name">delayDuration</td><td class="type">number</td><td class="default"
|
|
>700</td
|
|
><td>Global hover delay (ms) before tooltips open.</td></tr
|
|
>
|
|
<tr
|
|
><td class="name">skipDelayDuration</td><td class="type">number</td><td
|
|
class="default">300</td
|
|
><td>Grace window for instant sibling open.</td></tr
|
|
>
|
|
<tr
|
|
><td class="name">disableHoverableContent</td><td class="type">boolean</td><td
|
|
class="default">false</td
|
|
><td>Tooltip closes when pointer leaves trigger.</td></tr
|
|
>
|
|
<tr
|
|
><td class="name">disabled</td><td class="type">boolean</td><td class="default"
|
|
>false</td
|
|
><td>Disable all tooltips inside group.</td></tr
|
|
>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<div data-uix-subsection-head>Provider (Tooltip)</div>
|
|
<div data-uix-table-wrap>
|
|
<table data-uix-table>
|
|
<thead><tr><th>Prop</th><th>Type</th><th>Default</th><th>Description</th></tr></thead>
|
|
<tbody>
|
|
<tr
|
|
><td class="name">open <span data-uix-tag data-kind="bindable">bindable</span></td><td
|
|
class="type">boolean</td
|
|
><td class="default">false</td><td>Open state.</td></tr
|
|
>
|
|
<tr
|
|
><td class="name">delayDuration / closeDelay</td><td class="type">number</td><td
|
|
class="default">inherit / 150</td
|
|
><td>Per-tooltip overrides.</td></tr
|
|
>
|
|
<tr
|
|
><td class="name">disabled</td><td class="type">boolean</td><td class="default"
|
|
>false</td
|
|
><td>Disable this single tooltip.</td></tr
|
|
>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<div data-uix-subsection-head>Content</div>
|
|
<div data-uix-table-wrap>
|
|
<table data-uix-table>
|
|
<thead><tr><th>Prop</th><th>Type</th><th>Default</th><th>Description</th></tr></thead>
|
|
<tbody>
|
|
<tr
|
|
><td class="name">side / sideOffset / align / alignOffset</td><td class="type"
|
|
>Side / number / Align / number</td
|
|
><td class="default">'top' / 0 / 'center' / 0</td><td>Floating positioning.</td></tr
|
|
>
|
|
<tr
|
|
><td class="name">avoidCollisions / collisionPadding</td><td class="type"
|
|
>boolean / number</td
|
|
><td class="default">true / 8</td><td>Reposition to avoid viewport edges.</td></tr
|
|
>
|
|
<tr
|
|
><td class="name">sticky / hideWhenDetached / forceMount</td><td class="type"
|
|
>'partial'|'always' / boolean / boolean</td
|
|
><td class="default">'partial' / true / false</td><td
|
|
>Scroll behaviors + DOM presence.</td
|
|
></tr
|
|
>
|
|
<tr
|
|
><td class="name">ariaLabel / dir</td><td class="type">string / 'ltr'|'rtl'</td><td
|
|
class="default empty">— / inherit</td
|
|
><td>Accessible label, text direction.</td></tr
|
|
>
|
|
<tr
|
|
><td class="name">size <span data-uix-tag data-kind="eidos">eidos</span></td><td
|
|
class="type">ResponsiveProp<'sm'|'md'|'lg'></td
|
|
><td class="default">'md'</td><td>Padding + font-size preset.</td></tr
|
|
>
|
|
<tr
|
|
><td class="name">variant <span data-uix-tag data-kind="eidos">eidos</span></td><td
|
|
class="type">'solid'|'outline'|'ghost'</td
|
|
><td class="default">'solid'</td><td>Surface treatment.</td></tr
|
|
>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<div data-uix-subsection-head>Arrow</div>
|
|
<div data-uix-table-wrap>
|
|
<table data-uix-table>
|
|
<thead><tr><th>Prop</th><th>Type</th><th>Default</th><th>Description</th></tr></thead>
|
|
<tbody>
|
|
<tr
|
|
><td class="name">width / height</td><td class="type">number</td><td class="default"
|
|
>10 / 5</td
|
|
><td>Arrow dimensions in px.</td></tr
|
|
>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</section>
|
|
{/if}
|
|
|
|
{#if tab === 'morfo'}
|
|
<section data-uix-section>
|
|
<h2 data-uix-section-title>
|
|
<span data-uix-layer-badge="morfo">morfo</span> · declarative contract
|
|
</h2>
|
|
<p data-uix-section-desc>
|
|
Source: <code>src/uix/morfo/components/tooltip.ts</code>. Presence-driven —
|
|
open / close / close-dismiss edges flow through Floating + Dismissal layers.
|
|
</p>
|
|
|
|
<div data-uix-table-wrap>
|
|
<table data-uix-table>
|
|
<thead><tr><th>Field</th><th>Value</th></tr></thead>
|
|
<tbody>
|
|
<tr><td class="name">name</td><td class="type">"{tooltipMorfo.name}"</td></tr>
|
|
<tr><td class="name">kebab</td><td class="type">"{tooltipMorfo.kebab}"</td></tr>
|
|
<tr
|
|
><td class="name">scope</td><td class="type"
|
|
>[{tooltipMorfo.scope.map((s) => `"${s}"`).join(', ')}]</td
|
|
></tr
|
|
>
|
|
<tr
|
|
><td class="name">apg</td><td
|
|
><a href={tooltipMorfo.apg} target="_blank" rel="noreferrer">{tooltipMorfo.apg}</a
|
|
></td
|
|
></tr
|
|
>
|
|
<tr
|
|
><td class="name">parts.length</td><td class="default">{tooltipMorfo.parts.length}</td
|
|
></tr
|
|
>
|
|
<tr><td class="name">events.length</td><td class="default">{events.length}</td></tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div data-uix-subsection-head>Parts</div>
|
|
<div data-uix-table-wrap>
|
|
<table data-uix-table>
|
|
<thead
|
|
><tr
|
|
><th>Part</th><th>Marker</th><th>Element</th><th>Role</th><th>Archetype</th><th
|
|
>States</th
|
|
><th>Optional</th></tr
|
|
></thead
|
|
>
|
|
<tbody>
|
|
{#each partsList as part}
|
|
<tr>
|
|
<td class="name">{part.kebab}</td>
|
|
<td><code data-uix-part-marker>[{part.marker}]</code></td>
|
|
<td class="type"><{part.defaultElement}></td>
|
|
<td class="type">{part.role ?? '—'}</td>
|
|
<td class="default">{part.archetype ?? '—'}</td>
|
|
<td class="default">{part.states.length ? part.states.join(' | ') : '—'}</td>
|
|
<td class="default">{part.optional ? 'yes' : 'no'}</td>
|
|
</tr>
|
|
{/each}
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
{#each tooltipMorfo.parts as rawPart}
|
|
{@const partAny = rawPart as unknown as {
|
|
kebab: string;
|
|
aria?: ReadonlyArray<{
|
|
attr: string;
|
|
value: { kind: string };
|
|
condition?: { when: string; prop?: string };
|
|
severity?: string;
|
|
}>;
|
|
keyboard?: ReadonlyArray<{ key: string; action: string }>;
|
|
}}
|
|
{@const dataAttrs = compiled.contracts.dataAttrsByPart.get(partAny.kebab) ?? []}
|
|
{@const ariaAttrs = partAny.aria ?? []}
|
|
{@const keyboard = partAny.keyboard ?? []}
|
|
{#if dataAttrs.length || ariaAttrs.length || keyboard.length}
|
|
<div data-uix-subsection-head>{partAny.kebab}</div>
|
|
{#if dataAttrs.length}
|
|
<div data-uix-table-wrap>
|
|
<table data-uix-table>
|
|
<thead><tr><th>data-attr</th><th>Values</th><th>Source</th></tr></thead>
|
|
<tbody>
|
|
{#each dataAttrs as attr}
|
|
<tr>
|
|
<td class="name">{attr.attr}</td>
|
|
<td class="type">{attr.values ? attr.values.join(' | ') : '—'}</td>
|
|
<td class="default"
|
|
>{'value' in attr && attr.value
|
|
? (attr as { value: { kind: string } }).value.kind
|
|
: '—'}</td
|
|
>
|
|
</tr>
|
|
{/each}
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
{/if}
|
|
{#if ariaAttrs.length}
|
|
<div data-uix-table-wrap style="margin-top: var(--uix-space-2);">
|
|
<table data-uix-table>
|
|
<thead
|
|
><tr><th>aria-attr</th><th>Source</th><th>Condition</th><th>Severity</th></tr
|
|
></thead
|
|
>
|
|
<tbody>
|
|
{#each ariaAttrs as a}
|
|
<tr>
|
|
<td class="name">{a.attr}</td>
|
|
<td class="type">{a.value.kind}</td>
|
|
<td class="default"
|
|
>{a.condition
|
|
? `when ${a.condition.when}${a.condition.prop ? ` (${a.condition.prop})` : ''}`
|
|
: 'always'}</td
|
|
>
|
|
<td class="default">{a.severity ?? 'required'}</td>
|
|
</tr>
|
|
{/each}
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
{/if}
|
|
{#if keyboard.length}
|
|
<div data-uix-table-wrap style="margin-top: var(--uix-space-2);">
|
|
<table data-uix-table>
|
|
<thead><tr><th>key</th><th>action</th></tr></thead>
|
|
<tbody>
|
|
{#each keyboard as kb}
|
|
<tr
|
|
><td><span data-uix-kbd>{kb.key === ' ' ? 'Space' : kb.key}</span></td><td
|
|
class="default">{kb.action}</td
|
|
></tr
|
|
>
|
|
{/each}
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
{/if}
|
|
{/if}
|
|
{/each}
|
|
|
|
{#if events.length}
|
|
<div data-uix-subsection-head>Events declaration</div>
|
|
<div data-uix-table-wrap>
|
|
<table data-uix-table>
|
|
<thead
|
|
><tr
|
|
><th>name</th><th>family</th><th>verb</th><th>sequence</th><th>intent</th><th
|
|
>target</th
|
|
><th>Play</th></tr
|
|
></thead
|
|
>
|
|
<tbody>
|
|
{#each events as action}
|
|
<tr>
|
|
<td class="name">{action.name}</td>
|
|
<td class="type">{action.semantic.family}</td>
|
|
<td>{action.semantic.verb ?? '—'}</td>
|
|
<td>{action.semantic.sequence ?? 'pre'}</td>
|
|
<td class="default">—</td>
|
|
<td>{action.target}</td>
|
|
<td>
|
|
<button
|
|
data-uix-play
|
|
onclick={() => {
|
|
const target = (stageRef?.querySelector(
|
|
'[data-tooltip-content]'
|
|
) ?? stageRef?.querySelector('[data-tooltip-trigger]')) as HTMLElement | null;
|
|
if (!target) return;
|
|
void uix.events?.emit({
|
|
name: action.name,
|
|
family: action.semantic.family,
|
|
target
|
|
});
|
|
}}>▶ play</button
|
|
>
|
|
</td>
|
|
</tr>
|
|
{/each}
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
{/if}
|
|
</section>
|
|
{/if}
|
|
|
|
{#if tab === 'sema'}
|
|
<section data-uix-section>
|
|
<h2 data-uix-section-title>
|
|
<span data-uix-layer-badge="sema">sema</span> · events
|
|
</h2>
|
|
<p data-uix-section-desc>
|
|
Tooltip is presence-only — the events below describe the open/close edges that the
|
|
dismissal + floating layers drive. They do not require any user-triggered action beyond
|
|
hover / focus. Use ▶ play to dispatch them against the live stage.
|
|
</p>
|
|
{#if events.length}
|
|
<div data-uix-table-wrap>
|
|
<table data-uix-table>
|
|
<thead
|
|
><tr
|
|
><th>name</th><th>family</th><th>verb</th><th>sequence</th><th>target</th><th
|
|
>Play</th
|
|
></tr
|
|
></thead
|
|
>
|
|
<tbody>
|
|
{#each events as action}
|
|
<tr>
|
|
<td class="name">{action.name}</td>
|
|
<td class="type">{action.semantic.family}</td>
|
|
<td>{action.semantic.verb ?? '—'}</td>
|
|
<td>{action.semantic.sequence ?? 'pre'}</td>
|
|
<td>{action.target}</td>
|
|
<td>
|
|
<button
|
|
data-uix-play
|
|
onclick={() => {
|
|
const target = (stageRef?.querySelector(
|
|
'[data-tooltip-content]'
|
|
) ?? stageRef?.querySelector('[data-tooltip-trigger]')) as HTMLElement | null;
|
|
if (!target) return;
|
|
void uix.events?.emit({
|
|
name: action.name,
|
|
family: action.semantic.family,
|
|
target
|
|
});
|
|
}}>▶ play</button
|
|
>
|
|
</td>
|
|
</tr>
|
|
{/each}
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
{:else}
|
|
<div data-uix-empty-state>No Sema events declared.</div>
|
|
{/if}
|
|
</section>
|
|
{/if}
|
|
|
|
{#if tab === 'recipe'}
|
|
<section data-uix-section>
|
|
<h2 data-uix-section-title>Eidos recipe</h2>
|
|
<p data-uix-section-desc>
|
|
Selectors at <code>src/uix/eidos/components/tooltip/tooltip.css</code>. Three variants drive
|
|
surface tokens. Honours <code>prefers-reduced-motion</code>.
|
|
</p>
|
|
<div data-uix-table-wrap>
|
|
<table data-uix-table>
|
|
<thead><tr><th>Selector</th><th>Source</th></tr></thead>
|
|
<tbody>
|
|
<tr
|
|
><td class="name">[data-tooltip-content]</td><td
|
|
><span data-uix-tag data-kind="soma">morfo</span></td
|
|
></tr
|
|
>
|
|
<tr
|
|
><td class="name">[data-tooltip-content][data-size]</td><td
|
|
><span data-uix-tag data-kind="eidos">eidos</span></td
|
|
></tr
|
|
>
|
|
<tr
|
|
><td class="name">[data-tooltip-content][data-variant]</td><td
|
|
><span data-uix-tag data-kind="eidos">eidos</span></td
|
|
></tr
|
|
>
|
|
<tr
|
|
><td class="name">[data-tooltip-content][data-state='delayed-open'][data-side]</td><td
|
|
><span data-uix-tag data-kind="soma">morfo + floating</span></td
|
|
></tr
|
|
>
|
|
<tr
|
|
><td class="name">[data-tooltip-content][data-state='instant-open']</td><td
|
|
><span data-uix-tag data-kind="soma">morfo</span></td
|
|
></tr
|
|
>
|
|
<tr
|
|
><td class="name">[data-tooltip-content][data-state='closed'][data-side]</td><td
|
|
><span data-uix-tag data-kind="soma">morfo + floating</span></td
|
|
></tr
|
|
>
|
|
<tr
|
|
><td class="name">[data-tooltip-arrow]</td><td
|
|
><span data-uix-tag data-kind="soma">morfo</span></td
|
|
></tr
|
|
>
|
|
<tr
|
|
><td class="name">@media (prefers-reduced-motion: reduce)</td><td
|
|
><span data-uix-tag data-kind="eidos">eidos · a11y</span></td
|
|
></tr
|
|
>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</section>
|
|
{/if}
|
|
|
|
{#if tab === 'a11y'}
|
|
<section data-uix-section>
|
|
<h2 data-uix-section-title>Accessibility</h2>
|
|
<p data-uix-section-desc>
|
|
Follows the APG <a href={tooltipMorfo.apg} target="_blank" rel="noreferrer"
|
|
>tooltip pattern</a
|
|
>. Non-modal, non-interactive. For interactive popovers use
|
|
<a href="/uix/components/popover">Popover</a> instead.
|
|
</p>
|
|
<div data-uix-subsection-head>Keyboard</div>
|
|
<div data-uix-table-wrap>
|
|
<table data-uix-table>
|
|
<thead><tr><th>Key</th><th>Action</th></tr></thead>
|
|
<tbody>
|
|
<tr><td><span data-uix-kbd>Escape</span></td><td>Close while focused.</td></tr>
|
|
<tr
|
|
><td><span data-uix-kbd>Tab</span></td><td
|
|
>Focus moves to/from trigger; tooltip opens on focus, closes on blur.</td
|
|
></tr
|
|
>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<div data-uix-subsection-head>ARIA contract</div>
|
|
<div data-uix-table-wrap>
|
|
<table data-uix-table>
|
|
<thead><tr><th>Part</th><th>Attribute</th><th>Value</th></tr></thead>
|
|
<tbody>
|
|
<tr
|
|
><td class="name">trigger</td><td>aria-describedby</td><td class="type"
|
|
>{`<content id>`}</td
|
|
></tr
|
|
>
|
|
<tr><td class="name">content</td><td>role</td><td class="type">"tooltip"</td></tr>
|
|
<tr
|
|
><td class="name">content</td><td>aria-label</td><td class="type"
|
|
>{`{ariaLabel}`} (when set)</td
|
|
></tr
|
|
>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</section>
|
|
{/if}
|
|
</div>
|