@mi18n/svelte
v5.15.1
Published
Svelte implementation for Mi18n localization framework
Downloads
4
Maintainers
Readme
Mi18n is an open-source alternative to Crowdin, Phrase, or Lokalise with its very own revolutionary integrations.
Become part of the family. Join slack channel
What is Mi18n for Svelte?
Svelte integration library of Mi18n. With this package, it's super simple to add i18n to your Svelte app! For more information about using Mi18n with Svelte, visit the docs 📖.
Localize (translate) your Svelte or SvelteKit projects to multiple languages with Mi18n. Integration of Mi18n is extremely simple! 🇯🇵 🇰🇷 🇩🇪 🇨🇳 🇺🇸 🇫🇷 🇪🇸 🇮🇹 🇷🇺 🇬🇧
Quick links
- Mi18n for Angular docs
- Mi18n JS SDK docs
- Mi18n Website
- Product (Learn more about the great features)
- Mi18n platform docs
Installation
npm install @mi18n/svelte
Then use the library in your app:
<script lang="ts">
import {
Mi18nProvider,
Mi18n,
SveltePlugin,
FormatSimple,
} from '@mi18n/svelte';
const mi18n = Mi18n()
.use(SveltePlugin())
.use(FormatSimple())
.init({
apiUrl: import.meta.env.VITE_MI18N_API_URL,
apiKey: import.meta.env.VITE_MI18N_API_KEY,
language: 'en',
});
</script>
<Mi18nProvider {mi18n}>
<div slot="fallback">Loading...</div>
<slot />
</Mi18nProvider>
Usage
To translate texts using Mi18n Svelte integration, you can use T
component or getTranslate
function.
T component
<script>
import { T } from '@mi18n/svelte';
</script>
<T keyName="key" defaultValue="This is default" />
getTranslate function
The getTranslate
function returns a store containing the function, which translates your key.
<script>
import { getTranslate } from '@mi18n/svelte';
const { t } = getTranslate();
</script>
{$t('this_is_a_key', { key: 'value', key2: 'value2' })}
Changing the language
To change the current language, use getLanguageStore
method. For example, you can bind it to a select value.
<script lang="ts">
import { getMi18n } from '@mi18n/svelte';
const mi18n = getMi18n(['language']);
function handleLanguageChange(e) {
$mi18n.changeLanguage(e.currentTarget.value);
}
</script>
<select value={$mi18n.getLanguage()} on:change={handleLanguageChange}>
...
</select>
Prerequisites
- You have some Svelte-based project
- You have generated an API key from Mi18n Cloud or a self-hosted Mi18n instance.
Why to use Mi18n?
Because it saves a lot of time, you would spend on localization tasks without it. Because it enables you to provide perfectly translated software.
Features
- All-in-one localization solution for your JS application 🙌
- Out-of-box in-context localization 🎉
- Automated screenshot generation 📷
- Translation management platform 🎈
- Open-source 🔥
Read more on the Mi18n website
Development
We welcome your PRs.
To develop the package locally:
- Clone the repository
- Install the packages in the repository root
pnpm install
- Run the development script
pnpm develop:svelte
This runs the development suite of this monorepo for the svelte
integration. The changes in each dependency package are
automatically built and propagated to the test application, which you can open and play within the browser.
Testing
To run Jest tests of this package, execute
npm run test
In the /packages/svelte
directory.
End-to-end (e2e) testing
To run the e2e tests, simply execute
pnpm run e2e run svelte
To open and play with e2e tests, run:
pnpm run e2e open svelte