// Copyright 2026 Arctel.net // SPDX-License-Identifier: Apache-2.0 "use client" import * as React from "react" import {Code} from "lucide-react" import {Card, CardContent, CardDescription, CardHeader, CardTitle} from "@/components/ui/card" import {Tabs, TabsContent, TabsList, TabsTrigger} from "@/components/ui/tabs" // 引入模块化拆分后的 Tab 子组件 import {DashboardTab} from "./tabs/dashboard-tab" import {TableTab} from "./tabs/table-tab" import {ControlsTab} from "./tabs/controls-tab" export default function HeaderDemoPage() { const [activeTab, setActiveTab] = React.useState("dashboard") return (
{/* 1. 标准页面标题 */}

开发规范示例

{/* 说明区域 */}
规范说明
此页面展示了后台 Sidebar 关联页面的标准标题栏布局,供开发参考。

核心规范细节与编写原则:

  • 结构专注:页面标题区必须保持绝对干净。请不要在标题下方放置任何描述段落或小字副标题,让页面在视线进入时保持极简与信息纯粹。
  • 容器与上边距对齐:使用 flex items-center gap-2 作为标题行基础容器(不含下边框),外层统一使用 py-6 px-1 (或 py-6) 进行上边距的视觉对齐,确保切换菜单时顶部高度感一致。
  • 图标呈现:直接将 Lucide 图标组件嵌套于标题容器中,应用 size-5 text-primary 样式。禁止为图标包裹任何背景色小卡片、圆角或装饰性边框。
  • 文本样式标准:文本使用且仅使用 {'h1 className="text-2xl font-semibold tracking-tight"'},禁用字重加粗(如 font-bold)或任何渐变色,保证全站字体一致性。
  • Tabs 模块化拆分:凡是带有多个 Tab 页切换的页面,**禁止**将所有 Tab 的渲染代码堆积在同一个物理页面主文件内。每个 Tab 页对应的 Content 必须单独拆分为独立组件文件(如 tabs/events-tab.tsx 或就近放在 components/ 下),主页面文件只负责维护当前 Tab 的激活状态及外层骨架布局。
  • 复杂度驱动的区块拆分:不仅是 Tabs 切换,当一个页面代码行数超过 600 行时,必须将高密度区块拆分为子组件。路由专属、不复用的子组件应放在对应路由的特征目录中(如 app/(main)/admin/database/components/),只有真正跨页面复用的组件才进入全局 components/common/。典型标杆案例参考“数据管理” (/admin/database) 的 table-browser.tsx、cache-manager.tsx 与 sql-console.tsx。
{/* Tabs 切换 */} 仪表盘与指标卡片 数据表格规范 输入控件与表单
) }