Animare l'aspetto del testo carattere per carattere

Puoi animare, carattere per carattere, l'aspetto del testo, in modo che sembri un effetto di digitazione in streaming, simile a quello prodotto da una macchina da scrivere.

Compatibilità delle versioni

Questa implementazione richiede che minSDK del progetto sia impostato sul livello API 21 o superiore.

Dipendenze

Animare il testo carattere per carattere

Questo codice anima il testo carattere per carattere. Traccia un indice per controllare la quantità di testo visualizzata. Il testo visualizzato viene aggiornato in modo dinamico per mostrare solo i caratteri fino all'indice corrente. Infine, la variabile esegue l'animazione quando cambia.

@Composable
private fun AnimatedText() {
    val text = "This text animates as though it is being typed \uD83E\uDDDE\u200D♀\uFE0F \uD83D\uDD10  \uD83D\uDC69\u200D❤\uFE0F\u200D\uD83D\uDC68 \uD83D\uDC74\uD83C\uDFFD"

    // Use BreakIterator as it correctly iterates over characters regardless of how they are
    // stored, for example, some emojis are made up of multiple characters.
    // You don't want to break up an emoji as it animates, so using BreakIterator will ensure
    // this is correctly handled!
    val breakIterator = remember(text) { BreakIterator.getCharacterInstance() }

    // Define how many milliseconds between each character should pause for. This will create the
    // illusion of an animation, as we delay the job after each character is iterated on.
    val typingDelayInMs = 50L

    var substringText by remember {
        mutableStateOf("")
    }
    LaunchedEffect(text) {
        // Initial start delay of the typing animation
        delay(1000)
        breakIterator.text = StringCharacterIterator(text)

        var nextIndex = breakIterator.next()
        // Iterate over the string, by index boundary
        while (nextIndex != BreakIterator.DONE) {
            substringText = text.subSequence(0, nextIndex).toString()
            // Go to the next logical character boundary
            nextIndex = breakIterator.next()
            delay(typingDelayInMs)
        }
    }
    Text(substringText)

Punti chiave del codice

  • BreakIterator esegue correttamente l'iterazione sui caratteri indipendentemente da come sono archiviati. Ad esempio, le emoji animate sono composte da più caratteri; BreakIterator garantisce che vengano gestite come un unico carattere, in modo che l'animazione non venga interrotta.
  • LaunchedEffect avvia una coroutine per introdurre il ritardo tra i caratteri. Puoi sostituire il blocco di codice con un listener di clic o qualsiasi altro evento per attivare l'animazione.
  • Il composable Text viene eseguito di nuovo ogni volta che il valore di substringText viene aggiornato.

Risultati

Figura 1. Testo ed emoji animati carattere per carattere.

Raccolte che contengono questa guida

Questa guida fa parte di queste raccolte selezionate di guide rapide che coprono obiettivi di sviluppo Android più ampi:

Il testo è un elemento centrale di qualsiasi UI. Scopri diversi modi per presentare il testo nella tua app e offrire un'esperienza utente piacevole.
Questa serie di video introduce varie API Compose, mostrandoti rapidamente cosa è disponibile e come utilizzarle.

Hai domande o feedback

Visita la nostra pagina delle domande frequenti, consulta le guide rapide o contattaci per farci sapere cosa ne pensi.