Buildit Gravity Particles
这是Buildit Gravity设计系统中使用的的设计令牌资产的“单源真理”。
通过NPM消费导出的设计令牌
各种格式的设计令牌的导出已作为一个NPM包发布: @buildit/gravity-particles
。
设置
将NPM包作为依赖项(或开发依赖项)添加到您的项目中
npm install --save @buildit/gravity-particles
用法:JavaScript / TypeScript
设计令牌可在JavaScript(Node.js)应用程序中使用。也已发布TypeScript类型声明。
在您的代码中,您可以使用以下方式 require
和使用令牌
const gravityParticles = require('@buildit/gravity-particles');
用法:SASS
设计快捷码也以SASS变量形式发布。
我们建议使用Eyeglass SASS来简化将这个库导入到您的SASS代码中的过程。按照Eyeglass的说明来将其与您的SASS编译选项集成。
设置完成后,您可以将它们导入到您的SASS代码中,如下所示
@import 'gravity-particles';
开发
设置
- 将此仓库克隆到您的计算机上
- 运行
npm install
以安装依赖项
恭喜,您已经准备好了!
提示:我们建议使用NVM以确保您拥有兼容的Node.js版本(>= 8.11.1)。
构建
要构建,并将快捷码导出为所有支持格式,请运行
npm run build
这将创建一个包含导出快捷码的dist/
目录。(它还将创建一个用于中间构建文件的.tmp/
目录)
清除
要删除任何之前的构建输出,请运行
npm run clean
在macOS上运行时,第一次构建会下载一些额外工具,并将它们放在.tmp-bin/
下。如果您愿意,可以通过运行:npm run clean-bin
来删除它们(例如,在下次构建时强制重新下载)。
它是如何工作的
设计快捷码以JSON文件形式表达在src/tokens/
下。我们使用亚马逊的Style Dictionary以不同格式导出它们。
配置和一些Style Dictionary自定义选项保存在build-scripts/
下。
最后,我们使用Gulp作为我们的任务运行器来运行Style Dictionary并执行构建所需的其它操作。