README

yii2-money

注意

自2018年1月起，此扩展已被 yii2-number 扩展取代。此扩展将不再进行增强或支持。建议您访问 yii2-number 扩展文档和示例以获取对Yii2的增强数字管理功能。

基于 jQuery-maskMoney 插件，为 Yii Framework 2 提供的先进货币掩码输入。该插件提供了一种简单的方法来创建货币表单字段的掩码。yii2-money 扩展包括以下增强功能，以有效地使用 maskMoney 插件

默认为 Bootstrap 3 的样式，并支持 Yii Active Field 验证
在字段加载时自动读取浮点数/小数并将其转换为货币格式
一旦掩码更改，自动将字段转换回浮点数/小数以保存（维护内部隐藏字段）
允许通过 Yii::$app->params 全局设置 mask money 插件选项

示例

您可以在此处找到有关该扩展使用方法的详细文档。

安装

安装此扩展的最佳方式是通过 composer。

注意：请检查此扩展的 composer.json 以获取扩展的要求和依赖关系。阅读此网络提示 /wiki 以设置应用程序 composer.json 中的 minimum-stability 设置。

运行以下命令之一：

$ php composer.phar require kartik-v/yii2-money "dev-master"

或

"kartik-v/yii2-money": "dev-master"

将以下内容添加到您的 composer.json 文件的 require 部分。

使用方法

全局设置

您可以在 Yii 配置文件的 params 部分中全局设置应用程序中货币格式的插件选项。您需要在 Yii 应用程序参数中设置 maskMoneyOptions。例如

'params' => [
    'maskMoneyOptions' => [
        'prefix' => 'US$ ',
        'suffix' => ' c',
        'affixesStay' => true,
        'thousands' => ',',
        'decimal' => '.',
        'precision' => 2, 
        'allowZero' => false,
        'allowNegative' => false,
    ]
]

格式化设置

如果您没有设置如上所示的参数，则插件将默认从配置文件中的 Yii::$app->formatter 设置中的 thousandSeparator 和 decimalSeparator。

'components' => [
    'formatter' => [
        'class' => 'yii\i18n\formatter',
        'thousandSeparator' => ',',
        'decimalSeparator' => '.',
    ]
]

MaskMoney

您可以根据以下示例配置小部件。任何未传递的插件选项将从上述两个部分（params 和 formatter）中默认设置。请注意，如以下示例中在 widget 级别直接设置的 pluginOptions 属性将覆盖其他全局设置。

use kartik\money\MaskMoney;
echo MaskMoney::widget([
    'name' => 'currency',
    'value' => 122423.18,
    'pluginOptions' => [
        'prefix' => '$ ',
    ],
]);

许可协议

yii2-money 根据 BSD 3-Clause 许可协议发布。有关详细信息，请参阅捆绑的 LICENSE.md。

kartik-v / yii2-money

维护者

详细信息