Popover

A floating overlay anchored to a trigger element.

View source 
import * as Popover from "@danielfrg/solid-ui/popover"
import styles from "./index.module.css"

export function DemoPopoverHero() {
  return (
    <Popover.Root>
      <Popover.Trigger class={styles.button}>View notifications</Popover.Trigger>
      <Popover.Portal>
        <Popover.Content class={styles.content}>
          <Popover.Arrow />
          <Popover.Title class={styles.title}>Notifications</Popover.Title>
          <Popover.Description class={styles.description}>You are all caught up. Good job!</Popover.Description>
          <div class={styles.actions}>
            <Popover.CloseButton class={styles.button}>Close</Popover.CloseButton>
          </div>
        </Popover.Content>
      </Popover.Portal>
    </Popover.Root>
  )
}
.button {
  box-sizing: border-box;
  display: flex;
  align-items: center;
  justify-content: center;
  height: 2.5rem;
  padding: 0 0.875rem;
  outline: 0;
  border: 1px solid var(--color-gray-200);
  border-radius: 0.375rem;
  background-color: var(--color-gray-50);
  font-family: inherit;
  font-size: 1rem;
  font-weight: 500;
  line-height: 1.5rem;
  color: var(--color-gray-900);
  user-select: none;
  cursor: pointer;
}

@media (hover: hover) {
  .button:hover {
    background-color: var(--color-gray-100);
  }
}

.button:active {
  background-color: var(--color-gray-100);
}

.button:focus-visible {
  outline: 2px solid var(--color-blue);
  outline-offset: -1px;
}

.content {
  box-sizing: border-box;
  padding: 1rem 1.5rem;
  border-radius: 0.5rem;
  background-color: var(--color-gray-50);
  color: var(--color-gray-900);
  max-width: 500px;
  z-index: 50;
  outline: 1px solid var(--color-gray-200);
  box-shadow:
    0 10px 15px -3px var(--color-gray-200),
    0 4px 6px -4px var(--color-gray-200);
  animation: contentHide 150ms ease forwards;
}

.content[data-expanded] {
  animation: contentShow 150ms ease;
}

@media (prefers-color-scheme: dark) {
  .content {
    outline: 1px solid var(--color-gray-300);
    box-shadow: none;
  }
}

.title {
  font-size: 1rem;
  line-height: 1.5rem;
  font-weight: 500;
}

.description {
  font-size: 1rem;
  line-height: 1.5rem;
  color: var(--color-gray-600);
}

.actions {
  display: flex;
  justify-content: end;
  gap: 1rem;
  margin-top: 1rem;
}

@keyframes contentShow {
  from {
    opacity: 0;
    transform: scale(0.96);
  }
  to {
    opacity: 1;
    transform: scale(1);
  }
}

@keyframes contentHide {
  from {
    opacity: 1;
    transform: scale(1);
  }
  to {
    opacity: 0;
    transform: scale(0.96);
  }
}

.anchor {
  display: inline-block;
  padding: 0.75rem 1rem;
  border: 1px dashed var(--color-gray-300);
  border-radius: 0.375rem;
  font-size: 1rem;
  color: var(--color-gray-900);
  line-height: 1.5rem;
}

.inlineTrigger {
  display: inline;
  padding: 0;
  border: none;
  background: none;
  outline: none;
  font-family: inherit;
  font-size: inherit;
  color: var(--color-blue);
  text-decoration: underline;
  cursor: pointer;
}

.inlineTrigger:focus-visible {
  outline: 2px solid var(--color-blue);
  border-radius: 0.125rem;
}
:root {
  --color-blue: oklch(45% 50% 264deg);
  --color-red: oklch(50% 55% 31deg);
  --color-gray-50: oklch(98% 0.25% 264deg);
  --color-gray-100: oklch(12% 9.5% 264deg / 5%);
  --color-gray-200: oklch(12% 9% 264deg / 7%);
  --color-gray-300: oklch(12% 8.5% 264deg / 17%);
  --color-gray-400: oklch(12% 8% 264deg / 38%);
  --color-gray-500: oklch(12% 7.5% 264deg / 50%);
  --color-gray-600: oklch(12% 7% 264deg / 67%);
  --color-gray-700: oklch(12% 6% 264deg / 77%);
  --color-gray-800: oklch(12% 5% 264deg / 85%);
  --color-gray-900: oklch(12% 5% 264deg / 90%);
  --color-gray-950: oklch(12% 5% 264deg / 95%);
}

