tabler rubygem

Таблер Рубиновый драгоценный камень

Tabler Ruby Gem для Ruby on Rails.

Установка

См. соответствующее руководство для выбранной вами среды:

• Ruby on Rails 4+ или другая среда Sprockets.

• Другие фреймворки Ruby, не поддерживающие Rails.

а. Рубин на рельсах

---

v0.1.4 СЕРЬЕЗНОЕ ИЗМЕНЕНИЕ:

Изображения больше не включаются по умолчанию. Вместо этого вы можете включить все наборы изображений или определенные наборы изображений, которые вам нужны (браузер, флаг и/или платежи). Подробную информацию о том, как это сделать, читайте ниже.

---

Добавьте bootstrap и tabler-rubygem в ваш Gemfile:

 драгоценный камень 'bootstrap', '~> 4.1.1' драгоценный камень 'tabler-rubygem'

Убедитесь, что sprockets-rails имеют версию не ниже 2.3.2.

bundle install и перезапустите сервер, чтобы файлы стали доступны через конвейер.

Импортируйте стили Tabler и, при необходимости, стили и значки плагинов Tabler в app/assets/stylesheets/application.scss :

 // Пользовательские переменные tabler должны быть установлены или импортированы *до* начальной загрузки и tabler.@import "tabler/variables";@import "bootstrap";@import "tabler";@import "tabler.plugins"; // необязательный@импорт "tabler.icons"; // необязательно включает [браузер, флаг, платежи]

Доступные переменные можно найти здесь.
Плагины Tabler включают CSS-файлы для JavaScript, найденные здесь.

Вы также можете включить CSS плагина отдельно для каждого плагина, например:

 // Пользовательские переменные tabler должны быть установлены или импортированы *перед* tabler.@import "tabler/variables";@import "bootstrap";@import "tabler";@import "tabler/plugins/charts-c3/plugin.scss" ;

или включите CSS-значки для каждого типа, например:

 // Пользовательские переменные tabler должны быть установлены или импортированы *перед* 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

Затем удалите все операторы *= require и *= require_tree из файла Sass. Вместо этого используйте @import для импорта файлов Sass.

Не используйте *= require в Sass, иначе ваши другие таблицы стилей не смогут получить доступ к миксинам и переменным Tabler.

Добавьте Tabler и, при необходимости, плагины Tabler в ваш application.js :

 //= требуется tabler//= требуется tabler.plugins

Tabler уже включает в себя jQuery и JavaScript Bootstrap.
Плагины Tabler включают в себя JavaScript, найденные здесь.

Если вы уже включили jQuery в свой проект, вы можете включить js tabler для каждого файла отдельно, чтобы избежать конфликтов:

 // = требуется 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

б. Другие фреймворки Ruby

Если ваша платформа использует Sprockets или Hanami, ресурсы будут зарегистрированы в Sprockets, когда драгоценный камень потребуется, и вы сможете использовать их в соответствии с разделом руководства Rails.

В противном случае вам может потребоваться зарегистрировать активы вручную. Обратитесь к документации вашего фреймворка по этому вопросу.

Конфигурация

Sass: автопрефиксер

Tabler требует использования Autoprefixer. Autoprefixer добавляет префиксы поставщиков к правилам CSS, используя значения из Can I Use.

Если вы используете tabler с Rails, автопрефиксер настраивается автоматически. В противном случае обратитесь к документации Autoprefixer.

Sass: отдельные компоненты

По умолчанию импортируется весь Tabler.

Вы также можете импортировать компоненты явно. Чтобы начать с полного списка модулей, скопируйте файл _tabler.scss в свои ресурсы как _tabler-custom.scss . Затем закомментируйте ненужные вам компоненты из _tabler-custom . В файле Sass приложения замените @import 'tabler' на:

 @import 'табличный-пользовательский';