From b04bff9996f0ca326392aa5ce439f50c3f7f4b68 Mon Sep 17 00:00:00 2001 From: Alexander Date: Wed, 9 Oct 2024 10:48:19 -0600 Subject: [PATCH] es: Create text-wrap (#23948) Co-authored-by: GrayWolf --- files/es/web/css/text-wrap/index.md | 142 ++++++++++++++++++++++++++++ 1 file changed, 142 insertions(+) create mode 100644 files/es/web/css/text-wrap/index.md diff --git a/files/es/web/css/text-wrap/index.md b/files/es/web/css/text-wrap/index.md new file mode 100644 index 00000000000000..e200492adfa27f --- /dev/null +++ b/files/es/web/css/text-wrap/index.md @@ -0,0 +1,142 @@ +--- +title: text-wrap +slug: Web/CSS/text-wrap +l10n: + sourceCommit: 4ecbac9e89961a132c1e7f5493ec94f60dcb1ee4 +--- + +{{CSSRef}} + +La propiedad abreviada de CSS **`text-wrap`** controla cómo se envuelve el texto dentro de un elemento. Los diferentes valores proporcionan: + +- Mejoras tipográficas, por ejemplo, longitudes de línea más equilibradas en títulos divididos. +- Una forma de desactivar completamente el ajuste de texto. + +> [!NOTE] +> Las propiedades {{CSSxRef("white-space-collapse")}} y `text-wrap` pueden declararse juntas usando la propiedad abreviada {{CSSxRef("white-space")}}. + +{{EmbedInteractiveExample("pages/css/text-wrap.html")}} + +## Propiedades constituyentes + +Esta propiedad es una abreviatura de las siguientes propiedades de CSS: + +- [`text-wrap-mode`](/es/docs/Web/CSS/text-wrap-mode) +- [`text-wrap-style`](/es/docs/Web/CSS/text-wrap-style) + +## Sintaxis + +```css +/* Valores de palabras clave */ +text-wrap: wrap; +text-wrap: nowrap; +text-wrap: balance; +text-wrap: pretty; +text-wrap: stable; + +/* Valores globales */ +text-wrap: inherit; +text-wrap: initial; +text-wrap: revert; +text-wrap: revert-layer; +text-wrap: unset; +``` + +La propiedad `text-wrap` se especifica como una palabra clave única elegida de la lista de valores a continuación. + +### Valores + +- `wrap` + - : El texto se envuelve en líneas en caracteres apropiados (por ejemplo, espacios en idiomas como el inglés que usan separadores de espacio) para minimizar el desbordamiento. Este es el valor predeterminado. +- `nowrap` + - : El texto no se envuelve en líneas. Desbordará su elemento contenedor en lugar de dividirse en una nueva línea. +- `balance` + - : El texto se envuelve de una manera que equilibra mejor el número de caracteres en cada línea, mejorando la calidad y la legibilidad del diseño. Dado que contar caracteres y equilibrarlos en varias líneas es computacionalmente costoso, este valor solo es compatible con bloques de texto que abarcan un número limitado de líneas (seis o menos para Chromium y diez o menos para Firefox). +- `pretty` + - : Da como resultado el mismo comportamiento que `wrap`, excepto que el agente de usuario utilizará un algoritmo más lento que favorece un mejor diseño sobre la velocidad. Esto está destinado al texto principal donde se prefiere una buena tipografía sobre el rendimiento (por ejemplo, cuando se debe minimizar el número de palabras [huérfanas](/es/docs/Web/CSS/orphans)). +- `stable` + - : Da como resultado el mismo comportamiento que `wrap`, excepto que cuando el usuario está editando el contenido, las líneas que preceden a las líneas que están editando permanecen estáticas en lugar de que todo el bloque de texto se vuelva a ajustar. + +## Descripción + +Hay dos formas en que el texto puede fluir a través de líneas dentro de un bloque de contenido, como un párrafo ({{HTMLElement("p")}}) o encabezados ({{HTMLElement("heading_elements","<h1>–<h6>")}}). Estos son _saltos de línea forzados_, que son controlados por el usuario, y _saltos de línea suaves_, que son controlados por el navegador. La propiedad `text-wrap` se puede usar para indicar al navegador cómo controlar los _saltos de línea suaves_. + +El valor que elija para `text-wrap` depende de cuántas líneas de texto anticipe estilizar, si el texto es `contenteditable` (contenido editable), y si necesita priorizar la apariencia o el rendimiento. + +Cuando el contenido estilizado se limitará a un número corto de líneas, como títulos, leyendas y citas en bloque, se puede agregar `text-wrap: balance` para equilibrar el número de caracteres en cada línea, mejorando la calidad y la legibilidad del diseño. Dado que los navegadores limitan el número de líneas afectadas por esta propiedad, el impacto de este valor en el rendimiento es insignificante. + +Para secciones de texto más largas, se puede usar `text-wrap: pretty`. Tenga en cuenta que `pretty` tiene un efecto negativo en el rendimiento, por lo que solo debe usarse para bloques de texto más largos cuando el diseño es más importante que la velocidad. + +El valor `stable` mejora la experiencia del usuario cuando se usa en [`contenteditable`](/es/docs/Web/HTML/Global_attributes/contenteditable) (contenido que es editable). Este valor asegura que, a medida que el usuario está editando texto, las líneas anteriores en el área que se está editando permanezcan estables. + +## Definición formal + +{{CSSInfo}} + +## Sintaxis formal + +{{CSSSyntax}} + +## Ejemplos + +### Comparación de valores básicos de text-wrap + +#### HTML + +```html +

+ El comportamiento predeterminado; el texto en el título se envuelve + "normalmente" +

+ +

+ En este caso, el texto en el título no se envuelve y desborda el contenedor +

+ +

+ En este caso, el texto en el título está bien equilibrado entre líneas +

+``` + +### CSS + +```css +.wrap { + text-wrap: wrap; +} + +.nowrap { + text-wrap: nowrap; +} + +.balance { + text-wrap: balance; +} + +h2 { + font-size: 2rem; + font-family: sans-serif; +} +``` + +#### Resultado + +El texto en el ejemplo es editable. Cambie el texto, agregando palabras largas, para ver cómo las diferentes longitudes de la línea y las palabras impactan el envoltorio. + +{{EmbedLiveSample("Ejemplos", "100%", 350)}} + +## Especificaciones + +{{Specifications}} + +## Compatibilidad con los navegadores + +{{Compat}} + +## Véase también + +- {{CSSxRef("white-space")}} +- {{CSSxRef("white-space-collapse")}} +- [Módulo de texto CSS](/es/docs/Web/CSS/CSS_text) +- [CSS `text-wrap: balance`](https://developer.chrome.com/docs/css-ui/css-text-wrap-balance) en developer.chrome.com +- [CSS `text-wrap: pretty`](https://developer.chrome.com/blog/css-text-wrap-pretty/) en developer.chrome.com