ajtarragona / charts
Laravel frontend for ChartsJs Library
Requires
- php: >=7.0.0
- laravel/framework: ^6.0
README
Frontend package for the Charts generation library ChartsJs
Instalació
composer require ajtarragona/charts:"@dev"
Important!! Cada vegada que s'actualitzi el paquet, cal executar aquesta comanda per sobrescriure els assets (js i css)
php artisan ajtarragona:charts:assets
Configuració
Pots publicar l'arxiu de configuració del paquet amb la comanda:
php artisan vendor:publish --tag=ajtarragona-charts-config
Això copiarà l'arxiu a config/charts.php
.
Hi podries afegir més Paletes de colors.
Incloure els assets a la pantilla HTML
<!doctype html> <html lang="{{ app()->getLocale() }}"> <head> ... <link href="{{ asset('vendor/ajtarragona/css/charts.css') }}" rel="stylesheet"> </head> <body> ... <script src="{{ asset('vendor/ajtarragona/js/charts.js')}}" language="JavaScript"></script> </body> </html>
Incloure a la capçalera el token CSRF i la url base
<!doctype html> <html lang="{{ app()->getLocale() }}"> <head> ... <meta name="csrf-token" content="{{ csrf_token() }}"> <meta name="base-url" content="{{ url('') }}"> ...
Inicialitzar els charts
Podem inicialitzar tots els que hi hagi carregats:
<script language="JavaScript"> $('.chart-canvas').tgnChart(); </script>
O bé ho podem fer individualment a partir de l'ID:
<script language="JavaScript"> $('#demo-chart-1').tgnChart(); </script>
Ús
Podem crear gràfiques amb el component blade @chart
des de les nostres vistes.
Tenim dues opcions:
O bé passar una instància de BaseChart
i un array d'opcions:
@chart($chart, $opcions=[])
O bé fer un chart dinàmic. Passant un string amb tipus de gràfica, els datasets i un array d'opcions:
@chart($tipus, $datasets, $opcions=[])
Des de la teva aplicació, es pot accedir a una DEMO amb la ruta
ajtarragona/charts/samples
Podem deshabilitar la DEMO definint la variable
CHART_SAMPLES = false
a l'arxiu.env
de l'aplicació (recomanable fer-ho en producció)