
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-snapshotsVisual 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
或點擊選擇檔案
目標語言
無需註冊即時估價