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
Поле для работы с десятичными числами в административной панели MoonShine. Наследуется от поля Text. При редактировании к полю применяется маска @money Alpine.js
Содержание
- Установка
- Использование
- Единицы измерения
- Лицензия
Установка
Команда для установки:
Использование
[!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 $unit, string|array $data)
:
$unit
- название колонки в базе данных.$data
- массив с данными, или название класса перечисления с данными о единицах измерения.
unitDefault(mixed $default)
:
$default
- значение по умолчанию для поля.
Примеры использования:
Как это выглядит в административной панели: | Просмотр | Редактирование |
---|---|---|
Лицензия
Лицензия MIT.