InputFilter: τι είναι, η διεπαφή InputFilter και φιλτράρισμα σε Android

Τι είναι το InputFilter και γιατί χρειάζεται;

InputFilter είναι μια λειτουργική διεπαφή από το πακέτο android.text που ορίζει μια μοναδική μέθοδο filter(CharSequence source, int start, int end, Spanned dest, int dstart, int dend). Καλείται αυτόματα κάθε φορά που ο χρήστης προσπαθεί να εισαγάγει, να επικολλήσει ή να αντικαταστήσει κείμενο στο EditText. Η τιμή που επιστρέφεται καθορίζει εάν η αλλαγή θα γίνει αποδεκτή, απορριπτεία ή τροποποιημένη.

Ο κύριος σκοπός του InputFilter είναι η πρόληψη λανθασμένης εισαγωγής πριν το κείμενο να φτάσει στο πεδίο. Η μέθοδος filter λαμβάνει έξι παραμέτρους. Εάν η μέθοδος επιστρέψει null, η αλλαγή γίνεται αποδεκτή χωρίς αλλαγές. Εάν επιστρέψει μια κενή συμβολοσειρά “”, η αλλαγή αποκλείεται. Το InputFilter δεν μεταβάλλει την αρχική πηγή δεδομένων, αλλά επιστρέφει μόνο τη φιλτραρισμένη έκδοση.

Πώς λειτουργεί το InputFilter

Για παράδειγμα, εάν ο χρήστης προσπαθήσει να εισαγάγει το γράμμα “a” σε ένα πεδίο όπου επιτρέπονται μόνο αριθμοί, το φίλτρο επιστρέφει “” και ο χαρακτήρας δεν εμφανίζεται. Το InputFilter δεν μεταβάλλει την αρχική πηγή δεδομένων, αλλά επιστρέφει μόνο τη φιλτραρισμένη έκδοση.

Τυπικά φίλτρα στο Android SDK

Το Android SDK παρέχει πολλάπλες ενσωματωμένες υλοποιήσεις του InputFilter. Το πιο κοινό είναι το InputFilter.LengthFilter που περιορίζει το μέγιστο μήκος κειμένου. Το InputFilter.AllCaps μετατρέπει όλους τους εισαγόμενους χαρακτήρες σε κεφαλαία.

Δημιουργία προσαρμοσμένου InputFilter

Για να δημιουργήσετε ένα προσαρμοσμένο φίλτρο, πρέπει να υλοποιήσετε τη διεπαφή InputFilter και να παρακάμψετε τη μέθοδο filter. Το παράδειγμα φίλτρου DigitsInputFilter διανύει όλους τους χαρακτήρες και κρατά μόνο τους αριθμούς.

class DigitsInputFilter : InputFilter {
    override fun filter(
        source: CharSequence?,
        start: Int,
        end: Int,
        dest: Spanned?,
        dstart: Int,
        dend: Int
    ): CharSequence? {
        val sb = StringBuilder()
        for (i in start until end) {
            val c = source?.get(i)
            if (c != null && Character.isDigit(c)) {
                sb.append(c)
            }
        }
        return if (sb.length == end - start) null else sb
    }
}

Ένα άλλο δημοφιλές σενάριο είναι το φίλτρο που απαγορεύει ειδικούς χαρακτήρες.

Εφαρμογή InputFilter σε EditText

Τα φίλτρα ορίζονται στο EditText μέσω της μεθόδου setFilters(InputFilter[]). Ο πίνακας φιλτρων αντικαθιστά τα τρέχοντα φίλτρα.

val editText = findViewById<EditText>(R.id.phone_input)
editText.filters = arrayOf(
    DigitsInputFilter(),
    InputFilter.LengthFilter(10)
)

Στο παράδειγμα, δύο φίλτρα ορίζονται: DigitsInputFilter (μόνο αριθμοί) και LengthFilter (μέγιστο 10 χαρακτήρες). Τα φίλτρα μπορούν να οριστούν και μέσω της XML ιδιότητας android:inputType.

InputFilter και επαλήθευση εισαγωγής

Το InputFilter και το TextWatcher έχουν διαφορετικές λειτουργίες και συχνά χρησιμοποιούνται μαζί. Το InputFilter λειτουργεί σε επίπεδο εισαγωγής, το TextWatcher λειτουργεί μετά την εισαγωγή.