跳到正文

六个页头是怎么变成一个的

工程实践约 8 分钟2 次阅读

改版前,这个博客有六份页头。

不是六个页面共用一份,是六份各自独立的代码——首页一份、文章页一份、归档页一份、标签云一份、标签详情一份、关于页一份。它们长得像,但没有一份是完全一样的。

复制粘贴的账单

把六份摆在一起对比,问题一目了然:

站名写死在四个文件里。 首页从数据库读 site_name,其余五个页面顶上都写着 const BLOG_TITLE = "Loki"。意味着在后台改站名,只有首页会变。这不是理论风险——设置项形同虚设。

版心有三种宽度。 首页 max-w-5xl、归档和标签 max-w-3xl、搜索和关于 max-w-2xl。从首页点进文章,内容框会突然跳宽;再点到归档,又缩回去。没有任何设计意图,纯粹是各写各的。

导航项每页不一样。 归档页的导航是「首页 / 归档 / 搜索」,标签页是「首页 / 归档 / 标签 / 关于」,首页是「首页 / 归档 / 标签 / 关于 + 后台入口」。你在归档页看不到「标签」入口,在标签页看不到「搜索」。

搜索页干脆没有页头页脚。 点进 /search,整个站点外框消失,只剩一个孤零零的搜索框,连回首页的链接都没有。

当前页高亮全靠手写。 每个页面在自己的导航里把对应那项硬编码成蓝色:<span style={{color:"#1890ff"}}>归档</span>。所以标签详情页 /tags/xxx 的导航里,「标签」这一项是不高亮的——因为那份复制过来的代码里,高亮的是别的项。

这些都不是「没做好」,是复制粘贴这种做法的必然产物。第一次复制的时候一切正常,之后每改一次就多一份分歧。

路由组:让页头只存在一次

Next.js App Router 有个特性叫路由组——用括号包住的目录不参与 URL 路径,但可以拥有自己的 layout。

于是把所有公开页面移进 (site):

src/app/
  (site)/
    layout.tsx      ← 页头页脚只在这里出现一次
    page.tsx        → /
    [slug]/         → /:slug
    archive/        → /archive
    tags/           → /tags
    tags/[slug]/    → /tags/:slug
    about/          → /about
    search/         → /search
  admin/            ← 不在组内,不会带上站点外框
  login/

URL 一个都没变。/admin 和 /login 留在外面,自然就不会套上公开站的页头。

layout 里做的事很少:

export default async function SiteLayout({ children }) {
  const { siteName, footerText, social } = await getSiteSettings();
  return (
    <div className="flex min-h-screen flex-col bg-bg">
      <a href="#main" className="sr-only focus:not-sr-only ...">跳到正文</a>
      <SiteHeader siteName={siteName} />
      <main id="main" className="flex-1">{children}</main>
      <SiteFooter siteName={siteName} footerText={footerText} social={social} />
    </div>
  );
}

站点设置读一次,7 个页面全部拿到。

三个单一来源

光有 layout 还不够,得把散落的事实收拢:

导航配置 收进 src/lib/site-nav.ts。高亮判定也收进去,写成一个函数而不是每页手写:

export function isNavItemActive(pathname: string, href: string): boolean {
  if (href === "/") return pathname === "/";
  return pathname === href || pathname.startsWith(`${href}/`);
}

首页要精确匹配(否则任何路径都会命中 /),其余匹配前缀——这样 /tags/foo 也会把「标签」点亮,顺手修好了标签详情页不高亮的问题。

站点设置 收进 src/lib/site-settings.ts,带兜底和 titleWithSite() 辅助函数。现在所有页面的 generateMetadata 都从这里取标题后缀,改站名全站生效。

版心 收成一个 Container 组件,只有两档:

<Container width="page">     {/* 列表类,宽 */}
<Container width="content">  {/* 正文阅读列,窄 */}

具体像素值交给皮肤的 --page-max / --content-max 决定。编辑部风格的正文列是 42rem,科技风格是 45rem——因为后者字号更小,同样字数需要更宽。

顺手拿到的东西

页头变成一个之后,往里加东西的成本就变成 1 份而不是 6 份。所以顺手补了几个原本「不值得改六遍」的功能:

⌘K 全站搜索。 复用已有的 /api/public/search,300ms 防抖,AbortController 防止乱序响应覆盖新结果,方向键导航,回车直达。搜索从「藏在页脚的一个链接」变成了随手可及。

移动端抽屉菜单。 原来窄屏下导航项是硬挤在一行的。

吸顶 + 滚动才显分隔线。 首屏不出现那条多余的横线。

跳到正文链接。 键盘和读屏用户可以跳过导航,sr-only focus:not-sr-only,只在聚焦时出现。

这些都不是什么惊人的功能。重点在于——当共享结构建立起来之后,它们才第一次变得「划算」。

顺带一提:一个死循环

改到页头的时候发现一个存在很久的 bug:后台入口组件 AdminLink 的逻辑是「已登录才渲染」。

于是:没登录 → 看不到入口 → 无从登录。

这个循环在改版前就存在,只是站长自己记得住 URL 所以没暴露。修法是在页脚放一个常驻的「管理」链接指向 /admin/posts——因为中间件已经会把未登录的请求重定向到 /login?from=/admin/posts,登录后自动回到目标页,一个链接同时服务两种状态。

收尾

这次重构没有增加任何架构复杂度。恰恰相反——删掉的代码比加的多,7 个页面加起来少了几百行。

所谓「抽象」,很多时候不是引入新概念,只是把本来就该是一个的东西,真的变成一个。

分享