用于 Ruby on Rails 的 Tabler ruby gem。
请参阅适合您选择的环境的指南:
Ruby on Rails 4+ 或其他 Sprockets 环境。
其他不在 Rails 上的 Ruby 框架。
v0.1.4 重大变更:
默认情况下不再包含图像。相反,您可以包含所有图像集或您想要的特定图像集(浏览器、标记和/或付款)。 请阅读下文,了解有关如何执行此操作的更多信息。
将bootstrap
和tabler-rubygem
添加到您的 Gemfile 中:
gem 'bootstrap', '~> 4.1.1'gem 'tabler-rubygem'
确保sprockets-rails
至少为 v2.3.2。
bundle install
并重新启动服务器以使文件可以通过管道使用。
在app/assets/stylesheets/application.scss
中导入 Tabler 样式和可选的 Tabler 插件样式和图标:
// 自定义 tabler 变量必须在 bootstrap 和 tabler *之前设置或导入。@import "tabler/variables";@import "bootstrap";@import "tabler";@import "tabler.plugins"; // 可选@import "tabler.icons"; // 可选包括[浏览器、标志、付款]
可用的变量可以在这里找到。
Tabler 插件包含此处找到的 javascript 的 css 文件。
您还可以选择在每个插件的基础上包含插件 css,例如:
// 自定义 tabler 变量必须在 *before* tabler.@import "tabler/variables";@import "bootstrap";@import "tabler";@import "tabler/plugins/charts-c3/plugin.scss" 设置或导入;
或者包含每种类型的图标 css,例如:
// 自定义 tabler 变量必须在 *before* tabler.@import "tabler/variables";@import "bootstrap";@import "tabler";@import "tabler/icons/flag";
确保文件具有.scss
扩展名(或.sass
用于 Sass 语法)。如果您刚刚生成了一个新的 Rails 应用程序,它可能会附带一个.css
文件。如果此文件存在,它将代替 Sass 提供服务,因此将其重命名:
$ mv app/assets/stylesheets/application.css app/assets/stylesheets/application.scss
然后,从 Sass 文件中删除所有*= require
和*= require_tree
语句。相反,使用@import
导入 Sass 文件。
不要在 Sass 中使用*= require
,否则你的其他样式表将无法访问 Tabler mixins 和变量。
将 Tabler 和可选的 Tabler 插件添加到您的application.js
中:
//= 需要 tabler //= 需要 tabler.plugins
Tabler 已经包含 jQuery 和 Bootstrap javascript。
Tabler 插件包含此处找到的 javascript。
如果您已经在项目中包含 jQuery,则可以在每个文件的基础上包含 tabler 的 js 以避免冲突:
// = 需要 tabler/tabler// = 需要 tabler/vendors/bootstrap.bundle.min // = 需要 tabler/vendors/circle-progress.min // = 需要 tabler/vendors/jquery.sparkline.min // = 需要表/核心
您还可以选择在每个插件的基础上包含插件 js,例如:
//= 需要 tabler//= 需要 tabler/plugins/charts-c3/js/d3.v3.min//= 需要 tabler/plugins/charts-c3/js/c3.min
如果您的框架使用 Sprockets 或 Hanami,则当需要 gem 时,资源将在 Sprockets 中注册,您可以按照指南的 Rails 部分使用它们。
否则您可能需要手动注册资产。请参阅有关该主题的框架文档。
Tabler 需要使用 Autoprefixer。 Autoprefixer 使用 Can I Use 中的值将供应商前缀添加到 CSS 规则中。
如果您将 tabler 与 Rails 一起使用,则会自动为您设置 autoprefixer。否则,请查阅 Autoprefixer 文档。
默认情况下,所有 Tabler 都会被导入。
您还可以显式导入组件。要从完整的模块列表开始,请将_tabler.scss
文件作为_tabler-custom.scss
复制到您的资产中。然后从_tabler-custom
中注释掉您不需要的组件。在应用程序 Sass 文件中,将@import 'tabler'
替换为:
@import 'tabler-custom';