| Package Data | |
|---|---|
| Maintainer Username: | DrewNeon |
| Maintainer Contact: | drewneon@users.noreply.github.com (Drew Neon) |
| Package Create Date: | 2017-02-20 |
| Package Last Update: | 2017-02-24 |
| License: | MIT |
| Last Refreshed: | 2024-04-15 15:04:12 |
| Package Statistics | |
|---|---|
| Total Downloads: | 27 |
| Monthly Downloads: | 0 |
| Daily Downloads: | 0 |
| Total Stars: | 0 |
| Total Watchers: | 0 |
| Total Forks: | 0 |
| Total Open Issues: | 0 |
Localization, one of the core features of Laravel, separates language strings from views, so as to serve a robust foundation for multilingual projects. However, trans(), trans_choice() or the newly-introduced __(), supported by Blade template engine of different version of Laravel, are not usable in Javascript. This issue is definitely inevitable for developing any serious multilingual projects and just what Lang4JS is addressing. When Lang4JS is installed as a package in your Laravel application, you are able to use trans(), trans_choice() and __() in Javascript with the same syntax just as in Blade templates, the language strings defined in files under resources/lang folder are retrieved correspondently and displayed right to the users. Lang4JS is very easy to use and lightweight, merely a 3Kb controller file and a 4Kb minified JS file.
Lang4JS is compatible with Laravel 4.2+.
$ composer require drewneon/lang4js
config/app.php:DrewNeon\Lang4JS\Lang4JSServiceProvider::class,
lang4js.min.js:$ php artisan vendor:publish --tag=public --force
routes/web.php:Route::post('/lang4js', '\DrewNeon\Lang4JS\Lang4JSController@lang4js');
Lang4JS retrieves language strings directly from your language files resides in resources/lang folder. Please add lines supposed to be used in your Javascript as those for your view blades.
Lang4JS requires [jQuery] (http://jquery.com) library, you have to load it before the lang4js.min.js. So in any view blades you want to apply multilingual strings in Javascript, please insert these two lines:
<script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/1.12.4/jquery.min.js"></script>
<script src="/vendor/lang4js/lang4js.min.js"></script>
3) Absolute Path
Both post('/lang4js', in route and src="/vendor/lang4js/lang4js.min.js" in view uses absolute path for the convenience to include the script from any URL. This means you have to point your domain to the public folder in your project, instead of the root folder, otherwise, a 404 error will occur or modify the paths according to your own environment.
4) CSRF Token
Lang4JS utilizes Ajax requests to retrieve language strings, and this requires CSRF Token in Laravel. There are two ways to set CSRF Token in your webpages.
{{ csrf_field() }} in there. If not, add the line somewhere between <form>...</form>.<meta name="csrf-token" content="{{ csrf_token() }}"> into <head>...</head>.In terms of security of you website, it's a good practice to always have CSRF Token presented in all webpages, which can be easily done by adding the meta tag for CSRF Token in the head sub-view for all views.
Now in your Javascript, feel free to use trans(), trans_choice() as well as __() newly introduced in Laravel 5.4. Please refer to the Localization document according to your Laravel version for more information. For example:
trans('messages.welcome') or __('messages.welcome') translates to the string defined in the line 'welcome' => '' of the file resources/lang/[locale]/messages.php;trans_choice('messages.apples', 10) translates to the plural part of the line 'apples' => '|' in resources/lang/[locale]/messages.php.The only difference in syntax
When using the place-holder feature of trans() or __(), the syntax ['name' => 'dayle'] does NOT work for Javascript, please write {'name' : 'dayle'} instead.
Some Issues
trans(), trans_choice() or __() in your Javascript does NOT work before the DOM is ready, and will halt your entire Javascript. Please use them in functions.trans() nor trans_choice() nor __() at all in your Javascript. To fix this, just remove <script src="/vendor/lang4js/lang4js.min.js"></script> from you view.<br> for HTML and \n for Javascript. If you want to show \n as is in Javascript, please wrap it in double quotes, i.e. "\n".Please see CHANGELOG for more information on what has changed recently.
$ composer test
Please see CONTRIBUTING and CONDUCT for details.
If you discover any security related issues, please email drewneon@gmail.com instead of using the issue tracker.
The MIT License (MIT). Please see License File for more information.