Bỏ qua đến nội dung
1.6k

Tab

Chuyển đổi giữa các bảng nội dung xếp lớp — trang cài đặt, bảng điều khiển và bản xem trước mã — với hiệu ứng đường viền và bóng theo phong cách tân thô mộc.

import {
  Card,
  CardContent,

Tabs sắp xếp các panel nội dung xếp lớp phía sau một hàng trigger — mỗi lúc chỉ một panel hiển thị, không cần điều hướng. Được xây dựng trên thành phần Base UI Tabs và tạo kiểu theo công thức neobrutalist: viền dày, bóng đổ đậm và kiểu chữ đậm.

Nên dùng khi:

  • Trang cài đặt — Tài khoản / Mật khẩu / Thông báo trên cùng một màn hình, trạng thái được giữ nguyên khi chuyển qua lại.
  • Chế độ xem dashboard — chuyển giữa Tổng quan, Phân tích và Báo cáo mà không đổi route.
  • Khung code + xem trước — món quen thuộc của trang tài liệu: nút chuyển Xem trước / Code và lệnh cài đặt theo từng trình quản lý gói.

Cài đặt

pnpm dlx shadcn@latest add https://neobrutalism.com/r/base/tabs.json
npx shadcn@latest add https://neobrutalism.com/r/base/tabs.json
yarn dlx shadcn@latest add https://neobrutalism.com/r/base/tabs.json
bunx --bun shadcn@latest add https://neobrutalism.com/r/base/tabs.json

Cài đặt các dependency sau:

pnpm add @base-ui/react
npm install @base-ui/react
yarn add @base-ui/react
bun add @base-ui/react

Sao chép và dán đoạn mã sau vào dự án của bạn.

components/ui/tabs.tsx
"use client"

import * as React from "react"
import { cva, type VariantProps } from "class-variance-authority"
import { Tabs as TabsPrimitive } from "radix-ui"

import { cn } from "@/lib/utils"

function Tabs({
  className,
  orientation = "horizontal",
  ...props
}: React.ComponentProps<typeof TabsPrimitive.Root>) {
  return (
    <TabsPrimitive.Root
      data-slot="tabs"
      data-orientation={orientation}
      className={cn(
        "group/tabs flex gap-2 data-horizontal:flex-col",
        className
      )}
      {...props}
    />
  )
}

const tabsListVariants = cva(
  "group/tabs-list inline-flex w-fit items-center justify-center rounded p-1 text-muted-foreground group-data-horizontal/tabs:h-11 group-data-vertical/tabs:h-fit group-data-vertical/tabs:flex-col data-[variant=line]:rounded-none",
  {
    variants: {
      variant: {
        default: "border-2 bg-card shadow-sm",
        line: "gap-1 bg-transparent",
      },
    },
    defaultVariants: {
      variant: "default",
    },
  }
)

function TabsList({
  className,
  variant = "default",
  ...props
}: React.ComponentProps<typeof TabsPrimitive.List> &
  VariantProps<typeof tabsListVariants>) {
  return (
    <TabsPrimitive.List
      data-slot="tabs-list"
      data-variant={variant}
      className={cn(tabsListVariants({ variant }), className)}
      {...props}
    />
  )
}

function TabsTrigger({
  className,
  ...props
}: React.ComponentProps<typeof TabsPrimitive.Trigger>) {
  return (
    <TabsPrimitive.Trigger
      data-slot="tabs-trigger"
      className={cn(
        "relative inline-flex h-[calc(100%-1px)] flex-1 cursor-pointer items-center justify-center gap-1.5 rounded border-2 border-transparent px-4 py-2 text-sm font-head font-medium whitespace-nowrap text-foreground/60 transition-all group-data-vertical/tabs:w-full group-data-vertical/tabs:justify-start hover:text-foreground focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary disabled:pointer-events-none disabled:opacity-50 has-data-[icon=inline-end]:pr-1 has-data-[icon=inline-start]:pl-1 group-data-[variant=default]/tabs-list:data-active:border-border group-data-[variant=default]/tabs-list:data-active:shadow-sm group-data-[variant=line]/tabs-list:data-active:shadow-none [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",
        "group-data-[variant=line]/tabs-list:bg-transparent group-data-[variant=line]/tabs-list:data-active:bg-transparent",
        "data-active:bg-primary data-active:text-primary-foreground group-data-[variant=line]/tabs-list:data-active:text-foreground",
        "after:absolute after:bg-foreground after:opacity-0 after:transition-opacity group-data-horizontal/tabs:after:inset-x-0 group-data-horizontal/tabs:after:bottom-[-5px] group-data-horizontal/tabs:after:h-1 group-data-vertical/tabs:after:inset-y-0 group-data-vertical/tabs:after:-right-1 group-data-vertical/tabs:after:w-1 group-data-[variant=line]/tabs-list:data-active:after:opacity-100",
        className
      )}
      {...props}
    />
  )
}

function TabsContent({
  className,
  ...props
}: React.ComponentProps<typeof TabsPrimitive.Content>) {
  return (
    <TabsPrimitive.Content
      data-slot="tabs-content"
      className={cn("flex-1 text-sm outline-none", className)}
      {...props}
    />
  )
}

export { Tabs, TabsList, TabsTrigger, TabsContent, tabsListVariants }

Cập nhật các đường dẫn import cho phù hợp với cấu hình dự án của bạn.

Cách dùng

import { Tabs, TabsContent, TabsList, TabsTrigger } from "@/components/ui/tabs"
<Tabs defaultValue="account" className="w-[400px]">
  <TabsList>
    <TabsTrigger value="account">Account</TabsTrigger>
    <TabsTrigger value="password">Password</TabsTrigger>
  </TabsList>
  <TabsContent value="account">Make changes to your account here.</TabsContent>
  <TabsContent value="password">Change your password here.</TabsContent>
</Tabs>

Kết hợp

Dùng cách kết hợp sau để xây dựng Tabs:

Tabs
├── TabsList
│   ├── TabsTrigger
│   └── TabsTrigger
├── TabsContent
└── TabsContent

Ví dụ

Đường kẻ

Dùng prop variant="line" trên TabsList cho kiểu đường kẻ.

import { Tabs, TabsList, TabsTrigger } from "@/components/ui/tabs"

export function TabsLine() {

Vertical

Dùng orientation="vertical" cho tab dọc.

import { Tabs, TabsList, TabsTrigger } from "@/components/ui/tabs"

export function TabsVertical() {

Vô hiệu hóa

import { Tabs, TabsList, TabsTrigger } from "@/components/ui/tabs"

export function TabsDisabled() {

Icon

import { AppWindowIcon, CodeIcon } from "lucide-react"

import { Tabs, TabsList, TabsTrigger } from "@/components/ui/tabs"

RTL

Để bật hỗ trợ RTL trong Neobrutalism, xem hướng dẫn cấu hình RTL.

"use client"

import * as React from "react"

Khả năng truy cập

Tabs tuân theo mẫu Tabs của WAI-ARIA: danh sách render role="tablist", mỗi trigger là một nút role="tab" với aria-selected và aria-controls, và mỗi panel là một role="tabpanel" được gắn nhãn bởi trigger của nó. Chỉ trigger đang hoạt động nằm trong thứ tự Tab — phần còn lại do phím mũi tên đảm nhiệm (roving tabindex). Theo mặc định, focus một trigger cũng kích hoạt nó luôn; đặt activateOnFocus={false} trên TabsList để yêu cầu nhấn Space/Enter rõ ràng.

Tương tác bàn phím:

PhímHành động
TabDi chuyển focus đến trigger đang hoạt động, sau đó vào panel đang hoạt động
ArrowRight / ArrowLeftDi chuyển focus đến trigger kế tiếp / trước đó (hướng ngang)
ArrowDown / ArrowUpDi chuyển focus đến trigger kế tiếp / trước đó (hướng dọc)
Home / EndNhảy đến trigger đầu tiên / cuối cùng
Space / EnterKích hoạt trigger đang được focus (chỉ cần khi kích hoạt thủ công)

Tham chiếu API

Xem tài liệu Base UI Tabs.