首页
/ Zen Grids 项目技术文档

Zen Grids 项目技术文档

2024-12-23 14:10:39作者:侯霆垣

1. 安装指南

1.1 使用 npm 安装

npm install --save-dev zen-grids

1.2 使用 Bower 安装

bower install --save-dev zen-grids

1.3 使用 Ruby Gem 安装

gem install zen-grids

如果使用 Compass,请在 config.rb 文件中添加以下内容:

require "zen-grids"

1.4 使用 Bundler 和 Ruby Gem 安装

bundle inject zen-grids '~> 2.0'

安装完成后,您可以在 Sass 文件中引入 Zen Grids:

@import "zen-grids";

2. 项目使用说明

Zen Grids 是一个直观且灵活的网格系统,利用内容的自然源顺序来简化创建响应式设计的流程。通过易于使用的 Sass mixin 集,Zen Grids 可以应用于多种布局,包括响应式、自适应、流体和固定宽度布局。

2.1 基本示例

以下是一个简单的示例,展示如何在 12 列网格中创建一个内容列和两个侧边栏:

@import "zen-grids";

$zen-gutters: 40px;  // 设置 gutter 大小,每个列的两侧都会使用半个 gutter。

.container {
  @include zen-grid-container();  // 定义网格项的容器。
}

$zen-columns: 12;  // 设置在此媒体查询中使用的网格列数。

@media all and (min-width: 50em) {
  .sidebar1 {
    @include zen-grid-item(3, 1);   // 从第 1 列开始,跨 3 列。
  }
  .content {
    @include zen-grid-item(6, 4);   // 从第 4 列开始,跨 6 列。
  }
  .sidebar2 {
    @include zen-grid-item(3, 10);  // 从第 10 列开始,跨 3 列。
  }
}

.container 元素中,.sidebar1.sidebar2.content 元素可以按任意顺序排列。

3. 项目 API 使用文档

3.1 zen-grid-container()

定义网格项的容器。使用此 mixin 来创建一个包含网格项的容器。

.container {
  @include zen-grid-container();
}

3.2 zen-grid-item($span, $start)

定义网格项的跨度和起始列。$span 参数指定网格项的跨度,$start 参数指定网格项的起始列。

.sidebar1 {
  @include zen-grid-item(3, 1);  // 从第 1 列开始,跨 3 列。
}

3.3 $zen-gutters

设置网格的 gutter 大小。gutter 是列与列之间的间距,每个列的两侧都会使用半个 gutter。

$zen-gutters: 40px;

3.4 $zen-columns

设置网格的列数。此变量用于定义在特定媒体查询中使用的列数。

$zen-columns: 12;

4. 项目安装方式

Zen Grids 可以通过多种方式安装,包括 npm、Bower、Ruby Gem 和 Bundler。安装完成后,您可以在 Sass 文件中引入 Zen Grids 并开始使用其功能。

4.1 使用 npm 安装

npm install --save-dev zen-grids

4.2 使用 Bower 安装

bower install --save-dev zen-grids

4.3 使用 Ruby Gem 安装

gem install zen-grids

4.4 使用 Bundler 和 Ruby Gem 安装

bundle inject zen-grids '~> 2.0'

安装完成后,您可以在 Sass 文件中引入 Zen Grids:

@import "zen-grids";
热门项目推荐
相关项目推荐

项目优选

收起
Python-100-DaysPython-100-Days
Python - 100天从新手到大师
Python
625
117
HarmonyOS-ExamplesHarmonyOS-Examples
本仓将收集和展示仓颉鸿蒙应用示例代码,欢迎大家投稿,在仓颉鸿蒙社区展现你的妙趣设计!
Cangjie
286
82
openHiTLSopenHiTLS
旨在打造算法先进、性能卓越、高效敏捷、安全可靠的密码套件,通过轻量级、可剪裁的软件技术架构满足各行业不同场景的多样化要求,让密码技术应用更简单,同时探索后量子等先进算法创新实践,构建密码前沿技术底座!
C
60
49
Cangjie-ExamplesCangjie-Examples
本仓将收集和展示高质量的仓颉示例代码,欢迎大家投稿,让全世界看到您的妙趣设计,也让更多人通过您的编码理解和喜爱仓颉语言。
Cangjie
205
61
RuoYi-Cloud-Vue3RuoYi-Cloud-Vue3
🎉 基于Spring Boot、Spring Cloud & Alibaba、Vue3 & Vite、Element Plus的分布式前后端分离微服务架构权限管理系统
Vue
45
31
MateChatMateChat
前端智能化场景解决方案UI库,轻松构建你的AI应用,我们将持续完善更新,欢迎你的使用与建议。 官网地址:https://matechat.gitcode.com
418
36
vue3-element-adminvue3-element-admin
🔥Vue3 + Vite6+ TypeScript + Element-Plus 构建的后台管理前端模板,配套接口文档和后端源码,vue-element-admin 的 Vue3 版本。
Vue
79
11
open-eBackupopen-eBackup
open-eBackup是一款开源备份软件,采用集群高扩展架构,通过应用备份通用框架、并行备份等技术,为主流数据库、虚拟化、文件系统、大数据等应用提供E2E的数据备份、恢复等能力,帮助用户实现关键数据高效保护。
HTML
90
65
Ffit-framework
FIT: 企业级AI开发框架,提供多语言函数引擎(FIT)、流式编排引擎(WaterFlow)及Java生态的LangChain替代方案(FEL)。原生/Spring双模运行,支持插件热插拔与智能聚散部署,无缝统一大模型与业务系统。
Java
113
13
CangjieCommunityCangjieCommunity
为仓颉编程语言开发者打造活跃、开放、高质量的社区环境
Markdown
901
0