Download the PHP package forest-lynx/moonshine-decimal-field without Composer
On this page you can find all versions of the php package forest-lynx/moonshine-decimal-field. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package moonshine-decimal-field
Поле Decimal для Moonshine
Documentation in English
Поле для работы с десятичными числами в административной панели MoonShine. Наследуется от поля Text. При редактировании к полю применяется маска @money Alpine.js
[!NOTE] Редактирование поля в режиме предварительного просмотра осуществляется через всплывающее окно, как это предусмотрено методом полей
updateInPopover()админ панели MoonShine.[!NOTE] Валидация для единиц измерения не поддерживается.
Совместимость
| Версия пакета | Версия админ-панели MoonShine |
|---|---|
| ^1.x | ^2.18.0 |
| ^2.x | ^3.x |
| ^3.x | ^4.x |
Содержание
- Установка
- Использование
- Единицы измерения
- Лицензия
Установка
Команда для установки:
Использование
[!NOTE] При формировании поля используется NumberFormatter php-intl. По умолчанию данные о локали берутся из настроек проекта, для ее переопределения используйте метод
locale()
Методы
locale(string $locale):
$locale- принимает строку с локалью, например: 'ru_RU' или 'ru'.
precision(int $precision, ?bool $isNaturalNumber):
$precisionпринимает число, количество знаков дробной части.$isNaturalNumberНе обязательный параметр, по умолчаниюfalse. Отвечает за обработку натуральных чисел, например если у вас в базе данных значения хранятся в виде целых чисел.naturalNumber(?int $precision = 2)$precisionпринимает число, количество знаков дробной части, по умолчанию 2.
Пример с натуральным числом, значение поля в базе данных = 12564. Предположим, что с учетом Ваших потребностей оно должно трансформироваться в 125.64:
[!CAUTION] Значения
$precisionв методахprecision(),naturalNumber()перезаписывает данные о количестве знаков дробной части, ранее определенных указанными методами. Например:Данный код переопределит значение количества знаков после запятой на 4.
[!NOTE] При работе с натуральными числами, со значением поля полученным из request перед сохранением происходит обратная трансформация.
Единицы измерения
Для указания поля, где хранятся единицы измерения:
Методы
unit(string $column, \Closure|array|Options|string $data, ?Closure $formatted = null):
$column- связь с полем в базе данных.$data- Для создания поля типа Enum нужно передать название класса (например:App\Enums\Unit::class). Для формирования поля типа Select нужно передать опции, как через методoptions()поля Select.$formatted- замыкание для форматирования значения поля в режиме preview.
unitDefault(mixed $default) идентичен методу default(),
unitNullable() идентичен методу nullable(),
unitSearchable() идентичен методу searchable(),
Примеры использования:
| Как это выглядит в административной панели: | Просмотр | Редактирование |
|---|---|---|
![]() |
![]() |
Лицензия
Лицензия MIT.

