datalogix/laravel-charts

Laravel charts 是一个简化图表使用的包。

v0.1.2 2022-08-15 15:28 UTC

This package is auto-updated.

Last update: 2024-09-15 19:41:37 UTC


README

Latest Stable Version Total Downloads tests StyleCI codecov License

Laravel charts 是一个简化图表使用的包。

特性

  • 自动注册图表
  • 自定义图表的路由、中间件和前缀
  • 创建新图表的命令 php artisan make:chart ChartName

安装

您可以通过 composer 安装此包

composer require datalogix/laravel-charts

该包将自动注册自己。

配置

默认设置在 config/charts.php 中。将此文件复制到您的配置目录以修改值。您可以使用以下命令发布配置

php artisan vendor:publish --provider="Datalogix\Charts\ChartsServiceProvider" --tag="config"

命令

您可以使用 laravel artisan 的典型 make 命令开始创建图表。

php artisan make:chart SampleChart

这将创建位于 App\Charts 命名空间下的 SampleChart 类。

渲染图表

Laravel charts 可以在 PHP 端不进行任何渲染。这意味着它可以作为一个 API 端点使用。无需修改配置文件或图表即可实现这一点。

然而,如果您不打算开发前端作为 SPA 或在另一个应用程序中,并且可以使用 laravel Blade 语法,那么您可以使用 @chart 助手来创建图表。

@chart blade 助手接受一个包含图表名称的字符串来获取其 URL。以下示例可以作为指南

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>Charts example</title>
  </head>
  <body>
    <!-- Chart container -->
    <div id="chart" style="height: 300px;"></div>
    <!-- Chart library -->
    <script src="https://unpkg.com/echarts/dist/echarts.min.js"></script>
    <!-- Chartisan -->
    <script src="https://unpkg.com/@chartisan/echarts/dist/chartisan_echarts.js"></script>
    <!-- Your application script -->
    <script>
      const chart = new Chartisan({
        el: '#chart',
        url: "@chart('sample_chart')",
      });
    </script>
  </body>
</html>