innxt-design-system 1.6.0

package/docs/src/app/(docs)/kb/components/tooltip/demos/index.module.css

@@ -0,0 +1,233 @@
+.Container {
+  display: flex;
+  gap: 0.5rem;
+  flex-wrap: wrap;
+  justify-content: center;
+}
+
+.ButtonGroup {
+  display: flex;
+}
+
+.IconButton {
+  box-sizing: border-box;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: 2rem;
+  height: 2rem;
+  padding: 0;
+  margin: 0;
+  border: 1px solid oklch(14.5% 0 0deg);
+  background-color: white;
+  color: oklch(14.5% 0 0deg);
+  -webkit-user-select: none;
+  user-select: none;
+
+  @media (prefers-color-scheme: dark) {
+    border: 1px solid white;
+    background-color: oklch(14.5% 0 0deg);
+    color: white;
+  }
+
+  &[data-popup-open] {
+    background-color: oklch(97% 0 0deg);
+
+    @media (prefers-color-scheme: dark) {
+      background-color: oklch(26.9% 0 0deg);
+    }
+  }
+
+  @media (hover: hover) {
+    &:hover:not([data-disabled]) {
+      background-color: oklch(97% 0 0deg);
+
+      @media (prefers-color-scheme: dark) {
+        background-color: oklch(26.9% 0 0deg);
+      }
+    }
+  }
+
+  &:active:not([data-disabled]) {
+    background-color: oklch(92.2% 0 0deg);
+
+    @media (prefers-color-scheme: dark) {
+      background-color: oklch(37.1% 0 0deg);
+    }
+  }
+
+  &:not(:first-child) {
+    border-left: none;
+  }
+
+  &[data-disabled] {
+    color: oklch(55.6% 0 0deg);
+    border-color: oklch(55.6% 0 0deg);
+
+    @media (prefers-color-scheme: dark) {
+      color: oklch(70.8% 0 0deg);
+      border-color: oklch(70.8% 0 0deg);
+    }
+  }
+
+  &:focus-visible {
+    outline: 2px solid oklch(14.5% 0 0deg);
+    outline-offset: -1px;
+    position: relative;
+
+    @media (prefers-color-scheme: dark) {
+      outline-color: white;
+    }
+  }
+}
+
+.Positioner {
+  height: var(--positioner-height);
+  width: var(--positioner-width);
+  max-width: var(--available-width);
+}
+
+.Popup {
+  box-sizing: border-box;
+  position: relative;
+  font-size: 0.875rem;
+  line-height: 1.25rem;
+  padding: 0.25rem 0.5rem;
+  border: 1px solid oklch(14.5% 0 0deg);
+  background-color: white;
+  color: oklch(14.5% 0 0deg);
+  box-shadow: 0.25rem 0.25rem 0 rgb(0 0 0 / 12%);
+  transform-origin: var(--transform-origin);
+  transition:
+    scale 100ms ease-out,
+    opacity 100ms ease-out;
+
+  @media (prefers-color-scheme: dark) {
+    border: 1px solid white;
+    background-color: oklch(14.5% 0 0deg);
+    color: white;
+    box-shadow: none;
+  }
+
+  &[data-starting-style],
+  &[data-ending-style] {
+    opacity: 0;
+    scale: 0.98;
+  }
+
+  &[data-instant] {
+    transition: none;
+  }
+}
+
+.Arrow {
+  display: block;
+  position: relative;
+  width: 12px;
+  height: 6px;
+  overflow: clip;
+
+  &[data-side='top'] {
+    bottom: -6px;
+    rotate: 180deg;
+  }
+
+  &[data-side='bottom'] {
+    top: -6px;
+    rotate: 0deg;
+  }
+
+  &[data-side='left'] {
+    right: -9px;
+    rotate: 90deg;
+  }
+
+  &[data-side='right'] {
+    left: -9px;
+    rotate: -90deg;
+  }
+
+  &::before {
+    content: '';
+    display: block;
+    position: absolute;
+    bottom: 0;
+    left: 50%;
+    box-sizing: border-box;
+    width: calc(6px * sqrt(2));
+    height: calc(6px * sqrt(2));
+    background-color: white;
+    border: 1px solid oklch(14.5% 0 0deg);
+    transform: translate(-50%, 50%) rotate(45deg);
+
+    @media (prefers-color-scheme: dark) {
+      background-color: oklch(14.5% 0 0deg);
+      border: 1px solid white;
+    }
+  }
+}
+
+.Button {
+  box-sizing: border-box;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  gap: 0.5rem;
+  height: 2rem;
+  padding: 0 0.75rem;
+  margin: 0;
+  border: 1px solid oklch(14.5% 0 0deg);
+  background-color: white;
+  font-family: inherit;
+  font-size: 0.875rem;
+  font-weight: 400;
+  line-height: 1;
+  white-space: nowrap;
+  color: oklch(14.5% 0 0deg);
+  -webkit-user-select: none;
+  user-select: none;
+
+  @media (prefers-color-scheme: dark) {
+    border: 1px solid white;
+    background-color: oklch(14.5% 0 0deg);
+    color: white;
+  }
+
+  @media (hover: hover) {
+    &:hover:not([data-disabled]) {
+      background-color: oklch(97% 0 0deg);
+
+      @media (prefers-color-scheme: dark) {
+        background-color: oklch(26.9% 0 0deg);
+      }
+    }
+  }
+
+  &:active:not([data-disabled]) {
+    background-color: oklch(92.2% 0 0deg);
+
+    @media (prefers-color-scheme: dark) {
+      background-color: oklch(37.1% 0 0deg);
+    }
+  }
+
+  &[data-disabled] {
+    color: oklch(55.6% 0 0deg);
+    border-color: oklch(55.6% 0 0deg);
+
+    @media (prefers-color-scheme: dark) {
+      color: oklch(70.8% 0 0deg);
+      border-color: oklch(70.8% 0 0deg);
+    }
+  }
+
+  &:focus-visible {
+    outline: 2px solid oklch(14.5% 0 0deg);
+    outline-offset: -1px;
+    position: relative;
+
+    @media (prefers-color-scheme: dark) {
+      outline-color: white;
+    }
+  }
+}

