Using Laravel translations in Javascript with the Laravel Translations Loader
Published on by Luis Dalmolin
Have you ever wanted to use the same Laravel translations you use on the back-end in your front-end code?
Laravel Translations Loader is a webpack loader that enables you to load your Laravel translations into your javascript bundle.
Instead of doing HTTP requests to fetch translations, the package enters in the middle of the asset compilation process and translates your PHP translation files (JSON and PHP) into a JSON object so you can use however you like.
It works out of the box with packages like vue-i18n or with a few configuration tweaks with the popular i18next package.
Show me the code
The first step, is to install the package using NPM or Yarn.
npm install @kirschbaum-development/laravel-translations-loader --saveyarn add @kirschbaum-development/laravel-translations-loader --save
Or, by using Yarn.
npm install @kirschbaum-development/laravel-translations-loader --save
Basically, in your javascript file, you just need to include the following line to import your language bundle.
import languageBundle from'@kirschbaum-development/laravel-translations-loader!@kirschbaum-development/laravel-translations-loader';
This will load and parse all your language files, including PHP and JSON translations. The languageBundle
will look something like this:
{ "en": { "auth": { "failed": "These credentials do not match our records." } }, "es": { "auth": { "failed": "Estas credenciales no coinciden con nuestros registros." } }}
Along with all other translations you may have on your translations folder.
There are options for loading either just PHP or JSON translations files, as well as adding a namespace between the lang keys and the actual translations that some packages require. You can check the different loading options on the readme of the project. And please fill out an issue if you have any troubles or suggestions.
Example using vue–i18n
Notice you can directly pass the languageBundle
object as a parameter into the VueI18n
constructor.
import languageBundle from '@kirschbaum-development/laravel-translations-loader!@kirschbaum-development/laravel-translations-loader';import VueI18n from 'vue-i18n';Vue.use(VueI18n);const i18n = new VueI18n({ locale: window.Locale, messages: languageBundle,})
And on any vue component, you can just use the $t
function, like the following example:
<template> <span>{{ $t('auth.failed') }}</span> <!-- this will output the same as {{ trans('auth.failed') }} using Laravel --></template>
Luis is a senior developer at Kirschbaum and has over 10 years of experience architecting complex applications and has been working with Laravel since the early days of Laravel 4.
In addition to PHP and Laravel, Luis specializes in VueJS/Javascript and everything DevOps related. He loves working with Open Source and has contributed several open-source projects to the community.
Luis taught an AngularJS course at University Feevale, where he also earned his degree in Internet Systems, and he translated the Laravel book "Code Bright" by Dayle Rees into Portuguese.