Автоматическое форматирование номера телефона в текстовом поле

Вы можете автоматически форматировать номер телефона в текстовом поле вашего приложения, экономя время пользователей за счет форматирования номера телефона по мере ввода цифр. Следуйте этим инструкциям, чтобы автоматически отформатировать номер телефона:

• Создайте текстовое поле.
• Автоматическое форматирование числа в текстовом поле.

Совместимость версий

Для этой реализации требуется, чтобы для minSDK вашего проекта был установлен уровень API 21 или выше.

Зависимости

Создайте текстовое поле

Сначала настройте TextField . В этом примере показан номер телефона, отформатированный в соответствии с Североамериканским планом нумерации (NANP). NanpVisualTransformation форматирует необработанную строку чисел в NANP, например. 1234567890 по телефону (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)
    )
}
TextSnippets.kt

Ключевые моменты о коде

• Компонуемый TextField , в котором onValueChange использует регулярное выражение для удаления всех нечисловых символов и ограничивает длину максимум 10 символами перед обновлением состояния phoneNumber .
• TextField имеет собственный экземпляр VisualTransformation , установленный в атрибуте visualTransformation . NanpVisualTransformation , созданный здесь пользовательский класс, определяется в следующем разделе.

Автоматическое форматирование числа в текстовом поле

Чтобы отформатировать необработанную строку чисел, используйте реализацию пользовательского класса NanpVisualTransformation :

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
            }
    }
}
TextSnippets.kt

Ключевые моменты о коде

• Функция filter() вставляет нечисловые символы форматирования в соответствующие места.
• Объект phoneNumberOffsetTranslator содержит два метода. Один сопоставляет смещения между исходной строкой и отформатированной, а другой выполняет обратное сопоставление. Эти сопоставления позволяют пропускать символы форматирования, когда пользователь меняет положение курсора в текстовом поле.
• Отформатированная строка и phoneNumberOffsetTranslator используются в качестве аргументов для экземпляра TransformedText , который возвращается и используется TextField для выполнения форматирования.

Результаты

Коллекции, содержащие это руководство

Это руководство является частью тщательно подобранной коллекции быстрых руководств, охватывающих более широкие цели разработки Android:

Отображать текст

Текст — это центральная часть любого пользовательского интерфейса. Узнайте, как можно представить текст в своем приложении, чтобы обеспечить приятный пользовательский опыт.

Сборник кратких руководств

Запросить ввод пользователя

Узнайте, как реализовать способы взаимодействия пользователей с вашим приложением путем ввода текста и использования других средств ввода.

Сборник кратких руководств

Есть вопросы или отзывы

Перейдите на нашу страницу часто задаваемых вопросов и узнайте о кратких руководствах или свяжитесь с нами и сообщите нам свои мысли.

Перейти к часто задаваемым вопросам Оставить отзыв