jQuery Mask插件：实现带固定前导零的电话号码输入掩码-js教程-PHP中文网

jQuery Mask插件：实现带固定前导零的电话号码输入掩码

聖光之護

发布： 2025-11-30 14:11:01

原创

351人浏览过

jQuery Mask插件：实现带固定前导零的电话号码输入掩码

本文详细介绍了如何使用jquery mask插件为电话号码输入框实现一个固定前导零的掩码。通过利用插件的`translation`选项，我们将覆盖默认的数字匹配行为，从而使前导零作为不可编辑的文字显示，确保用户始终看到并输入以“0”开头的电话号码，提升数据输入的规范性和用户体验。

在许多业务场景中，电话号码需要以特定的前缀（例如国家代码或地区代码）开头，并且这个前缀通常是固定的、不可由用户修改的。当使用jQuery Mask插件创建输入掩码时，如果直接在掩码字符串中使用数字（如0 (999) 999-9999），插件默认会将这些数字视为数字占位符（即允许用户输入0-9的任何数字）。这与我们希望“0”作为固定、不可编辑前缀的需求相悖。

理解jQuery Mask的默认行为

jQuery Mask插件在处理掩码字符串时，会将某些字符识别为占位符。例如，9通常代表任何数字（0-9），而0在默认情况下也常被视为数字占位符（/\d/）。因此，如果直接设置掩码为'0 (999) 999-9999'，用户将可以删除或修改开头的“0”，这不符合我们的预期。

核心解决方案：利用 translation 选项

要实现固定前导零，我们需要告诉jQuery Mask插件，掩码字符串中的“0”不应该被视为一个可编辑的数字占位符，而是一个字面量字符。这可以通过插件的 translation 选项来实现。

translation 选项允许我们自定义或覆盖掩码中特定字符的匹配规则。默认情况下，插件内部可能有一个类似'0': {pattern: /\d/}的规则，将“0”映射为匹配任何数字的正则表达式。我们的解决方案是移除或修改这个默认映射。

通过将'0': null添加到translation选项中，我们实际上是告诉插件：“当你在掩码字符串中遇到字符‘0’时，不要将其视为一个需要用户输入的占位符，而是将其作为一个固定的、不可编辑的字面量字符直接显示。”

实现步骤

下面将详细介绍如何通过引入必要的库、设置HTML结构和配置jQuery Mask插件来实现带有固定前导零的电话号码输入掩码。

1. 引入必要的库

首先，确保你的项目中已经引入了jQuery库和jQuery Mask插件。你可以通过CDN或本地文件引入它们。

BibiGPT-哔哔终结者

B站视频总结器-一键总结音视频内容

871

查看详情

<script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.3.1/jquery.min.js"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/jquery.mask/1.14.16/jquery.mask.min.js"></script>

登录后复制

2. HTML 结构

创建一个用于电话号码输入的文本框。为了方便通过jQuery选择器选中，我们可以为其添加一个类名，例如phone。

<div>
  <div class="col">
    <label>电话号码</label>
    <input type="text" class="phone" />
  </div>
</div>

登录后复制

3. jQuery Mask 配置

在文档加载完成后，使用jQuery选择器选中输入框，并应用mask方法。关键在于在第二个参数中传入一个配置对象，其中包含translation选项。

jQuery(function ($) {
  // 应用带有固定前导零的电话号码掩码
  $('.phone').mask('0 (999) 999-9999', {
    'translation': {
      // 将'0'字符的默认匹配行为设置为null，使其成为一个字面量字符
      0: null 
    }
  });
});

登录后复制

在上述代码中：

'0 (999) 999-9999' 是我们期望的掩码格式。
'translation': { 0: null } 是核心。它覆盖了插件对掩码字符串中“0”的默认处理方式。现在，掩码字符串中的第一个“0”将不再是等待用户输入的数字占位符，而是一个预设的、用户无法删除或修改的字面量字符。

完整示例代码

将上述HTML和JavaScript代码整合在一起，即可实现带有固定前导零的电话号码输入框。

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>jQuery Mask 固定前导零示例</title>
    <!-- 引入jQuery库 -->
    <script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.3.1/jquery.min.js"></script>
    <!-- 引入jQuery Mask插件 -->
    <script src="https://cdnjs.cloudflare.com/ajax/libs/jquery.mask/1.14.16/jquery.mask.min.js"></script>
    <style>
        body { font-family: Arial, sans-serif; margin: 20px; }
        label { display: block; margin-bottom: 5px; font-weight: bold; }
        input[type="text"] {
            padding: 8px;
            margin-bottom: 15px;
            border: 1px solid #ccc;
            border-radius: 4px;
            width: 200px;
        }
    </style>
</head>
<body>

    <h1>电话号码输入（固定前导零）</h1>

    <div>
        <label for="phoneNumberInput">请输入电话号码:</label>
        <input type="text" id="phoneNumberInput" class="phone" placeholder="0 (___) ___-____" />
    </div>

    <script>
        jQuery(function ($) {
            // 应用带有固定前导零的电话号码掩码
            $('.phone').mask('0 (999) 999-9999', {
                'translation': {
                    // 将'0'字符的默认匹配行为设置为null，使其成为一个字面量字符
                    0: null 
                }
            });
        });
    </script>

</body>
</html>

登录后复制

注意事项

库的引入顺序: 确保jQuery库在jQuery Mask插件之前引入，因为插件依赖于jQuery。
translation 的灵活性: translation 选项非常强大，你可以用它来定义任何自定义的占位符字符及其匹配规则。例如，如果你想让A代表任何字母，可以设置'translation': { A: {pattern: /[A-Za-z]/} }。
其他掩码字符: 除了0和9，jQuery Mask还支持其他占位符，如A（任何字母）、S（任何字母数字字符）、#（数字，可选）等。了解这些可以帮助你构建更复杂的掩码。
用户体验: 即使前导零是固定的，也建议在输入框的placeholder属性中提供一个清晰的示例，帮助用户理解输入格式。