Communitygithub.com

Bento网格布局系统

设计并实现一个系统性、非对称的便当盒网格布局框架,以连贯的方式组织多样化的内容类型,同时保持严格的视觉层次、逻辑焦点顺序和响应式灵活性。

Bento网格布局系统 是什么?

Bento网格布局系统提供了一种方法论,用于将不同内容(如关键绩效指标、视觉插图、交互式小部件、引用和产品功能预告)组织成统一的模块化网格。灵感来自传统日式便当盒,它通过不同单元格高度和宽度建立非对称平衡。该系统通过强制执行严格的比例规则、一致的内边距和结构化的排版比例,解决了仪表板、着陆页和作品集上视觉碎片化的设计问题,将原本可能混乱的布局转变为精致、易扫描且可访问的视觉层次。它支持 SaaS 功能展示、数据和指标仪表板、作品集以及电子商务集合等用例。系统遵循 5 步工作流程,包括建立网格几何形状、按视觉层次映射内容、设计单元格内部结构、组织 DOM 顺序以实现可访问性,以及定义响应式堆叠和断点。决策规则指导单元格跨列/行的选择、排版缩放以及内容包含 vs 出血布局。约束条件遵循 WCAG 2.2 可访问性标准,确保焦点可见性、触摸目标、阅读顺序和对比度合规。常见失败模式包括“视觉杂物抽屉”效应、DOM-视觉断开、移动布局爆炸等问题。验证标准涵盖统一几何形状、清晰层次、自然 Tab 键顺序、移动端可堆叠性、内部间距一致性、对比度 AA 合规性和交互安全性。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/coastdigitalgroup/coastai-skills/tree/HEAD/website-design/bento-grid-layout-system

在你喜欢的 AI 中提问

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

文档

Bento网格布局系统 是做什么的?

用途

Bento网格布局系统提供了一种方法论,用于将不同内容(如关键绩效指标、视觉插图、交互式小部件、引用和产品功能预告)组织成统一的模块化网格。灵感来自传统日式便当盒,它通过不同单元格高度和宽度建立非对称平衡。该系统通过强制执行严格的比例规则、一致的内边距和结构化的排版比例,解决了仪表板、着陆页和作品集上视觉碎片化的设计问题,将原本可能混乱的布局转变为精致、易扫描且可访问的视觉层次。

使用场景

  • SaaS功能展示: 在单个着陆页部分展示多样化的产品功能、性能统计、系统集成和交互式UI预览。
  • 数据和指标仪表板: 将关键绩效指标(KPI)、图表和运营摘要分组到高密度视觉块中。
  • 作品集和案例研究: 以动态、非线性方式展示创意作品、项目图片、客户引用和设计工作流程。
  • 电商系列: 以高影响力、编辑布局突出显示特色产品、限时系列、促销横幅和社会证明。

何时不应使用

  • 统一内容列表: 如果页面包含相同重复元素(例如,标准博客文章列表或产品网格),请使用 card-ui-system 或 responsive-grid-system。
  • 纯粹分层叙事: 对于依赖线性、连续叙事的布局(例如,“步骤1、步骤2、步骤3”),请使用 step-progress-system 或 section-composition-system。
  • 复杂高容量表格数据: 如果用户需要比较精确的技术值或阅读字母数字数据行,请使用 data-table-ui-system。
  • 内容驱动的文章: 对于核心焦点是不间断流动文本的编辑页面,请使用 article-layout-system。

输入

  1. 内容清单和优先级: 要放置在bento网格中的项目列表,按层次分类(1个核心主打,2-3个支撑,2-4个点缀)。
  2. 视觉资产分类: 每个单元格中资产的类型(静态图像、动画插图、交互式滑块、纯文本、数字指标)。
  3. 目标列和断点: 桌面列系统(通常为4列主网格)、平板适配(通常为2列)和移动端堆叠规则。
  4. 流体间距量表: 用于间距和内部单元格布局的流体内外边距标记(来自 fluid-spacing-system)。
  5. 品牌设计标记: 排版比例、边框半径、边框样式、背景填充比例和高度标记(来自 elevation-and-depth-system 和 fluid-typography-system)。

