Communitygithub.com

粘性浮动UI组件系统

设计一个系统化的框架,用于实现持久、覆盖和滚动响应的UI元素,包括渐进式头部、移动底部坞、浮动操作按钮和粘性侧边栏小部件,以最大化转化率和实用性,同时防止布局阻塞和WCAG焦点遮挡。

粘性浮动UI组件系统 是什么?

该技能提供了一个系统化的设计和方法论,用于在Web应用中创建粘性(sticky)和浮动(floating)UI组件。它重点解决了如何让关键操作(如主导航、转化按钮、浮动操作按钮等)在用户滚动页面时始终易于访问,同时避免常见的可用性和可访问性问题。该框架涵盖了渐进式导航头部、移动底部持久操作栏、粘性侧边栏小部件以及浮动动作按钮等多种常见场景,并提供了从空间预算、z-index层级分配到具体CSS实现(如`position: sticky`、`transform`过渡、`env(safe-area-inset-bottom)`)的详细工作流。技能特别强调了WCAG 2.2 SC 2.4.11(焦点不被遮挡)的合规性,通过`scroll-margin-top`等技术确保键盘焦点元素不会被粘性元素遮挡。此外,它还包含了严格的约束条件,如粘性元素占用视口高度不超过15%、移动端交互目标至少44x44px、以及防止累积布局偏移(CLS)。该技能适用于Cursor、Claude Code和Codex等AI编程助手,帮助开发者在构建注重转化率和用户体验的界面时做出明智的设计决策。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/coastdigitalgroup/coastai-skills/tree/HEAD/website-design/sticky-and-floating-ui-system

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

粘性与浮动UI系统

目的

粘性与浮动UI系统提供了一种设计持久、视口固定和滚动响应界面组件的方法论。它确保关键控件(如主导航、驱动转化的行动号召按钮、上下文实用小部件和快速操作按钮)在活动滚动状态下保持易于访问。

一个设计良好的粘性与浮动系统解决了即时操作可用性与主要内容消费之间的空间矛盾。它防止布局疲劳,保护视口免受过多视觉混乱,尊重移动设备的物理安全区域(如设备刘海和系统主屏幕指示器),并严格减轻键盘焦点遮挡故障(WCAG 2.2 SC 2.4.11)。

使用场景

  • 渐进式导航头部: 向下滚动时隐藏(最大化阅读区域),向上滚动时显示(使导航立即可用)的头部。
  • 移动持久底部坞: 为移动布局设计的浮动或固定底部栏,包含主要转化操作(例如,“加入购物车”、“立即预订”、“申请”)。
  • 粘性侧边栏小部件: 上下文子导航、分享栏或产品购买配置,随主要内容区域滚动,但在到达结构边界前锁定位置。
  • 浮动操作按钮(FAB): 视口锚定的触发器,用于快速高频操作,如“返回顶部”导航、直接支持聊天或购物车抽屉。
  • 锚点与阅读进度条: 跟踪视口完成率的粘性元素,或提供指向页面主体子部分的直接链接。

何时不使用

  • 数据密集的SaaS仪表板: 其中屏幕空间被表格数据、工作画布或视口锁定面板严重限制;请使用dashboard-layout-system。
  • 短/单视口页面: 整个页面内容适合单个屏幕视图,无需滚动即可访问。
  • 叙事驱动的实验性网站: 有意选择视觉迷失或沉浸式3D空间流,而非标准导航实用性。
  • 键盘焦点表单: 用多字段表单使页面过载,且粘性按钮会遮挡移动虚拟键盘上的活动输入字段。

输入

  1. 内容与叙事结构: 页面的线框图序列(来自section-composition-system),以了解粘性元素应在何时何地激活。
  2. 设备视口约束: 针对移动、平板和桌面断点进行适配,在固定栏和浮动侧边容器之间调整布局。
  3. 主要和次要行动号召: 确定需要持久可见性的转化目标。
  4. 层叠顺序(Z-Index)策略: 在elevation-and-depth-system中建立的层叠关系和层级,以防止视觉重叠冲突。
  5. 系统安全区域度量: 硬件安全区域内嵌(env(safe-area-inset-bottom),刘海),以防止与设备界面重叠。

