Rich Text

The text for UI elements and text meshes can incorporate multiple font styles and sizes. The Text, GUIStyle, and TextMesh classes have a Rich Text setting which instructs Unity to look for markup tags within the text. The Debug.Log function can also use these markup tags to enhance error reports from code. The tags are not displayed but indicate style changes to be applied to the text.

Markup format

El sistema de marcado está inspirado por HTML pero no está intencionado en ser estrictamente compatible con HTML estándar. La idea básica es que una sección del texto puede ser encerrado a dentro de un par de etiquetas de marcado:-

We are <b>not</b> amused.

As the example shows, the tags are just pieces of text inside the “angle bracket” characters, < and >.

You place the opening tag at the beginning of the section. The text inside the tag denotes its name (which in this case is just b).

You place another tag at the end of the section. This is the closing tag. It has the same name as the opening tag, but the name is prefixed with a slash / character. Every opening tag must have a corresponding closing tag. If you don’t close an opening tag, it is rendered as regular text.

The tags are not displayed to the user directly but are interpreted as instructions for styling the text they enclose. The b tag used in the example above applies boldface to the word “not”, so the text appears ons creen as:-

We are not amused

Una sección marcada de texto (incluyendo las etiquetas que la encierran) es referida como un element.

Nested elements

Es posible aplicar más de un estilo a una sección de texto al “nesting” un elemento adentro de otro

We are <b><i>definitely not</i></b> amused

The <i> tag applies italic style, so this would be presented onscreen as

We are definitely not amused

Note the ordering of the closing tags, which is in reverse to that of the opening tags. The reason for this is perhaps clearer when you consider that the inner tags need not span the whole text of the outermost element

We are <b>absolutely <i>definitely</i> not</b> amused

que da

We are absolutely definitely not amused

Tag parameters

Algunas etiquetas tienen un efecto simple de todo-o-nada en el texto pero otras podrían permitir variaciones. Por ejemplo, la etiqueta color necesita saber qué color aplicar. Información como esta es agregada a las etiquetas mediante el uso de parameters:-

We are <color=green>green</color> with envy

Which produces this result:

Tenga en cuenta que la etiqueta de finalización no incluye el valor del parámetro. Opcionalmente, el valor puede ser rodeado por signos de interrogación pero esto no es requerido.

Tag parameters cannot include blank spaces. For example:

We are <color = green>green</color> with envy

does not work because of the spaces to either side of the = character.

Supported tags

La siguiente lista describe todas las etiquetas de estilo soportadas por Unity.

Tag	Description	Example	Notes
b	Renderiza el texto en negrilla.	We are <b>not</b> amused.
i	Renderiza el texto en itálico.	We are <i>usually</i> not amused.
size	Establece el tamaño del texto de acuerdo al valor del parámetro, dado en píxeles.	We are <size=50>largely</size> unaffected.	Aunque esta etiqueta está disponible para debug.log, usted encontrará que el interlineado en la barra de la ventana y la consola tienen un aspecto extraño, si el tamaño es demasiado grande.
color	Sets the color of the text according to the parameter value. The color can be specified in the traditional HTML format. #rrggbbaa …where the letters correspond to pairs of hexadecimal digits denoting the red, green, blue and alpha (transparency) values for the color. For example, cyan at full opacity would be specified by color=#00ffffff… You can specify hexadecimal values in uppercase or lowercase; #FF0000 is equivalent to #ff0000.	We are <color=#ff0000ff>colorfully</color> amused	Another option is to use the name of the color. This is easier to understand but naturally, the range of colors is limited and full opacity is always assumed. <color=cyan>some text</color> The available color names are given in the table below.
material	Esto es solamente útil para meshes de texto y renderiza una sección del texto con un material especificado por el parámetro. El valor es un índice a la matriz del mesh de texto de los materias como es mostrado por el inspector.	We are <material=2>texturally</material> amused
quad	Esto es solamente útil para meshes de texto y renderiza una imagen enlinea con texto. Toma parámetros que especifican el material a usar para la imagen, la altura de la imagen en píxeles, y otros cuatro que denotan un área rectangular de la imagen para mostrar. A diferencia de las otras etiquetas, quad no rodea una parte del texto y por lo tanto no hay ninguna etiqueta final - el carácter de barra se coloca al final de la etiqueta inicial para indicar que se trata de “cierre automático”.	<quad material=1 size=20 x=0.1 y=0.1 width=0.5 height=0.5>	Esto selecciona el material en posición en la matriz del material renderizado y establece la altura de la imagen a 20 píxeles. El área rectangular de imagen comienza en los valores dados x,y, del ancho y altura, que son todos dados como un fracción de la anchura sin escala, y la altura de la textura.

Supported colors

The following table lists colors for which you can use a name instead of a hexadecimal tag in the <color> rich text tag.

Nombre del Color	Valor Hex	Swatch
aqua (el mismo que el cian(cyan))	#00ffffff
negro	#000000ff
azul	#0000ffff
marrón	#a52a2aff
cian(cyan) (el mismo que el aqua)	#00ffffff
azul oscuro	#0000a0ff
fucsia(fuchsia) (el mismo que magenta)	#ff00ffff
verde	#008000ff
gris	#808080ff
azul claro	#add8e6ff
limón	#00ff00ff
magenta (el mismo que fuchsia)	#ff00ffff
granate	#800000ff
azul marino	#000080ff
oliva	#808000ff
naranja	#ffa500ff
morado	#800080ff
rojo	#ff0000ff
plateado	#c0c0c0ff
verde azulado	#008080ff
blanco	#ffffffff
amarillo	#ffff00ff

Editor GUI

Rich text is disabled by default in the editor GUI system but it can be enabled explicitly using a custom GUIStyle. The richText property should be set to true and the style passed to the GUI function in question:

GUIStyle style = new GUIStyle ();
style.richText = true;
GUILayout.Label("<size=30>Some <color=yellow>RICH</color> text</size>",style)