Griddle 技术文档

1. 安装指南

Griddle 是一个适用于现代浏览器的 CSS 网格系统，由 Sass 函数和混合指令生成。您可以通过以下方式安装 Griddle：

• 下载 Zip 压缩包：下载地址
• 使用 Bower 包管理器：运行命令 bower install --save griddle
• 使用 Git：运行命令 git clone https://github.com/necolas/griddle.git

2. 项目使用说明

Griddle 网格系统适用于移动优先或非移动优先的开发方式。您可以通过导入 griddle 来在给定断点处初始化网格。

griddle-build() 混合指令用于生成网格样式。它可以接受一个由空格分隔的整数列表，每个整数将创建相应列数的网格。例如：

@import "griddle";
// 创建 2、3 和 4 列的网格
@include griddle-build(2 3 4);

混合指令还接受一个字符串作为第二个（可选）参数。这可以用来生成修改后的选择器，以便在不同断点处覆盖单元的宽度。例如：

@media (min-width: 40em) {
    // 在更宽的屏幕上创建 2、3、4、5、6 和 12 列的网格
    @include griddle-build(2 3 4 5 6 12, '--desktop');
}

每个网格单元以相同的方式创建，使用 HTML 类。您可以让一个单元在窄视口宽为 50%，但在宽视口宽为 25%，当样式应用于修饰类时：

<div class="grid__cell unit-1-2 unit-1-4--desktop">
    ...
</div>

您可以根据个人喜好自定义默认的类名模式。

3. 项目 API 使用文档

Griddle 的核心 API 是 griddle-build 混合指令。以下是如何使用它的基本示例：

@import "griddle";

// 在默认断点创建一个 3 列的网格
@include griddle-build(3);

// 在较大屏幕的断点上创建一个 4 列的网格
@media (min-width: 768px) {
    @include griddle-build(4, '--large');
}

您可以为不同的断点创建不同的网格布局，并使用修饰符类来定义特定断点下的单元宽度。

4. 项目安装方式

Griddle 支持多种安装方式，您可以选择最适合您项目的方式：

• 通过 Bower：运行 bower install --save griddle 命令。
• 通过 Git：运行 git clone https://github.com/necolas/griddle.git 命令，然后将其集成到您的项目中。
• 手动下载：从 GitHub 下载 Zip 压缩包，然后解压到您的项目中。

确保在您的 Sass 文件中导入 Griddle，并在 HTML 中使用相应的类来定义网格布局。