输出

  1. 粘性行为规范: 滚动触发器、动画阈值以及进入/退出过渡公式的明确定义。
  2. 移动底部坞布局: 针对移动屏幕的空间优化布局蓝图,详细说明目标大小、安全区域偏移和对比度要求。
  3. 遮挡缓解映射: 显示如何使粘性覆盖层不遮挡焦点元素的设计定义(WCAG 2.2 SC 2.4.11)。
  4. 桌面侧边栏/小部件锁定规范: 边界规则(页眉、页脚、部分终点),滚动侧元素必须在此处对齐并锁定。

工作流程

1. 建立视口分区与空间预算

在定位持久层之前,定义“视觉安全区”以确保内容可读性得以保留。

  • 15%预算规则: 在任何设备屏幕上,粘性元素占用的总垂直视口空间不得超过15%。
  • 层叠顺序(Z-Index)分配: 使用elevation-and-depth-system层级分配清晰的层叠值。
    • 渐进式头部:z-index: 100(第3层:粘性)
    • 移动底部坞:z-index: 150(第3层:粘性/浮动)
    • 浮动操作按钮:z-index: 200(第3层:浮动触发器)
  • 避免堆叠重叠: 永远不要让粘性头部和粘性底部栏同时保持静态,以免挤占屏幕;确保它们有足够的呼吸空间,或在特定状态下隐藏。

2. 设计渐进式头部行为

静态粘性头部会占用宝贵的垂直像素。采用“渐进式”模型:

  • 默认状态: 透明或与页面背景融合的头部。
  • 向下滚动(阈值 >100px): 将头部平滑向上平移出视图(transform: translateY(-100%)),以最大化内容扫描区域。
  • 向上滚动(增量 >15px): 将头部立即或平滑平移回视图中,应用实色或模糊表面背景(backdrop-filter: blur(8px))和细微阴影,以表示与页面主体文本的分离。
  • 边界停止: 一旦滚动条返回到视口顶部(scrollY < 50px),禁用向上滚动过渡,使头部恢复其原始静态布局。

3. 设计移动持久底部坞

底部持久栏是移动转化的主要驱动力,但极易受到物理和视觉干扰。

  • 物理安全区域: 始终使用CSS环境变量锚定底部坞的边缘:padding-bottom: calc(var(--base-padding) + env(safe-area-inset-bottom))。这确保它干净地坐落在iOS主屏幕指示器和Android导航栏上方,而不会重叠交互触发器。
  • 进入滚动触发器: 不要在初始英雄视口显示移动底部坞。等到用户滚动过英雄部分的主要内联行动号召后(阈值 > 100% VH),再从底部滑入坞(transform: translateY(0),从translateY(100%)开始)。
  • 布局拆分: 将坞限制为单个主要操作按钮(例如,“加入购物车”)和一个次要实用按钮/徽章(例如,“价格”或“保存”),以保持点击目标极其清晰。

4. 构建桌面粘性侧边栏和小部件

侧边栏小部件在与深层主内容列一起滚动时,必须保持锁定在视口焦点中:

  • 容器隔离: 侧边栏必须位于与主要内容区域高度匹配的列容器内。
  • position: sticky规范:使用position: sticky; top: calc(var(--header-height) + var(--space-l));样式化小部件。这防止小部件滑到主导航栏后面或与它重叠。
  • 页脚边界锁定: 确保粘性小部件的父列具有overflow: visible(或正确包含在网格弹性包装器中),允许浏览器自然阻止小部件与全局页脚或底部部分重叠。

5. 防止键盘焦点遮挡(无障碍核心)

最常见的网页设计无障碍失败之一是键盘标签页用户聚焦一个链接,但该链接隐藏在粘性头部或底部坞下方(违反WCAG 2.2 SC 2.4.11 焦点不被遮挡)。

  • 顶部滚动边距: 为所有目标部分、标题(h2, h3)和关键交互目标应用全局scroll-margin-top:
    :target, [id] {
      scroll-margin-top: calc(var(--header-height) + var(--space-m));
    }
    
  • 焦点内边距: 如果交互元素接收到键盘焦点,浏览器视图必须滚动,使该元素完全可见在持久粘性覆盖层的边界之外。
  • 逃生口: 如果从粘性元素打开了模态框或下拉菜单,则需捕获焦点(使用focus-trap-implementation)并使背景页面内容不可操作(inert)。