@media (prefers-color-scheme: dark) {
  :root {
    --color-blue: oklch(69% 50% 264deg);
    --color-red: oklch(80% 55% 31deg);
    --color-gray-50: oklch(17% 0.25% 264deg);
    --color-gray-100: oklch(28% 0.75% 264deg / 65%);
    --color-gray-200: oklch(29% 0.75% 264deg / 80%);
    --color-gray-300: oklch(35% 0.75% 264deg / 80%);
    --color-gray-400: oklch(47% 0.875% 264deg / 80%);
    --color-gray-500: oklch(64% 1% 264deg / 80%);
    --color-gray-600: oklch(82% 1% 264deg / 80%);
    --color-gray-700: oklch(92% 1.125% 264deg / 80%);
    --color-gray-800: oklch(93% 0.875% 264deg / 85%);
    --color-gray-900: oklch(95% 0.5% 264deg / 90%);
    --color-gray-950: oklch(94% 0.375% 264deg / 95%);
  }
}

Examples

Controlled

Use open and onOpenChange to control the popover visibility externally.

View source 
import { createSignal } from "solid-js"
import * as Popover from "@danielfrg/solid-ui/popover"
import styles from "./index.module.css"

export function DemoPopoverControlled() {
  const [open, setOpen] = createSignal(false)

  return (
    <Popover.Root open={open()} onOpenChange={setOpen}>
      <Popover.Trigger class={styles.button}>{open() ? "Close" : "View notifications"}</Popover.Trigger>
      <Popover.Portal>
        <Popover.Content class={styles.content}>
          <Popover.Arrow />
          <Popover.Title class={styles.title}>Notifications</Popover.Title>
          <Popover.Description class={styles.description}>You are all caught up. Good job!</Popover.Description>
          <div class={styles.actions}>
            <Popover.CloseButton class={styles.button}>Close</Popover.CloseButton>
          </div>
        </Popover.Content>
      </Popover.Portal>
    </Popover.Root>
  )
}
.button {
  box-sizing: border-box;
  display: flex;
  align-items: center;
  justify-content: center;
  height: 2.5rem;
  padding: 0 0.875rem;
  outline: 0;
  border: 1px solid var(--color-gray-200);
  border-radius: 0.375rem;
  background-color: var(--color-gray-50);
  font-family: inherit;
  font-size: 1rem;
  font-weight: 500;
  line-height: 1.5rem;
  color: var(--color-gray-900);
  user-select: none;
  cursor: pointer;
}

@media (hover: hover) {
  .button:hover {
    background-color: var(--color-gray-100);
  }
}

.button:active {
  background-color: var(--color-gray-100);
}

.button:focus-visible {
  outline: 2px solid var(--color-blue);
  outline-offset: -1px;
}

.content {
  box-sizing: border-box;
  padding: 1rem 1.5rem;
  border-radius: 0.5rem;
  background-color: var(--color-gray-50);
  color: var(--color-gray-900);
  max-width: 500px;
  z-index: 50;
  outline: 1px solid var(--color-gray-200);
  box-shadow:
    0 10px 15px -3px var(--color-gray-200),
    0 4px 6px -4px var(--color-gray-200);
  animation: contentHide 150ms ease forwards;
}

.content[data-expanded] {
  animation: contentShow 150ms ease;
}

@media (prefers-color-scheme: dark) {
  .content {
    outline: 1px solid var(--color-gray-300);
    box-shadow: none;
  }
}

.title {
  font-size: 1rem;
  line-height: 1.5rem;
  font-weight: 500;
}

.description {
  font-size: 1rem;
  line-height: 1.5rem;
  color: var(--color-gray-600);
}

.actions {
  display: flex;
  justify-content: end;
  gap: 1rem;
  margin-top: 1rem;
}

@keyframes contentShow {
  from {
    opacity: 0;
    transform: scale(0.96);
  }
  to {
    opacity: 1;
    transform: scale(1);
  }
}

