ClintchizandClaude Opus 5
949cf78636
DataTable replaces the 20-line Table scaffold entirely: columns, sorting, filtering, pagination, selection, bulk actions, comparison layout, sticky first column, custom HTML cells, and a remote source driven by a `request` output rather than a function prop (props travel as HTML attributes, so a function arrives as its own source text). Toaster replaces the hand-rolled status div: tone icons, actions, hover pause/resume and a progress bar. Overlays audit -- Modal and Drawer declared aria-modal="true" but nothing ever moved focus into the panel, so the @keydown handler on their root never ran and closeOnEscape did nothing. Focus, focus restore, a Tab trap and a body scroll lock now live in the reactive runtime, shared by both. ContextMenu placed pointer menus by subtracting a guessed 340x420 from the viewport, which pushed every menu that was not that size away from the pointer; it now positions at the pointer and lets the anchored clamp pull it back once it can be measured. The reactive runtime size budget moves 150k -> 175k to cover anchored overlays, dialog behaviour, the toaster and the DataTable client half. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
181 lines
21 KiB
Plaintext
181 lines
21 KiB
Plaintext
// Generated by scripts/generate-showcase.mjs. Do not edit directly.
|
|
page TooltipDetail {
|
|
layout = "showcase"
|
|
state playground_id = ctx.url.searchParams.get("pg_id") ?? ""
|
|
state playground_open = (ctx.url.searchParams.get("pg_open") ?? "false") === "true"
|
|
state playground_defaultOpen = (ctx.url.searchParams.get("pg_defaultOpen") ?? "false") === "true"
|
|
state playground_title = ctx.url.searchParams.get("pg_title") ?? "Tooltip example"
|
|
state playground_description = ctx.url.searchParams.get("pg_description") ?? "A polished default tooltip for a modern application."
|
|
state playground_content = ctx.url.searchParams.get("pg_content") ?? "Hover or focus the trigger to inspect the tooltip."
|
|
state playground_trigger = ctx.url.searchParams.get("pg_trigger") ?? "hover"
|
|
state playground_placement = ctx.url.searchParams.get("pg_placement") ?? "top"
|
|
state playground_size = ctx.url.searchParams.get("pg_size") ?? "default"
|
|
state playground_color = ctx.url.searchParams.get("pg_color") ?? "primary"
|
|
state playground_variant = ctx.url.searchParams.get("pg_variant") ?? "dark"
|
|
state playground_maxWidth = ctx.url.searchParams.get("pg_maxWidth") ?? "18rem"
|
|
state playground_offset = Number(ctx.url.searchParams.get("pg_offset") ?? "10")
|
|
state playground_showArrow = (ctx.url.searchParams.get("pg_showArrow") ?? "true") === "true"
|
|
state playground_interactive = (ctx.url.searchParams.get("pg_interactive") ?? "false") === "true"
|
|
state playground_disabled = (ctx.url.searchParams.get("pg_disabled") ?? "false") === "true"
|
|
state playground_class = ctx.url.searchParams.get("pg_class") ?? "showcase-instance showcase-instance--1"
|
|
seo {
|
|
title = "Tooltip"
|
|
description = "Show concise accessible contextual help on hover, focus, click, or controlled open state."
|
|
}
|
|
view {
|
|
<nav class="docs-breadcrumbs" aria-label="Breadcrumb">
|
|
<a href="/">Components</a><span aria-hidden="true">/</span><a href="/overlays">Overlays</a><span aria-hidden="true">/</span><span>Tooltip</span>
|
|
</nav>
|
|
<header class="detail-hero">
|
|
<div class="detail-hero-copy">
|
|
<span class="showcase-eyebrow">Overlays component</span>
|
|
<h1>Tooltip</h1>
|
|
<p>Show concise accessible contextual help on hover, focus, click, or controlled open state.</p>
|
|
<div class="detail-badges"><span>17 props</span><span>2 slots</span><span>3 outputs</span><span>Theme ready</span><span>Responsive</span></div>
|
|
</div>
|
|
<div class="detail-hero-icon"><span class="icon-[lucide--component] size-10" aria-hidden="true"></span></div>
|
|
</header>
|
|
<section id="playground" class="detail-section playground-section" data-playground data-playground-component="Tooltip" data-playground-public-tag="true" data-playground-has-slot="true" data-playground-events="toggle,open,close">
|
|
<div class="detail-section-heading"><span>Interactive playground</span><h2>Configure Tooltip</h2><p>Change any prop and inspect the server-rendered component immediately.</p></div>
|
|
<div class="playground-workbench">
|
|
<div class="playground-preview">
|
|
<div class="demo-browser-chrome"><span></span><span></span><span></span><small>Live preview</small></div>
|
|
<div class="playground-preview-source" data-playground-preview><Tooltip id='{playground_id}' open='{playground_open}' defaultOpen='{playground_defaultOpen}' title='{playground_title}' description='{playground_description}' content='{playground_content}' trigger='{playground_trigger}' placement='{playground_placement}' size='{playground_size}' color='{playground_color}' variant='{playground_variant}' maxWidth='{playground_maxWidth}' offset='{playground_offset}' showArrow='{playground_showArrow}' interactive='{playground_interactive}' disabled='{playground_disabled}' class='{playground_class}'><div data-slot="trigger"><button type="button" class="showcase-action">Hover or focus</button></div></Tooltip></div>
|
|
<section class="playground-code" aria-label="Current component code">
|
|
<header><span><span class="icon-[lucide--code-2] size-4" aria-hidden="true"></span>Component code</span><button type="button" data-playground-copy><span class="icon-[lucide--copy] size-4" aria-hidden="true"></span>Copy</button></header>
|
|
<pre><code data-playground-code><Tooltip
|
|
title="Tooltip example"
|
|
description="A polished default tooltip for a modern application.">
|
|
<div data-slot="trigger">
|
|
<div class="showcase-slot">trigger slot</div>
|
|
</div>
|
|
</Tooltip></code></pre>
|
|
</section>
|
|
<div class="playground-status" data-playground-status aria-live="polite"></div>
|
|
<div class="playground-event-log" data-playground-event-log aria-live="polite"><strong>Event output</strong><span>Interact with the preview to inspect the typed <code>payload</code>.</span></div>
|
|
</div>
|
|
<form class="playground-controls" data-playground-form>
|
|
<header><div><span>Component props</span><strong>17 controls</strong></div><button type="reset"><span class="icon-[lucide--rotate-ccw] size-4" aria-hidden="true"></span>Reset</button></header>
|
|
<div class="playground-fields"><label class="playground-field" for="playground-tooltip-id"><span><strong>id</strong><small>string</small></span><input id="playground-tooltip-id" name="pg_id" type="text" value="" /></label><label class="playground-toggle" for="playground-tooltip-open"><span><strong>open</strong><small>boolean</small></span><input id="playground-tooltip-open" name="pg_open" type="checkbox" value="true" data-playground-boolean /><i aria-hidden="true"></i></label><label class="playground-toggle" for="playground-tooltip-defaultOpen"><span><strong>default Open</strong><small>boolean</small></span><input id="playground-tooltip-defaultOpen" name="pg_defaultOpen" type="checkbox" value="true" data-playground-boolean /><i aria-hidden="true"></i></label><label class="playground-field" for="playground-tooltip-title"><span><strong>title</strong><small>string</small></span><input id="playground-tooltip-title" name="pg_title" type="text" value="Tooltip example" /></label><label class="playground-field" for="playground-tooltip-description"><span><strong>description</strong><small>string</small></span><input id="playground-tooltip-description" name="pg_description" type="text" value="A polished default tooltip for a modern application." /></label><label class="playground-field" for="playground-tooltip-content"><span><strong>content</strong><small>string</small></span><input id="playground-tooltip-content" name="pg_content" type="text" value="Hover or focus the trigger to inspect the tooltip." /></label><label class="playground-field" for="playground-tooltip-trigger"><span><strong>trigger</strong><small>string</small></span><select id="playground-tooltip-trigger" name="pg_trigger"><option value="hover" selected>hover</option><option value="focus">focus</option><option value="click">click</option><option value="both">both</option><option value="manual">manual</option></select></label><label class="playground-field" for="playground-tooltip-placement"><span><strong>placement</strong><small>string</small></span><select id="playground-tooltip-placement" name="pg_placement"><option value="top" selected>top</option><option value="top-start">top-start</option><option value="top-end">top-end</option><option value="bottom">bottom</option><option value="bottom-start">bottom-start</option><option value="bottom-end">bottom-end</option><option value="left">left</option><option value="right">right</option><option value="right-start">right-start</option><option value="right-end">right-end</option><option value="left-start">left-start</option><option value="left-end">left-end</option></select></label><label class="playground-field" for="playground-tooltip-size"><span><strong>size</strong><small>string</small></span><select id="playground-tooltip-size" name="pg_size"><option value="default" selected>default</option><option value="sm">sm</option><option value="lg">lg</option><option value="xs">xs</option><option value="md">md</option><option value="xl">xl</option><option value="icon">icon</option><option value="icon-xs">icon-xs</option><option value="icon-sm">icon-sm</option><option value="icon-lg">icon-lg</option></select></label><label class="playground-field" for="playground-tooltip-color"><span><strong>color</strong><small>string</small></span><select id="playground-tooltip-color" name="pg_color"><option value="primary" selected>primary</option><option value="secondary">secondary</option><option value="success">success</option><option value="warning">warning</option><option value="danger">danger</option><option value="info">info</option></select></label><label class="playground-field" for="playground-tooltip-variant"><span><strong>variant</strong><small>string</small></span><select id="playground-tooltip-variant" name="pg_variant"><option value="dark" selected>dark</option><option value="light">light</option><option value="soft">soft</option><option value="solid">solid</option></select></label><label class="playground-field" for="playground-tooltip-maxWidth"><span><strong>max Width</strong><small>string</small></span><select id="playground-tooltip-maxWidth" name="pg_maxWidth"><option value="18rem" selected>18rem</option><option value="compact">compact</option><option value="lg">lg</option><option value="xl">xl</option><option value="wide">wide</option><option value="2xl">2xl</option><option value="full">full</option></select></label><label class="playground-field" for="playground-tooltip-offset"><span><strong>offset</strong><small>number</small></span><input id="playground-tooltip-offset" name="pg_offset" type="number" value="10" /></label><label class="playground-toggle" for="playground-tooltip-showArrow"><span><strong>show Arrow</strong><small>boolean</small></span><input id="playground-tooltip-showArrow" name="pg_showArrow" type="checkbox" value="true" checked data-playground-boolean /><i aria-hidden="true"></i></label><label class="playground-toggle" for="playground-tooltip-interactive"><span><strong>interactive</strong><small>boolean</small></span><input id="playground-tooltip-interactive" name="pg_interactive" type="checkbox" value="true" data-playground-boolean /><i aria-hidden="true"></i></label><label class="playground-toggle" for="playground-tooltip-disabled"><span><strong>disabled</strong><small>boolean</small></span><input id="playground-tooltip-disabled" name="pg_disabled" type="checkbox" value="true" data-playground-boolean /><i aria-hidden="true"></i></label><label class="playground-field" for="playground-tooltip-class"><span><strong>class</strong><small>string</small></span><input id="playground-tooltip-class" name="pg_class" type="text" value="showcase-instance showcase-instance--1" /></label></div>
|
|
</form>
|
|
</div>
|
|
</section>
|
|
<div class="detail-layout">
|
|
<main class="detail-content">
|
|
<section class="detail-section"><div class="detail-section-heading"><span>Live examples</span><h2>Designed for real product surfaces</h2><p>Compare configurations and resize the browser to check responsive behavior.</p></div><div class="demo-list">
|
|
<article class="demo-case">
|
|
<header class="demo-case-header">
|
|
<div><span class="demo-case-eyebrow">Recommended</span><h2>Hover and focus tooltip</h2><p>Explain an unfamiliar control without interrupting the workflow.</p></div>
|
|
<span class="demo-case-number">01</span>
|
|
</header>
|
|
<div class="demo-workbench">
|
|
<div id="tooltip-demo-1" class="demo-canvas demo-canvas--1">
|
|
<div class="demo-browser-chrome"><span></span><span></span><span></span><small>Live preview</small></div>
|
|
<p class="demo-interaction-hint"><span class="icon-[lucide--mouse-pointer-click] size-4" aria-hidden="true"></span>Hover, focus, or click the trigger</p>
|
|
<div class="demo-render"><Tooltip id="help-tooltip" open="false" defaultOpen="false" title="Helpful information" description="A polished default tooltip for a modern application." content="Tooltips explain controls without interrupting the user." placement="top" size="default" variant="dark" offset="10" showArrow="true" interactive="false" disabled="false" class="showcase-instance showcase-instance--1"><div data-slot="trigger"><button type="button" class="showcase-action">Hover or focus</button></div></Tooltip></div>
|
|
</div>
|
|
<section class="demo-code" aria-label="Hover and focus tooltip usage">
|
|
<header><span><span class="icon-[lucide--code-2] size-4" aria-hidden="true"></span>Component usage</span><small>.wrn</small></header>
|
|
<pre><code><Tooltip
|
|
id="help-tooltip"
|
|
title="Helpful information"
|
|
description="A polished default tooltip for a modern application."
|
|
content="Tooltips explain controls without interrupting the user.">
|
|
<div data-slot="trigger">
|
|
<button type="button" class="showcase-action">Hover or focus</button>
|
|
</div>
|
|
</Tooltip></code></pre>
|
|
</section>
|
|
</div>
|
|
</article>
|
|
<article class="demo-case">
|
|
<header class="demo-case-header">
|
|
<div><span class="demo-case-eyebrow">Compact</span><h2>Click tooltip</h2><p>Use click activation for touch-first or interactive help.</p></div>
|
|
<span class="demo-case-number">02</span>
|
|
</header>
|
|
<div class="demo-workbench">
|
|
<div id="tooltip-demo-2" class="demo-canvas demo-canvas--2">
|
|
<div class="demo-browser-chrome"><span></span><span></span><span></span><small>Live preview</small></div>
|
|
<p class="demo-interaction-hint"><span class="icon-[lucide--mouse-pointer-click] size-4" aria-hidden="true"></span>Hover, focus, or click the trigger</p>
|
|
<div class="demo-render"><Tooltip id="click-tooltip" open="false" defaultOpen="false" title="Compact Tooltip" description="A compact configuration for dashboards and dense product surfaces." content="Click again or press Escape to close." trigger="click" placement="bottom" size="sm" variant="soft" offset="10" showArrow="true" interactive="false" disabled="false" class="showcase-instance showcase-instance--2"><div data-slot="trigger"><button type="button" class="showcase-action">Click for help</button></div></Tooltip></div>
|
|
</div>
|
|
<section class="demo-code" aria-label="Click tooltip usage">
|
|
<header><span><span class="icon-[lucide--code-2] size-4" aria-hidden="true"></span>Component usage</span><small>.wrn</small></header>
|
|
<pre><code><Tooltip
|
|
id="click-tooltip"
|
|
title="Compact Tooltip"
|
|
description="A compact configuration for dashboards and dense product surfaces."
|
|
content="Click again or press Escape to close."
|
|
trigger="click"
|
|
placement="bottom"
|
|
size="sm"
|
|
variant="soft">
|
|
<div data-slot="trigger">
|
|
<button type="button" class="showcase-action">Click for help</button>
|
|
</div>
|
|
</Tooltip></code></pre>
|
|
</section>
|
|
</div>
|
|
</article>
|
|
<article class="demo-case">
|
|
<header class="demo-case-header">
|
|
<div><span class="demo-case-eyebrow">Advanced</span><h2>Interactive rich tooltip</h2><p>Allow pointer interaction when the tooltip contains supporting links or controls.</p></div>
|
|
<span class="demo-case-number">03</span>
|
|
</header>
|
|
<div class="demo-workbench">
|
|
<div id="tooltip-demo-3" class="demo-canvas demo-canvas--3">
|
|
<div class="demo-browser-chrome"><span></span><span></span><span></span><small>Live preview</small></div>
|
|
<p class="demo-interaction-hint"><span class="icon-[lucide--mouse-pointer-click] size-4" aria-hidden="true"></span>Hover, focus, or click the trigger</p>
|
|
<div class="demo-render"><Tooltip id="interactive-tooltip" open="false" defaultOpen="false" title="Keyboard shortcut" description="Open global search from anywhere." content="Press Ctrl or Command plus K." trigger="both" placement="right" size="lg" variant="dark" maxWidth="22rem" offset="10" showArrow="true" interactive="true" disabled="false" class="showcase-instance showcase-instance--3"><div data-slot="trigger"><button type="button" class="showcase-action">Show shortcut</button></div></Tooltip></div>
|
|
</div>
|
|
<section class="demo-code" aria-label="Interactive rich tooltip usage">
|
|
<header><span><span class="icon-[lucide--code-2] size-4" aria-hidden="true"></span>Component usage</span><small>.wrn</small></header>
|
|
<pre><code><Tooltip
|
|
id="interactive-tooltip"
|
|
title="Keyboard shortcut"
|
|
description="Open global search from anywhere."
|
|
content="Press Ctrl or Command plus K."
|
|
trigger="both"
|
|
placement="right"
|
|
size="lg"
|
|
maxWidth="22rem"
|
|
interactive="true">
|
|
<div data-slot="trigger">
|
|
<button type="button" class="showcase-action">Show shortcut</button>
|
|
</div>
|
|
</Tooltip></code></pre>
|
|
</section>
|
|
</div>
|
|
</article></div></section>
|
|
<section id="events" class="detail-section"><div class="detail-section-heading"><span>Component outputs</span><h2>Receive every typed component output</h2><p>Use declarative output handlers in <code>.wrn</code> files or register a direct output handler from JavaScript. The canonical API exposes <code>payload</code> and does not require <code>event.detail</code>.</p></div><div class="detail-events-grid"><div class="detail-events-list"><div><code>@toggle</code><span>Fires when the component changes between open and closed or on and off states.</span></div><div><code>@open</code><span>Fires after the component opens.</span></div><div><code>@close</code><span>Fires after the component closes.</span></div></div><div class="detail-event-examples"><section class="demo-code"><header><span><span class="icon-[lucide--braces] size-4" aria-hidden="true"></span>Declarative handlers</span><small>.wrn</small></header><pre><code><Tooltip
|
|
@toggle='console.log(payload)'
|
|
@open='console.log(payload)'
|
|
@close='console.log(payload)'
|
|
/></code></pre></section><section class="demo-code"><header><span><span class="icon-[lucide--radio] size-4" aria-hidden="true"></span>Direct output handlers</span><small>.js</small></header><pre><code>import <span>{</span> registerOutputHandler <span>}</span> from "@wrnexus/csr/outputs"
|
|
|
|
const component = document.querySelector("[data-ui-component=\"Tooltip\"], [data-component=\"Tooltip\"]")
|
|
|
|
if (component) registerOutputHandler(component, "toggle", (payload) => <span>{</span>
|
|
console.log("toggle", payload)
|
|
<span>}</span>)
|
|
|
|
if (component) registerOutputHandler(component, "open", (payload) => <span>{</span>
|
|
console.log("open", payload)
|
|
<span>}</span>)
|
|
|
|
if (component) registerOutputHandler(component, "close", (payload) => <span>{</span>
|
|
console.log("close", payload)
|
|
<span>}</span>)</code></pre></section></div></div></section>
|
|
<section id="api" class="detail-section"><div class="detail-section-heading"><span>Component API</span><h2>Props and configuration</h2><p>All content and behavior shown above is supplied through these props and slots.</p></div><div class="docs-table-wrap"><table class="docs-table"><thead><tr><th>Prop</th><th>Type</th><th>Default</th><th>Required</th></tr></thead><tbody><tr><td><code>id</code></td><td>string</td><td><code>""</code></td><td>No</td></tr><tr><td><code>open</code></td><td>boolean</td><td><code>false</code></td><td>No</td></tr><tr><td><code>defaultOpen</code></td><td>boolean</td><td><code>false</code></td><td>No</td></tr><tr><td><code>title</code></td><td>string</td><td><code>""</code></td><td>No</td></tr><tr><td><code>description</code></td><td>string</td><td><code>""</code></td><td>No</td></tr><tr><td><code>content</code></td><td>string</td><td><code>"Tooltip"</code></td><td>No</td></tr><tr><td><code>trigger</code></td><td>string</td><td><code>"hover"</code></td><td>No</td></tr><tr><td><code>placement</code></td><td>string</td><td><code>"top"</code></td><td>No</td></tr><tr><td><code>size</code></td><td>string</td><td><code>"default"</code></td><td>No</td></tr><tr><td><code>color</code></td><td>string</td><td><code>"primary"</code></td><td>No</td></tr><tr><td><code>variant</code></td><td>string</td><td><code>"dark"</code></td><td>No</td></tr><tr><td><code>maxWidth</code></td><td>string</td><td><code>"18rem"</code></td><td>No</td></tr><tr><td><code>offset</code></td><td>number</td><td><code>10</code></td><td>No</td></tr><tr><td><code>showArrow</code></td><td>boolean</td><td><code>true</code></td><td>No</td></tr><tr><td><code>interactive</code></td><td>boolean</td><td><code>false</code></td><td>No</td></tr><tr><td><code>disabled</code></td><td>boolean</td><td><code>false</code></td><td>No</td></tr><tr><td><code>class</code></td><td>string</td><td><code>""</code></td><td>No</td></tr></tbody></table></div></section>
|
|
</main>
|
|
<aside class="detail-aside">
|
|
<div class="detail-toc"><strong>On this page</strong><a href="#playground">Playground</a><a href="#tooltip-demo-1">Hover and focus tooltip</a><a href="#tooltip-demo-2">Click tooltip</a><a href="#tooltip-demo-3">Interactive rich tooltip</a><a href="#events">Outputs</a><a href="#api">Props API</a></div>
|
|
</aside>
|
|
</div>
|
|
<nav class="detail-pagination">
|
|
<a href="/components/popover"><small>Previous</small><strong>← Popover</strong></a>
|
|
<span></span>
|
|
</nav>
|
|
}
|
|
}
|