text-overflow

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

La propiedad de CSS text-overflow determina como el contenido que se desborda y que no es mostrado, va a hacérsele notar a los usuarios. Puede ser cortado, mostrar una elipsis ('…', U+2026 Horizontal Ellipsis), o mostrar una cadena de texto personalizada.

Pruébalo

La propiedad text-overflow no fuerza a que ocurra un desbordamiento. Para hacer que un texto desborde a su contenedor debes poner algunas otras propiedades de CSS. Por ejemplo:

css

overflow: hidden;
white-space: nowrap;

La propiedad text-overflow solo afecta al contenido que está rebasando un elemento de contenedor en bloque en su dirección de progresión inline (no así, a un texto que rebase por el bottom del contenedor, por).

Sintaxis

La propiedad text-overflow ha de ser especificada usando uno o dos valores. Si se define solo un valor, este determinará el comportamiento del overflow para el final de la línea (el extremo derecho en un texto izquierda-a-derecha o el extremo izquierdo en un texto derecha-a-izquierda). Si se definen dos valores, el primero hará referencia al comportamiento overflow para para el extremo izquierdo y el segundo al extremo derecho de la línea.

Cada valor se especificará como una de las siguientes opciones:

Una palabra clave: clip, ellipsis, fade
La función fade(), que recibe <length> o <percentage> para controlar la distancia de desvanecimiento
Un <string>.

Valores

clip

Este es el valor predeterminado para esta propiedad. El valor de la palabra clave truncará el texto en el límite del área de contenido, por lo tanto el corte puede darse en medio de una palabra. Para recortar justo en la transición entre caracteres se puede especificar con text-overflow como una cadena vacía, si eso es compatible con sus navegadores: text-overflow: '';.

ellipsis

El valor de la palabra clave mostrará puntos suspensivos ('…', U+2026 Horizontal Ellipsis) para representar texto recortado. Los puntos suspensivos se muestran dentro del área de contenido, disminuyendo la cantidad de texto mostrado. Si no hay suficiente espacio para mostrar los puntos suspensivos, se recorta.

<string> Experimental

El <string> que será utilizado para representar texto recortado. La cadena se muestra dentro del área de contenido, disminuyendo el tamaño del texto mostrado. Si no hay suficiente espacio para mostrar la cadena, se recorta.

fade Experimental

El valor de esta palabra clave recorta el contenido en línea del texto que se desborda y aplica un efecto de atenuación cerca del borde de la linea de la caja con total transparencia en el borde.

fade( <length> | <percentage> ) Experimental

Esta función recorta el contenido desbordante en línea y aplica un efecto de atenuación cerca del límite de la caja con total transparencia en el borde.

El argumento determina la distancia sobre la que se aplica el efecto de atenuación. El <percentage> se revuelve contra la anchura de la línea de la caja. Los valore menores que 0 se truncan a 0. Los valores mayores que el ancho de la caja se recortan al ancho de la caja.

Formal syntax

text-overflow = 
  clip      |
  ellipsis

Examples

CSS

css

p {
  width: 200px;
  border: 1px solid;
  padding: 2px 5px;

  /* BOTH of the following are required for text-overflow */
  white-space: nowrap;
  overflow: hidden;
}

.overflow-visible {
  white-space: initial;
}

.overflow-clip {
  text-overflow: clip;
}

.overflow-ellipsis {
  text-overflow: ellipsis;
}

.overflow-string {
  /* Not supported in most browsers,
     see the 'Browser compatibility' section below */
  text-overflow: " [..]";
}

HTML

html

<p class="overflow-visible">
  Lorem ipsum dolor sit amet, consectetur adipisicing elit.
</p>
<p class="overflow-clip">
  Lorem ipsum dolor sit amet, consectetur adipisicing elit.
</p>
<p class="overflow-ellipsis">
  Lorem ipsum dolor sit amet, consectetur adipisicing elit.
</p>
<p class="overflow-string">
  Lorem ipsum dolor sit amet, consectetur adipisicing elit.
</p>

Result

CSS value	`direction: ltr`	`direction: rtl`
visible overflow	1234567890	1234567890	0987654321	1234567890
`text-overflow: clip`		123456		1234567890
`text-overflow: ''`	12345	123456	54321	1234567890
`text-overflow: ellipsis`	1234…	1234567890	…4321	1234567890
`text-overflow: '.'`	1234.	1234567890	.4321	1234567890
`text-overflow: clip clip`	123456	1234567890	654321	1234567890
`text-overflow: clip ellipsis`	1234…	1234567890	6543…	1234567890
`text-overflow: clip '.'`	1234.	1234567890	6543.	1234567890
`text-overflow: ellipsis clip`	…3456	1234567890	…4321	1234567890
`text-overflow: ellipsis ellipsis`	…34…	1234567890	…43…	1234567890
`text-overflow: ellipsis '.'`	…34.	1234567890	…43.	1234567890
`text-overflow: ',' clip`	,3456	1234567890	,4321	1234567890
`text-overflow: ',' ellipsis`	,34…	1234567890	,43…	1234567890
`text-overflow: ',' '.'`	,34.	1234567890	,53.	1234567890

Especificaciones

Specification
CSS Overflow Module Level 3 # text-overflow

Compatibilidad con navegadores

BCD tables only load in the browser

CSS value	`direction: ltr`		`direction: rtl`
CSS value	Expected Result	Live result	Expected Result	Live result
visible overflow	1234567890	1234567890	0987654321	1234567890
`text-overflow: clip`		123456		1234567890
`text-overflow: ''`	12345	123456	54321	1234567890
`text-overflow: ellipsis`	1234…	1234567890	…4321	1234567890
`text-overflow: '.'`	1234.	1234567890	.4321	1234567890
`text-overflow: clip clip`	123456	1234567890	654321	1234567890
`text-overflow: clip ellipsis`	1234…	1234567890	6543…	1234567890
`text-overflow: clip '.'`	1234.	1234567890	6543.	1234567890
`text-overflow: ellipsis clip`	…3456	1234567890	…4321	1234567890
`text-overflow: ellipsis ellipsis`	…34…	1234567890	…43…	1234567890
`text-overflow: ellipsis '.'`	…34.	1234567890	…43.	1234567890
`text-overflow: ',' clip`	,3456	1234567890	,4321	1234567890
`text-overflow: ',' ellipsis`	,34…	1234567890	,43…	1234567890
`text-overflow: ',' '.'`	,34.	1234567890	,53.	1234567890