Preview card built on the Popover API, shown when a link is hovered or focused, for profiles, repositories, and other previews.
MarkasUI
UI components for Blade, React, and Vue.
Joined March 2026
MarkasUI
UI components for Blade, React, and Vue.
Joined March 2026
MarkasUI
UI components for Blade, React, and Vue.
Joined March 2026
MarkasUI
UI components for Blade, React, and Vue.
Joined March 2026
MarkasUI
UI components for Blade, React, and Vue.
Joined March 2026
<div class="flex justify-center py-6">
<x-markas.hover-card>
<a href="https://github.com/markasui" class="text-sm rounded-sm font-medium text-primary underline underline-offset-4 focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary">@markasui</a>
<x-slot:content>
<div class="flex gap-3">
<span class="grid size-10 shrink-0 place-items-center rounded-full border border-line bg-canvas"><svg class="size-6" viewBox="0 0 1464 1430" aria-hidden="true"><polygon points="354,578 1256,138 1171,430 268,868" class="fill-ink/15" /><polygon points="553,443 1455,3 1370,295 467,733" class="fill-ink/55" /><polygon points="421,762 1325,318 1240,611 336,1050" class="fill-success/35" /><polygon points="265,1073 1169,629 1084,922 180,1362" class="fill-ink/25" /><polygon points="93,965 997,521 912,814 8,1253" class="fill-ink/75" /><polygon points="347,1135 1251,691 1166,984 262,1424" class="fill-success" /></svg></span>
<div class="grid gap-1">
<p class="font-medium text-ink">MarkasUI</p>
<p class="text-muted">UI components for Blade, React, and Vue.</p>
<p class="text-xs text-muted">Joined March 2026</p>
</div>
</div>
</x-slot:content>
</x-markas.hover-card>
</div>import { HoverCard } from "@/components/markas/HoverCard";
const mark = [
{ points: "354,578 1256,138 1171,430 268,868", className: "fill-ink/15" },
{ points: "553,443 1455,3 1370,295 467,733", className: "fill-ink/55" },
{
points: "421,762 1325,318 1240,611 336,1050",
className: "fill-success/35",
},
{ points: "265,1073 1169,629 1084,922 180,1362", className: "fill-ink/25" },
{ points: "93,965 997,521 912,814 8,1253", className: "fill-ink/75" },
{
points: "347,1135 1251,691 1166,984 262,1424",
className: "fill-success",
},
];
export default function HoverCardExample() {
return (
<div className="flex justify-center py-6">
<HoverCard
content={
<div className="flex gap-3">
<span className="grid size-10 shrink-0 place-items-center rounded-full border border-line bg-canvas">
<svg
className="size-6"
viewBox="0 0 1464 1430"
aria-hidden="true"
>
{mark.map((shape) => (
<polygon
key={shape.points}
points={shape.points}
className={shape.className}
/>
))}
</svg>
</span>
<div className="grid gap-1">
<p className="font-medium text-ink">MarkasUI</p>
<p className="text-muted">
UI components for Blade, React, and Vue.
</p>
<p className="text-xs text-muted">Joined March 2026</p>
</div>
</div>
}
>
<a
href="https://github.com/markasui"
className="rounded-sm text-sm font-medium text-primary underline underline-offset-4 focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary"
>
@markasui
</a>
</HoverCard>
</div>
);
}<script setup lang="ts">
import HoverCard from "@/components/markas/HoverCard.vue";
const mark = [
{ points: "354,578 1256,138 1171,430 268,868", className: "fill-ink/15" },
{ points: "553,443 1455,3 1370,295 467,733", className: "fill-ink/55" },
{
points: "421,762 1325,318 1240,611 336,1050",
className: "fill-success/35",
},
{ points: "265,1073 1169,629 1084,922 180,1362", className: "fill-ink/25" },
{ points: "93,965 997,521 912,814 8,1253", className: "fill-ink/75" },
{
points: "347,1135 1251,691 1166,984 262,1424",
className: "fill-success",
},
];
</script>
<template>
<div class="flex justify-center py-6">
<HoverCard>
<a
href="https://github.com/markasui"
class="rounded-sm text-sm font-medium text-primary underline underline-offset-4 focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary"
>@markasui</a
>
<template #content>
<div class="flex gap-3">
<span
class="grid size-10 shrink-0 place-items-center rounded-full border border-line bg-canvas"
><svg class="size-6" viewBox="0 0 1464 1430" aria-hidden="true">
<polygon
v-for="shape in mark"
:key="shape.points"
:points="shape.points"
:class="shape.className"
/></svg
></span>
<div class="grid gap-1">
<p class="font-medium text-ink">MarkasUI</p>
<p class="text-muted">UI components for Blade, React, and Vue.</p>
<p class="text-xs text-muted">Joined March 2026</p>
</div>
</div>
</template>
</HoverCard>
</div>
</template><script lang="ts">
import HoverCard from "$lib/components/markas/HoverCard.svelte";
const mark = [
{ points: "354,578 1256,138 1171,430 268,868", class: "fill-ink/15" },
{ points: "553,443 1455,3 1370,295 467,733", class: "fill-ink/55" },
{ points: "421,762 1325,318 1240,611 336,1050", class: "fill-success/35" },
{ points: "265,1073 1169,629 1084,922 180,1362", class: "fill-ink/25" },
{ points: "93,965 997,521 912,814 8,1253", class: "fill-ink/75" },
{ points: "347,1135 1251,691 1166,984 262,1424", class: "fill-success" },
];
</script>
<div class="flex justify-center py-6">
<HoverCard>
<a
href="https://github.com/markasui"
class="rounded-sm text-sm font-medium text-primary underline underline-offset-4 focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary"
>@markasui</a
>
{#snippet content()}
<div class="flex gap-3">
<span
class="grid size-10 shrink-0 place-items-center rounded-full border border-line bg-canvas"
>
<svg class="size-6" viewBox="0 0 1464 1430" aria-hidden="true">
{#each mark as shape (shape.points)}
<polygon points={shape.points} class={shape.class} />
{/each}
</svg>
</span>
<div class="grid gap-1">
<p class="font-medium text-ink">MarkasUI</p>
<p class="text-muted">UI components for Blade, React, and Vue.</p>
<p class="text-xs text-muted">Joined March 2026</p>
</div>
</div>
{/snippet}
</HoverCard>
</div>---
import HoverCard from "@/components/markas/HoverCard.astro";
const mark = [
{ points: "354,578 1256,138 1171,430 268,868", class: "fill-ink/15" },
{ points: "553,443 1455,3 1370,295 467,733", class: "fill-ink/55" },
{ points: "421,762 1325,318 1240,611 336,1050", class: "fill-success/35" },
{ points: "265,1073 1169,629 1084,922 180,1362", class: "fill-ink/25" },
{ points: "93,965 997,521 912,814 8,1253", class: "fill-ink/75" },
{ points: "347,1135 1251,691 1166,984 262,1424", class: "fill-success" },
];
---
<div class="flex justify-center py-6">
<HoverCard>
<a
href="https://github.com/markasui"
class="rounded-sm text-sm font-medium text-primary underline underline-offset-4 focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary"
>@markasui</a
>
<div slot="content" class="flex gap-3">
<span class="grid size-10 shrink-0 place-items-center rounded-full border border-line bg-canvas">
<svg class="size-6" viewBox="0 0 1464 1430" aria-hidden="true">
{mark.map((shape) => <polygon points={shape.points} class={shape.class} />)}
</svg>
</span>
<div class="grid gap-1">
<p class="font-medium text-ink">MarkasUI</p>
<p class="text-muted">UI components for Blade, React, and Vue.</p>
<p class="text-xs text-muted">Joined March 2026</p>
</div>
</div>
</HoverCard>
</div>import { Component } from "@angular/core";
import { HoverCard } from "./markas/hover-card.component";
@Component({
selector: "markas-example",
imports: [HoverCard],
template: `
<div class="flex justify-center py-6">
<markas-hover-card>
<a href="https://github.com/markasui" [class]="link">@markasui</a>
<div content class="flex gap-3">
<span [class]="badge">
<svg class="size-6" viewBox="0 0 1464 1430" aria-hidden="true">
@for (shape of mark; track shape.points) {
<polygon
[attr.points]="shape.points"
[attr.class]="shape.class"
/>
}
</svg>
</span>
<div class="grid gap-1">
<p class="font-medium text-ink">MarkasUI</p>
<p class="text-muted">UI components for Blade, React, and Vue.</p>
<p class="text-xs text-muted">Joined March 2026</p>
</div>
</div>
</markas-hover-card>
</div>
`,
})
export default class HoverCardExample {
protected readonly link =
"rounded-sm text-sm font-medium text-primary underline underline-offset-4 focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary";
protected readonly badge =
"grid size-10 shrink-0 place-items-center rounded-full border border-line bg-canvas";
protected readonly mark = [
{ points: "354,578 1256,138 1171,430 268,868", class: "fill-ink/15" },
{ points: "553,443 1455,3 1370,295 467,733", class: "fill-ink/55" },
{ points: "421,762 1325,318 1240,611 336,1050", class: "fill-success/35" },
{ points: "265,1073 1169,629 1084,922 180,1362", class: "fill-ink/25" },
{ points: "93,965 997,521 912,814 8,1253", class: "fill-ink/75" },
{ points: "347,1135 1251,691 1166,984 262,1424", class: "fill-success" },
];
}Examples
Inside text
Rina Wijaya
Design engineer in Bandung. Works on forms and accessibility.
Rina Wijaya
Design engineer in Bandung. Works on forms and accessibility.
Rina Wijaya
Design engineer in Bandung. Works on forms and accessibility.
Rina Wijaya
Design engineer in Bandung. Works on forms and accessibility.
Rina Wijaya
Design engineer in Bandung. Works on forms and accessibility.
<div class="text-sm leading-6 text-muted">
This release was maintained by <x-markas.hover-card><a href="https://github.com/rinawijaya" class="rounded-sm font-medium text-primary underline underline-offset-4 focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary">Rina Wijaya</a><x-slot:content><div class="grid gap-1"><p class="font-medium text-ink">Rina Wijaya</p><p class="text-muted">Design engineer in Bandung. Works on forms and accessibility.</p></div></x-slot:content></x-markas.hover-card> with help from 40 contributors.
</div>import { HoverCard } from "@/components/markas/HoverCard";
export default function Example() {
return (
<div className="text-sm leading-6 text-muted">
This release was maintained by{" "}
<HoverCard
content={
<div className="grid gap-1">
<p className="font-medium text-ink">Rina Wijaya</p>
<p className="text-muted">
Design engineer in Bandung. Works on forms and accessibility.
</p>
</div>
}
>
<a
href="https://github.com/rinawijaya"
className="rounded-sm font-medium text-primary underline underline-offset-4 focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary"
>
Rina Wijaya
</a>
</HoverCard>{" "}
with help from 40 contributors.
</div>
);
}<script setup lang="ts">
import HoverCard from "@/components/markas/HoverCard.vue";
</script>
<template>
<div class="text-sm leading-6 text-muted">
This release was maintained by
<HoverCard
><a
href="https://github.com/rinawijaya"
class="rounded-sm font-medium text-primary underline underline-offset-4 focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary"
>Rina Wijaya</a
><template #content
><div class="grid gap-1">
<p class="font-medium text-ink">Rina Wijaya</p>
<p class="text-muted">
Design engineer in Bandung. Works on forms and accessibility.
</p>
</div></template
></HoverCard
>
with help from 40 contributors.
</div>
</template><script lang="ts">
import HoverCard from "$lib/components/markas/HoverCard.svelte";
</script>
<div class="text-sm leading-6 text-muted">
This release was maintained by <HoverCard>
<a
href="https://github.com/rinawijaya"
class="rounded-sm font-medium text-primary underline underline-offset-4 focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary"
>Rina Wijaya</a
>
{#snippet content()}
<div class="grid gap-1">
<p class="font-medium text-ink">Rina Wijaya</p>
<p class="text-muted">
Design engineer in Bandung. Works on forms and accessibility.
</p>
</div>
{/snippet}
</HoverCard> with help from 40 contributors.
</div>---
import HoverCard from "@/components/markas/HoverCard.astro";
---
<div class="text-sm leading-6 text-muted">
This release was maintained by <HoverCard
><a
href="https://github.com/rinawijaya"
class="rounded-sm font-medium text-primary underline underline-offset-4 focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary"
>Rina Wijaya</a
><div slot="content" class="grid gap-1">
<p class="font-medium text-ink">Rina Wijaya</p>
<p class="text-muted">Design engineer in Bandung. Works on forms and accessibility.</p>
</div></HoverCard
> with help from 40 contributors.
</div>import { Component } from "@angular/core";
import { HoverCard } from "./markas/hover-card.component";
@Component({
selector: "markas-example",
imports: [HoverCard],
template: `
<div class="text-sm leading-6 text-muted">
This release was maintained by
<markas-hover-card>
<a href="https://github.com/rinawijaya" [class]="link">Rina Wijaya</a>
<div content class="grid gap-1">
<p class="font-medium text-ink">Rina Wijaya</p>
<p class="text-muted">
Design engineer in Bandung. Works on forms and accessibility.
</p>
</div>
</markas-hover-card>
with help from 40 contributors.
</div>
`,
})
export default class HoverCardInlineExample {
protected readonly link =
"rounded-sm font-medium text-primary underline underline-offset-4 focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary";
}Repository preview
Built on top of
markasui/markasui
Copy and paste UI components with identical markup in three frameworks.
Built on top of
markasui/markasui
Copy and paste UI components with identical markup in three frameworks.
Built on top of
markasui/markasui
Copy and paste UI components with identical markup in three frameworks.
Built on top of
markasui/markasui
Copy and paste UI components with identical markup in three frameworks.
Built on top of
markasui/markasui
Copy and paste UI components with identical markup in three frameworks.
<div class="grid gap-2 rounded-lg border border-line bg-surface p-4">
<p class="text-sm text-muted">Built on top of</p>
<div>
<x-markas.hover-card>
<a href="https://github.com/markasui/markasui" class="text-sm rounded-sm font-medium text-primary underline underline-offset-4 focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary">markasui/markasui</a>
<x-slot:content>
<div class="grid gap-3">
<div class="grid gap-1">
<p class="font-medium text-ink">markasui/markasui</p>
<p class="text-muted">Copy and paste UI components with identical markup in three frameworks.</p>
</div>
<div class="flex items-center gap-4 text-xs text-muted">
<span class="inline-flex items-center gap-1">
<svg class="size-4" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m12 3 2.8 5.7 6.2.9-4.5 4.4 1 6.2L12 17.3 6.5 20.2l1-6.2L3 9.6l6.2-.9z" /></svg>
1.2k stars
</span>
<span>MIT license</span>
<span>Updated today</span>
</div>
</div>
</x-slot:content>
</x-markas.hover-card>
</div>
</div>import { HoverCard } from "@/components/markas/HoverCard";
export default function Example() {
return (
<div className="grid gap-2 rounded-lg border border-line bg-surface p-4">
<p className="text-sm text-muted">Built on top of</p>
<div>
<HoverCard
content={
<div className="grid gap-3">
<div className="grid gap-1">
<p className="font-medium text-ink">markasui/markasui</p>
<p className="text-muted">
Copy and paste UI components with identical markup in three
frameworks.
</p>
</div>
<div className="flex items-center gap-4 text-xs text-muted">
<span className="inline-flex items-center gap-1">
<svg
className="size-4"
viewBox="0 0 24 24"
fill="none"
stroke="currentColor"
strokeWidth="1.5"
strokeLinecap="round"
strokeLinejoin="round"
aria-hidden="true"
>
<path d="m12 3 2.8 5.7 6.2.9-4.5 4.4 1 6.2L12 17.3 6.5 20.2l1-6.2L3 9.6l6.2-.9z" />
</svg>
1.2k stars
</span>
<span>MIT license</span>
<span>Updated today</span>
</div>
</div>
}
>
<a
href="https://github.com/markasui/markasui"
className="rounded-sm text-sm font-medium text-primary underline underline-offset-4 focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary"
>
markasui/markasui
</a>
</HoverCard>
</div>
</div>
);
}<script setup lang="ts">
import HoverCard from "@/components/markas/HoverCard.vue";
</script>
<template>
<div class="grid gap-2 rounded-lg border border-line bg-surface p-4">
<p class="text-sm text-muted">Built on top of</p>
<div>
<HoverCard>
<a
href="https://github.com/markasui/markasui"
class="rounded-sm text-sm font-medium text-primary underline underline-offset-4 focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary"
>markasui/markasui</a
>
<template #content>
<div class="grid gap-3">
<div class="grid gap-1">
<p class="font-medium text-ink">markasui/markasui</p>
<p class="text-muted">
Copy and paste UI components with identical markup in three
frameworks.
</p>
</div>
<div class="flex items-center gap-4 text-xs text-muted">
<span class="inline-flex items-center gap-1">
<svg
class="size-4"
viewBox="0 0 24 24"
fill="none"
stroke="currentColor"
stroke-width="1.5"
stroke-linecap="round"
stroke-linejoin="round"
aria-hidden="true"
>
<path
d="m12 3 2.8 5.7 6.2.9-4.5 4.4 1 6.2L12 17.3 6.5 20.2l1-6.2L3 9.6l6.2-.9z"
/>
</svg>
1.2k stars
</span>
<span>MIT license</span>
<span>Updated today</span>
</div>
</div>
</template>
</HoverCard>
</div>
</div>
</template><script lang="ts">
import HoverCard from "$lib/components/markas/HoverCard.svelte";
</script>
<div class="grid gap-2 rounded-lg border border-line bg-surface p-4">
<p class="text-sm text-muted">Built on top of</p>
<div>
<HoverCard>
<a
href="https://github.com/markasui/markasui"
class="rounded-sm text-sm font-medium text-primary underline underline-offset-4 focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary"
>markasui/markasui</a
>
{#snippet content()}
<div class="grid gap-3">
<div class="grid gap-1">
<p class="font-medium text-ink">markasui/markasui</p>
<p class="text-muted">
Copy and paste UI components with identical markup in three
frameworks.
</p>
</div>
<div class="flex items-center gap-4 text-xs text-muted">
<span class="inline-flex items-center gap-1">
<svg
class="size-4"
viewBox="0 0 24 24"
fill="none"
stroke="currentColor"
stroke-width="1.5"
stroke-linecap="round"
stroke-linejoin="round"
aria-hidden="true"
>
<path
d="m12 3 2.8 5.7 6.2.9-4.5 4.4 1 6.2L12 17.3 6.5 20.2l1-6.2L3 9.6l6.2-.9z"
/>
</svg>
1.2k stars
</span>
<span>MIT license</span>
<span>Updated today</span>
</div>
</div>
{/snippet}
</HoverCard>
</div>
</div>---
import HoverCard from "@/components/markas/HoverCard.astro";
---
<div class="grid gap-2 rounded-lg border border-line bg-surface p-4">
<p class="text-sm text-muted">Built on top of</p>
<div>
<HoverCard>
<a
href="https://github.com/markasui/markasui"
class="rounded-sm text-sm font-medium text-primary underline underline-offset-4 focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary"
>markasui/markasui</a
>
<div slot="content" class="grid gap-3">
<div class="grid gap-1">
<p class="font-medium text-ink">markasui/markasui</p>
<p class="text-muted">Copy and paste UI components with identical markup in three frameworks.</p>
</div>
<div class="flex items-center gap-4 text-xs text-muted">
<span class="inline-flex items-center gap-1">
<svg
class="size-4"
viewBox="0 0 24 24"
fill="none"
stroke="currentColor"
stroke-width="1.5"
stroke-linecap="round"
stroke-linejoin="round"
aria-hidden="true"
>
<path d="m12 3 2.8 5.7 6.2.9-4.5 4.4 1 6.2L12 17.3 6.5 20.2l1-6.2L3 9.6l6.2-.9z"></path>
</svg>
1.2k stars
</span>
<span>MIT license</span>
<span>Updated today</span>
</div>
</div>
</HoverCard>
</div>
</div>import { Component } from "@angular/core";
import { HoverCard } from "./markas/hover-card.component";
@Component({
selector: "markas-example",
imports: [HoverCard],
template: `
<div class="grid gap-2 rounded-lg border border-line bg-surface p-4">
<p class="text-sm text-muted">Built on top of</p>
<div>
<markas-hover-card>
<a href="https://github.com/markasui/markasui" [class]="link">
markasui/markasui
</a>
<div content class="grid gap-3">
<div class="grid gap-1">
<p class="font-medium text-ink">markasui/markasui</p>
<p class="text-muted">
Copy and paste UI components with identical markup in three
frameworks.
</p>
</div>
<div class="flex items-center gap-4 text-xs text-muted">
<span class="inline-flex items-center gap-1">
<svg
class="size-4"
viewBox="0 0 24 24"
fill="none"
stroke="currentColor"
stroke-width="1.5"
stroke-linecap="round"
stroke-linejoin="round"
aria-hidden="true"
>
<path
d="m12 3 2.8 5.7 6.2.9-4.5 4.4 1 6.2L12 17.3 6.5 20.2l1-6.2L3 9.6l6.2-.9z"
/>
</svg>
1.2k stars
</span>
<span>MIT license</span>
<span>Updated today</span>
</div>
</div>
</markas-hover-card>
</div>
</div>
`,
})
export default class HoverCardRepositoryExample {
protected readonly link =
"rounded-sm text-sm font-medium text-primary underline underline-offset-4 focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary";
}Avatar triggers
<div class="flex items-center justify-center gap-3 py-6">
<x-markas.hover-card>
<a href="https://github.com/dewilestari" class="inline-flex rounded-full focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary"><x-markas.avatar name="Dewi Lestari" /></a>
<x-slot:content>
<div class="grid gap-1">
<p class="font-medium text-ink">Dewi Lestari</p>
<p class="text-muted">Product designer. Leads the design system team.</p>
</div>
</x-slot:content>
</x-markas.hover-card>
<x-markas.hover-card>
<a href="https://github.com/budisantoso" class="inline-flex rounded-full focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary"><x-markas.avatar name="Budi Santoso" /></a>
<x-slot:content>
<div class="grid gap-1">
<p class="font-medium text-ink">Budi Santoso</p>
<p class="text-muted">Backend engineer. Maintains the registry and CLI.</p>
</div>
</x-slot:content>
</x-markas.hover-card>
</div>import { Avatar } from "@/components/markas/Avatar";
import { HoverCard } from "@/components/markas/HoverCard";
export default function Example() {
return (
<div className="flex items-center justify-center gap-3 py-6">
<HoverCard
content={
<div className="grid gap-1">
<p className="font-medium text-ink">Dewi Lestari</p>
<p className="text-muted">
Product designer. Leads the design system team.
</p>
</div>
}
>
<a
href="https://github.com/dewilestari"
className="inline-flex rounded-full focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary"
>
<Avatar name="Dewi Lestari" />
</a>
</HoverCard>
<HoverCard
content={
<div className="grid gap-1">
<p className="font-medium text-ink">Budi Santoso</p>
<p className="text-muted">
Backend engineer. Maintains the registry and CLI.
</p>
</div>
}
>
<a
href="https://github.com/budisantoso"
className="inline-flex rounded-full focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary"
>
<Avatar name="Budi Santoso" />
</a>
</HoverCard>
</div>
);
}<script setup lang="ts">
import Avatar from "@/components/markas/Avatar.vue";
import HoverCard from "@/components/markas/HoverCard.vue";
</script>
<template>
<div class="flex items-center justify-center gap-3 py-6">
<HoverCard>
<a
href="https://github.com/dewilestari"
class="inline-flex rounded-full focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary"
><Avatar name="Dewi Lestari"
/></a>
<template #content>
<div class="grid gap-1">
<p class="font-medium text-ink">Dewi Lestari</p>
<p class="text-muted">
Product designer. Leads the design system team.
</p>
</div>
</template>
</HoverCard>
<HoverCard>
<a
href="https://github.com/budisantoso"
class="inline-flex rounded-full focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary"
><Avatar name="Budi Santoso"
/></a>
<template #content>
<div class="grid gap-1">
<p class="font-medium text-ink">Budi Santoso</p>
<p class="text-muted">
Backend engineer. Maintains the registry and CLI.
</p>
</div>
</template>
</HoverCard>
</div>
</template><script lang="ts">
import Avatar from "$lib/components/markas/Avatar.svelte";
import HoverCard from "$lib/components/markas/HoverCard.svelte";
const link =
"inline-flex rounded-full focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary";
</script>
<div class="flex items-center justify-center gap-3 py-6">
<HoverCard>
<a href="https://github.com/dewilestari" class={link}>
<Avatar name="Dewi Lestari" />
</a>
{#snippet content()}
<div class="grid gap-1">
<p class="font-medium text-ink">Dewi Lestari</p>
<p class="text-muted">
Product designer. Leads the design system team.
</p>
</div>
{/snippet}
</HoverCard>
<HoverCard>
<a href="https://github.com/budisantoso" class={link}>
<Avatar name="Budi Santoso" />
</a>
{#snippet content()}
<div class="grid gap-1">
<p class="font-medium text-ink">Budi Santoso</p>
<p class="text-muted">
Backend engineer. Maintains the registry and CLI.
</p>
</div>
{/snippet}
</HoverCard>
</div>---
import Avatar from "@/components/markas/Avatar.astro";
import HoverCard from "@/components/markas/HoverCard.astro";
const link =
"inline-flex rounded-full focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary";
---
<div class="flex items-center justify-center gap-3 py-6">
<HoverCard>
<a href="https://github.com/dewilestari" class={link}><Avatar name="Dewi Lestari" /></a>
<div slot="content" class="grid gap-1">
<p class="font-medium text-ink">Dewi Lestari</p>
<p class="text-muted">Product designer. Leads the design system team.</p>
</div>
</HoverCard>
<HoverCard>
<a href="https://github.com/budisantoso" class={link}><Avatar name="Budi Santoso" /></a>
<div slot="content" class="grid gap-1">
<p class="font-medium text-ink">Budi Santoso</p>
<p class="text-muted">Backend engineer. Maintains the registry and CLI.</p>
</div>
</HoverCard>
</div>import { Component } from "@angular/core";
import { Avatar } from "./markas/avatar.component";
import { HoverCard } from "./markas/hover-card.component";
@Component({
selector: "markas-example",
imports: [Avatar, HoverCard],
template: `
<div class="flex items-center justify-center gap-3 py-6">
<markas-hover-card>
<a href="https://github.com/dewilestari" [class]="link">
<markas-avatar name="Dewi Lestari" />
</a>
<div content class="grid gap-1">
<p class="font-medium text-ink">Dewi Lestari</p>
<p class="text-muted">
Product designer. Leads the design system team.
</p>
</div>
</markas-hover-card>
<markas-hover-card>
<a href="https://github.com/budisantoso" [class]="link">
<markas-avatar name="Budi Santoso" />
</a>
<div content class="grid gap-1">
<p class="font-medium text-ink">Budi Santoso</p>
<p class="text-muted">
Backend engineer. Maintains the registry and CLI.
</p>
</div>
</markas-hover-card>
</div>
`,
})
export default class HoverCardAvatarExample {
protected readonly link =
"inline-flex rounded-full focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary";
}Installation
npx markasui@latest add hover-cardpnpm dlx markasui@latest add hover-cardyarn dlx markasui@latest add hover-cardbunx --bun markasui@latest add hover-card- Make sure Tailwind CSS v4 and markas.css are installed. See Installation.
- Install the dependency:
npm install alpinejs - Copy the component source below to
resources/views/components/markas/hover-card.blade.php.
@props([])
@php
$root = 'inline-block';
$card = 'inset-auto m-0 w-72 max-w-[calc(100vw-16px)] rounded-xl border border-line bg-surface p-4 text-sm text-ink shadow-overlay';
// Same id on every render, so Livewire's morph (which matches elements by id) keeps the element. Pass `id` to set it.
$idKey = 'markas-hover-card|'.(isset($this) && $this instanceof \Livewire\Component ? $this->getId() : '').'|'.($attributes->get('wire:key') ?? $attributes->whereStartsWith('wire:model')->first() ?? $attributes->get('name')).'|';
for ($idIndex = 0; $__env->hasRenderedOnce($idKey.$idIndex); $idIndex++);
$__env->markAsRenderedOnce($idKey.$idIndex);
$id = $attributes->get('id') ?? 'markas-hover-card-'.hash('xxh32', $idKey.$idIndex);
@endphp
<span
x-data="{
open: false,
timer: null,
show() {
clearTimeout(this.timer);
{{-- Link again in case a re-render (Livewire morph) dropped aria-describedby from the trigger. --}}
this.describe();
this.$refs.card.showPopover();
},
showLater() {
clearTimeout(this.timer);
if (this.open) return;
this.timer = setTimeout(() => this.show(), 400);
},
hide() {
clearTimeout(this.timer);
this.$refs.card.hidePopover();
},
{{-- Jeda singkat supaya pointer sempat pindah dari pemicu ke kartu. --}}
hideLater() {
clearTimeout(this.timer);
this.timer = setTimeout(() => this.hide(), 100);
},
{{-- Fokus yang pindah ke dalam kartu (misalnya link di kartu) tidak menutup kartu. --}}
onFocusOut(event) {
if (! this.$root.contains(event.relatedTarget)) this.hide();
},
describe() {
const trigger = this.$root.firstElementChild;
const described = trigger?.getAttribute('aria-describedby') ?? '';
if (trigger && trigger !== this.$refs.card && ! described.split(' ').includes(@js($id))) {
trigger.setAttribute('aria-describedby', [described, @js($id)].filter(Boolean).join(' '));
}
},
{{-- Letakkan kartu di bawah tengah pemicu, pindah ke atas kalau tidak muat. --}}
place() {
const gap = 8;
const anchor = this.$root.getBoundingClientRect();
const { width, height } = this.$refs.card.getBoundingClientRect();
const above = anchor.top - gap - height;
const below = anchor.bottom + gap;
const onTop = below + height > window.innerHeight && above >= 0;
this.$refs.card.style.top = (onTop ? above : below) + 'px';
this.$refs.card.style.left = Math.max(gap, Math.min(anchor.left + anchor.width / 2 - width / 2, window.innerWidth - width - gap)) + 'px';
},
unfollow: null,
{{-- Jalankan ulang penempatan saat halaman digulir atau jendela berubah ukuran. --}}
follow() {
this.unfollow?.();
const update = () => this.place();
const scrollOptions = { capture: true, passive: true };
window.addEventListener('scroll', update, scrollOptions);
window.addEventListener('resize', update, { passive: true });
this.unfollow = () => {
window.removeEventListener('scroll', update, scrollOptions);
window.removeEventListener('resize', update);
this.unfollow = null;
};
},
destroy() {
clearTimeout(this.timer);
this.unfollow?.();
},
onToggle(event) {
this.open = event.newState === 'open';
if (! this.open) return this.unfollow?.();
this.place();
this.follow();
},
}"
x-init="describe()"
@mouseenter="showLater()"
@mouseleave="hideLater()"
@focusin="show()"
@focusout="onFocusOut($event)"
@keydown.escape.window="hide()"
{{ $attributes->except('id')->class([$root]) }}
>{{ $slot }}<span
x-ref="card"
id="{{ $id }}"
popover="manual"
wire:ignore.self
data-state="closed"
:data-state="open ? 'open' : 'closed'"
@toggle="onToggle($event)"
class="{{ $card }}"
>{{ $content ?? '' }}</span></span>- Make sure Tailwind CSS v4 and markas.css are installed. See Installation.
- Copy the component source below to
src/components/markas/HoverCard.tsx.
"use client";
import {
useEffect,
useId,
useRef,
useState,
type ComponentProps,
type FocusEvent,
type ReactNode,
type ToggleEvent,
} from "react";
const root = "inline-block";
const card =
"inset-auto m-0 w-72 max-w-[calc(100vw-16px)] rounded-xl border border-line bg-surface p-4 text-sm text-ink shadow-overlay";
const cx = (...c: (string | false | null | undefined)[]) =>
c.filter(Boolean).join(" ");
const GAP = 8;
const SHOW_DELAY = 400;
/** Jeda singkat supaya pointer sempat pindah dari pemicu ke kartu. */
const HIDE_DELAY = 100;
/** Letakkan kartu di bawah tengah pemicu, pindah ke atas kalau tidak muat. */
function placeCard(trigger: HTMLElement, target: HTMLElement) {
const anchor = trigger.getBoundingClientRect();
const { width, height } = target.getBoundingClientRect();
const above = anchor.top - GAP - height;
const below = anchor.bottom + GAP;
const onTop = below + height > window.innerHeight && above >= 0;
const left = Math.max(
GAP,
Math.min(
anchor.left + anchor.width / 2 - width / 2,
window.innerWidth - width - GAP,
),
);
target.style.top = `${onTop ? above : below}px`;
target.style.left = `${left}px`;
}
/** Jalankan ulang penempatan saat halaman digulir atau jendela berubah ukuran. Mengembalikan fungsi pelepas. */
function followViewport(update: () => void) {
const scrollOptions = { capture: true, passive: true };
window.addEventListener("scroll", update, scrollOptions);
window.addEventListener("resize", update, { passive: true });
return () => {
window.removeEventListener("scroll", update, scrollOptions);
window.removeEventListener("resize", update);
};
}
export type HoverCardProps = Omit<ComponentProps<"span">, "content"> & {
/** Isi kartu pratinjau. */
content: ReactNode;
};
export function HoverCard({
content,
id,
className,
children,
...props
}: HoverCardProps) {
const generatedId = useId();
const cardId = id ?? generatedId;
const rootRef = useRef<HTMLSpanElement>(null);
const cardRef = useRef<HTMLSpanElement>(null);
const timer = useRef<ReturnType<typeof setTimeout>>(undefined);
const [open, setOpen] = useState(false);
const show = () => {
clearTimeout(timer.current);
cardRef.current?.showPopover();
};
const showLater = () => {
clearTimeout(timer.current);
if (open) return;
timer.current = setTimeout(show, SHOW_DELAY);
};
const hide = () => {
clearTimeout(timer.current);
cardRef.current?.hidePopover();
};
const hideLater = () => {
clearTimeout(timer.current);
timer.current = setTimeout(hide, HIDE_DELAY);
};
// Fokus yang pindah ke dalam kartu (misalnya link di kartu) tidak menutup kartu.
const handleBlur = (event: FocusEvent<HTMLSpanElement>) => {
if (!rootRef.current?.contains(event.relatedTarget)) hide();
};
useEffect(() => {
const trigger = rootRef.current?.firstElementChild;
const described = trigger?.getAttribute("aria-describedby") ?? "";
if (
trigger &&
trigger !== cardRef.current &&
!described.split(" ").includes(cardId)
)
trigger.setAttribute(
"aria-describedby",
[described, cardId].filter(Boolean).join(" "),
);
const onKeyDown = (event: KeyboardEvent) => {
if (event.key !== "Escape") return;
clearTimeout(timer.current);
cardRef.current?.hidePopover();
};
document.addEventListener("keydown", onKeyDown);
return () => {
document.removeEventListener("keydown", onKeyDown);
clearTimeout(timer.current);
};
}, [cardId]);
useEffect(() => {
if (!open) return;
return followViewport(() => {
if (rootRef.current && cardRef.current)
placeCard(rootRef.current, cardRef.current);
});
}, [open]);
const handleToggle = (event: ToggleEvent<HTMLSpanElement>) => {
const isOpen = event.newState === "open";
setOpen(isOpen);
if (isOpen && rootRef.current && cardRef.current)
placeCard(rootRef.current, cardRef.current);
};
return (
<span
ref={rootRef}
{...props}
className={cx(root, className)}
onMouseEnter={showLater}
onMouseLeave={hideLater}
onFocus={show}
onBlur={handleBlur}
>
{children}
<span
ref={cardRef}
id={cardId}
popover="manual"
data-state={open ? "open" : "closed"}
className={card}
onToggle={handleToggle}
>
{content}
</span>
</span>
);
}- Make sure Tailwind CSS v4 and markas.css are installed. See Installation.
- Copy the component source below to
src/components/markas/HoverCard.vue.
<script setup lang="ts">
import {
computed,
onBeforeUnmount,
onMounted,
ref,
useId,
useTemplateRef,
} from "vue";
const props = withDefaults(defineProps<{ id?: string }>(), { id: undefined });
const root = "inline-block";
const card =
"inset-auto m-0 w-72 max-w-[calc(100vw-16px)] rounded-xl border border-line bg-surface p-4 text-sm text-ink shadow-overlay";
const GAP = 8;
const SHOW_DELAY = 400;
/** Jeda singkat supaya pointer sempat pindah dari pemicu ke kartu. */
const HIDE_DELAY = 100;
/** Letakkan kartu di bawah tengah pemicu, pindah ke atas kalau tidak muat. */
function placeCard(trigger: HTMLElement, target: HTMLElement) {
const anchor = trigger.getBoundingClientRect();
const { width, height } = target.getBoundingClientRect();
const above = anchor.top - GAP - height;
const below = anchor.bottom + GAP;
const onTop = below + height > window.innerHeight && above >= 0;
const left = Math.max(
GAP,
Math.min(
anchor.left + anchor.width / 2 - width / 2,
window.innerWidth - width - GAP,
),
);
target.style.top = `${onTop ? above : below}px`;
target.style.left = `${left}px`;
}
/** Jalankan ulang penempatan saat halaman digulir atau jendela berubah ukuran. Mengembalikan fungsi pelepas. */
function followViewport(update: () => void) {
const scrollOptions = { capture: true, passive: true };
window.addEventListener("scroll", update, scrollOptions);
window.addEventListener("resize", update, { passive: true });
return () => {
window.removeEventListener("scroll", update, scrollOptions);
window.removeEventListener("resize", update);
};
}
const generatedId = useId();
const cardId = computed(() => props.id ?? generatedId);
const rootEl = useTemplateRef<HTMLSpanElement>("rootRef");
const cardEl = useTemplateRef<HTMLSpanElement>("cardRef");
const open = ref(false);
let timer: ReturnType<typeof setTimeout> | undefined;
let unfollow: (() => void) | undefined;
function show() {
clearTimeout(timer);
cardEl.value?.showPopover();
}
function showLater() {
clearTimeout(timer);
if (open.value) return;
timer = setTimeout(show, SHOW_DELAY);
}
function hide() {
clearTimeout(timer);
cardEl.value?.hidePopover();
}
function hideLater() {
clearTimeout(timer);
timer = setTimeout(hide, HIDE_DELAY);
}
// Fokus yang pindah ke dalam kartu (misalnya link di kartu) tidak menutup kartu.
function onFocusOut(event: FocusEvent) {
if (!rootEl.value?.contains(event.relatedTarget as Node | null)) hide();
}
function onKeydown(event: KeyboardEvent) {
if (event.key === "Escape") hide();
}
function stopFollowing() {
unfollow?.();
unfollow = undefined;
}
function place() {
if (rootEl.value && cardEl.value) placeCard(rootEl.value, cardEl.value);
}
function onToggle(event: Event) {
stopFollowing();
open.value = (event as ToggleEvent).newState === "open";
if (!open.value) return;
place();
unfollow = followViewport(place);
}
onMounted(() => {
const trigger = rootEl.value?.firstElementChild;
const described = trigger?.getAttribute("aria-describedby") ?? "";
if (
trigger &&
trigger !== cardEl.value &&
!described.split(" ").includes(cardId.value)
)
trigger.setAttribute(
"aria-describedby",
[described, cardId.value].filter(Boolean).join(" "),
);
document.addEventListener("keydown", onKeydown);
});
onBeforeUnmount(() => {
document.removeEventListener("keydown", onKeydown);
clearTimeout(timer);
stopFollowing();
});
</script>
<template>
<span
ref="rootRef"
:class="root"
@mouseenter="showLater"
@mouseleave="hideLater"
@focusin="show"
@focusout="onFocusOut"
>
<slot />
<span
:id="cardId"
ref="cardRef"
popover="manual"
:data-state="open ? 'open' : 'closed'"
:class="card"
@toggle="onToggle"
><slot name="content"
/></span>
</span>
</template>- Make sure Tailwind CSS v4 and markas.css are installed. See Installation.
- Copy the component source below to
src/lib/components/markas/HoverCard.svelte.
<script lang="ts">
import type { Snippet } from "svelte";
import type { HTMLAttributes } from "svelte/elements";
const root = "inline-block";
const card =
"inset-auto m-0 w-72 max-w-[calc(100vw-16px)] rounded-xl border border-line bg-surface p-4 text-sm text-ink shadow-overlay";
const GAP = 8;
const SHOW_DELAY = 400;
/** Short delay so the pointer can move from the trigger to the card. */
const HIDE_DELAY = 100;
type Props = HTMLAttributes<HTMLSpanElement> & {
/** Content of the preview card. */
content?: Snippet;
children?: Snippet;
};
let { content, id, class: className, children, ...rest }: Props = $props();
const generatedId = $props.id();
const cardId = $derived(id ?? generatedId);
let rootEl = $state<HTMLSpanElement>();
let cardEl = $state<HTMLSpanElement>();
let open = $state(false);
let timer: ReturnType<typeof setTimeout> | undefined;
function show() {
clearTimeout(timer);
cardEl?.showPopover();
}
function showLater() {
clearTimeout(timer);
if (open) return;
timer = setTimeout(show, SHOW_DELAY);
}
function hide() {
clearTimeout(timer);
cardEl?.hidePopover();
}
function hideLater() {
clearTimeout(timer);
timer = setTimeout(hide, HIDE_DELAY);
}
// Focus that moves into the card (a link in the card, for example) keeps it open.
function handleFocusOut(event: FocusEvent) {
if (!rootEl?.contains(event.relatedTarget as Node | null)) hide();
}
/** Place the card below the center of the trigger, flip above when it does not fit. */
function place() {
if (!rootEl || !cardEl) return;
const anchor = rootEl.getBoundingClientRect();
const { width, height } = cardEl.getBoundingClientRect();
const above = anchor.top - GAP - height;
const below = anchor.bottom + GAP;
const onTop = below + height > window.innerHeight && above >= 0;
const left = Math.max(
GAP,
Math.min(
anchor.left + anchor.width / 2 - width / 2,
window.innerWidth - width - GAP,
),
);
cardEl.style.top = `${onTop ? above : below}px`;
cardEl.style.left = `${left}px`;
}
function handleToggle(event: ToggleEvent) {
open = event.newState === "open";
if (open) place();
}
// The first element is the trigger: link it to the card. Escape hides the card anywhere.
$effect(() => {
const trigger = rootEl?.firstElementChild;
const described = trigger?.getAttribute("aria-describedby") ?? "";
if (trigger && trigger !== cardEl && !described.split(" ").includes(cardId))
trigger.setAttribute(
"aria-describedby",
[described, cardId].filter(Boolean).join(" "),
);
const onKeydown = (event: KeyboardEvent) => {
if (event.key === "Escape") hide();
};
document.addEventListener("keydown", onKeydown);
return () => {
document.removeEventListener("keydown", onKeydown);
clearTimeout(timer);
};
});
// Re-place while open when the page scrolls or the window resizes.
$effect(() => {
if (!open) return;
const scrollOptions = { capture: true, passive: true };
window.addEventListener("scroll", place, scrollOptions);
window.addEventListener("resize", place, { passive: true });
return () => {
window.removeEventListener("scroll", place, scrollOptions);
window.removeEventListener("resize", place);
};
});
</script>
<!-- svelte-ignore a11y_no_static_element_interactions -->
<span
bind:this={rootEl}
{...rest}
class={[root, className]}
onmouseenter={showLater}
onmouseleave={hideLater}
onfocusin={show}
onfocusout={handleFocusOut}
>
{@render children?.()}<span
bind:this={cardEl}
id={cardId}
popover="manual"
data-state={open ? "open" : "closed"}
class={card}
ontoggle={handleToggle}>{@render content?.()}</span
>
</span>- Make sure Tailwind CSS v4 and markas.css are installed. See Installation.
- Copy the component source below to
src/components/markas/HoverCard.astro.
---
import type { HTMLAttributes } from "astro/types";
const root = "inline-block";
const card =
"inset-auto m-0 w-72 max-w-[calc(100vw-16px)] rounded-xl border border-line bg-surface p-4 text-sm text-ink shadow-overlay";
type Props = HTMLAttributes<"span">;
const { id, class: className, ...rest } = Astro.props;
const cardId = id ?? `markas-hover-card-${crypto.randomUUID().slice(0, 8)}`;
---
<markas-hover-card class="contents"
><span {...rest} class:list={[root, className]}
><slot /><span
id={cardId}
popover="manual"
data-state="closed"
class={card}><slot name="content" /></span
></span
></markas-hover-card
>
<script>
const GAP = 8;
const SHOW_DELAY = 400;
/** Short delay so the pointer can move from the trigger to the card. */
const HIDE_DELAY = 100;
// Per instance: timers, the aria-describedby link, and placement while open.
class MarkasHoverCard extends HTMLElement {
private timer: ReturnType<typeof setTimeout> | undefined;
private abort: AbortController | undefined;
private open = false;
private get root() {
return this.firstElementChild as HTMLElement;
}
private get card() {
return this.root.lastElementChild as HTMLElement;
}
connectedCallback() {
const { root, card } = this;
if (!root || !card) return;
this.abort = new AbortController();
const { signal } = this.abort;
const trigger = root.firstElementChild;
const described = trigger?.getAttribute("aria-describedby") ?? "";
if (trigger && trigger !== card && !described.split(" ").includes(card.id))
trigger.setAttribute(
"aria-describedby",
[described, card.id].filter(Boolean).join(" "),
);
root.addEventListener("mouseenter", () => this.showLater(), { signal });
root.addEventListener("mouseleave", () => this.hideLater(), { signal });
root.addEventListener("focusin", () => this.show(), { signal });
// Focus that moves into the card (a link in the card, for example) keeps it open.
root.addEventListener(
"focusout",
(event) => {
if (!root.contains(event.relatedTarget as Node | null)) this.hide();
},
{ signal },
);
card.addEventListener(
"toggle",
(event) => {
this.open = (event as ToggleEvent).newState === "open";
card.dataset.state = this.open ? "open" : "closed";
if (this.open) this.place();
},
{ signal },
);
document.addEventListener(
"keydown",
(event) => {
if (event.key === "Escape") this.hide();
},
{ signal },
);
// Re-place while open when the page scrolls or the window resizes.
const update = () => {
if (this.open) this.place();
};
window.addEventListener("scroll", update, {
capture: true,
passive: true,
signal,
});
window.addEventListener("resize", update, { passive: true, signal });
}
disconnectedCallback() {
clearTimeout(this.timer);
this.abort?.abort();
}
private show() {
clearTimeout(this.timer);
this.card.showPopover();
}
private showLater() {
clearTimeout(this.timer);
if (this.open) return;
this.timer = setTimeout(() => this.show(), SHOW_DELAY);
}
private hide() {
clearTimeout(this.timer);
this.card.hidePopover();
}
private hideLater() {
clearTimeout(this.timer);
this.timer = setTimeout(() => this.hide(), HIDE_DELAY);
}
/** Place the card below the center of the trigger, flip above when it does not fit. */
private place() {
const anchor = this.root.getBoundingClientRect();
const { width, height } = this.card.getBoundingClientRect();
const above = anchor.top - GAP - height;
const below = anchor.bottom + GAP;
const onTop = below + height > window.innerHeight && above >= 0;
const left = Math.max(
GAP,
Math.min(
anchor.left + anchor.width / 2 - width / 2,
window.innerWidth - width - GAP,
),
);
this.card.style.top = `${onTop ? above : below}px`;
this.card.style.left = `${left}px`;
}
}
if (!customElements.get("markas-hover-card"))
customElements.define("markas-hover-card", MarkasHoverCard);
</script>- Make sure Tailwind CSS v4 and markas.css are installed. See Installation.
- Copy the component source below to
src/app/markas/hover-card.component.ts.
import {
afterNextRender,
ChangeDetectionStrategy,
Component,
computed,
DestroyRef,
type ElementRef,
inject,
input,
signal,
viewChild,
} from "@angular/core";
const root = "inline-block";
const card =
"inset-auto m-0 w-72 max-w-[calc(100vw-16px)] rounded-xl border border-line bg-surface p-4 text-sm text-ink shadow-overlay";
const GAP = 8;
const SHOW_DELAY = 400;
/** Short delay so the pointer can move from the trigger to the card. */
const HIDE_DELAY = 100;
let nextId = 0;
/**
* Slots: an element with the `content` attribute (an ng-container works) fills the card,
* everything else is the trigger. The first element of the trigger gets aria-describedby.
* Host stays out of layout; id and class move to the root element and the card.
*/
@Component({
selector: "markas-hover-card",
changeDetection: ChangeDetectionStrategy.OnPush,
host: {
class: "contents",
"[attr.id]": "null",
"(document:keydown.escape)": "hide()",
},
template: `<span
#root
[class]="rootClasses()"
(mouseenter)="showLater()"
(mouseleave)="hideLater()"
(focusin)="show()"
(focusout)="handleFocusOut($event)"
><ng-content /><span
#cardEl
[id]="cardId()"
popover="manual"
[attr.data-state]="open() ? 'open' : 'closed'"
[class]="card"
(toggle)="handleToggle($event)"
><ng-content select="[content]" /></span
></span>`,
})
export class HoverCard {
readonly id = input<string>();
readonly userClass = input("", { alias: "class" });
protected readonly card = card;
protected readonly open = signal(false);
private readonly generatedId = `markas-hover-card-${nextId++}`;
protected readonly cardId = computed(() => this.id() ?? this.generatedId);
protected readonly rootClasses = computed(() =>
[root, this.userClass()].filter(Boolean).join(" "),
);
private readonly rootRef =
viewChild.required<ElementRef<HTMLSpanElement>>("root");
private readonly cardRef =
viewChild.required<ElementRef<HTMLSpanElement>>("cardEl");
private timer: ReturnType<typeof setTimeout> | undefined;
private readonly update = () => this.place();
private readonly scrollOptions = { capture: true, passive: true };
constructor() {
// Projected content is only known after the first render.
afterNextRender(() => this.describe());
inject(DestroyRef).onDestroy(() => {
clearTimeout(this.timer);
this.stopFollowing();
});
}
protected show() {
clearTimeout(this.timer);
this.cardRef().nativeElement.showPopover();
}
protected showLater() {
clearTimeout(this.timer);
if (this.open()) return;
this.timer = setTimeout(() => this.show(), SHOW_DELAY);
}
protected hide() {
clearTimeout(this.timer);
this.cardRef().nativeElement.hidePopover();
}
protected hideLater() {
clearTimeout(this.timer);
this.timer = setTimeout(() => this.hide(), HIDE_DELAY);
}
// Focus that moves into the card (a link in the card, for example) keeps it open.
protected handleFocusOut(event: FocusEvent) {
if (
!this.rootRef().nativeElement.contains(event.relatedTarget as Node | null)
)
this.hide();
}
protected handleToggle(event: Event) {
this.stopFollowing();
const isOpen = (event as ToggleEvent).newState === "open";
this.open.set(isOpen);
if (!isOpen) return;
this.place();
// Re-place while open when the page scrolls or the window resizes.
window.addEventListener("scroll", this.update, this.scrollOptions);
window.addEventListener("resize", this.update, { passive: true });
}
private describe() {
const id = this.cardId();
const trigger = this.rootRef().nativeElement.firstElementChild;
const described = trigger?.getAttribute("aria-describedby") ?? "";
if (
trigger &&
trigger !== this.cardRef().nativeElement &&
!described.split(" ").includes(id)
)
trigger.setAttribute(
"aria-describedby",
[described, id].filter(Boolean).join(" "),
);
}
/** Place the card below the center of the trigger, flip above when it does not fit. */
private place() {
const target = this.cardRef().nativeElement;
const anchor = this.rootRef().nativeElement.getBoundingClientRect();
const { width, height } = target.getBoundingClientRect();
const above = anchor.top - GAP - height;
const below = anchor.bottom + GAP;
const onTop = below + height > window.innerHeight && above >= 0;
const left = Math.max(
GAP,
Math.min(
anchor.left + anchor.width / 2 - width / 2,
window.innerWidth - width - GAP,
),
);
target.style.top = `${onTop ? above : below}px`;
target.style.left = `${left}px`;
}
private stopFollowing() {
window.removeEventListener("scroll", this.update, this.scrollOptions);
window.removeEventListener("resize", this.update);
}
}Usage
<x-markas.hover-card>
<a href="https://github.com/markasui">@markasui</a>
<x-slot:content>
<p class="font-medium text-ink">Markas UI</p>
<p class="text-muted">UI components for Blade, React, and Vue.</p>
</x-slot:content>
</x-markas.hover-card>Needs Alpine.js.
import { HoverCard } from "@/components/markas/HoverCard";
<HoverCard
content={
<>
<p className="font-medium text-ink">Markas UI</p>
<p className="text-muted">UI components for Blade, React, and Vue.</p>
</>
}
>
<a href="https://github.com/markasui">@markasui</a>
</HoverCard>;<template>
<HoverCard>
<a href="https://github.com/markasui">@markasui</a>
<template #content>
<p class="font-medium text-ink">Markas UI</p>
<p class="text-muted">UI components for Blade, React, and Vue.</p>
</template>
</HoverCard>
</template><script lang="ts">
import HoverCard from "$lib/components/markas/HoverCard.svelte";
</script>
<HoverCard>
<a href="https://github.com/markasui">@markasui</a>
{#snippet content()}
<p class="font-medium text-ink">Markas UI</p>
<p class="text-muted">UI components for Blade, React, and Vue.</p>
{/snippet}
</HoverCard>---
import HoverCard from "@/components/markas/HoverCard.astro";
---
<HoverCard>
<a href="https://github.com/markasui">@markasui</a>
<Fragment slot="content">
<p class="font-medium text-ink">Markas UI</p>
<p class="text-muted">UI components for Blade, React, and Vue.</p>
</Fragment>
</HoverCard>Each card is wrapped in a small markas-hover-card custom element with display: contents, so it also works after view transitions.
import { Component } from "@angular/core";
import { HoverCard } from "./markas/hover-card.component";
@Component({
selector: "app-maintainer",
imports: [HoverCard],
template: `
<markas-hover-card>
<a href="https://github.com/markasui">@markasui</a>
<ng-container content>
<p class="font-medium text-ink">Markas UI</p>
<p class="text-muted">UI components for Blade, React, and Vue.</p>
</ng-container>
</markas-hover-card>
`,
})
export class Maintainer {}- The first element inside HoverCard is the trigger and automatically gets
aria-describedbypointing to the card. - The card shows below the trigger and flips above it when there is no room.
- Inside a paragraph, keep the card content to inline elements (span, a, strong), because a
divorpwould break the paragraph in server rendered HTML. - Hover Card has no built-in text. Write the content in the language of your site.
Props
| Name | Type | Default | Description |
|---|---|---|---|
children / slot | slot / ReactNode | - | A single focusable trigger element, usually a link. |
content | slot / ReactNode / snippet | - | Card content. Blade, Vue, and Astro use the content slot, React uses the content prop, Svelte the content snippet, Angular an element with the content attribute. |
id | string | auto | Card element id, used for the trigger aria-describedby. |
Accessibility
- The trigger automatically gets aria-describedby pointing to the card, so screen readers announce the preview.
- Shows on hover after 400ms and right away when the trigger receives keyboard focus.
- Moving the mouse away, moving focus outside the trigger and card, or pressing Escape hides the card.
- The card is a preview only: the trigger link must lead to the same information.
Related components
More overlay components with the same classes in every framework.
- Alert DialogModal confirmation built on the native dialog element. It needs an explicit cancel or action choice and never closes on a backdrop click.
- Command PaletteSearchable list of commands in a modal dialog, filtered as you type, with arrow key navigation and an optional Ctrl+K or Cmd+K shortcut.
- Context MenuMenu opened by right-clicking an area or pressing Shift+F10, shown at the pointer through the Popover API with WAI-ARIA Menu keyboard support.
- DrawerFull-height side panel built on the native dialog element, sliding in from the right or left.
- Dropdown MenuAction menu built on the Popover API, with keyboard navigation following the WAI-ARIA Menu Button pattern.
- ModalModal dialog built on the native dialog element, with focus trapping and a close button.