搜索分类、插件与代码仓

mask 封面
插件详情v1.0.5

mask

该项目旨在让您能够在项目中以简单便捷的方式进行验证和格式化

AndroidiOSWebmacOSWindowsLinux
近 30 天下载
177
喜欢数
35
Pub 分数
160

安装插件

flutter pub add mask

插件介绍

基于插件公开信息、社区数据与项目使用情况整理的选型参考。

该掩码包为 Flutter 应用程序中的用户输入提供了一种简单且高效的方式来应用格式化和验证。它支持文本字段的自动格式化,例如电话号码、CPF/CNPJ、日期和自定义模式,确保数据一致性。通过最少的设置,开发者可以跨多个平台在表单输入中增强实时掩码和验证逻辑。该包非常适合需要结构化输入的表单,既提升了可用性,又保证了数据完整性。

适合场景

  • 表单输入格式化
  • 电话号码遮蔽
  • CPF/CNPJ 验证
  • 日期和时间格式化
  • 自定义模式应用
  • 实时输入验证

主要特点

  • 与 TextFormField 的轻松集成
  • 支持多个预定义的掩码
  • 自定义遮罩创建
  • 跨平台兼容性
  • 实时输入处理
  • 轻量且高效

适合对象

  • 带有表单输入的 Flutter 应用
  • 需要数据验证的应用程序
  • 寻求简单掩码解决方案的开发者
  • 面向 Android、iOS、Web、macOS、Windows 和 Linux 的项目
  • 需要一致用户输入格式的应用程序

使用建议

  • 需要手动配置复杂模式
  • 内置掩码有限,仅限常见格式
  • 可能需要额外的验证逻辑来处理边缘情况
  • 不适用于非文本输入类型
  • 取决于TextController和onChanged的正确使用

原始 README

以下为关联源码仓库的 README 原文快照,最新内容请访问源码仓库。

Mask

- validations

  • Mask.validation.cpf
  • Mask.validation.cnpj
  • Mask.validation.cpfOrCnpj
  • Mask.validation.email
  • Mask.validation.money
  • Mask.validation.date
  • Mask.validation.dateTime
  • Mask.validation.time
  • Mask.validation.money
  • Mask.validation.phone
  • Mask.validation.generic

- Description

Validations are for you to be able to simply validate your field

- Masks

  • Mask.creditCard
  • Mask.cpf
  • Mask.cnpj
  • Mask.cpfOrCnpj
  • Mask.money
  • Mask.date
  • Mask.phone
  • Mask.generic

- Description

The masks are for you to be able to customize your field, according to that information

- Examples

// money mask and validation
TextFormField(
  autovalidateMode: AutovalidateMode.onUserInteraction,
  validator: (value) => Mask.validations.money(
    value, 
    min: 100.0, // optional field
  ),
  inputFormatters: [Mask.money()],
),

// cpf or cnpj mask and validation
TextFormField(
  validator: Mask.validations.cpfOrCnpj,
  inputFormatters: [Mask.cpfOrCnpj()],
),

// your custom mask and validation
TextFormField(
  validator: (value) => Mask.validations.generic(value, min:8, error: 'info erro'),
  inputFormatters: [
    Mask.generic(
      masks: ['##-##-##'], 
      hashtag: Hashtag.numbers, // optional field
    ),
  ),
)
screenshot - cpf validation example


Feito com ❤️ by Weliton Sousa

所属分类

源码仓库

使用此插件的项目