norgeit / nova-bar-metrics
A Laravel Nova 工具,用于柱状图指标和频率分布。
Requires
- php: >=7.1.0
README
此 Nova 工具允许您
- 创建柱状图
- 创建频率分布图(使用饼图和/或柱状图)
柱状图指标截图
频率分布指标截图(柱状图)
频率分布指标截图(饼图)
柱状图指标
对于柱状图指标,只需像通常为 Partition
指标创建度量类一样创建度量类。在 Partition
指标中可用的所有方法也都在 BarChartMetric
中可用!您不需要扩展 Partition
,只需像这样扩展 BarChartMetric
use Insenseanalytics\NovaBarMetrics\BarChartMetric; class BrandsPerCategory extends BarChartMetric { public function calculate(Request $request) { return $this->count($request, BrandCategory::class, 'category_name'); } }
您还可以像在 Laravel Nova 的 TrendMetric
中一样使用 suffix
、prefix
、dollars
和 euros
方法。此外,我们还有一个 precision
方法来设置显示在柱状图右上角的 avg
指标的精度。
柱状图指标和分区指标的频率分布
要创建频率分布图,可以扩展 BarChartMetric
类或扩展 Partition
类并使用特性 HasFrequencyDistributions
。您可以使用 distributions
辅助方法创建频率分布图,如下所示
BarChartMetric 的示例
use Insenseanalytics\NovaBarMetrics\BarChartMetric; class BrandFacebookFollowers extends BarChartMetric { public function calculate(Request $request) { return $this->distributions($request, Brand::class, 'facebook_followers', 100000); } }
在上面的示例中,100000 是用于频率分布范围的 步长大小
,facebook_followers 是用于按范围分配的 列
。
除了提供 步长大小
外,您还可以使用 distributionsWithSteps
方法提供最大步长数,该包将自动计算步长大小,如下所示
use Insenseanalytics\NovaBarMetrics\BarChartMetric; class BrandFacebookFollowers extends BarChartMetric { public function calculate(Request $request) { return $this->distributionsWithSteps($request, Brand::class, 'facebook_followers', 15); } }
对于友好的格式化范围(K 表示千,M 表示百万,B 表示十亿),您可以使用 withFormattedRangeLabels
方法,如下所示
public function calculate(Request $request) { return $this->distributions($request, Brand::class, 'facebook_followers', 100000) ->withFormattedRangeLabels(); }
分区指标的示例
use Laravel\Nova\Metrics\Partition; use Insenseanalytics\NovaBarMetrics\HasFrequencyDistributions; class BrandFacebookFollowers extends Partition { use HasFrequencyDistributions; public function calculate(Request $request) { return $this->distributions($request, Brand::class, 'facebook_followers', 100000); } }
需求 & 依赖
除了 Laravel Nova 包之外,没有 PHP 依赖。在前端 JS 中,此包使用 vue
、chartist
、chartist-plugin-tooltips
和 laravel-nova
,这些都是 Nova 本身使用的。
安装
您可以通过 composer 将此工具安装到使用 Nova 的 Laravel 应用中
composer require insenseanalytics/nova-bar-metrics
接下来,如果您没有启用包发现,您需要在 config/app.php
文件中注册提供者。
'providers' => [ ..., Insenseanalytics\NovaBarMetrics\NovaBarMetricsServiceProvider::class, ]
使用
您可以使用控制台命令 php artisan nova:barmetric <classname>
创建新的 BarMetric 类
贡献
欢迎贡献,只要您使用 PSR-2,解释您想要解决的问题/功能,并使用测试来支持您的代码,您的贡献将得到充分认可。祝您编码愉快!
许可
MIT 许可证(MIT)。有关更多信息,请参阅 许可文件