6. 设计浮动操作按钮(FAB)和返回顶部触发器

FAB位于视口的较低角落,提供快速的次要全局实用功能。

  • 基于阈值的进入: 隐藏“返回顶部”触发器,直到用户滚动经过至少两个完整视口(scrollY > 200% VH)。触发后,淡入并缩放显示(从scale(0.8); opacity: 0;过渡到transform: scale(1); opacity: 1;)。
  • 视口偏移: 在桌面上,FAB距离右视口边缘至少保持24px,在移动设备上保持16px。
  • 避免目标阻挡: 将FAB水平放置在主要内容阅读线的对面。确保它们不会在滚动到页面底部时阻挡链接、社交图标或页脚中的内联导航。

决策规则

  • 静态vs.渐进式头部: 如果网站是任务繁重的Web门户或电子商务商店(搜索和过滤功能被频繁使用),则使用静态粘性头部。对于文章布局、内容营销或销售落地页(垂直阅读区域是优先考虑的因素),则使用渐进式粘性头部。
  • 底部坞vs.内联行动号召: 在移动设备上,如果页面包含单个高价值转化目标(如注册或购买),则使用底部固定行动号召。如果页面有多个同等优先级的竞争操作,则不要使用底部坞。
  • FAB大小和触摸区域: 确保浮动触发器是圆形或圆角卡片。视觉元素直径必须至少为48px,实际交互点击容器必须满足最小44x44px(WCAG 2.2推荐)的覆盖范围,以方便拇指操作。
  • 渐进式模糊vs.纯色: 使用backdrop-filter: blur(8px)和略微透明的颜色(例如,rgba(255, 255, 255, 0.8))代替完全不透明背景。这保持了视觉深度感,让用户在粘性框架后感知到滚动进度。

约束条件

  • 可访问性(WCAG AA最低要求):
    • SC 2.4.11 焦点不被遮挡(最低要求): 高对比度焦点环绝不能隐藏在粘性元素后面。确保元素可以在不被头部或页脚阻挡的情况下干净地进行标签页导航。
    • SC 2.5.8 目标大小(最低要求): 粘性栏和FAB中的所有交互目标必须至少为24x24px,对于移动底部坞上的主要拇指触发器,推荐44x44px。
    • 无标签页陷阱: 键盘用户必须能够使用标准Tab/Shift+Tab键导航进入和退出粘性栏控件。
  • 响应性(布局稳定性):
    • 粘性层绝不能导致水平视口溢出。使用基于百分比的宽度或left: 0; right: 0;布局,并具有精确的box-sizing约束。
    • 在移动设备上,将桌面粘性侧边栏转换为简单的内联面板,或将其合并到底部抽屉中。
  • 布局偏移缓解(CLS):
    • 切勿在不保留其原始空间容量的情况下,动态地将元素的position从static更改为fixed。切换到fixed会立即折叠其原始容器高度,导致巨大的累积布局偏移(CLS)。相反,使用position: sticky(它保留布局容量)或在预先保留的容器内切换样式。

常见失败模式

  • 焦点遮挡面纱: 键盘用户在页面中切换标签页,但焦点环落在完全隐藏在粘性头部下方的链接上,使其无法看到。
  • iOS主屏幕指示器重叠: 固定移动底部栏而未添加env(safe-area-inset-bottom),导致原生操作系统滑动手势条直接位于“立即购买”按钮上方。
  • 抖动滚动循环: 使用JavaScript设置滚动过渡,恰好在一个边界线上触发,导致粘性栏在可见和隐藏状态之间快速视觉抖动。
  • 视口三明治: 在小型移动设备上同时激活一个厚的粘性头部和一个厚的粘性底部栏,将可读屏幕空间减少到微小的40%窗口。
  • CLS瞬间折叠: 滚动时将头部切换为fixed,导致页面主要内容瞬间向上弹跳80px,使用户迷失方向。