@keyframes contentHide {
  from {
    opacity: 1;
    transform: scale(1);
  }
  to {
    opacity: 0;
    transform: scale(0.96);
  }
}

.anchor {
  display: inline-block;
  padding: 0.75rem 1rem;
  border: 1px dashed var(--color-gray-300);
  border-radius: 0.375rem;
  font-size: 1rem;
  color: var(--color-gray-900);
  line-height: 1.5rem;
}

.inlineTrigger {
  display: inline;
  padding: 0;
  border: none;
  background: none;
  outline: none;
  font-family: inherit;
  font-size: inherit;
  color: var(--color-blue);
  text-decoration: underline;
  cursor: pointer;
}

.inlineTrigger:focus-visible {
  outline: 2px solid var(--color-blue);
  border-radius: 0.125rem;
}
:root {
  --color-blue: oklch(45% 50% 264deg);
  --color-red: oklch(50% 55% 31deg);
  --color-gray-50: oklch(98% 0.25% 264deg);
  --color-gray-100: oklch(12% 9.5% 264deg / 5%);
  --color-gray-200: oklch(12% 9% 264deg / 7%);
  --color-gray-300: oklch(12% 8.5% 264deg / 17%);
  --color-gray-400: oklch(12% 8% 264deg / 38%);
  --color-gray-500: oklch(12% 7.5% 264deg / 50%);
  --color-gray-600: oklch(12% 7% 264deg / 67%);
  --color-gray-700: oklch(12% 6% 264deg / 77%);
  --color-gray-800: oklch(12% 5% 264deg / 85%);
  --color-gray-900: oklch(12% 5% 264deg / 90%);
  --color-gray-950: oklch(12% 5% 264deg / 95%);
}

@media (prefers-color-scheme: dark) {
  :root {
    --color-blue: oklch(69% 50% 264deg);
    --color-red: oklch(80% 55% 31deg);
    --color-gray-50: oklch(17% 0.25% 264deg);
    --color-gray-100: oklch(28% 0.75% 264deg / 65%);
    --color-gray-200: oklch(29% 0.75% 264deg / 80%);
    --color-gray-300: oklch(35% 0.75% 264deg / 80%);
    --color-gray-400: oklch(47% 0.875% 264deg / 80%);
    --color-gray-500: oklch(64% 1% 264deg / 80%);
    --color-gray-600: oklch(82% 1% 264deg / 80%);
    --color-gray-700: oklch(92% 1.125% 264deg / 80%);
    --color-gray-800: oklch(93% 0.875% 264deg / 85%);
    --color-gray-900: oklch(95% 0.5% 264deg / 90%);
    --color-gray-950: oklch(94% 0.375% 264deg / 95%);
  }
}

Custom anchor

Use Popover.Anchor to anchor the popover to a region instead of the trigger element alone.

Hover over this region or to open the popover.
View source 
import * as Popover from "@danielfrg/solid-ui/popover"
import styles from "./index.module.css"

export function DemoPopoverCustomAnchor() {
  return (
    <Popover.Root>
      <Popover.Anchor class={styles.anchor}>
        <span>Hover over this region or </span>
        <Popover.Trigger class={styles.inlineTrigger}>click here</Popover.Trigger>
        <span> to open the popover.</span>
      </Popover.Anchor>
      <Popover.Portal>
        <Popover.Content class={styles.content}>
          <Popover.Arrow />
          <Popover.Title class={styles.title}>Custom anchor</Popover.Title>
          <Popover.Description class={styles.description}>
            The popover is anchored to the entire region, not just the trigger.
          </Popover.Description>
          <div class={styles.actions}>
            <Popover.CloseButton class={styles.button}>Close</Popover.CloseButton>
          </div>
        </Popover.Content>
      </Popover.Portal>
    </Popover.Root>
  )
}
.button {
  box-sizing: border-box;
  display: flex;
  align-items: center;
  justify-content: center;
  height: 2.5rem;
  padding: 0 0.875rem;
  outline: 0;
  border: 1px solid var(--color-gray-200);
  border-radius: 0.375rem;
  background-color: var(--color-gray-50);
  font-family: inherit;
  font-size: 1rem;
  font-weight: 500;
  line-height: 1.5rem;
  color: var(--color-gray-900);
  user-select: none;
  cursor: pointer;
}

