tabler rubygem

Gemme rubis de table

Gemme rubis Tabler pour Ruby on Rails.

Installation

Veuillez consulter le guide approprié pour l'environnement de votre choix :

• Ruby on Rails 4+ ou autre environnement Sprockets.

• Autres frameworks Ruby non sur Rails.

un. Rubis sur Rails

---

v0.1.4 CHANGEMENT DE RUPTURE :

Les images ne sont plus incluses par défaut. Au lieu de cela, vous pouvez inclure tous les ensembles d'images ou les ensembles d'images spécifiques de votre choix (navigateur, indicateur et/ou paiements). Lisez ci-dessous pour plus d’informations sur la façon de procéder.

---

Ajoutez bootstrap et tabler-rubygem à votre Gemfile :

 gem 'bootstrap', '~> 4.1.1'gem 'tabler-rubygem'

Assurez-vous que sprockets-rails sont au moins v2.3.2.

bundle install et redémarrez votre serveur pour rendre les fichiers disponibles via le pipeline.

Importez les styles Tabler et éventuellement les styles et icônes du plug-in Tabler dans app/assets/stylesheets/application.scss :

 // Les variables de table personnalisées doivent être définies ou importées *avant* bootstrap et tabler.@import "tabler/variables";@import "bootstrap";@import "tabler";@import "tabler.plugins"; // optionnel@import "tabler.icons" ; // facultatif inclut [navigateur, indicateur, paiements]

Les variables disponibles peuvent être trouvées ici.
Les plugins Tabler incluent les fichiers CSS pour les javascripts trouvés ici.

Vous pouvez également choisir d’inclure le CSS du plugin pour chaque plugin, par exemple :

 // Les variables de table personnalisées doivent être définies ou importées *avant* tabler.@import "tabler/variables";@import "bootstrap";@import "tabler";@import "tabler/plugins/charts-c3/plugin.scss" ;

ou incluez des icônes CSS par type, par exemple :

 // Les variables de table personnalisées doivent être définies ou importées *avant* tabler.@import "tabler/variables";@import "bootstrap";@import "tabler";@import "tabler/icons/flag";

Assurez-vous que le fichier a l'extension .scss (ou .sass pour la syntaxe Sass). Si vous venez de générer une nouvelle application Rails, elle peut être accompagnée d'un fichier .css . Si ce fichier existe, il sera servi à la place de Sass, alors renommez-le :

 $ mv app/assets/stylesheets/application.css app/assets/stylesheets/application.scss

Ensuite, supprimez toutes les instructions *= require et *= require_tree du fichier Sass. Utilisez plutôt @import pour importer des fichiers Sass.

N'utilisez pas *= require dans Sass ou vos autres feuilles de style ne pourront pas accéder aux mixins et variables de Tabler.

Ajoutez Tabler et éventuellement des plugins Tabler à votre application.js :

 //= nécessite un tabler//= nécessite un tabler.plugins

Tabler inclut déjà le javascript jQuery et Bootstrap.
Les plugins Tabler incluent les javascripts trouvés ici.

Si vous incluez déjà jQuery dans votre projet, vous pouvez inclure les js de tabler fichier par fichier pour éviter les conflits :

 // = require tabler/tabler// = require tabler/vendors/bootstrap.bundle.min// = require tabler/vendors/circle-progress.min// = require tabler/vendors/jquery.sparkline.min// = require tableur/noyau

Vous pouvez également choisir d'inclure le plugin js pour chaque plugin, par exemple :

 //= nécessite un tabler//= nécessite un tabler/plugins/charts-c3/js/d3.v3.min//= nécessite un tabler/plugins/charts-c3/js/c3.min

b. Autres frameworks Ruby

Si votre framework utilise Sprockets ou Hanami, les actifs seront enregistrés auprès de Sprockets lorsque la gemme est requise, et vous pourrez les utiliser conformément à la section Rails du guide.

Sinon, vous devrez peut-être enregistrer les actifs manuellement. Reportez-vous à la documentation de votre framework sur le sujet.

Configuration

Sass : préfixeur automatique

Tabler nécessite l'utilisation d'Autoprefixer. Autoprefixer ajoute des préfixes de fournisseur aux règles CSS en utilisant les valeurs de Can I Use.

Si vous utilisez tabler avec Rails, le préfixe automatique est automatiquement configuré pour vous. Sinon, veuillez consulter la documentation d'Autoprefixer.

Sass : composants individuels

Par défaut, tout Tabler est importé.

Vous pouvez également importer des composants explicitement. Pour commencer avec une liste complète des modules, copiez le fichier _tabler.scss dans vos actifs sous le nom _tabler-custom.scss . Ensuite, commentez les composants que vous ne voulez pas de _tabler-custom . Dans le fichier Sass de l'application, remplacez @import 'tabler' par :

 @import 'tabler-custom';