戻る

gt-next@6.11.0

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

概要

gt-next@6.11.0 では、generaltranslation@8.1.0 で導入された formatCutoff() 機能を基に、翻訳関数で $maxChars パラメータがサポートされました。

使用方法

$maxChars パラメータは、あらゆる文字列の翻訳呼び出しで使用できます。

gt('Welcome to our application', { $maxChars: 20 });
// AIが20文字以内での翻訳を試みます: "Bienvenido a app"

文字数制限の処理

$maxChars パラメータは、2つの異なる仕組みを有効にします。

  1. AI翻訳の最適化: AI は文字数制限を受け取り、指定された長さに収まる翻訳を生成しようとします。

  2. ライブラリの切り詰め処理: 翻訳 (AI によるものでもキャッシュされたものでも) が文字数制限を超えた場合、ライブラリは制限内に収めるため、ロケールに応じた切り詰めを適用します。

gt('Long description text', { $maxChars: 15 });
// AIが簡潔な翻訳を試みる: "Texto breve"
// 結果が上限を超えた場合: "Texto de desc…" (切り詰め)

連携

既存の翻訳オプションと併用できます。

gt('User notification', {
  $context: 'mobile-alert',
  $maxChars: 30,
});
// AIが30文字以内での翻訳を試みる: "Notificación usuario"
// 必要に応じてライブラリが切り詰める: "Notificación del usuario…"

このパラメータは翻訳ハッシュに影響し、文字数制限が異なる場合は別個の翻訳エントリが作成されるようにします。