InputFilter: ano ito, interface ng InputFilter at pagsasala sa Android

Ano ang InputFilter at para saan ito?

InputFilter ay isang functional na interface mula sa package na android.text na tumutukoy sa isang pamamaraan na filter(CharSequence source, int start, int end, Spanned dest, int dstart, int dend). Ito ay awtomatikong tinatawag sa tuwing susubukan ng user na mag-input, mag-paste, o palitan ang teksto sa EditText. Ang ibinalik na halaga ay tumutukoy kung ang pagbabago ay tatanggapin, tatanggihan, o babaguhin.

Ang pangunahing layunin ng InputFilter ay pigilan ang maling input bago pumasok ang teksto sa field. Ang pamamaraang filter ay tumatanggap ng anim na parameter. Kung ang pamamaraan ay nagbalik ng null, ang pagbabago ay tinatanggap nang walang pagbabago. Kung nagbalik ng walang laman na string “”, ang pagbabago ay nahaharang. Ang InputFilter ay hindi nagbabago ng orihinal na pinagmulan ng data, tanging ibinabalik ang na-filter na bersyon.

Paano gumagana ang InputFilter

Halimbawa, kung susubukan ng user na magpasok ng titik “a” sa isang field kung saan ang mga numero lamang ang pinapayagan, ang filter ay nagbabalik ng “” at ang karakter ay hindi lumilitaw. Ang InputFilter ay hindi nagbabago ng orihinal na pinagmulan ng data, tanging ibinabalik ang na-filter na bersyon.

Karaniwang mga filter sa Android SDK

Ang Android SDK ay nagbibigay ng ilang built-in na implementasyon ng InputFilter. Ang pinakakaraniwan ay ang InputFilter.LengthFilter na naglilimita sa maximum na haba ng teksto. Ang InputFilter.AllCaps ay nagko-convert ng lahat ng inilagay na karakter sa malalaking titik.

Paggawa ng custom na InputFilter

Upang gumawa ng custom na filter, kailangan mong ipatupad ang InputFilter interface at i-override ang filter method. Ang halimbawa ng filter na DigitsInputFilter ay dumadaan sa lahat ng karakter ng inilagay na teksto at nagpapanatili lamang ng mga numero.

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
    }
}

Ang isa pang popular na senaryo ay ang filter na nagbabawal ng mga espesyal na karakter, ginagamit sa mga field ng username, paghahanap, at iba pang lugar kung saan hindi pinapayagan ang mga espesyal na karakter.

Paglalapat ng InputFilter sa EditText

Ang mga filter ay itinakda sa EditText sa pamamagitan ng pamamaraang setFilters(InputFilter[]). Ang array ng filter ay pumapalit sa kasalukuyang mga filter. Upang magdagdag ng filter sa mga umiiral na, kunin ang kasalukuyang mga filter sa pamamagitan ng getFilters(), gumawa ng bagong array, at itakda itong muli.

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

Sa halimbawa, dalawang filter ang itinakda: DigitsInputFilter (mga numero lamang) at LengthFilter (maximum na 10 karakter). Maaari ring itakda ang mga filter sa pamamagitan ng XML attribute na android:inputType.

InputFilter at pagpapatunay ng input

Ang InputFilter at TextWatcher ay may magkaibang function at madalas na ginagamit nang magkasama. Ang InputFilter ay gumagana sa antas ng input, ang TextWatcher ay gumagana pagkatapos ng input. Ang kumbinasyon ng parehong mga diskarte ay nagbibigay ng pinakamahusay na resulta.