Zurück

gt-next@6.11.0

Ernest McCarter avatarErnest McCarter
gt-next6.11.0maxcharscharacter-limits

Überblick

gt-next@6.11.0 führt in Übersetzungsfunktionen die Unterstützung des Parameters $maxChars ein und baut damit auf der formatCutoff()‑Funktionalität auf, die in generaltranslation@8.1.0 eingeführt wurde.

Verwendung

Der Parameter $maxChars kann mit beliebigen String-Übersetzungsaufrufen verwendet werden:

gt('Welcome to our application', { $maxChars: 20 })
// KI versucht Übersetzung innerhalb von 20 Zeichen: "Bienvenido a app"

Umgang mit Zeichenlimits

Der Parameter $maxChars löst zwei unterschiedliche Mechanismen aus:

  1. KI-Übersetzungsoptimierung: Die KI erhält das Zeichenlimit und versucht, eine Übersetzung zu erzeugen, die innerhalb der angegebenen Länge bleibt.

  2. Kürzung durch die Bibliothek: Wenn eine Übersetzung (von der KI oder aus dem Cache) das Zeichenlimit überschreitet, wendet die Bibliothek eine lokalesensitiv arbeitende Kürzung an, um das Limit durchzusetzen.

gt('Long description text', { $maxChars: 15 })
// KI versucht prägnante Übersetzung: "Texto breve"
// Falls Ergebnis Limit überschreitet: "Texto de desc…" (gekürzt)

Integration

Kompatibel mit vorhandenen Übersetzungsoptionen:

gt('User notification', {
  $context: 'mobile-alert',
  $maxChars: 30
})
// KI versucht Übersetzung innerhalb von 30 Zeichen: "Notificación usuario"
// Bibliothek kürzt bei Bedarf ab: "Notificación del usuario…"

Der Parameter beeinflusst das Hashing der Übersetzungen und stellt sicher, dass unterschiedliche Zeichenlimits zu separaten Übersetzungseinträgen führen.