README

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

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

演示

您可以在 这里 查看扩展的详细使用文档。

最新版本

该扩展的最新版本为 v1.2.1。有关各个版本详细信息的变更日志，请参考 CHANGE LOG。

安装

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

注意：请检查此扩展的 composer.json 文件，了解此扩展的要求和依赖。阅读此 web 提示 /wiki 了解如何在您的应用程序的 composer.json 中设置 minimum-stability 设置。

运行以下命令之一：

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

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

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

使用方法

全局设置

您可以在 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。