台灣國定假日標籤
依行政院人事行政總處公告日曆，標示國定/農曆/彈性假日，並以不同色調區分。非假日不顯示。資料涵蓋 2025–2026。
Renders a coloured badge if a given date is a Taiwan public holiday per 行政院人事行政總處 (DGPA) calendar. National / lunar / adjusted holidays each get a distinct tone. Quietly renders nothing for non-holiday dates.
CLI
npx taiwan-ui add taiwan-holiday-badgenpm package
npm install @taiwan-ui/reactRequires: data/taiwan-holidays.json
Showing 2026 holidays + one regular workday for contrast:
| Prop | Type | Default |
|---|---|---|
date* | Date | string | — |
english | boolean | false |
size | "sm" | "md" | "md" |
fallback | React.ReactNode | — |
要檢查的日期
使用英文假日名
標籤尺寸
Non-editable type — edit in code.
非假日時的替代內容
import TaiwanHolidayBadge from "@/components/taiwan/TaiwanHolidayBadge";
export default function Example() {
return (
<TaiwanHolidayBadge
size="md"
/>
);
}
import TaiwanHolidayBadge from "@/components/taiwan/TaiwanHolidayBadge";
export default function HolidayCheck() {
return (
<div>
<TaiwanHolidayBadge date="2026-02-17" />
<TaiwanHolidayBadge date="2026-10-10" />
</div>
);
}