ข้ามไปเนื้อหา
WhereUI

ค้นหาในเอกสาร

ค้นหาชื่อ component หรือหน้าเอกสาร

Trace

จาก shadcn

ไทม์ไลน์ขั้นตอนการประมวลผล เช่น เส้นทางของคำขอลาตั้งแต่ยื่นจนได้ผล มีสถานะกำลังทำ เกิดข้อผิดพลาด และรอคิว พร้อมส่วนที่กดขยายดูรายละเอียดได้

รับคำขอลาพักร้อนของ สมหญิง09:41หัวหน้าแผนกอนุมัติแล้ว10:05ฝ่ายบัญชีตรวจนับวันลาคงเหลือ10:06
ใบรับรองแพทย์ของผู้ที่พึ่งพาฉบับจากโรงพยาบาลเอกชนยังไม่มีเลขที่ใบอนุญาต กรุณาแนบฉบับใหม่ในขั้นตอนถัดไปก่อนส่งต่อผู้จัดการ
แจ้งผลการพิจารณาทางอีเมลรอขั้นก่อนหน้า

ติดตั้ง

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,}