输出

  1. Bento网格几何地图: 一个比例坐标蓝图,指定每个单元格的列跨度(grid-column: span X)和行跨度(grid-row: span Y)。
  2. 内部卡片解剖规范: 不同单元格宽高比内的结构间距、内容嵌套和对齐规则。
  3. DOM顺序和无障碍地图: 一个逻辑Tab键顺序,显示HTML源结构如何在视觉位置不规则的情况下保持可访问性。
  4. 响应式堆叠计划: 精确的过渡规范,显示非对称网格如何简化为平板和移动屏幕。

工作流程

1. 建立网格几何形状和列

首先定义底层坐标网格。

  • 主网格结构: 桌面布局(1200px以上)标准化为4列CSS网格。这为单元格宽度(1/4、2/4、3/4或4/4宽度)提供了极好的数学因子。
  • 非对称轨道高度: 显式设置行高度或使用 grid-auto-rows: minmax(180px, auto) 建立正方形或水平矩形比例基础(每单位宽高比1:1或2:1)。
  • 流体间距: 使用流体间距标记作为网格间隙(例如,gap: clamp(16px, 2vw, 24px))以保持单元格视觉分离但紧密结合。

2. 按视觉层次映射和分配内容

不要随意分散项目。将每个单元格分类为三个结构层之一:

  • 核心主打单元格(跨2x2或3x2轨道): 占据网格区域约40-50%。托管最重要的视觉资产、视频或指标。它决定了整个部分的视觉入口点。
  • 支撑单元格(跨2x1或1x2轨道): 突出中间功能或关键统计数据。它们比基本块更高或更宽,以容纳结构化文本和图形。
  • 点缀单元格(跨1x1轨道): 保留用于小型视觉元素、简单单值指标、图标或徽章。它们完善网格以保持矩形包含。

3. 设计Bento单元格的内部结构

应用严格的内部间距约束以保持单元格内聚:

  • 统一内边距: 对所有单元格应用一致的内部边距,通常使用流体内边距标记(例如,padding: var(--space-m))。例外:点缀单元格(1x1)可以使用稍紧的内边距(--space-s)。
  • 内部对齐模式: 在单元格内部使用flexbox(display: flex; flex-direction: column; justify-content: space-between),以垂直对齐文本块到顶部,视觉点缀(指标、图形)到底部。
  • 背景和边框: 标准化所有单元格的统一边框半径(例如,border-radius: 16px 到 24px)。使用微妙的背景填充(例如,中性色调、半透明玻璃态背景或低对比度卡片表面)以建立清晰的卡片边界。

4. 为键盘和屏幕阅读器可访问性组织DOM顺序

不规则的网格布局可能导致视觉阅读顺序与物理DOM顺序不匹配。

  • 自然阅读流程: 按逻辑从左到右、从上到下的顺序排列HTML文档中的元素,就像它们被阅读的顺序一样。
  • 避免修改顺序: 切勿在CSS中使用 order 或以跳过可聚焦元素的方式任意定位单元格。如果单元格1位于左上,单元格2位于右上,它们在DOM中必须按该顺序出现,即使CSS网格布局以不同方式跨越它们。
  • 语义标题: 为每个内容密集的单元格提供一个清晰、描述性的标题标签(通常为 <h3> 或 <h4>),与父部分 <h2> 的大纲相匹配。

5. 定义响应式堆叠和断点

确保网格优雅地处理视口缩放:

  • 桌面(1200px以上): 4列布局。非对称列和行跨度。
  • 平板(768px - 1199px): 切换到2列网格。重新映射跨度,使原本1x1的单元格跨1列,2x1的单元格跨两列(2列全宽)。
  • 移动端(767px以下): 将网格完全折叠为1列垂直堆叠(grid-template-columns: 1fr)。移除显式行高(grid-auto-rows: auto),让元素自然流动,高度由内部边距和内容大小决定。

决策规则

何时跨列 vs 行

项目内容类型跨度决策规则推荐桌面几何形状
高影响力指标/主要功能同时跨列和行以创建焦点中心。grid-column: span 2; grid-row: span 2;
宽视觉/时间线/图表水平跨列;保持高度为1行以水平引导视线。grid-column: span 2; grid-row: span 1;
长文本列表/高图像垂直跨行;保持宽度为1列以垂直引导视线。grid-column: span 1; grid-row: span 2;
单一指标/徽章/图标不跨。保持为标准正方形块。grid-column: span 1; grid-row: span 1;

