@codingheads/sticky-header

中文文档
1.0.2发布于 2021/07/10GPL-3TypeScriptESM + CJS零依赖近 30 天下载 5729

一个允许您创建粘贴头的库. 用这个 position: sticky 和交叉观察员

中文使用文档
文档目录3 节
  1. 安装
  2. 在 JavaScript 中初始化
  3. 警告

粘贴页眉

这个库允许您创建粘贴头. 用这个 position: sticky 和交叉观察员.

插件不需要jQuery,但如果jQuery存在于页面上,它会加入到jQuery中.

安装

使用 npm(或纱线)来安装软件包.

npm install --save @codingheads/sticky-header

在 JavaScript 中初始化

要初始化库,您需要创建一个新的实例 StickyHeader 类 :

import StickyHeader from '@codingheads/sticky-header';

const header = document.querySelector('header.page-header');
new StickyHeader(header, options);

或使用 j 查询 :

import '@codingheads/sticky-header';

$('header.page-header).stickyHeader(options);

选项对象可具有以下属性:

  • mainClass - 插件初始化时添加的类( 默认 ): sticky(中文(简体) )
  • pinnedClass - 元素变成"粘"时添加的类别(默认: sticky-pinned(中文(简体) )
  • unpinnedClass - 当元素变成"不粘"时,该类添加(默认: sticky-unpinned(中文(简体) )
  • offset - 元素应当成为“ stuck” (默认: 0) 的偏移( 像素)
  • addBodyClasses - 增加一个 pinnedClass 财务报告和审定财务报表 unpinnedClass 分类到正文元素(默认:真实)

警告

  1. 该插件使用 position: sticky。这在所有现代浏览器中都得到了支持。 不过, position: sticky 具有一些要求: 您不能有父元素 overflow: hidden,否则无效(该位置将静止)。 如果无法启动,请检查是否没有 overflow: hidden 在父元素上.

  2. 如果您根据"stuck"/"unstuck"的状态更改了标题大小,可能需要防止窗口在这样的情况下滚动(标题会将内容推后).

如果你有一个 #wrapper 元素围绕内容(包括标题),您可以做这样的事情:

header.sticky {
  top: 0;
  position: sticky;
}

/** fix for when the header grows in size when it becomes unpinned and the scroll position changes (we need to scroll more) **/
@supports (position: sticky) {
  body.sticky-unpinned #wrapper {
    overflow-anchor: none;
  }
}

版本与发布记录

@codingheads/sticky-header 共发布 3 个版本,首次发布于 2021/07/10;过去 12 个月发布了 0 个版本。

版本发布日期距今
1.0.2latest2021/07/105 年前
1.0.12021/07/105 年前
1.0.02021/07/105 年前

关于 @codingheads/sticky-header 的常见问题

@codingheads/sticky-header 是什么?

一个允许您创建粘贴头的库. 用这个 position: sticky 和交叉观察员

如何安装 @codingheads/sticky-header?

在项目目录运行 npm install @codingheads/sticky-header,或使用 pnpm add / yarn add / bun add。

@codingheads/sticky-header 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@codingheads/sticky-header 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@codingheads/sticky-header 可以商用吗?

@codingheads/sticky-header 使用 GPL-3 许可。声明的许可为 GPL-3,请阅读许可原文确认使用条件。以上为概括,不构成法律意见,请以许可原文为准。

@codingheads/sticky-header 的下载量有多少?

根据 npm 官方下载统计,@codingheads/sticky-header 在 2026/10/10 – 2026/11/08 这 30 天内被下载 5,729 次,日均约 191 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@codingheads/sticky-header 还在维护吗?

最新版本 1.0.2 发布于 2021/07/10(5 年前);至今共发布 3 个版本,其中过去 12 个月发布了 0 个;首次发布于 2021/07/10。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。