告别 JSON API 和状态管理:用 Go + HTMX 重构社区交互实录
文章目录
告别 JSON API 和状态管理:用 Go + HTMX 重构社区交互实录
前情提要:在上一篇《我们砍掉了 Nuxt 3,把技术社区重构成了 Go + Templ + HTMX》中,我们复盘了
helloworld.net抛弃 Node.js SSR 的整体架构。今天这篇单独把 HTMX 拎出来,聊聊它是如何帮我们砍掉 90% 的前端胶水代码的。
在传统的 Vue/React 架构里,实现一个看似简单的“帖子点赞”功能,开发链路往往长这样:
- 后端写一个
POST /api/posts/:id/like接口,返回{ "liked": true, "count": 43 }。 - 前端封装 Axios/Fetch 请求,写一个
toggleLike()方法。 - 前端维护
isLiked和likeCount两个响应式变量(甚至还要塞进 Pinia/Redux)。 - 处理加载中(Loading)防连点、接口报错回滚状态。
一个按钮,前后端加起来写上百行代码。在重构 helloworld.net 时,我们引入了 HTMX,彻底终结了这种“为了局部刷新而写整套 JSON API”的繁琐。
一、 HTMX 的核心理念:后端直接吐 HTML
HTMX 的本质只有一句话:让任何 HTML 元素都能直接发起 HTTP 请求,并用服务器返回的 HTML 片段局部替换页面上的任意位置。
在 helloworld.net 的新架构里,后端不再返回 JSON 数据,而是直接用 Go 渲染好一小段新的 HTML 返回给浏览器:
<!-- 后端首次渲染及点击后返回的局部 HTML 片段 -->
<button
id="like-btn-1024"
hx-post="/posts/1024/like"
hx-swap="outerHTML"
hx-disabled-elt="this"
class="btn-like liked">
👍 已赞 <span>43</span>
</button>
来看看这几个属性干了什么:
hx-post="/posts/1024/like":点击按钮时,自动向后端发送 POST 请求(带 Cookie/Session 鉴权)。hx-swap="outerHTML":收到后端返回的新<button>...</button>后,直接把当前整个按钮节点原地替换掉。hx-disabled-elt="this":请求发出到响应回来期间,自动给按钮加上disabled属性,一行 JS 没写就解决了“手快重复提交”的问题。
前端没有虚拟 DOM diff,没有 JSON 解析,也没有状态同步 bug——服务端数据库里是什么状态,页面上就替换成什么 HTML。
二、 社区四大高频交互的 HTMX 极简实现
除了点赞,我们在 helloworld.net 中把最核心的几个社区交互全部改造成了 HTMX 模式:
1. 无限滚动分页(Infinite Scroll)
以前做列表“滚动到底部加载下一页”,前端要监听 scroll 事件或配置 IntersectionObserver,再维护 page 页码和 list 数组拼接。用 HTMX 只需要在列表最后一条元素上加 3 个属性:
<!-- 当最后一条帖子进入视口(revealed)时,自动请求下一页并追加到列表末尾 -->
<article class="post-card"
hx-get="/posts?page=2"
hx-trigger="revealed"
hx-swap="afterend">
<h3>第 20 篇帖子的标题...</h3>
</article>
2. 站内实时搜索(自带防抖)
配合我们在主文中提到的 PostgreSQL tsvector 全文索引,搜索框只需这样写:
<input
type="search"
name="q"
placeholder="搜索技术文章..."
hx-get="/search"
hx-trigger="keyup changed delay:300ms, search"
hx-target="#search-results"
hx-indicator=".search-spinner" />
<div id="search-results"></div>
用户输入停顿 300ms 后自动触发请求,查询期间自动显示 .search-spinner 加载动画,结果直接渲染进 #search-results 容器。
3. 全站 hx-boost="true":让多页面拥有 SPA 的丝滑感
这是 HTMX 最被低估的杀手级特性。只要在全站公共布局的 <body> 或导航栏上加上 hx-boost="true":
<body hx-boost="true">
<nav>
<a href="/latest">最新</a>
<a href="/hot">热门</a>
</nav>
<!-- 页面主体 -->
</body>
当用户点击站内普通 <a> 链接时,HTMX 会自动拦截默认整页跳转,改用 AJAX 静默拉取目标页面,提取其中的 <body> 替换当前页面,并自动更新浏览器地址栏 URL(支持前进/后退)。既保留了 100% 原生 URL 直链与 SEO 收录能力,又消除了页面刷新白屏。
三、 实战中的两个关键细节
- 区分整页请求与局部请求:在 Go 后端中间件里,通过检查请求头
r.Header.Get("HX-Request") == "true",就能轻松判断当前是浏览器直接刷新(返回完整 HTML 页面包含 Header/Footer),还是 HTMX 局部跳转/分页(只返回局部 HTML 片段),一套路由逻辑完美复用。 - 第三方 JS 插件重新初始化:像文章详情页的代码高亮(Highlight.js),如果内容是通过 HTMX 动态插入的,需要在全局监听
htmx:afterSwap事件重新执行一次渲染,确保新加载的代码块也能正确着色。
系列延伸阅读:HTMX 负责把后端 HTML 片段高效送到浏览器,而负责在 Go 后端类型安全、零反射地生成这些 HTML 片段的,则是另一位核心主角——欢迎继续阅读姊妹篇:《Templ 实战:像写 JSX 一样在 Go 里写编译期类型安全的 HTML 模板》。也欢迎直接访问 helloworld.net 亲自体验全站
hx-boost的丝滑加载速度!

评论
登录后参与技术讨论,分享你的经验与见解。
登录 / 注册暂无评论