Bento单元格中的排版缩放

  • 自适应大小: 不要对所有卡片使用相同的字号。使排版比例与卡片大小成正比。
  • 主打卡片: 标题使用 font-size: clamp(1.5rem, 4cqi, 2.25rem)(如果支持,使用容器查询单位 cqi)。
  • 点缀卡片(1x1): 将标题限制为 font-size: clamp(1rem, 2.5cqi, 1.25rem),并保持描述简短(最多2行)或完全省略描述,改用图标+指标。

内容包含 vs 出血布局

  • 包含布局: 将内容完全放置在卡片内边距内,文本和边框之间至少有 16px 的呼吸空间。最适合文本密集型信息卡片。
  • 出血布局: 让视觉元素(产品截图、详细3D模型、复杂图表)出血到卡片的底部和/或右侧边缘,掩蔽溢出(单元格上的 overflow: hidden)。文本保持内边距并在顶部可读。将其用于核心主打和支撑视觉卡片。

约束条件

  • 焦点可见性(WCAG 2.2 SC 2.4.11 / 2.4.13): 如果任何单元格是可聚焦的(例如,作为大链接卡片),它必须有显式、高对比度的 :focus-visible 轮廓。焦点指示器绝不能因父网格的容器或卡片边界而被裁剪。
  • 触摸目标(WCAG 2.2 SC 2.5.8): Bento单元格内的所有交互元素(按钮、展开切换、滑块)必须具有 24x24px 的最小目标尺寸,并有足够的周围间距,对于移动端触发器首选 44x44px。
  • 阅读顺序对齐(WCAG 2.1 SC 1.3.2): 屏幕阅读器解析的内容顺序必须与bento网格的语义含义和视觉顺序相匹配。左上角单元格必须始终先于源代码DOM中的右下角单元格出现。
  • 对比度(WCAG AA): Bento卡片内的所有文本必须与卡片背景达到至少 4.5:1 的对比度。避免在着色卡片内的描述中使用低对比度的微妙灰色。

常见失败模式

  • “视觉杂物抽屉”效应: 仅仅因为能放进去就把任意元素塞入bento网格。每个单元格必须为父页面服务于内聚的叙事目的。
  • DOM-视觉断开: 以某种视觉顺序排列卡片,而在HTML中却留下完全不同的顺序。屏幕阅读器和键盘Tab导航在网格中混乱地跳跃。
  • 移动布局爆炸: 在移动屏幕上保留硬编码的列跨度,导致卡片收缩,文本溢出并完全不可读。
  • 边框半径过大冲突: 在卡片上使用巨大的边框半径,同时保持微小、尖锐的边缘,或嵌套内部元素的边框半径与外部卡片的同心角曲线不匹配。
  • 缺乏焦点锚点: 创建所有单元格大小完全相同的网格(例如,全部1x1或全部2x1),消除了布局的入口点并导致扫描疲劳。

验证标准

  • 统一几何形状: 网格使用底层、一致的坐标框架(理想情况下桌面上为4列布局),具有统一的间距。
  • 清晰层次: 单个“主打”块在视觉上占主导地位,并建立清晰的布局入口点。
  • 自然Tab键顺序: 通过网格元素的Tab导航可预测地从左到右、从上到下移动,匹配视觉布局。
  • 移动端可堆叠性: 布局干净地切换到移动视口(< 768px)上的单列堆叠,没有水平溢出。
  • 内部间距一致性: 所有相似卡片的单元格内边距相同,元素垂直对齐一致。
  • 对比度AA合规性: 每张卡片内所有文本块和状态指示器的对比度至少达到4.5:1的WCAG AA标准。
  • 交互安全性: Bento卡片内所有小部件的点击目标符合WCAG 2.2 24x24px的最低要求。

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 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 specify a systematic dark theme framework, establishing rules for elevation-based surface colors, desaturated brand accents, text legibility, and media adaptation to ensure an accessible, low-fatigue experience.

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.

相关技能