Formatter — ano ito, mga input formatter at NSFormatter

Ano ang Formatter sa iOS?

Formatter sa iOS ay isang component na nagko-convert ng raw user input sa isang structured format ayon sa isang tinukoy na template. Hindi tulad ng simpleng pag-validate pagkatapos ng pagsusumite ng form, ang formatter ay gumagana sa real-time, nagwawasto ng display ng data habang ito ay ipinapasok.

Ang iOS ay nagbibigay ng ilang antas ng pag-format: system Foundation formatters (NumberFormatter, DateFormatter, ByteCountFormatter) para sa display ng data, PhoneNumberKit framework para sa mga numero ng telepono, at third-party InputMask library para sa arbitrary input masks.

Ayon sa Apple Human Interface Guidelines, ang input formatters ay sumasagot ng tatlong gawain: nagbabawas ng cognitive load, nagbabawas ng bilang ng mga error, at nagpapabilis ng pagpuno ng form.

Ang mga formatter ay lalong mahalaga para sa mga mobile device, kung saan ang pag-input ng data gamit ang on-screen keyboard ay nangangailangan ng mas maraming pagsisikap kaysa sa pisikal.

Mga uri ng input formatter

Input formatters sa iOS ay nahahati sa tatlong kategorya: system Foundation formatters, specialized Apple formatters (PhoneNumberKit), at third-party library (InputMask, MaskedTextField).

System Foundation formatters

NumberFormatter ay nagfo-format ng numeric values. DateFormatter ay nagko-convert ng mga petsa at oras sa localized strings.

PhoneNumberKit

PhoneNumberKit — Apple library para sa pag-format ng mga numero ng telepono ayon sa pambansang pamantayan.

Input Mask library

Third-party library InputMask ay nagbibigay ng universal input masking mechanism para sa anumang format: card numbers (0000 0000 0000 0000), dates (MM.DD.YYYY), TIN (000000000).

Abstract class na NSFormatter

NSFormatter — ay isang abstract Foundation class na minamana ng lahat ng system iOS formatters. Ito ay tumutukoy ng dalawang pangunahing pamamaraan: string(for:) at getObjectValue(_:for:errorDescription:). Apple ay nagrerekomenda ng paggamit ng mga umiiral na Foundation formatters. NSFormatter ay sumusuporta din sa localization ng mga error message.

Input Mask at input masking

Input Mask — isang template na tumutukoy sa format ng input data at awtomatikong naglalagay ng mga separator habang nagta-type. Ang pinakasikat na library para sa iOS — InputMask mula sa RedMadRobot. Sinusuportahan nito ang kumplikadong mask na may mga kondisyon at opsyonal na bloke.

Pag-format ng mga numero ng telepono

Pag-format ng mga numero ng telepono — ang pinakakaraniwang sitwasyon ng paggamit ng formatter sa mobile apps. Ang iOS ay nagbibigay ng PhoneNumberKit framework para dito. Mula noong iOS 16, may built-in na mekanismo sa pamamagitan ng UIContentUnavailableConfiguration.

Pagpapatupad ng formatter sa Swift

Pagpapatupad ng formatter sa Swift ay depende sa napiling approach. Para sa system Foundation formatters, ginagamit ang formatter property na available mula noong iOS 15 para sa UITextField.

import PhoneNumberKit

class PhoneViewController: UIViewController {

    let phoneNumberKit = PhoneNumberKit()
    @IBOutlet var phoneField: UITextField!

    override func viewDidLoad() {
        super.viewDidLoad()
        phoneField.delegate = self
    }
}

extension PhoneViewController: UITextFieldDelegate {
    func textField(
        _ textField: UITextField,
        shouldChangeCharactersIn range: NSRange,
        replacementString string: String
    ) -> Bool {
        guard let text = textField.text else { return true }
        let partial = (text as NSString).replacingCharacters(in: range, with: string)
        textField.text = partial.applyPhoneMask()
        return false
    }
}

Para sa NumberFormatter mula noong iOS 15+, ang formatter property ay available sa UITextField, na awtomatikong nagfo-format ng input number habang nagta-type.

let amountField = UITextField()
let formatter = NumberFormatter()
formatter.numberStyle = .currency
formatter.locale = Locale(identifier: "ru_RU")
amountField.formatter = formatter

Para sa InputMask RedMadRobot, configuration ay ginagawa sa pamamagitan ng initialization ng mask at application sa pamamagitan ng delegate.

import InputMask

class CardViewController: UIViewController {
    @IBOutlet var cardField: UITextField!
    var listener: MaskedTextFieldDelegate!

    override func viewDidLoad() {
        super.viewDidLoad()
        listener = MaskedTextFieldDelegate(
            primaryMaskFormat: "[0000] [0000] [0000] [0000]"
        )
        cardField.delegate = listener
    }
}