输入掩码 < 单元格 < 产品特性

输入掩码是一串字符，它定义了用户期望的输入格式。屏蔽输入可减少数据出错的可能性，并有助于保持数据库的一致性，从而更容易分析和处理数据。您可以使用由模式、占位符、屏蔽字符等组成的用户生成规则来创建屏蔽。

SpreadJS 提供了一个掩码属性和一个模式选项来设置输入掩码。您可以使用占位符选项来指定占位符。占位符是显示在输入字段中的一串字符，代表预期的输入格式，引导用户按照格式进行输入。如果用户没有指定占位符，SpreadJS 默认使用“_”。您可以使用excludePlaceholder选项选择是否在输入字符串中显示占位符。

例如，如果屏蔽模式为“000000”，“_”为占位符，则空白输入字段显示“______”以指示所需的 6 位格式。如果 excludePlaceholder 选项设置为 false（默认值）并且用户输入“1234”，则在退出编辑模式后输入将保存为“1234____”。当该选项为真时，输入存储为“1234”，即排除占位符。

同样，您也可以通过将excludeLiteral设置为 true 来排除文字字符。文字是在特定位置显示的字符，不能被任何其他字符替换。电话号码中使用的括号和连字符或日期格式中的正斜杠就是几个例子。

以下代码显示了如何设置输入掩码：

如果用户在光标位于占位符处时输入字符，则新字符将替换占位符字符。在其他情况下，插入新字符。如果用户输入与模式不匹配，SpreadJS 会从左到右保留与模式匹配的部分，并丢弃剩余的无效部分。但是，当用户删除某些文本时，它只会删除当前的限制内容。例如，在模式 'a{3}0{3}' 的情况下，如果用户从输入的最左边的字符开始删除，SpreadJS 允许删除当前限制的前三个字符。要删除剩余的输入，用户必须将光标放在下一个限制的开头。

为了确认模式是否有效，SpreadJS 提供了一个静态方法validatePattern。以下代码显示了如何使用 validatePattern 方法来验证模式：

遮罩图案有两种类型：

字符串模式

日期模式

字符串模式是定义输入格式的最简单方法，它是使用最小模式单元构造的。最小模式单元由字符限制和可选的字符长度限制组成。当没有指定字符长度限制时，它被认为是一个字符。下表定义了使用这两种类型的限制创建模式的各种规则。

限制类型

分类

模式字符

解释

示例模式

显示('_’ as placeholder)

输入

输出

Character length

Letters

a

Letter

aaa

___

abc

abc

>

Letter auto-converted to uppercase

>

_

a

A

>