Laravel ChartJS 使用指南
2025-05-20 16:50:03作者:盛欣凯Ernestine
1. 项目介绍
Laravel ChartJS 是一个基于 Chart.js 的 Laravel 包装器,用于简化在 Laravel 应用程序中使用图表的过程。Chart.js 是一个功能强大的、基于 JavaScript 的图表库,它提供了多种图表类型,如折线图、柱状图、饼图等。
2. 项目快速启动
首先,确保您的 Laravel 环境满足以下要求:
- Laravel 版本 9 或更高版本。
- Node.js 和 npm 用于编译前端资源。
安装
通过 Composer 安装 Laravel ChartJS:
composer require icehouse-ventures/laravel-chartjs
对于 Laravel 8 及以下版本,需要在 config/app.php
文件中注册服务提供者:
'providers' => [
// ...
IcehouseVentures\LaravelChartjs\Providers\ChartjsServiceProvider::class,
]
发布配置文件以便自定义设置(如 Chart.js 版本和文件交付方式):
php artisan vendor:publish --provider="IcehouseVentures\LaravelChartjs\Providers\ChartjsServiceProvider" --tag="config"
安装 Chart.js
Laravel ChartJS 提供了多种安装 Chart.js 的方式:
- CDN:快速开发测试时,可以将配置文件中的
delivery
方法设置为'CDN'
,这样会通过外部内容分发网络加载指定的 Chart.js 文件。 - Publish:若不使用 JavaScript 包管理器,可以发布预编译的 Chart.js 文件到应用程序的公共文件夹。
- Binary:在特定情况下,可以选择直接从应用程序内部加载二进制文件,但不推荐这种方式。
- NPM:最佳实践是使用 NPM、Laravel Mix 或 Vite 将 Chart.js 包含在 JavaScript/CSS 打包流程中。
发布 Chart.js 资源文件的示例命令:
# 发布 Chart.js 版本 4 资源文件
php artisan vendor:publish --provider="IcehouseVentures\LaravelChartjs\Providers\ChartjsServiceProvider" --force --tag="assets"
# 发布 Chart.js 版本 3 资源文件
php artisan vendor:publish --provider="IcehouseVentures\LaravelChartjs\Providers\ChartjsServiceProvider" --force --tag="assets-v3"
# 发布 Chart.js 版本 2 资源文件
php artisan vendor:publish --provider="IcehouseVentures\LaravelChartjs\Providers\ChartjsServiceProvider" --force --tag="assets-v2"
使用
在控制器或路由中,使用 ChartJS Facade 创建图表:
use IcehouseVentures\LaravelChartjs\Facades\Chartjs;
$chart = Chartjs::build()
->name('myChart')
->type('line')
->size(600, 400)
->labels(['Label 1', 'Label 2', 'Label 3'])
->datasets([
[
'label' => 'Dataset 1',
'data' => [10, 20, 30],
'borderColor' => 'red',
'fill' => false,
],
])
->options([
'scales' => [
'x' => [
'title' => [
'display' => true,
'text' => 'X轴标题',
],
],
],
]);
在 Blade 视图中,显示图表:
<canvas id="{{ $chart->name }}" width="{{ $chart->width }}" height="{{ $chart->height }}"></canvas>
@push('scripts')
<script src="{{ asset('path/to/chart.js') }}"></script>
<script>
new Chart(document.getElementById('{{ $chart->name }}'), {{ $chart->datasets|json }});
</script>
@endpush
3. 应用案例和最佳实践
- 在数据分析仪表板中使用折线图和柱状图展示实时数据。
- 在报告页面中使用饼图展示百分比分布。
- 使用配置选项
optionsRaw
方法添加高级 Chart.js 配置。
4. 典型生态项目
- Laravel: 提供基础框架。
- Chart.js: 用于渲染图表的 JavaScript 库。
- Node.js 和 npm:用于编译和打包前端资源。
- Laravel Mix 或 Vite:用于优化前端资源和提高开发效率。
登录后查看全文
热门项目推荐
GLM-4.6
GLM-4.6在GLM-4.5基础上全面升级:200K超长上下文窗口支持复杂任务,代码性能大幅提升,前端页面生成更优。推理能力增强且支持工具调用,智能体表现更出色,写作风格更贴合人类偏好。八项公开基准测试显示其全面超越GLM-4.5,比肩DeepSeek-V3.1-Terminus等国内外领先模型。【此简介由AI生成】Jinja00- DDeepSeek-V3.2-ExpDeepSeek-V3.2-Exp是DeepSeek推出的实验性模型,基于V3.1-Terminus架构,创新引入DeepSeek Sparse Attention稀疏注意力机制,在保持模型输出质量的同时,大幅提升长文本场景下的训练与推理效率。该模型在MMLU-Pro、GPQA-Diamond等多领域公开基准测试中表现与V3.1-Terminus相当,支持HuggingFace、SGLang、vLLM等多种本地运行方式,开源内核设计便于研究,采用MIT许可证。【此简介由AI生成】Python00
openPangu-Ultra-MoE-718B-V1.1
昇腾原生的开源盘古 Ultra-MoE-718B-V1.1 语言模型Python00ops-transformer
本项目是CANN提供的transformer类大模型算子库,实现网络在NPU上加速计算。C++0117AI内容魔方
AI内容专区,汇集全球AI开源项目,集结模块、可组合的内容,致力于分享、交流。02Spark-Chemistry-X1-13B
科大讯飞星火化学-X1-13B (iFLYTEK Spark Chemistry-X1-13B) 是一款专为化学领域优化的大语言模型。它由星火-X1 (Spark-X1) 基础模型微调而来,在化学知识问答、分子性质预测、化学名称转换和科学推理方面展现出强大的能力,同时保持了强大的通用语言理解与生成能力。Python00GOT-OCR-2.0-hf
阶跃星辰StepFun推出的GOT-OCR-2.0-hf是一款强大的多语言OCR开源模型,支持从普通文档到复杂场景的文字识别。它能精准处理表格、图表、数学公式、几何图形甚至乐谱等特殊内容,输出结果可通过第三方工具渲染成多种格式。模型支持1024×1024高分辨率输入,具备多页批量处理、动态分块识别和交互式区域选择等创新功能,用户可通过坐标或颜色指定识别区域。基于Apache 2.0协议开源,提供Hugging Face演示和完整代码,适用于学术研究到工业应用的广泛场景,为OCR领域带来突破性解决方案。00- HHowToCook程序员在家做饭方法指南。Programmer's guide about how to cook at home (Chinese only).Dockerfile011
- PpathwayPathway is an open framework for high-throughput and low-latency real-time data processing.Python00
热门内容推荐
1 freeCodeCamp全栈开发课程中React组件导出方式的衔接问题分析2 freeCodeCamp课程视频测验中的Tab键导航问题解析3 freeCodeCamp课程中屏幕放大器知识点优化分析4 freeCodeCamp课程页面空白问题的技术分析与解决方案5 freeCodeCamp Cafe Menu项目中link元素的void特性解析6 freeCodeCamp 课程中关于角色与职责描述的语法优化建议 7 freeCodeCamp全栈开发课程中测验游戏项目的参数顺序问题解析8 freeCodeCamp全栈开发课程中React实验项目的分类修正9 freeCodeCamp猫照片应用教程中的HTML注释测试问题分析10 freeCodeCamp博客页面工作坊中的断言方法优化建议
项目优选
收起

