kaïniklas/filament-gauge

filament-gauge 的量表图表

v0.2.0 2024-02-02 20:49 UTC

README

Latest Version on Packagist GitHub Tests Action Status GitHub Code Style Action Status Total Downloads

Filament Gauge

filament 的 SVG 量表。

安装

您可以通过 composer 安装此包

composer require kainiklas/filament-gauge

可选地,您可以使用以下方式发布视图

php artisan vendor:publish --tag="filament-gauge-views"

使用

您可以渲染介于 0100 之间的任何数值。数值将被四舍五入。如果数值超出这些范围,您可以使用 upperBound() 方法进行规范化,例如,介于 01 之间的值需要被 upperBound(1) 限制,介于 050 之间的值需要被 upperBound(50) 限制。

use Kainiklas\FilamentGauge\Enums\GaugeSize;
use Kainiklas\FilamentGauge\Tables\Columns\Gauge;

InlineGauge::make('number')
    // circle size (SM, MD, XL)
    // default: SM
    ->size(Size::MD) 

    // hides the number in the middle of the circle
    ->valueHidden() 

    // set an upper bound to calculate correct percentages
    // this should be the highest possible value
    // default: 100, which means values between 0 and 100
    // example: values between 0 and 1 -> set it to 1
    ->upperBound(1) 

自定义样式

您可以使用以下 CSS 钩子类来自定义组件样式

/* arc, representing the value */
.fi-inline-gauge-section-color {
    @apply text-primary-600
}
/* full circle (the background) */
.fi-inline-gauge-shape-color {
    @apply text-gray-300 dark:text-gray-700
}

变更日志

请参阅 CHANGELOG 了解最近更改的更多信息。

贡献

请参阅 CONTRIBUTING 了解详细信息。

安全漏洞

请查阅 我们的安全策略 了解如何报告安全漏洞。

致谢

许可协议

MIT 许可协议 (MIT)。请参阅 许可文件 了解更多信息。