Metric Value

# Make

Метрика ValueMetric предназначена для отображения какого-либо значения. Например, сколько всего записей в таблице.

Создать ValueMetric можно воспользовавшись статическим методом make().

make(Closure|string $label)

Метод value() позволяет указать значение для метрики.

value(int|string|float|Closure $value)
use MoonShine\Metrics\ValueMetric;
 
//...
 
public function components(): array
{
return [
ValueMetric::make('Completed orders')
->value(Order::completed()->count())
];
}
 
//...

# Прогресс

Метод progress() позволяет отобразить индикатор прогресса достижения цели в метрике.

progress(int|float|Closure $target)
use MoonShine\Metrics\ValueMetric;
 
//...
 
public function components(): array
{
return [
ValueMetric::make('Open tasks')
->value(Task::opened()->count())
->progress(Task::count())
];
}
 
//...

При использовании индикатора прогресса, методу value() необходимо передать числовое значение или замыкание, которое вернет число.

# Формат значения

Метод valueFormat() позволяет отформатировать значение метрики и добавить префикс и суффикс.

valueFormat(string|Closure $value)
use MoonShine\Metrics\ValueMetric;
 
//...
 
public function components(): array
{
return [
ValueMetric::make('Profit')
->value(Order::completed()->sum('price'))
->valueFormat(fn($value) => \Illuminate\Support\Number::forHumans($value))
];
}
 
//...

# Icon

Метод icon() позволяет добавить иконку к метрике.

use MoonShine\Metrics\ValueMetric;
 
//...
 
public function components(): array
{
return [
ValueMetric::make('Orders')
->value(Order::count())
->icon('heroicons.shopping-bag')
];
}
 
//...

За более подробной информацией обратитесь к разделу Icons .

# Ширина блока

Метод columnSpan() позволяет задать ширину блока в Grid сетке.

columnSpan(
int $columnSpan,
int $adaptiveColumnSpan = 12
)

$columnSpan - значение для десктопной версии,
$adaptiveColumnSpan - значение для мобильной версии.

use App\Models\Article;
use MoonShine\Decorations\Grid;
use MoonShine\Metrics\ValueMetric;
 
//...
 
public function components(): array
{
return [
Grid::make([
ValueMetric::make(Articles)
->value(Article::count())
->columnSpan(6),
ValueMetric::make( Comments)
->value(Comment::count())
->columnSpan(6)
])
];
}
 
//...

За более подробной информацией обратитесь к разделу Декорация Layout .