ajtarragona/charts

Laravel frontend for ChartsJs Library

v0.0.10 2023-01-26 13:44 UTC

This package is auto-updated.

Last update: 2024-10-06 11:40:43 UTC


README

Frontend package for the Charts generation library ChartsJs

Latest Stable Version Total Downloads Latest Unstable Version License PHP Version Require

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=[])

Codi font d'exemples

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=[])

Codi font d'exemples

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ó)