תחביר תרגום

קיצורים מאפשרים גישה לתרגומים בהקשרים מסוימים.

// בהקשר של העיצוב (תגי מטא HTML ומסגרת עמוד ראשי)
{{ '@layout::meta.description' | trans }}
// בהקשר של העמוד (גוף העמוד או מודאל לדוגמה)
{{ '@page::page_title' | trans }}

חשוב להפחית טקסט כפול בקובץ תרגום. מפתחות קסם מאפשרים הכללות מקובץ אחד לאחר באמצעות התחביר הפנימי @folder.file::key.sub_key.

ניתן לשלב זאת עם המילה המפתח % אם המפתח או עץ המפתחות זהים.

# translation-file-one.en.yml
example_key:
  example_sub_key: Translation string

# translation-file-two.en.yml
example_key:
  # Using this key resolves to the first file
  # using the same key "example_key.example_sub_key"
  example_sub_key: '@translation-file-one::%'

אם רוב המפתחות בקובץ זהים לאחרים, פשוט יותר להשתמש בתחביר ~extends כדי לשחזר את כל המפתחות ולהוסיף רק את החדשים.

# translation-file-two.en.yml
~extends: '@translation-file-one'

קבצי תרגום נפתרים ומאוחסנים במטמון כדי לשמור על ביצועים.

תרגומים יכולים לעבור ל-Javascript לשימוש דינמי.

// template.html.twig
trans_js('@page::javascript.*')

// Hello Javascript!
app.layout.page.trans('@page::javascript.demo_text');

בדוק כאן