Gema Ruby Tabler para Ruby on Rails.
Consulte o guia apropriado para o ambiente de sua escolha:
Ruby on Rails 4+ ou outro ambiente Sprockets.
Outros frameworks Ruby que não estão no Rails.
v0.1.4 MUDANÇA DE QUEBRA:
As imagens não são mais incluídas por padrão. Em vez disso, você pode incluir todos os conjuntos de imagens ou os conjuntos de imagens específicos desejados (navegador, bandeira e/ou pagamentos). Leia abaixo para obter mais informações sobre como fazer isso.
Adicione bootstrap
e tabler-rubygem
ao seu Gemfile:
gema 'bootstrap', '~> 4.1.1'gem 'tabler-rubygem'
Certifique-se de que sprockets-rails
sejam pelo menos v2.3.2.
bundle install
e reinicie seu servidor para disponibilizar os arquivos por meio do pipeline.
Importe estilos do Tabler e, opcionalmente, estilos e ícones do Tabler Plugin em app/assets/stylesheets/application.scss
:
// Variáveis personalizadas do tabler devem ser definidas ou importadas *antes* do bootstrap e do tabler.@import "tabler/variables";@import "bootstrap";@import "tabler";@import "tabler.plugins"; // opcional@import "tabler.icons"; // opcional inclui [navegador, bandeira, pagamentos]
As variáveis disponíveis podem ser encontradas aqui.
Os plug-ins do Tabler incluem os arquivos css para os javascripts encontrados aqui.
Você também pode optar por incluir o plugin css por plugin, por exemplo:
// Variáveis personalizadas do tabler devem ser definidas ou importadas *antes* tabler.@import "tabler/variables";@import "bootstrap";@import "tabler";@import "tabler/plugins/charts-c3/plugin.scss" ;
ou inclua ícones css por tipo, por exemplo:
// Variáveis personalizadas do tabler devem ser definidas ou importadas *antes* do tabler.@import "tabler/variables";@import "bootstrap";@import "tabler";@import "tabler/icons/flag";
Certifique-se de que o arquivo tenha extensão .scss
(ou .sass
para sintaxe Sass). Se você acabou de gerar um novo aplicativo Rails, ele pode vir com um arquivo .css
. Se este arquivo existir, ele será servido em vez de Sass, então renomeie-o:
$ mv app/assets/stylesheets/application.css app/assets/stylesheets/application.scss
Em seguida, remova todas as instruções *= require
e *= require_tree
do arquivo Sass. Em vez disso, use @import
para importar arquivos Sass.
Não use *= require
no Sass ou suas outras folhas de estilo não poderão acessar os mixins e variáveis do Tabler.
Adicione o Tabler e, opcionalmente, os plug-ins do Tabler ao seu application.js
:
//= requer tabler //= requer tabler.plugins
Tabler já inclui jQuery e Bootstrap javascript.
Os plug-ins do Tabler incluem os javascripts encontrados aqui.
Se você já inclui jQuery em seu projeto, você pode incluir js do tabler por arquivo para evitar conflitos:
// = requer tabler/tabler// = requer tabler/vendors/bootstrap.bundle.min// = requer tabler/vendors/circle-progress.min// = requer tabler/vendors/jquery.sparkline.min// = requer tabulador/núcleo
Você também pode optar por incluir o plugin js por plugin, por exemplo:
//= requer tabler //= requer tabler/plugins/charts-c3/js/d3.v3.min//= requer tabler/plugins/charts-c3/js/c3.min
Se o seu framework usa Sprockets ou Hanami, os ativos serão registrados no Sprockets quando a gem for necessária, e você poderá usá-los conforme a seção Rails do guia.
Caso contrário, poderá ser necessário registrar os ativos manualmente. Consulte a documentação da sua estrutura sobre o assunto.
Tabler requer o uso do Autoprefixer. O Autoprefixer adiciona prefixos de fornecedores às regras CSS usando valores de Can I Use.
Se você estiver usando tabler com Rails, o autoprefixer será configurado automaticamente. Caso contrário, consulte a documentação do Autoprefixer.
Por padrão, todo o Tabler é importado.
Você também pode importar componentes explicitamente. Para começar com uma lista completa de módulos, copie o arquivo _tabler.scss
em seus ativos como _tabler-custom.scss
. Em seguida, comente os componentes que você não deseja de _tabler-custom
. No arquivo Sass da aplicação, substitua @import 'tabler'
por:
@import 'tabler-custom';