验证标准

  • 视口区域检查: 粘性元素在桌面或移动设备上占用的垂直视口空间不超过15%。
  • 焦点保护(SC 2.4.11): 所有键盘聚焦的元素在持久粘性元素的边界外保持完全可见。已配置全局scroll-margin-top。
  • 移动安全区域对齐: 移动底部坞明确使用env(safe-area-inset-bottom)来防止设备控件重叠。
  • 触发阈值逻辑: 移动底部坞在初始英雄视口中保持隐藏,仅在经过英雄行动号召后才淡入/滑入。
  • 布局偏移预防: 渐进式头部和粘性侧边栏小部件使用position: sticky样式化,或放置在预先测量的容器中,以保证零累积布局偏移(CLS)。
  • 无重叠冲突: 层叠上下文z-index已清晰映射并记录,以防止重叠视觉错误。
  • 目标尺寸: 移动底部坞触发器和FAB满足44x44px的触摸目标偏好。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for progressive disclosure using accordions, ensuring structural integrity, visual affordances, and accessibility across different content densities and devices.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for long-form content, managing readability, vertical rhythm, and information density to ensure a superior reading experience.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for informational elements that communicate state (Badges) and categorization (Tags) with clarity and accessibility.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for non-overlay notifications, managing global announcements and contextual inline alerts to communicate system states without interrupting the user's flow.

coastdigitalgroup/coastai-skills

Design and implement a systematic, asymmetrical bento-grid layout framework to organize diverse content types cohesively while maintaining strict visual hierarchy, logical focus order, and responsive flexibility.

coastdigitalgroup/coastai-skills

Design a responsive, mobile-first bottom navigation bar and persistent action dock system for mobile websites and web applications, establishing spatial anchors, tab bar anatomy, badge indicators, thumb-zone ergonomics, safe area inset handling, active/inactive state contrast, and desktop responsive adaptation rules.

coastdigitalgroup/coastai-skills

Design a mobile-first bottom sheet overlay system with configurable detents, drag affordances, safe area padding, responsive desktop modal/popover adaptation, and WCAG AA accessibility compliance.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for secondary navigation trails that provide orientation, context, and one-click access to parent levels in deep information architectures.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for buttons and interactive triggers, managing visual hierarchy, variant logic, and action grouping to ensure clear intent and accessible interaction.

coastdigitalgroup/coastai-skills

Design a systematic framework for date and time selection, managing calendar grids, range pickers, and scheduling interfaces to ensure precision and accessibility.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for modular content containers that maintain hierarchy, structural integrity, and action alignment across variable content and responsive viewports.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for horizontal discovery components, managing navigation affordances, scroll behavior, and accessibility to ensure effective content density without compromising usability.

coastdigitalgroup/coastai-skills

Design a systematic, highly accessible, and developer-friendly UI layout framework for code blocks, snippet showcases, multi-file code tabs, line-highlighting, diff views, and syntax token contrast in technical documentation and developer platforms.

coastdigitalgroup/coastai-skills

Design a systematic framework for global command menus (Cmd+K panels) that combines keyboard-driven navigation, command execution, and shortcut discovery into an accessible, responsive overlay.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for threaded conversations, managing nesting depths, action hierarchies, and community signaling to foster engagement and readability.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for side-by-side comparison interfaces, managing high attribute density and responsive complexity to support informed decision-making.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for user privacy, managing consent banners, preference centers, and persistent privacy controls to balance legal compliance with user trust.

coastdigitalgroup/coastai-skills

Design and implement a systematic, highly accessible, and responsive visual layout framework for conversational chat widgets, live chat boxes, and chatbot panels that ensures clear message scannability, native focus flow, and seamless mobile keyboard adaptation.

coastdigitalgroup/coastai-skills

Design a systematic, accessible, and high-conversion framework for custom select dropdowns and comboboxes, defining anatomy, states, search-filtering, and responsive mobile-adaptive patterns.

coastdigitalgroup/coastai-skills

Design and implement a systematic color palette that ensures WCAG 2.2 accessibility compliance. Trigger this skill when asked to define brand colors, create UI themes, or establish a visual system for a website.

相关技能