Skip to main content

Expansión de texto en i18n: evite que la longitud de las traducciones rompa el diseño

Su interfaz en inglés encaja perfectamente. Después llegan traducciones alemanas un 30 % más largas y finesas un 40 % más largas. Los botones se desbordan, las tablas se rompen y el diseño se desmorona. Las pruebas de expansión lo evitan.

1

Por qué la expansión de texto rompe los diseños

Los desarrolladores diseñan con texto en inglés, uno de los idiomas más compactos. Al llegar las traducciones, los idiomas más largos desbordan contenedores, rompen cuadrículas, truncan etiquetas de botones y sacan contenido de la pantalla. Estos errores solo aparecen en determinadas configuraciones regionales, lo que los hace invisibles durante el desarrollo y las pruebas solo en inglés.

The expansion problem
// English is one of the most compact languages.
// Translations are almost always LONGER.

// English (source):
"Save"           // 4 chars

// Translations:
"Speichern"      // German: 10 chars (+150%)
"Enregistrer"    // French: 12 chars (+200%)
"Guardar"        // Spanish: 7 chars (+75%)
"Сохранить"      // Russian: 9 chars (+125%)
"Tallenna"       // Finnish: 8 chars (+100%)

// Buttons, labels, and table headers designed for
// English text WILL break in other languages.
La expansión no es un caso límite. Toda interfaz multilingüe la sufrirá. El alemán es un 30 % más largo, el finés un 40 % y algunas cadenas cortas pueden superar el 100 %. Probar antes de traducir evita rediseños caros.
2

Proporciones de expansión de texto por idioma

Proporciones medias respecto al origen inglés. Las cadenas cortas —menos de 20 caracteres— se expanden más que las largas porque cada palabra influye más en la longitud total.

Expansion ratios by language
// Average text expansion relative to English:

// European languages:
// German:     +30-35%  (compound words)
// Finnish:    +30-40%  (agglutinative)
// French:     +15-25%  (articles, prepositions)
// Spanish:    +15-25%
// Italian:    +15-25%
// Portuguese: +15-25%
// Russian:    +20-30%  (case endings)
// Polish:     +20-30%
// Greek:      +20-30%

// Asian languages (CJK):
// Chinese:    -30-50%  (shorter in characters, but wider per char)
// Japanese:   -20-40%  (kanji compress meaning)
// Korean:     -10-20%

// Right-to-left:
// Arabic:     +20-30%
// Hebrew:     +10-20%

// Rule of thumb by source string length:
// 1-10 chars:   expect +200% expansion
// 11-20 chars:  expect +80% expansion
// 21-70 chars:  expect +40% expansion
// 71+ chars:    expect +30% expansion
Son promedios. Algunas cadenas se expanden mucho más: una etiqueta inglesa de 2 palabras puede convertirse en 4 en alemán. Pruebe proporciones mayores (50 % o más) en elementos críticos de la interfaz, como botones, navegación y encabezados de tablas.
3

Pruebas con i18n-pseudo

La estrategia de expansión de i18n-pseudo añade relleno a sus cadenas de origen para simular la longitud de una traducción. Defina la proporción de expansión de acuerdo con sus idiomas objetivo y pruebe sus diseños antes de que lleguen las traducciones reales.

Terminal
# Method 1: Pseudo-localization with expansion
npx i18n-pseudo generate \
  --source locales/en.json \
  --output locales/pseudo-expanded.json \
  --expansion 1.4 \
  --preset expanded

# Method 2: Longest-translation analysis
npx i18n-validate expansion \
  --source locales/en.json \
  --targets 'locales/*.json' \
  --report expansion-report.json

# Output:
# Key                  | EN  | Longest | Lang | Ratio
# ---------------------|-----|---------|------|-------
# nav.settings         | 8   | 14      | de   | 175%
# buttons.save         | 4   | 12      | fr   | 300%
# errors.networkFailed | 14  | 28      | fi   | 200%

# Method 3: Visual regression with expanded text
npx playwright test \
  --project=expansion-test \
  --update-snapshots
Visual regression tests
// playwright.config.ts
export default defineConfig({
  projects: [
    {
      name: 'expansion-test',
      use: {
        locale: 'pseudo-expanded',
      },
    },
  ],
});

// tests/expansion.spec.ts
test('buttons do not overflow with expanded text', async ({ page }) => {
  await page.goto('/');

  // Check no horizontal overflow
  const buttons = await page.locator('button').all();
  for (const button of buttons) {
    const box = await button.boundingBox();
    const parent = await button.locator('..').boundingBox();
    expect(box!.x + box!.width).toBeLessThanOrEqual(
      parent!.x + parent!.width
    );
  }

  // Visual snapshot comparison
  await expect(page).toHaveScreenshot('homepage-expanded.png', {
    maxDiffPixels: 100,
  });
});
Pruebe una expansión del 40 % para idiomas europeos y del 50 % en el peor caso. Si su diseño sobrevive al 50 %, gestionará prácticamente cualquier idioma.
4

Prácticas recomendadas de diseño para i18n

Crear diseños que admitan expansión exige decisiones previas a cualquier traducción. Estas prácticas evitan los errores más habituales.

CSS best practices
/* 1. Use flexible containers, not fixed widths */
/* WRONG */
.button { width: 120px; }

/* RIGHT */
.button { min-width: 80px; padding: 8px 16px; }

/* 2. Allow text wrapping in labels */
/* WRONG */
.label { white-space: nowrap; overflow: hidden; }

/* RIGHT */
.label { overflow-wrap: break-word; }

/* 3. Use CSS Grid/Flexbox for adaptive layouts */
.nav {
  display: flex;
  flex-wrap: wrap;
  gap: 8px;
}

/* 4. Reserve space for the longest expected translation */
/* Use min-width based on ~1.4x English length */
.table-header {
  min-width: max-content;
  padding-right: 16px;
}

/* 5. Test with the longest language first */
/* German and Finnish are good stress-test languages */

/* 6. For CJK: account for wider characters */
/* CJK characters are typically 2x the width of Latin chars */
/* Even though text is shorter, it may be wider visually */

Pruebe i18n Agent ahora

Arrastre y suelte aquí su archivo de traducción

JSON, YAML, PO, XML, CSV, Markdown, Properties

o haga clic para seleccionar

Idiomas de destino

No es necesario registrarsePresupuesto al instante

Preguntas frecuentes sobre expansión de texto