// 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 必须单独封装进全局 components/ 目录下专属文件夹中,主页面文件只负责维护当前 Tab 的激活状态及外层骨架布局。这有利于模块复用、编译优化以及提升单文件可读性。
  • 复杂度驱动的区块拆分:不仅是 Tabs 切换,当一个页面为单页界面且代码行数超过 800 行时,必须将不同的物理块内容拆分为子组件。为保持路由树的清爽和逻辑纯粹,所有拆分出的非复用子组件也应统一存放在全局组件文件夹中(如 components/common/admin/),而路由入口 page.tsx 仅用于定义整个页面的布局排版与全局框架。典型标杆案例参考“数据管理” (/admin/database) 的重构。
{/* Tabs 切换 */} 仪表盘与指标卡片 数据表格规范 输入控件与表单
) }