deepin linux kernel
C
22
6

OpenHarmony documentation | OpenHarmony开发者文档
Dockerfile
224
2.26 K

暂无简介
Dart
526
116

React Native鸿蒙化仓库
JavaScript
210
286

Nop Platform 2.0是基于可逆计算理论实现的采用面向语言编程范式的新一代低代码开发平台,包含基于全新原理从零开始研发的GraphQL引擎、ORM引擎、工作流引擎、报表引擎、规则引擎、批处理引引擎等完整设计。nop-entropy是它的后端部分,采用java语言实现,可选择集成Spring框架或者Quarkus框架。中小企业可以免费商用
Java
9
1

openvela 操作系统专为 AIoT 领域量身定制。服务框架:主要包含蓝牙、电话、图形、多媒体、应用框架、安全、系统服务框架。
CMake
795
12

🎉 (RuoYi)官方仓库 基于SpringBoot,Spring Security,JWT,Vue3 & Vite、Element Plus 的前后端分离权限管理系统
Vue
984
582

Ascend Extension for PyTorch
Python
67
97

本项目是CANN提供的数学类基础计算算子库,实现网络在NPU上加速计算。
C++
567
94

GLM-4.6在GLM-4.5基础上全面升级:200K超长上下文窗口支持复杂任务,代码性能大幅提升,前端页面生成更优。推理能力增强且支持工具调用,智能体表现更出色,写作风格更贴合人类偏好。八项公开基准测试显示其全面超越GLM-4.5,比肩DeepSeek-V3.1-Terminus等国内外领先模型。【此简介由AI生成】
Jinja
42
0