利用 jQuery 和 this 关键字实现输入字段的实时货币格式化

新闻中心 NEWS CENTER

您当前位置：首页 > 新闻中心 > 网络学院

利用 jQuery 和 this 关键字实现输入字段的实时货币格式化

2025-10-20

浏览次数：次

返回列表

利用 jQuery 和 this 关键字实现输入字段的实时货币格式化

本教程详细介绍了如何使用 jquery 和 j*ascript 的 intl.numberformat api，为具有特定 css 类（如 currency）的多个输入字段实现实时货币格式化功能。通过监听 keyup 事件并巧妙运用 this 关键字，确保用户在任意输入框键入时，系统能精确地格式化并更新当前操作的输入字段，提升用户体验。文章包含完整的代码示例和实现步骤。

1. 概述与挑战

在开发前端表单时，我们经常会遇到需要用户输入货币金额的场景。为了提升用户体验，实时地将用户输入的数字格式化为标准的货币形式（例如，将 "10000" 格式化为 "Rp 10.000"）是十分常见的需求。当页面上存在多个这样的输入字段，并且它们共享相同的格式化逻辑（例如，都具有 currency 类）时，如何确保在用户键入时，只有当前正在操作的输入字段被正确格式化并更新，而不会影响到其他字段，就成为了一个核心挑战。

核心挑战点在于：

事件识别： 精确识别哪个输入字段触发了输入事件。
实时响应： 在用户键入（keyup）时即时进行格式化。
数据清理： 将包含非数字字符的原始输入值转换为纯数字进行处理。
精确回填： 将格式化后的货币字符串准确回填到触发事件的那个输入字段。

2. 核心解决方案：事件监听与 this 上下文

解决上述问题的关键在于利用 J*aScript 事件处理机制中的 this 关键字。在事件处理函数内部，this 通常指向触发该事件的 DOM 元素。结合 jQuery 强大的选择器和事件绑定能力，我们可以为所有具有特定类名的元素统一绑定事件，然后在事件处理函数中通过 $(this) 来获取并操作当前触发事件的 jQuery 对象。

3. 实现步骤与代码示例

我们将通过以下几个部分来构建完整的实时货币格式化解决方案。

3.1 HTML 结构

