README

基于 jQuery-maskMoney 插件的 Yii 框架 2.0 高级货币格式输入。该插件提供了一种简单的方式来创建货币表单字段的格式。yii2-money 扩展包括以下增强功能，以便有效地使用 maskMoney 插件

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

演示

您可以在这里看到关于扩展使用方法的详细文档。

最新版本

该扩展的最新版本是 v1.2.1。有关各个版本详细信息的变更日志。

安装

安装此扩展的首选方式是通过 composer。

注意：请检查此扩展的 composer.json 以了解其要求和依赖关系。阅读此网络提示/维基以设置您应用程序的 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）中默认。请注意，如以下示例中直接在 pluginOptions 中设置的属性将覆盖其他全局设置。

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

许可证

yii2-money 采用了 BSD 3-Clause 许可证发布。有关详细信息，请参阅附带LICENSE.md 文件。