패키지 상세v2.3.2

currency_text_input_formatter

Flutter용 통화 텍스트 입력 포맷터입니다. Flutter 앱에서 쉽게 간단하게 사용하세요.

AndroidiOSWebmacOSWindowsLinux

pub.dev API 문서 소스 코드

30일 다운로드: 12.1만
좋아요: 293
Pub 점수: 160

패키지 설치

flutter pub add currency_text_input_formatter

패키지 개요

공개 정보를 바탕으로 생성한 선택 가이드입니다.

텍스트 입력을 통화 형식으로 포맷하는 플러터 패키지로, 자동으로 기호, 구분자 및 소수점을 추가합니다. 사용자가 입력할 때 일관된 형식을 보장함으로써 텍스트 필드에서 금액 값을 처리하는 것을 간소화합니다. 금융 데이터 입력이 필요한 폼에 이상적이며, 모바일, 웹, 데스크톱 등 여러 플랫폼을 지원합니다. 포매터는 쉽게 통합할 수 있으며 실시간 시각 피드백을 제공하여 사용자 경험을 향상시킵니다.

사용 사례

금융 앱 폼 입력
전자상거래 가격 입력
지출 추적 애플리케이션
청구 및 청구 시스템
사용자 프로필 재무 정보
결제 게이트웨이 통합

주요 기능

실시간 통화 형식 지정
사용자 정의 통화 기호 지원
자동 소수 및 천 단위 구분 기호
크로스 플랫폼 호환성
TextField와의 간단한 통합
사용자 정의 소수점 자릿수

적합한 대상

금융 관련 앱을 개발하는 개발자
서식이 지정된 통화 입력이 필요한 앱
일관된 숫자 형식이 필요한 프로젝트
사용자 입력 사용성 우선 고려 팀
간단한 포메터를 찾는 플러터 초보자

고려 사항

경계 사례에 대한 추가 검증이 필요할 수 있습니다
사용자 지정 옵션은 기본 형식 지정에만 제한됨
환율 변환을 처리하지 않음
추가 로직 없이 다화폐 환경에는 적합하지 않습니다
고주파 업데이트에서 성능에 미치는 영향은 미미하지만 존재함

원본 README

연결된 소스 저장소의 README 원문 스냅샷입니다. 최신 내용은 저장소에서 확인하세요.

Currency Text Input Formatter

Currency Text Input Formatter for Flutter. https://pub.dev/packages/currency_text_input_formatter

Installation

Solving Intl package conflict

Add this code end of pubspec.yaml.

dependency_overrides:
  intl: your intl package version

Usage

Basic

import 'package:currency_text_input_formatter/currency_text_input_formatter.dart';
import 'package:flutter/material.dart';

void main() => runApp(MyApp());

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Welcome to Flutter',
      home: Scaffold(
        appBar: AppBar(
          title: Text('Welcome to Flutter'),
        ),
        body: Center(
          child: TextField(
            inputFormatters: [CurrencyTextInputFormatter.currency()],
            // inputFormatters: [CurrencyTextInputFormatter.simpleCurrency()], < for simple
            // inputFormatters: [CurrencyTextInputFormatter()], < for basic
            keyboardType: TextInputType.number,
          ),
        ),
      ),
    );
  }
}

With initialValue

import 'package:currency_text_input_formatter/currency_text_input_formatter.dart';
import 'package:flutter/material.dart';

void main() => runApp(MyApp());

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Welcome to Flutter',
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Welcome to Flutter'),
        ),
        body: Center(
          child: MyFormField(),
        ),
      ),
    );
  }
}

class MyFormField extends StatefulWidget {
  const MyFormField({ super.key });

  @override
  State<MyFormField> createState() => _MyFormFieldState();
}

class _MyFormFieldState extends State<MyFormField> {
  final CurrencyTextInputFormatter _formatter = CurrencyTextInputFormatter.currency();

  @override
  Widget build(BuildContext context) {
    return TextFormField(
      initialValue: _formatter.formatString('2000'),
      inputFormatters: <TextInputFormatter>[_formatter],
      keyboardType: TextInputType.number,
    );
  }
}

Custom Options

import 'package:currency_text_input_formatter/currency_text_input_formatter.dart';
import 'package:flutter/material.dart';

void main() => runApp(MyApp());

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Welcome to Flutter',
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Welcome to Flutter'),
        ),
        body: Center(
          child: TextField(
            inputFormatters: <TextInputFormatter>[
              CurrencyTextInputFormatter.currency(
                locale: 'ko',
                decimalDigits: 0,
                symbol: 'KRW(원) ',
              ),
            ],
            keyboardType: TextInputType.number,
          ),
        ),
      ),
    );
  }
}

With built-in methods

import 'package:currency_text_input_formatter/currency_text_input_formatter.dart';
import 'package:flutter/material.dart';

void main() => runApp(MyApp());

class MyApp extends StatelessWidget {

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Welcome to Flutter',
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Welcome to Flutter'),
        ),
        body: Center(
          child: MyFormField(),
        ),
      ),
    );
  }
}

class MyFormField extends StatefulWidget {
  const MyFormField({ super.key });

  @override
  State<MyFormField> createState() => _MyFormFieldState();
}

class _MyFormFieldState extends State<MyFormField> {
  final CurrencyTextInputFormatter _formatter = CurrencyTextInputFormatter.currency();

  @override
  Widget build(BuildContext context) {
    // Built-in Methods
    print(_formatter.getFormattedValue()); // $ 2,000
    print(_formatter.getUnformattedValue()); // 2000.00
    print(_formatter.formatString('2000')); // $ 2,000
    print(_formatter.formatDouble(20.00)); // $ 20

    return TextFormField(
      inputFormatters: <TextInputFormatter>[_formatter],
      keyboardType: TextInputType.number,
    );
  }
}