DDBS UI
dashboard

Dashboard Hooks

useElementWidth, useOutsideDismiss, usePopoverState, useCountUp, useMounted, useToastQueue and useImageFailed.

npx shadcn@latest add https://ui.develop-better-solutions.com/r/dash-hooks.json
Fullscreen

useCountUp

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>
      );
    }