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 |
Содержание
- Установка
- Использование
- Единицы измерения
- Лицензия
Установка
Команда для установки:
Использование
[!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 = null, \Closure|array|Options|string $data, ?Closure $formatted = null)
:
$column
- связь столбца в базе и атрибутаname
у поля ввода.$data
- Для создания поля типа Enum нужно передать название класса (например:App\Enums\Unit::class
). Для формирования поля типа Select нужно передать опции, как через методoptions()
поля Select.$formatted
- замыкание для форматирования значения поля в режиме preview.
unitDefault(mixed $default)
идентичен методу default(),
unitNullable()
идентичен методу nullable(),
unitSearchable()
идентичен методу searchable(),
Примеры использования:
Как это выглядит в административной панели: | Просмотр | Редактирование |
---|---|---|
![]() |
![]() |
Лицензия
Лицензия MIT.