@media (hover: hover) {
  .button:hover {
    background-color: var(--color-gray-100);
  }
}

.button:active {
  background-color: var(--color-gray-100);
}

.button:focus-visible {
  outline: 2px solid var(--color-blue);
  outline-offset: -1px;
}

.content {
  box-sizing: border-box;
  padding: 1rem 1.5rem;
  border-radius: 0.5rem;
  background-color: var(--color-gray-50);
  color: var(--color-gray-900);
  max-width: 500px;
  z-index: 50;
  outline: 1px solid var(--color-gray-200);
  box-shadow:
    0 10px 15px -3px var(--color-gray-200),
    0 4px 6px -4px var(--color-gray-200);
  animation: contentHide 150ms ease forwards;
}

.content[data-expanded] {
  animation: contentShow 150ms ease;
}

@media (prefers-color-scheme: dark) {
  .content {
    outline: 1px solid var(--color-gray-300);
    box-shadow: none;
  }
}

.title {
  font-size: 1rem;
  line-height: 1.5rem;
  font-weight: 500;
}

.description {
  font-size: 1rem;
  line-height: 1.5rem;
  color: var(--color-gray-600);
}

.actions {
  display: flex;
  justify-content: end;
  gap: 1rem;
  margin-top: 1rem;
}

@keyframes contentShow {
  from {
    opacity: 0;
    transform: scale(0.96);
  }
  to {
    opacity: 1;
    transform: scale(1);
  }
}

@keyframes contentHide {
  from {
    opacity: 1;
    transform: scale(1);
  }
  to {
    opacity: 0;
    transform: scale(0.96);
  }
}

.anchor {
  display: inline-block;
  padding: 0.75rem 1rem;
  border: 1px dashed var(--color-gray-300);
  border-radius: 0.375rem;
  font-size: 1rem;
  color: var(--color-gray-900);
  line-height: 1.5rem;
}

.inlineTrigger {
  display: inline;
  padding: 0;
  border: none;
  background: none;
  outline: none;
  font-family: inherit;
  font-size: inherit;
  color: var(--color-blue);
  text-decoration: underline;
  cursor: pointer;
}

.inlineTrigger:focus-visible {
  outline: 2px solid var(--color-blue);
  border-radius: 0.125rem;
}
:root {
  --color-blue: oklch(45% 50% 264deg);
  --color-red: oklch(50% 55% 31deg);
  --color-gray-50: oklch(98% 0.25% 264deg);
  --color-gray-100: oklch(12% 9.5% 264deg / 5%);
  --color-gray-200: oklch(12% 9% 264deg / 7%);
  --color-gray-300: oklch(12% 8.5% 264deg / 17%);
  --color-gray-400: oklch(12% 8% 264deg / 38%);
  --color-gray-500: oklch(12% 7.5% 264deg / 50%);
  --color-gray-600: oklch(12% 7% 264deg / 67%);
  --color-gray-700: oklch(12% 6% 264deg / 77%);
  --color-gray-800: oklch(12% 5% 264deg / 85%);
  --color-gray-900: oklch(12% 5% 264deg / 90%);
  --color-gray-950: oklch(12% 5% 264deg / 95%);
}

@media (prefers-color-scheme: dark) {
  :root {
    --color-blue: oklch(69% 50% 264deg);
    --color-red: oklch(80% 55% 31deg);
    --color-gray-50: oklch(17% 0.25% 264deg);
    --color-gray-100: oklch(28% 0.75% 264deg / 65%);
    --color-gray-200: oklch(29% 0.75% 264deg / 80%);
    --color-gray-300: oklch(35% 0.75% 264deg / 80%);
    --color-gray-400: oklch(47% 0.875% 264deg / 80%);
    --color-gray-500: oklch(64% 1% 264deg / 80%);
    --color-gray-600: oklch(82% 1% 264deg / 80%);
    --color-gray-700: oklch(92% 1.125% 264deg / 80%);
    --color-gray-800: oklch(93% 0.875% 264deg / 85%);
    --color-gray-900: oklch(95% 0.5% 264deg / 90%);
    --color-gray-950: oklch(94% 0.375% 264deg / 95%);
  }
}