A FastBoot-enabled addon to detect the best language for your user.
$ ember install ember-best-languageember-best-language uses a scoring system to determine the best language to use. The scoring system is based on the Accept-Language header on the FastBoot-side. On the client side, we use navigator.languages and give a score to each language based on its order in the array.
ember-best-language also split language code from country code to make sure that if the user reads fr-CA and your system supports fr, you will have a match.
This addon is inspired by the work of Rémi Prévost in plug_best, you should check it out!
ember-best-language provides a service with two methods:
- bestLanguage
- bestLanguageOrFirst
To find out which language is the best one to use among a list of supported languages:
import Route from '@ember/routing/route';
import {inject as service} from '@ember/service';
export default class extends Route {
@service('best-language') bestLanguage;
beforeModel() {
const bestLanguage = this.bestLanguage.bestLanguage(['en-US', 'fr']);
// => {language: 'en-US', baseLanguage: 'en', score: 1}
}
});If none of the user’s languages are supported, ember-best-language will return null. However, you can use the bestLanguageOrFirst method to make it return the first supported language in those cases.
import Route from '@ember/routing/route';
import {inject as service} from '@ember/service';
export default class extends Route {
@service('best-language') bestLanguage;
beforeModel() {
const bestLanguage = this.bestLanguage.bestLanguage(['fr', 'de', 'en-US']);
// => null
const bestLanguageOrFirst = this.bestLanguage.bestLanguageOrFirst(['fr', 'de', 'en-US']);
// => {language: 'fr', baseLanguage: 'fr', score: 0}
}
});$ git clone https://github.com/mirego/ember-best-language
$ cd ember-best-language
$ yarn install$ yarn test # Runs `ember try:each` to test the addon against multiple Ember versions
$ ember test
$ ember test --server$ ember buildFor more information on using ember-cli, visit https://ember-cli.com.
ember-best-language is © 2017-2022 Mirego and may be freely distributed under the New BSD license. See the LICENSE.md file.
The flag logo is based on this lovely icon by Prasanta Kr Dutta, from The Noun Project. Used under a Creative Commons BY 3.0 license.
Mirego is a team of passionate people who believe that work is a place where you can innovate and have fun. We're a team of talented people who imagine and build beautiful Web and mobile applications. We come together to share ideas and change the world.
We also love open-source software and we try to give back to the community as much as we can.
![dependabot[bot] avatar](https://avatars.githubusercontent.com/in/29110?v=4 "dependabot[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent