Decoro：Android 文本输入自动格式化的利器

在开发 Android 应用时，处理用户输入的文本格式是一个常见的需求。无论是电话号码、信用卡号还是护照号码，都需要特定的格式来确保数据的正确性和易读性。为了简化这一过程，我们推荐一款强大的开源库——Decoro。

项目介绍

Decoro 是一个专为 Android 设计的库，旨在通过自定义规则自动格式化文本输入。它能够根据预定义的掩码（mask）或自定义掩码，自动调整用户输入的文本格式，从而减少开发者在处理文本格式化上的工作量。

项目技术分析

Decoro 的核心功能是通过掩码（mask）来控制文本的格式化。掩码由一系列槽（slot）组成，每个槽定义了输入字符的类型和格式。Decoro 提供了多种预定义的掩码，如俄罗斯电话号码、信用卡号码等，同时也支持开发者自定义掩码。

主要技术点：

1. 掩码（Mask）：定义文本的格式化规则。
2. 槽（Slot）：掩码的基本单元，定义了输入字符的类型和格式。
3. 格式化监听器（FormatWatcher）：实时监听文本输入，并根据掩码自动格式化。

项目及技术应用场景

Decoro 适用于多种需要格式化文本输入的场景，特别是在以下情况下：

• 电话号码输入：自动格式化电话号码，如俄罗斯电话号码格式 +7 (___) ___-__-__。
• 信用卡号码输入：自动格式化信用卡号码，如标准信用卡格式 ____ ____ ____ ____。
• 护照号码输入：自动格式化护照号码，如俄罗斯护照格式 ____ ______。
• 自定义格式输入：根据业务需求自定义文本格式，如日期格式、邮政编码等。

项目特点

1. 灵活性：支持预定义掩码和自定义掩码，满足不同场景的需求。
2. 易用性：通过简单的 API 即可实现文本的自动格式化，减少开发工作量。
3. 实时性：支持实时格式化，用户输入时即可看到格式化后的效果。
4. 开源：完全开源，开发者可以根据需求进行扩展和定制。

如何使用

安装

在项目的 build.gradle 文件中添加依赖：

dependencies {
    implementation 'ru.tinkoff.decoro:decoro:$latestVersion'
}

示例代码

示例 1：使用预定义掩码格式化电话号码

Mask mask = new MaskImpl(PredefinedSlots.RUS_PHONE_NUMBER, true);
mask.insertFront("9995554433");
System.out.println(mask.toString()); // [phone]

示例 2：使用自定义掩码格式化文本

Slot[] slots = new UnderscoreDigitSlotsParser().parseSlots("___ ___");
Mask mask = MaskImpl.createTerminated(slots);
mask.insertFront("9995554433");
System.out.println(mask.toString()); // 999 555

示例 3：实时格式化文本输入

MaskImpl mask = MaskImpl.createTerminated(PredefinedSlots.CARD_NUMBER_USUAL);
FormatWatcher watcher = new MaskFormatWatcher(mask);
watcher.installOn(editText); // 安装到任意 TextView

结语

Decoro 是一个功能强大且易于使用的 Android 库，能够显著简化文本输入的格式化工作。无论你是开发金融应用、社交应用还是其他类型的应用，Decoro 都能帮助你轻松处理文本格式化问题。赶快尝试一下吧！

项目地址