Dashboard Hooks
useElementWidth, useOutsideDismiss, usePopoverState, useCountUp, useMounted, useToastQueue and useImageFailed.
npx shadcn@latest add https://ui.develop-better-solutions.com/r/dash-hooks.jsonuseCountUp
0
useElementWidth
0px
Server render
useOutsideDismiss
useToastQueue (keeps 3)
Usage
dash-hooks-example.tsx
"use client";
import { useRef, useState } from "react";
import {
useCountUp,
useElementWidth,
useMounted,
useOutsideDismiss,
useToastQueue,
} from "@dbs/ui";
import { DashScope } from "./_store";
interface Note {
id: number;
text: string;
}
function Demo() {
const [target, setTarget] = useState(128);
const count = useCountUp(target);
const [ref, width] = useElementWidth<HTMLDivElement>();
const [open, setOpen] = useState(false);
const menu = useRef<HTMLDivElement>(null);
useOutsideDismiss(menu, open, () => setOpen(false));
const { toasts, push, dismiss } = useToastQueue<Note>(3);
const mounted = useMounted();
const btn = "rounded-full border border-[var(--dash-line)] px-4 py-1.5 text-sm hover:bg-[var(--dash-hover)]";
return (
<div className="grid gap-5 text-sm md:grid-cols-2">
<div className="flex flex-col gap-2">
<p className="text-[var(--dash-muted)]">useCountUp</p>
<p className="text-4xl font-semibold tabular-nums">{count}</p>
<button type="button" className={btn} onClick={() => setTarget((t) => t + 64)}>
Raise target
</button>
</div>
<div ref={ref} className="flex flex-col gap-2">
<p className="text-[var(--dash-muted)]">useElementWidth</p>
<p className="text-4xl font-semibold tabular-nums">{width}px</p>
<p className="text-[var(--dash-muted)]">{mounted ? "Mounted" : "Server render"}</p>
</div>
<div ref={menu} className="relative flex flex-col items-start gap-2">
<p className="text-[var(--dash-muted)]">useOutsideDismiss</p>
<button type="button" className={btn} onClick={() => setOpen((o) => !o)}>
{open ? "Close menu" : "Open menu"}
</button>
{open && (
<div className="rounded-xl border border-[var(--dash-line)] bg-[var(--dash-panel)] p-3 shadow-lg">
Click outside or press Escape.
</div>
)}
</div>
<div className="flex flex-col items-start gap-2">
<p className="text-[var(--dash-muted)]">useToastQueue (keeps 3)</p>
<button type="button" className={btn} onClick={() => push({ text: `Saved at ${new Date().toLocaleTimeString()}` }, 4000)}>
Push a toast
</button>
<ul className="flex flex-col gap-1">
{toasts.map((t) => (
<li key={t.id} className="flex items-center gap-2 rounded-lg bg-[var(--dash-hover)] px-3 py-1.5">
{t.text}
<button type="button" aria-label="Dismiss" onClick={() => dismiss(t.id)} className="text-[var(--dash-muted)]">
x
</button>
</li>
))}
</ul>
</div>
</div>
);
}
export default function DashHooksExample() {
return (
<div className="w-full max-w-3xl">
<DashScope minHeight={0}>
<Demo />
</DashScope>
</div>
);
}