首先，定义我们的输入字段。为了能够统一管理和绑定事件，这些字段应共享一个共同的类名，例如 currency。同时，我们需要引入 jQuery 库，它是我们后续 J*aScript 代码的基础。

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>实时货币格式化教程</title>
    <!-- 引入 jQuery 库 -->
    <script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.3.1/jquery.min.js"></script>
    <style>
        body { font-family: Arial, sans-serif; margin: 20px; }
        input { padding: 8px; margin-bottom: 10px; border: 1px solid #ccc; border-radius: 4px; width: 200px; }
        label { display: inline-block; width: 80px; vertical-align: top; margin-top: 8px;}
    </style>
</head>
<body>

    <h1>实时货币输入字段格式化</h1>
    <p>请在以下输入框中尝试输入数字，观察其如何实时格式化为印尼盾。</p>

    <label for="nilai1">金额 1:</label>
    <input class="form-textbox number-only currency" type="text" id="nilai1" required/>
    <br>
    <label for="nilai2">金额 2:</label>
    <input class="form-textbox number-only currency" type="text" id="nilai2" required/>

    <!-- J*aScript 代码将放在这里 -->

</body>
</html>

3.2 货币格式化函数

创建一个独立的 J*aScript 函数，用于将纯数字格式化为指定地区的货币形式。这里我们使用 Intl.NumberFormat API，它提供了强大的国际化数字格式化能力。

AI Surge Cloud

低代码数据分析平台，帮助企业快速交付深度数据

87 查看详情 AI Surge Cloud

/**
 * 将数字格式化为印尼盾货币形式。
 * @param {number} nominal - 需要格式化的数字。
 * @returns {string} 格式化后的货币字符串。
 */
function formatRupiah(nominal) {
    // 使用 'id-ID' locale 进行印尼盾格式化，不显示小数位
    return new Intl.NumberFormat('id-ID', {
        style: 'currency',      // 表示格式化为货币
        currency: 'IDR',        // 指定货币代码为印尼盾 (Indonesian Rupiah)
        minimumFractionDigits: 0 // 最少显示小数位数为 0
    }).format(nominal);
}

此函数接收一个数字 nominal，并返回一个格式化后的字符串，例如 Rp 10.000。

3.3 实时格式化与回填逻辑

接下来，我们将利用 jQuery 的 keyup 事件监听器，结合 formatRupiah 函数，实现输入字段的实时格式化和回填。

// 绑定 keyup 事件到所有 class 为 .currency 的输入字段
$('.currency').keyup(function() {
    // 1. 获取当前输入字段的原始值 (this.value)
    // 2. 使用正则表达式清理原始值，只保留数字 (0-9) 和小数点 (.)
    //    这样可以确保 parseFloat 能够正确解析，同时允许用户输入小数
    var rawValue = this.value.replace(/[^0-9.]/g, '');

    // 3. 将清理后的字符串转换为浮点数
    var numericValue = parseFloat(rawValue);

    // 4. 检查转换后的值是否是一个有效的数字
    if (!isNaN(numericValue)) {
        // 5. 如果是有效数字，则使用 formatRupiah 函数进行格式化
        var formattedValue = formatRupiah(numericValue);
        // 6. 将格式化后的值回填到当前触发事件的输入字段
        //    $(this) 将原生 DOM 元素 'this' 包装成 jQuery 对象，然后使用 .val() 方法设置其值
        $(this).val(formattedValue);
    } else {
        // 7. 如果输入无效（例如，用户输入了非数字字符且无法解析），则清空当前输入字段
        $(this).val('');
    }
});

代码解析：

$('.currency').keyup(function(){ ... });：这行代码选中所有 class 为 currency 的输入字段，并为它们绑定了一个 keyup 事件监听器。这意味着每当用户在这些输入框中释放一个按键时，括号内的匿名函数就会执行。
this.value.replace(/[^0-9.]/g, '')：this.value 获取当前输入字段的原始值。replace(/[^0-9.]/g, '') 是一个正则表达式，用于移除所有不是数字 (0-9) 或小数点 (.) 的字符。这一步至关重要，它将原始输入清理成一个纯数字或带小数点的数字字符串，以便 parseFloat 正确解析。
parseFloat(rawValue)：将清理后的字符串转换为浮点数。
!isNaN(numericValue)：检查 numericValue 是否是一个有效的数字。isNaN (Is Not a Number) 函数用于判断一个值是否为非数字。
formatRupiah(numericValue)：调用我们之前定义的货币格式化函数。
$(this).val(formattedValue)：这是实现精确回填的关键。$(this) 将当前的 DOM 元素 (this) 包装成一个 jQuery 对象，然后 .val(formattedValue) 方法用于设置该输入字段的值。这样就实现了对当前操作字段的精确更新。
$(this).val('')：如果输入内容无法解析为有效数字，则清空当前输入字段，提供清晰的用户反馈。

4. 完整代码示例

将所有代码片段组合在一起，形成一个完整的 HTML 文件，可以直接在浏览器中运行：

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>实时货币格式化教程</title>
    <!-- 引入 jQuery 库 -->
    <script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.3.1/jquery.min.js"></script>
    <style>
        body { font-family: Arial, sans-serif; margin: 20px; }
        input { padding: 8px; margin-bottom: 10px; border: 1px solid #ccc; border-radius: 4px; width: 200px; }
        label { display: inline-block; width: 80px; vertical-align: top; margin-top: 8px;}
    </style>
</head>
<body>

    <h1>实时货币输入字段格式化</h1>
    <p>请在以下输入框中尝试输入数字，观察其如何实时格式化为印尼盾。</p>

    <label for="nilai1">金额 1:</label>
    <input class="form-textbox number-only currency" type="text" id="nilai1" required/>
    <br>
    <label for="nilai2">金额 2:</label>
    <input class="form-textbox number-only currency" type="text" id="nilai2" required/>

    <script>
        /**
         * 将数字格式化为印尼盾货币形式。
         * @param {number} nominal - 需要格式化的数字。
         * @returns {string} 格式化后的货币字符串。
         */
        function formatRupiah(nominal) {
            return new Intl.NumberFormat('id-ID', {
                style: 'currency',
                currency: 'IDR',
                minimumFractionDigits: 0
            }).format(nominal);
        }

        // 绑定 keyup 事件到所有 class 为 .currency 的输入字段
        $('.currency').keyup(function() {
            // 获取当前输入字段的值，并清理掉非数字字符（保留小数点）
            var rawValue = this.value.replace(/[^0-9.]/g, '');
            var numericValue = parseFloat(rawValue);

            if (!isNaN(numericValue)) {
                var formattedValue = formatRupiah(numericValue);
                // 更新当前输入字段的值
                $(this).val(formattedValue);
            } else {
                // 如果输入无效，则清空输入字段
                $(this).val('');
            }
        });
    </script>

</body>
</html>