package/docs/src/app/(docs)/kb/components/tooltip/page.mdx

@@ -0,0 +1,270 @@
+# Tooltip
+
+<Subtitle>
+  A popup that appears when an element is hovered or focused, showing a hint for sighted users.
+</Subtitle>
+<Meta
+  name="description"
+  content="A high-quality, unstyled React tooltip component that appears when an element is hovered or focused, showing a hint for sighted users."
+/>
+
+import { DemoTooltipHero } from './demos/hero';
+
+<DemoTooltipHero />
+
+## Usage guidelines
+
+- **Prefer using tooltips as visual labels only**: Tooltips should act as supplementary visual labels for sighted mouse and keyboard users. Tooltips alone are not accessible to touch or screen reader users. See [Alternatives to tooltips](#alternatives-to-tooltips) for more details.
+- **Provide an accessible name for the trigger**: Tooltips are visual-only elements and are not a replacement for labeling the trigger. The tooltip's trigger must have an `aria-label` attribute that closely matches the tooltip's content to ensure consistency for screen reader users.
+
+## Anatomy
+
+Import the component and assemble its parts:
+
+```jsx title="Anatomy"
+import { Tooltip } from '@lizuzsusil/react/tooltip';
+
+<Tooltip.Provider>
+  <Tooltip.Root>
+    <Tooltip.Trigger />
+    <Tooltip.Portal>
+      <Tooltip.Positioner>
+        <Tooltip.Popup>
+          <Tooltip.Arrow />
+          <Tooltip.Viewport />
+        </Tooltip.Popup>
+      </Tooltip.Positioner>
+    </Tooltip.Portal>
+  </Tooltip.Root>
+</Tooltip.Provider>;
+```
+
+## Alternatives to tooltips
+
+Tooltips should be supplementary popups that provide non-essential clarity in high-density UIs. A user should not miss critical information if they never see a tooltip.
+
+Tooltips don't work well with touch input. Unlike mouse pointers with hover capability, there's no easily discoverable way to reveal a tooltip before tapping its trigger on a touch device.
+
+iOS doesn't provide a system-standard, touch-friendly tooltip affordance, while Android may show a tooltip on long press. However, on the web, long press is often used to trigger contextual menus in the browser, which can lead to potential conflicts. For this reason, tooltips are disabled on touch devices.
+
+### Infotips
+
+Popups that open when hovering an info icon should use [Popover](/react/components/popover) with the `openOnHover` prop on the trigger instead of a tooltip. This way, touch users and screen reader users can access the content.
+
+To know when to reach for a popover instead of a tooltip, consider the **purpose** of the trigger element:
+If the trigger's purpose is to open the popup itself, it's a popover. If the trigger's purpose is unrelated to opening the popup, it's a tooltip.
+
+### Description text
+
+Tooltips are designed for sighted users and are not a reliable way to deliver important information to touch users or assistive technologies. If the description is important to understanding the element, don't hide it behind a tooltip — use inline text or [Popover](/react/components/popover) if space is limited, so the information is accessible to everyone.
+
+Since tooltips serve sighted mouse and keyboard users, iconography should clearly communicate the purpose of icon-only triggers, especially on mobile where the text label may not be visible.
+
+If the description is not critical, a tooltip can still be used to provide extra clarity for sighted mouse or keyboard users.
+
+### Contextual feedback messages
+
+Use the Toast component's [anchoring ability](/react/components/toast#anchored-toasts) for more ergonomic DX, to ensure the message is announced to screen readers, and to support complex content.
+
+## Examples
+
+### Detached triggers
+
+A tooltip can be controlled by a trigger located either inside or outside the `<Tooltip.Root>` component.
+For simple, one-off interactions, place the `<Tooltip.Trigger>` inside `<Tooltip.Root>`, as shown in the example at the top of this page.
+
+However, if defining the tooltip's content next to its trigger is not practical, you can use a detached trigger.
+This involves placing the `<Tooltip.Trigger>` outside of `<Tooltip.Root>` and linking them with a `handle` created by the `Tooltip.createHandle()` function.
+
+```jsx title="Detached triggers"
+const demoTooltip = Tooltip.createHandle();
+
+// @highlight
+// @highlight-text "handle={demoTooltip}"
+<Tooltip.Trigger handle={demoTooltip}>Button</Tooltip.Trigger>
+
+// @highlight
+// @highlight-text "handle={demoTooltip}"
+<Tooltip.Root handle={demoTooltip}>
+  ...
+</Tooltip.Root>
+```
+
+import { DemoTooltipDetachedTriggersSimple } from './demos/detached-triggers-simple';
+
+<DemoTooltipDetachedTriggersSimple />
+
+### Multiple triggers
+
+A single tooltip can be opened by multiple trigger elements.
+You can achieve this by using the same `handle` for several detached triggers, or by placing multiple `<Tooltip.Trigger>` components inside a single `<Tooltip.Root>`.
+
+```jsx title="Multiple triggers within the Root part"
+<Tooltip.Root>
+  <Tooltip.Trigger>Trigger 1</Tooltip.Trigger>
+  <Tooltip.Trigger>Trigger 2</Tooltip.Trigger>
+  ...
+</Tooltip.Root>
+```
+
+```jsx title="Multiple detached triggers"
+const demoTooltip = Tooltip.createHandle();
+
+<Tooltip.Trigger handle={demoTooltip}>
+  Trigger 1
+</Tooltip.Trigger>
+
+<Tooltip.Trigger handle={demoTooltip}>
+  Trigger 2
+</Tooltip.Trigger>
+
+<Tooltip.Root handle={demoTooltip}>
+  ...
+</Tooltip.Root>
+```
+
+The tooltip can render different content depending on which trigger opened it.
+This is achieved by passing a `payload` to the `<Tooltip.Trigger>` and using the function-as-a-child pattern in `<Tooltip.Root>`.
+
+The payload can be strongly typed by providing a type argument to the `createHandle()` function:
+
+```jsx title="Detached triggers with payload"
+// @highlight
+const demoTooltip = Tooltip.createHandle<{ text: string }>();
+
+// @highlight
+// @highlight-text "payload"
+<Tooltip.Trigger handle={demoTooltip} payload={{ text: 'Trigger 1' }}>
+  Trigger 1
+</Tooltip.Trigger>
+
+// @highlight
+// @highlight-text "payload"
+<Tooltip.Trigger handle={demoTooltip} payload={{ text: 'Trigger 2' }}>
+  Trigger 2
+</Tooltip.Trigger>
+
+<Tooltip.Root handle={demoTooltip}>
+  {({ payload }) => ( // @highlight-text "payload"
+    <Tooltip.Portal>
+      <Tooltip.Positioner sideOffset={8}>
+        <Tooltip.Popup className={styles.Popup}>
+          <Tooltip.Arrow className={styles.Arrow}>
+            <ArrowSvg />
+          </Tooltip.Arrow>
+          {payload !== undefined && ( {/* @highlight-text "payload" */}
+            <span>
+              Tooltip opened by {payload.text} {/* @highlight-text "payload" */}
+            </span>
+          )}
+        </Tooltip.Popup>
+      </Tooltip.Positioner>
+    </Tooltip.Portal>
+  )}
+</Tooltip.Root>
+```
+
+### Controlled mode with multiple triggers
+
+You can control the tooltip's open state externally using the `open` and `onOpenChange` props on `<Tooltip.Root>`.
+This allows you to manage the tooltip's visibility based on your application's state.
+When using multiple triggers, you have to manage which trigger is active with the `triggerId` prop on `<Tooltip.Root>` and the `id` prop on each `<Tooltip.Trigger>`.
+
+Note that there is no separate `onTriggerIdChange` prop.
+Instead, the `onOpenChange` callback receives an additional argument, `eventDetails`, which contains the trigger element that initiated the state change.
+
+import { DemoTooltipDetachedTriggersControlled } from './demos/detached-triggers-controlled';
+
+<DemoTooltipDetachedTriggersControlled />
+
+### Animating the Tooltip
+
+You can animate a tooltip as it moves between different trigger elements.
+This includes animating its position, size, and content.
+
+#### Position and Size
+
+To animate the tooltip's position, apply CSS transitions to the `left`, `right`, `top`, and `bottom` properties of the **Positioner** part.
+To animate its size, transition the `width` and `height` of the **Popup** part.
+
+#### Content
+
+The tooltip also supports content transitions.
+This is useful when different triggers display different content within the same tooltip.
+
+To enable content animations, wrap the content in the `<Tooltip.Viewport>` part.
+This part provides features to create direction-aware animations.
+It renders a `div` with a `data-activation-direction` attribute (`left`, `right`, `up`, or `down`) that indicates the new trigger's position relative to the previous one.
+
+Inside the `<Tooltip.Viewport>`, the content is further wrapped in `div`s with data attributes to help with styling:
+
+- `data-current`: The currently visible content when no transitions are present or the incoming content.
+- `data-previous`: The outgoing content during a transition.
+
+You can use these attributes to style the enter and exit animations.
+
+import { DemoTooltipDetachedTriggersFull } from './demos/detached-triggers-full';
+
+<DemoTooltipDetachedTriggersFull />
+
+## API reference
+
+import { TypesTooltip } from './types';
+
+### Provider
+
+<TypesTooltip.Provider />
+
+### Root
+
+<TypesTooltip.Root />
+
+### Trigger
+
+<TypesTooltip.Trigger />
+
+### Portal
+
+<TypesTooltip.Portal />
+
+### Positioner
+
+<TypesTooltip.Positioner />
+
+### Popup
+
+<TypesTooltip.Popup />
+
+### Arrow
+
+<TypesTooltip.Arrow />
+
+## createHandle
+
+<TypesTooltip.createHandle />
+
+[//]: # '@exclude-table-of-contents'
+
+### Handle
+
+<TypesTooltip.Handle />
+
+export const metadata = {
+  keywords: [
+    'React Tooltip',
+    'Tooltip Component',
+    'Detached Trigger Tooltip',
+    'Hint',
+    'Help Text',
+    'Hover Text',
+    'Hover Hint',
+    'Info Popup',
+    'Infotip',
+    'Aria Describedby Tooltip',
+    'Accessible Tooltip',
+    'Multiple Tooltip Triggers',
+    'Animated Tooltip',
+    'Headless React Components',
+    'GovLK UI',
+  ],
+};