use-stick-to-bottom

让 AI 聊天消息自动吸底,滚动顺滑不跳变

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 对话助手 🍴 复刻 59 🐛 待处理 17 👀 关注 4
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 784
维护状态 低维护
是否开源 开源
定价模式 🏷️完全免费 开源MIT协议,完全免费,无付费版本。

项目预览

use-stick-to-bottom 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类对话助手
开发团队stackblitz-labs
定价模式🏷️完全免费
价格说明开源MIT协议,完全免费,无付费版本。
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议MIT
主要语言TypeScript
技术栈/模型ai,chatbot,chatgpt,claude,messages,smooth-scrolling
GitHub 星标★ 784
上线时间2024-09-07 00:00:00
代码更新2026-06-04
仓库体积220 KB
本站数据更新2026-11-10
维护状态低维护
收录时间2026-08-09
浏览次数7

项目介绍

use-stick-to-bottom 是一个轻量级的 React Hook,专为 AI 聊天应用设计,用于实现消息列表平滑吸底功能。它解决了聊天过程中新消息到来时列表滚动位置不自然、用户阅读体验差的问题。核心能力包括:自动检测内容溢出并吸底、支持平滑滚动动画、可自定义滚动行为(如仅在接近底部时吸底)、提供滚动状态回调。该 Hook 基于 TypeScript 开发,类型安全,体积小,易于集成到现有 React 项目中。它不依赖第三方滚动库,而是通过原生滚动事件和 requestAnimationFrame 实现高性能滚动控制,适用于 ChatGPT、Claude 等对话式 UI 场景。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 784

技术标签

使用教程

难度:入门 约 12 分钟 部署方式:前端集成 4 步

环境要求

  • React 18+
  • Node.js 18+

安装与启动步骤

  1. 1装包

    聊天列表自动贴底、且不打乱用户滚动位置的 hook。

    npm install use-stick-to-bottom
  2. 2接进列表

    把滚动容器换成它的组件。

    import { StickToBottom } from 'use-stick-to-bottom';
  3. 3包住内容

    内容区放 StickToBottom.Content。

    <StickToBottom><StickToBottom.Content>...</StickToBottom.Content></StickToBottom>
  4. 4处理新消息

    流式追加时保持视口稳定。

    在 content 末尾追加消息即可

如何确认成功

流式输出时视口不跳动,用户上滑后不再自动贴底。

注意事项

  • 零依赖、体积小,聊天类界面基本都要这个能力。
  • 自己用 scrollTop 实现很难处理「用户正在上滑」的判断。
  • 配 virtualization 时要额外注意高度测量。

核心亮点

  • 轻量无依赖,仅 React Hook,体积小易集成
  • 平滑滚动动画,避免生硬跳变,提升体验
  • 智能吸底策略,仅在接近底部时自动跟随,不干扰用户上翻阅读

不足之处

  • 仅支持垂直滚动,不支持横向或复杂滚动容器
  • 文档/社区待观察

适用场景

  • AI 聊天机器人消息流自动滚动到底部
  • 实时日志或通知面板的自动跟随更新
  • 长列表聊天窗口(如客服系统)的滚动管理

替代项目

react-chat-elements、react-scroll-to-bottom、chat-scroll

上一篇:serverless-chat-langchainjs

下一篇:panes

同类项目推荐

swift-ios-skills 开源

让 AI 写出更地道的 SwiftUI 代码,适配 iOS 26 新特性。

Agent Skills for iOS 26+, Swift 6.3, SwiftUI, and modern Apple frameworks

★ 1281 2026-08-09
ComfyUI-Gemini 开源

在 ComfyUI 里直接调用 Gemini,让多模态 AI 助力图像创作。

Using Gemini in ComfyUI

★ 781 2026-08-09
torchdistill 开源

免写代码,配置即复现顶会知识蒸馏实验

A coding-free framework built on PyTorch for reproducible deep learning studies. PyT···

★ 1636 2026-08-13
Hephaestus 开源

让AI代理自己搭建工作流,告别预设流程,动态完成任务。

Semi-Structured Agentic Framework. Workflows build themselves as agents discover wha···

★ 1185 2026-08-09
FastQL 开源

一行 Python 代码,快速启动 Rust 驱动的 GraphQL API

Spin up a super fast Rust powered GraphQL API to prototype your ML model in one line···

★ 107 2026-08-09
beyondllm 开源

快速构建、评估和观测你的 LLM 应用

Build, evaluate and observe LLM apps

★ 296 2026-08-09
dspy-advanced-prompting 开源

用DSpy实现高级提示词技巧,提升LLM应用效果

State-of-the-art prompting techniques implementation with DSpy - Manager-style promp···

★ 61 2026-08-09
agent-skills 开源

给 AI 编程代理装技能,先审后用更放心

The secure, validated skill registry for professional AI coding agents. Extend Antig···

★ 7152 2026-10-12