Puoi formattare automaticamente un numero di telefono in un campo di testo della tua app, risparmiando tempo agli utenti perché il numero viene formattato man mano che inseriscono le cifre. Segui queste indicazioni per formattare automaticamente un numero di telefono:
- Crea il campo di testo.
- Formatta automaticamente un numero nel campo di testo.
Compatibilità delle versioni
Questa implementazione richiede che il valore minSDK del progetto sia impostato sul livello API 21 o superiore.
Dipendenze
Crea il campo di testo
Innanzitutto, configura TextField
. Questo esempio mostra un numero di telefono
formattato in base al piano di numerazione nordamericano
(NANP).NanpVisualTransformation
formatta una stringa non elaborata di numeri in NANP, ad es.
1234567890 al numero (123) 456-7890.
@Composable fun PhoneNumber() { var phoneNumber by rememberSaveable { mutableStateOf("") } val numericRegex = Regex("[^0-9]") TextField( value = phoneNumber, onValueChange = { // Remove non-numeric characters. val stripped = numericRegex.replace(it, "") phoneNumber = if (stripped.length >= 10) { stripped.substring(0..9) } else { stripped } }, label = { Text("Enter Phone Number") }, visualTransformation = NanpVisualTransformation(), keyboardOptions = KeyboardOptions(keyboardType = KeyboardType.Number) ) }
Punti chiave del codice
- Un composable
TextField
in cuionValueChange
utilizza un'espressione regolare per rimuovere tutti i caratteri non numerici e limita la lunghezza a un massimo di 10 caratteri prima di aggiornare lo statophoneNumber
. TextField
ha un'istanzaVisualTransformation
personalizzata impostata sull'attributovisualTransformation
.NanpVisualTransformation
, la classe personalizzata istanzata qui, è definita nella sezione seguente.
Formattare automaticamente un numero nel campo di testo
Per formattare una stringa non elaborata di numeri, utilizza l'implementazione della classe personalizzataNanpVisualTransformation
:
class NanpVisualTransformation : VisualTransformation { override fun filter(text: AnnotatedString): TransformedText { val trimmed = if (text.text.length >= 10) text.text.substring(0..9) else text.text var out = if (trimmed.isNotEmpty()) "(" else "" for (i in trimmed.indices) { if (i == 3) out += ") " if (i == 6) out += "-" out += trimmed[i] } return TransformedText(AnnotatedString(out), phoneNumberOffsetTranslator) } private val phoneNumberOffsetTranslator = object : OffsetMapping { override fun originalToTransformed(offset: Int): Int = when (offset) { 0 -> offset // Add 1 for opening parenthesis. in 1..3 -> offset + 1 // Add 3 for both parentheses and a space. in 4..6 -> offset + 3 // Add 4 for both parentheses, space, and hyphen. else -> offset + 4 } override fun transformedToOriginal(offset: Int): Int = when (offset) { 0 -> offset // Subtract 1 for opening parenthesis. in 1..5 -> offset - 1 // Subtract 3 for both parentheses and a space. in 6..10 -> offset - 3 // Subtract 4 for both parentheses, space, and hyphen. else -> offset - 4 } } }
Punti chiave del codice
- La funzione
filter()
inserisce i caratteri di formattazione non numerici nelle posizioni appropriate. - L'oggetto
phoneNumberOffsetTranslator
contiene due metodi. Uno mappa gli offset tra la stringa originale e quella formattata, mentre l'altro esegue la mappatura inversa. Queste mappature consentono di saltare i caratteri di formattazione quando l'utente modifica la posizione del cursore nel campo di testo. - La stringa formattata e
phoneNumberOffsetTranslator
vengono utilizzati come argomenti per un'istanzaTransformedText
restituita e utilizzata daTextField
per eseguire la formattazione.
Risultati
![Un numero di telefono con formattazione automatica nel campo di testo](https://developer.android.google.cn/static/quick-guides/content/nanp_formatter.gif?hl=it)
Raccolte che contengono questa guida
Questa guida fa parte di queste raccolte di guide rapide selezionate che coprono obiettivi di sviluppo Android più ampi:
![](https://developer.android.google.cn/static/images/quick-guides/collection-illustration.png?hl=it)
Testo visualizzato
![](https://developer.android.google.cn/static/images/quick-guides/collection-illustration.png?hl=it)