Skip to main content

i18n 文字擴展:避免翻譯長度破壞佈局

英語 UI 完美適配,德語翻譯卻長 30%,芬蘭語長 40%。按鈕溢出、表格損壞、精心設計的佈局分崩離析。文字擴展測試可防止這些問題。

1

文字擴展為何會破壞佈局

開發者使用英語文字設計 UI,而英語是最緊湊的語言之一。翻譯完成後,較長語言會溢出容器、破壞網格佈局、截斷按鈕標籤,並將內容推離屏幕。這些缺陷只出現在特定地區設定中,因此僅使用英語開發和測試時無法發現。

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.
文字擴展並非邊界情況。每個支援多種語言的 UI 都會遇到。德語比英語長 30%,芬蘭語長 40%,某些語言中的短字串甚至可長 100% 以上。在翻譯完成前測試擴展,可避免昂貴的重新設計。
2

各語言文字擴展比例

相對於英語來源文字的平均擴展比例。短字串(少於 20 個字元)比長字串擴展更多,因為單個詞語選擇對總長度影響更大。

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
這些是平均值。單個字串可能擴展得更多,一個 2 詞英語按鈕標籤在德語中可能變為 4 個詞。對於按鈕、導覽和表頭等關鍵 UI 元素,請使用更高比例(50% 以上)測試。
3

使用 i18n-pseudo 測試

i18n-pseudo 的擴展策略會向來源字串新增填充,模擬翻譯長度。根據目標語言設定擴展比例,在真實翻譯完成前測試佈局。

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,
  });
});
歐洲語言使用 40% 擴展進行測試,最壞情況使用 50%。如果佈局能承受 50% 擴展,幾乎可以處理任何語言。
4

i18n 設計最佳實踐

構建可處理文字擴展的佈局,需要在開始翻譯前作出設計決策。以下實踐可防止最常見的擴展相關缺陷。

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 */

立即試用 i18n Agent

將翻譯檔案拖放到此處

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

或點擊選擇檔案

目標語言

無需註冊即時估價

文字擴展常見問題