Trace
จาก shadcnไทม์ไลน์ขั้นตอนการประมวลผล เช่น เส้นทางของคำขอลาตั้งแต่ยื่นจนได้ผล มีสถานะกำลังทำ เกิดข้อผิดพลาด และรอคิว พร้อมส่วนที่กดขยายดูรายละเอียดได้
ใบรับรองแพทย์ของผู้ที่พึ่งพาฉบับจากโรงพยาบาลเอกชนยังไม่มีเลขที่ใบอนุญาต กรุณาแนบฉบับใหม่ในขั้นตอนถัดไปก่อนส่งต่อผู้จัดการ
ติดตั้ง
Terminal
pnpm dlx shadcn@latest add @whereui/traceต้องผูก registry และติดตั้ง @whereui/theme นำหน้าเสมอเมื่อติดตั้งครั้งแรก
การใช้งาน
import { CheckIcon } from "lucide-react"import { Trace, TraceDescription, TraceIcon, TraceLine, TraceTitle,} from "@/components/ui/trace"<Trace> <TraceLine> <TraceIcon><CheckIcon /></TraceIcon> <TraceTitle>รับคำขอแล้ว</TraceTitle> <TraceDescription>09:41</TraceDescription> </TraceLine> <TraceLine status="running"> <TraceIcon><CheckIcon /></TraceIcon> <TraceTitle>กำลังตรวจสอบ</TraceTitle> </TraceLine></Trace>ข้อควรรู้
- status ของ TraceLine มี running (กะพริบ), error (สีแดง), pending (จางลง) และไม่ใส่ = เสร็จแล้ว
- ครอบขั้นตอนด้วย TraceCollapsible + TraceCollapsibleTrigger เมื่อต้องการกดดูรายละเอียดเพิ่ม
- เหมาะกับ log หรือสถานะงานเชิงเวลา ถ้าเป็นขั้นตอนที่ผู้ใช้กรอกเอง ลองดู Stepper
ซอร์สโค้ด
components/ui/trace.tsx
import * as React from "react"import { cn } from "cn"import { Collapsible, CollapsibleContent, CollapsibleTrigger,} from "@/components/ui/collapsible"import { ChevronRightIcon } from "lucide-react"function Trace({ className, ...props }: React.ComponentProps<"div">) { return ( <div data-slot="trace" className={cn( "flex w-full min-w-0 flex-col gap-2 *:has-[>[data-slot=trace-line]]:flex *:has-[>[data-slot=trace-line]]:w-fit *:has-[>[data-slot=trace-line]]:max-w-full *:has-[>[data-slot=trace-line]]:min-w-0 *:has-[>[data-slot=trace-line]]:rounded-md *:has-[>[data-slot=trace-line]]:text-left *:has-[>[data-slot=trace-line]]:outline-none *:has-[>[data-slot=trace-line]]:focus-visible:ring-3 *:has-[>[data-slot=trace-line]]:focus-visible:ring-ring/50", className )} {...props} /> )}function TraceLine({ className, status, ...props}: React.ComponentProps<"span"> & { status?: "running" | "error" | "pending"}) { return ( <span data-slot="trace-line" data-status={status} className={cn( "flex w-fit max-w-full min-w-0 items-center gap-2 text-sm text-muted-foreground transition-colors in-[a,button]:cursor-pointer in-[a:hover,button:hover]:text-foreground data-[status=error]:text-destructive data-[status=error]:in-[a:hover,button:hover]:text-destructive data-[status=pending]:opacity-60 data-[status=running]:*:data-[slot=trace-title]:shimmer", className )} {...props} /> )}function TraceIcon({ className, ...props }: React.ComponentProps<"span">) { return ( <span data-slot="trace-icon" aria-hidden="true" className={cn( "flex size-4 shrink-0 items-center justify-center [&_svg]:pointer-events-none [&_svg:not([class*='size-'])]:size-4 [[data-slot=trace-title]~&]:-ml-1", className )} {...props} /> )}function TraceTitle({ className, ...props }: React.ComponentProps<"span">) { return ( <span data-slot="trace-title" className={cn("min-w-0 truncate motion-reduce:shimmer-none", className)} {...props} /> )}function TraceDescription({ className, ...props}: React.ComponentProps<"span">) { return ( <span data-slot="trace-description" className={cn( "shrink-0 text-muted-foreground/70 tabular-nums", className )} {...props} /> )}function TraceCollapsible({ className, ...props}: Omit<React.ComponentProps<typeof Collapsible>, "open"> & ( | { open?: undefined } | { open: boolean onOpenChange: NonNullable< React.ComponentProps<typeof Collapsible>["onOpenChange"] > } )) { return ( <Collapsible data-slot="trace-collapsible" className={cn("flex w-full min-w-0 flex-col", className)} {...props} /> )}function TraceCollapsibleTrigger({ className, children, ...props}: React.ComponentProps<typeof CollapsibleTrigger>) { return ( <CollapsibleTrigger data-slot="trace-collapsible-trigger" className={cn( "group/trace-collapsible-trigger flex w-fit max-w-full min-w-0 cursor-pointer items-center gap-1 rounded-md text-left text-muted-foreground transition-colors outline-none hover:text-foreground focus-visible:ring-3 focus-visible:ring-ring/50 has-[[data-status=error]]:text-destructive", className )} {...props} > {children} <TraceIcon className="transition-transform group-aria-expanded/trace-collapsible-trigger:rotate-90"> <ChevronRightIcon /> </TraceIcon> </CollapsibleTrigger> )}function TraceCollapsibleContent({ className, children, ...props}: React.ComponentProps<typeof CollapsibleContent>) { return ( <CollapsibleContent data-slot="trace-collapsible-content" className="h-(--collapsible-panel-height) min-w-0 overflow-hidden transition-[height] duration-200 data-ending-style:h-0 data-starting-style:h-0" {...props} > <div data-slot="trace-collapsible-content-inner" className={cn( "mt-2 mb-1 ml-[calc(--spacing(2)-1px)] min-w-0 border-l pr-1 pl-4 leading-relaxed wrap-break-word text-muted-foreground", className )} > {children} </div> </CollapsibleContent> )}export { Trace, TraceLine, TraceIcon, TraceTitle, TraceDescription, TraceCollapsible, TraceCollapsibleTrigger, TraceCollapsibleContent,}