L'interfaccia utente del testo ricco utilizza semplici tag di marcatura per stilizzare sezioni di una stringa in grassetto, corsivo, sottolineato, colore di riempimento, variazioni di contorno e altro ancora. Puoi applicare i tag di stilizzazione agli oggetti TextLabel, TextButton e TextBox.
Abilitare il testo ricco
Devi abilitare il testo ricco caso per caso attraverso la sua proprietà RichText nella finestra Proprietà, oppure impostando la proprietà su true in un LocalScript.
Quando modifichi la proprietà Text di un oggetto in Studio, attivando la casella di controllo RichText nella finestra Proprietà viene visualizzata la stringa di testo come rendering finale. Questo è utile per identificare e correggere errori in qualsiasi tag supportato.
Localizzare un'esperienza per supportare altre lingue rimuove i tag di formattazione del testo ricco. Per garantire che la formattazione appaia in altre lingue, riapplica manualmente i tag alle tue stringhe localizzate.
Tag supportati
I tag di testo ricco sono simili ai tag XML/HTML e devi includere sia un tag di apertura che uno di chiusura attorno al testo formattato.
<b>Testo formattato</b>
Puoi anche annidare i tag all'interno l'uno dell'altro finché li chiudi nell'ordine inverso rispetto a quello in cui li hai aperti.
<b><i><u>Testo formattato</u></i></b>
Colore del font
<font color=""> </font>
Voglio la caramella <font color="#FF7800">arancione</font>.
Voglio la caramella <font color="rgb(255,125,0)">arancione</font>.
Dimensione del font
<font size=""> </font>
<font size="40">Questo è grande.</font> <font size="20">Questo è piccolo.</font>
Tipo di font
<font face=""> </font>
<font face="Michroma">Questo è il tipo di font Michroma.</font>
I nomi dei tipi di font/famiglie sono elencati nella pagina di riferimento dell'enumerazione Font.
Famiglia del font
<font family=""> </font>
<font family="rbxasset://fonts/families/Michroma.json">Questo è il tipo di font Michroma.</font>
I nomi dei tipi di font/famiglie sono elencati nella pagina di riferimento dell'enumerazione Font.
Peso del font
<font weight=""> </font>
Questo è normale. <font weight="heavy">Questo è pesante.</font>
Questo è normale. <font weight="900">Questo è pesante.</font>
Il peso del font può essere un nome di stringa non sensibile al maiuscolo/minuscolo, inclusi Thin, ExtraLight, Light, Regular, Medium, SemiBold, Bold, ExtraBold o Heavy; può anche essere un numero in fattori di 100 tra 100 e 900.
Trasparenza del font
<font transparency=""> </font>
Testo al <font transparency="0.5">50% di trasparenza</font>.
Contorno
<stroke> </stroke>
| Parametro | Proprietà equivalente | Valori di esempio |
|---|---|---|
| color | UIStroke.Color | "rgb(255,125,0)", "#FF7800" |
| thickness o th | UIStroke.Thickness | "1", "4", "0.5" |
| transparency o tr | UIStroke.Transparency | "0", "0.5", "1" |
| joins | UIStroke.LineJoinMode | "round", "bevel", "miter" |
| sizing | UIStroke.StrokeSizingMode | "fixed", "scaled" |
Hai vinto <stroke color="#00A2FF" thickness="2" transparency="0.25" joins="miter">25 gemme</stroke>.
Consulta le modifiche all'aspetto dell'UI per dettagli sui parametri del tag <stroke> come thickness e joins.
Grassetto
<b> </b>
Testo in <b>grassetto</b>.
Corsivo
<i> </i>
Testo <i>in corsivo</i>.
Sottolineato
<u> </u>
Testo <u>sottolineato</u>.
Barrato
<s> </s>
Testo con <s>barratura</s> applicata.
Interruzione di riga
<br/>
Una nuova riga si verifica dopo questa frase.<br/>Prossima frase...
Maiuscole
<uppercase> </uppercase>
<uc> </uc>
<uppercase>Maiuscole</uppercase> rende le parole più udibili!
<uc>Maiuscole</uc> rende le parole più udibili!
Piccole maiuscole
<smallcaps> </smallcaps>
<sc> </sc>
Il mio nome è <smallcaps>Diva Dragonslayer</smallcaps>.
Il mio nome è <sc>Diva Dragonslayer</sc>.
Evidenziare
<mark> </mark>
Testo <mark color="#009966" transparency="0">evidenziato</mark>.
Commento
<!-- -->
Dopo questo c'è un commento...<!--Questo non appare nel testo finale--> e ora altro testo...
Forme di escape
Se desideri rendere determinati caratteri come < o > e esentarli dalla considerazione come parte dei tag di testo ricco, puoi scriverli nella loro forma di escape.
| Carattere | Escape | Esempio | Risultato |
|---|---|---|---|
| < | < | 10 < 100 | 10 < 100 |
| > | > | 100 > 10 | 100 > 10 |
| " | " | Incontra "Diva Dragonslayer" | Incontra "Diva Dragonslayer" |
| ' | ' | Il pet di Diva' è un falco! | Il pet di Diva è un falco! |
| & | & | Rendi un'altra forma di escape <b>&lt;</b> sfuggendo un ampersand | Rendi un'altra forma di escape < sfuggendo un ampersand |