README

A Laravel Nova 工具，用于柱状图指标和频率分布

此 Nova 工具允许您

• 创建柱状图
• 创建频率分布图（使用饼图和/或柱状图）

柱状图指标截图

频率分布指标截图（柱状图）

频率分布指标截图（饼图）

柱状图指标

对于柱状图指标，只需创建一个类似于为 Partition 指标创建的度量类。所有在 Partition 指标中可用的方法也都适用于 BarChartMetric！您只需像这样扩展 BarChartMetric 而不是扩展 Partition

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();
}

Partition 指标示例

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）。有关更多信息，请参阅许可文件。