npm install -D tailwindcss postcss autoprefixernpx tailwindcss init -p
tailwind.config.ts
:import type { Config } from "tailwindcss";
const config: Config = { content: ["./index.html", "./src/**/*.{js,ts,jsx,tsx}"], theme: { extend: {}, }, plugins: [],};
export default config;
src/index.css
:@tailwind base;@tailwind components;@tailwind utilities;
npm install shadcn@latestnpx shadcn@latest init
components/
với cấu trúc component dựa trên utility classes của Tailwind.npx shadcn@latest add button
Button.tsx
trong thư mục components/ui
. Dưới đây là ví dụ đoạn code của Button với các biến thể (variants) và kích thước (size) được khai báo bằng class-variance-authority
:import * as React from "react";import { Slot } from "@radix-ui/react-slot";import { cva, type VariantProps } from "class-variance-authority";import { cn } from "@/lib/utils";
const buttonVariants = cva( "inline-flex items-center justify-center gap-2 whitespace-nowrap rounded-md text-sm font-medium transition-all disabled:pointer-events-none disabled:opacity-50 [&_svg]:pointer-events-none [&_svg:not([class*='size-'])]:size-4 shrink-0 [&_svg]:shrink-0 outline-none focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:ring-[3px] aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive", { variants: { variant: { default: "bg-primary text-primary-foreground shadow-xs hover:bg-primary/90", destructive: "bg-destructive text-white shadow-xs hover:bg-destructive/90 focus-visible:ring-destructive/20 dark:focus-visible:ring-destructive/40 dark:bg-destructive/60", outline: "border bg-background shadow-xs hover:bg-accent hover:text-accent-foreground dark:bg-input/30 dark:border-input dark:hover:bg-input/50", secondary: "bg-secondary text-secondary-foreground shadow-xs hover:bg-secondary/80", ghost: "hover:bg-accent hover:text-accent-foreground dark:hover:bg-accent/50", link: "text-primary underline-offset-4 hover:underline", }, size: { default: "h-9 px-4 py-2 has-[>svg]:px-3", sm: "h-8 rounded-md gap-1.5 px-3 has-[>svg]:px-2.5", lg: "h-10 rounded-md px-6 has-[>svg]:px-4", icon: "size-9", }, }, defaultVariants: { variant: "default", size: "default", }, });
function Button({ className, variant, size, asChild = false, ...props}: React.ComponentProps<"button"> & VariantProps<typeof buttonVariants> & { asChild?: boolean }) { const Comp = asChild ? Slot : "button"; return ( <Comp data-slot="button" className={cn(buttonVariants({ variant, size, className }))} {...props} /> );}
export { Button, buttonVariants };
App.tsx
như sau:import { Button } from "@/components/ui/button";
function App() { return ( <div className="flex h-screen items-center justify-center bg-gray-100"> <Button variant="default" onClick={() => alert("Shadcn Button Clicked")}> Click Me </Button> </div> );}
export default App;
variant
như destructive
, outline
để xem hiệu ứng khác hoặc tự thêm biến thể mới trong Button.tsx
.Ưu điểm | Mô tả |
---|---|
Khả năng truy cập tối ưu | Dựa trên Radix UI đảm bảo tiêu chuẩn ARIA và UX tốt cho mọi người dùng |
Tùy biến cao | Không bị đóng khung bởi styling sẵn có, dễ dàng thay đổi giao diện sử dụng Tailwind CSS |
Dễ bảo trì | Component nằm trong chính dự án, bạn tự chủ trong sửa đổi và mở rộng |
Hiệu suất tốt | Không có gánh nặng bundle lớn do copy-paste component theo nhu cầu |
Hỗ trợ TypeScript tuyệt vời | Tăng năng suất phát triển, giảm lỗi sai kiểu dữ liệu |
Giao diện nhất quán | Dễ dàng tạo hệ thống thiết kế đồng bộ với variants và class utilities |