5.26.0 • Published 2 days ago

@tolgee/svelte v5.26.0

Weekly downloads
-
License
MIT
Repository
github
Last release
2 days ago

{% import "../../readmeMacros/macros.njk.md" as macros %} {{ macros.header('Tolgee for Svelte', 'The Tolgee i18n SDK for Svelte', packageName) }}

What is Tolgee for Svelte?

Svelte integration library of Tolgee. With this package, it's super simple to add i18n to your Svelte app! For more information about using Tolgee with Svelte, visit the docs 📖.

Localize (translate) your Svelte or SvelteKit projects to multiple languages with Tolgee. Integration of Tolgee is extremely simple! 🇯🇵 🇰🇷 🇩🇪 🇨🇳 🇺🇸 🇫🇷 🇪🇸 🇮🇹 🇷🇺 🇬🇧

{{ macros.integrationLinks('Tolgee for Angular docs', macros.v5link('integrations/svelte/installation')) }}

{{ macros.installation('svelte') }}

Then use the library in your app:

<script lang="ts">
  import {
    TolgeeProvider,
    Tolgee,
    SveltePlugin,
    FormatSimple,
  } from '@tolgee/svelte';

  const tolgee = Tolgee()
    .use(SveltePlugin())
    .use(FormatSimple())
    .init({
      apiUrl: import.meta.env.VITE_TOLGEE_API_URL,
      apiKey: import.meta.env.VITE_TOLGEE_API_KEY,
      language: 'en',
    });
</script>

<TolgeeProvider {tolgee}>
  <div slot="fallback">Loading...</div>
  <slot />
</TolgeeProvider>

Usage

To translate texts using Tolgee Svelte integration, you can use T component or getTranslate function.

T component

<script>
  import { T } from '@tolgee/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 '@tolgee/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 { getTolgee } from '@tolgee/svelte';

  const tolgee = getTolgee(['language']);

  function handleLanguageChange(e) {
    $tolgee.changeLanguage(e.currentTarget.value);
  }
</script>

<select value={$tolgee.getLanguage()} on:change={handleLanguageChange}>
  ...
</select>

{{ macros.prereq('Svelte') }}

{{ macros.why() }}

Development

{{ macros.developmentInstallation() }} {{ macros.development('svelte') }}

{{ macros.developmentTesting('/packages/svelte') }}

{{ macros.e2eTesting('svelte') }}

{{ macros.contributors() }}

localizationinternationalizationl10ni18ntranslationlanguages
@tolgee/web
@everything-registry/sub-chunk-925@zalastax/nolb-_tol
5.25.1-prerelease.d38486d9.0

2 days ago

5.26.0

2 days ago

5.25.1-prerelease.d1c80a58.0

3 days ago

5.25.0

10 days ago

5.24.1

21 days ago

5.24.0

24 days ago

5.23.3

28 days ago

5.23.2

29 days ago

5.23.1

30 days ago

5.22.1-prerelease.4299f3f0.0

1 month ago

5.23.1-prerelease.88c01ea6.0

1 month ago

5.22.1-prerelease.b7e76156.0

1 month ago

5.23.0

1 month ago

5.22.1-prerelease.c21a4b30.0

1 month ago

5.22.1-prerelease.aa2f05c1.0

1 month ago

5.22.1-prerelease.d00c62d8.0

1 month ago

5.22.0

2 months ago

5.21.0

2 months ago

5.20.4-prerelease.afe383ff.0

2 months ago

5.20.3

2 months ago

5.20.2

2 months ago

5.20.1

2 months ago

5.20.0

2 months ago

5.19.7-prerelease.d6de9cd8.0

2 months ago

5.19.6

3 months ago

5.19.5

3 months ago

5.19.4

3 months ago

5.19.1-prerelease.e55c6636.0

4 months ago

5.19.3

4 months ago

5.19.3-prerelease.a08fc0b3.0

4 months ago

5.19.2

4 months ago

5.19.1

4 months ago

5.19.1-prerelease.e51a5792.0

4 months ago

5.19.0

5 months ago

5.18.0

5 months ago

5.17.0

5 months ago

5.11.1-prerelease.cb4bc75b.0

9 months ago

5.15.0

6 months ago

5.10.2-prerelease.4c2923b2.0

10 months ago

5.14.1-prerelease.a2c80516.0

6 months ago

5.10.2-prerelease.3fbb14b1.0

10 months ago

5.16.3

6 months ago

5.16.2

6 months ago

5.16.1

6 months ago

5.16.0

6 months ago

5.10.2-prerelease.4bd654a9.0

10 months ago

5.12.1-prerelease.6feb0c2e.0

8 months ago

5.9.2-prerelease.41828ff8.0

10 months ago

5.15.1-prerelease.f75e0f30.0

6 months ago

5.9.9

10 months ago

5.9.8

10 months ago

5.9.7

10 months ago

5.9.6

10 months ago

5.9.5

10 months ago

5.9.4

10 months ago

5.9.3

10 months ago

5.9.2

10 months ago

5.11.5-prerelease.c74f049c.0

8 months ago

5.14.1-prerelease.bcf10e02.0

6 months ago

5.10.2-prerelease.6c57bc94.0

10 months ago

5.10.2

10 months ago

5.10.1

10 months ago

5.10.0

10 months ago

5.9.2-prerelease.ce0c7097.0

10 months ago

5.9.10

10 months ago

5.9.11

10 months ago

5.9.12

10 months ago

5.11.5

8 months ago

5.11.4

8 months ago

5.11.3

8 months ago

5.11.2

8 months ago

5.11.1

9 months ago

5.11.0

9 months ago

5.11.5-prerelease.963d09c5.0

8 months ago

5.10.2-prerelease.466db753.0

10 months ago

5.12.0

8 months ago

5.13.3-prerelease.5f76277d.0

7 months ago

5.13.3

7 months ago

5.11.1-prerelease.74c6272d.0

9 months ago

5.13.2

7 months ago

5.13.1

7 months ago

5.13.0

7 months ago

5.16.1-prerelease.3be7ae26.0

6 months ago

5.9.3-prerelease.c6fa65f4.0

10 months ago

5.14.0

6 months ago

5.10.2-prerelease.efacb842.0

10 months ago

5.13.2-prerelease.0f38c926.0

7 months ago

5.10.2-prerelease.2a0213ec.0

10 months ago

5.12.1-prerelease.56c14f27.0

8 months ago

5.16.1-prerelease.d12444aa.0

6 months ago

5.11.6-prerelease.a415c070.0

8 months ago

5.11.1-prerelease.ebb7c0c6.0

9 months ago

5.8.8-prerelease.aa20b554.0

11 months ago

5.9.0

11 months ago

5.9.0-prerelease.fffd4303.0

11 months ago

5.9.0-prerelease.333e0d35.0

12 months ago

5.8.6

12 months ago

5.8.5

12 months ago

5.8.4

12 months ago

5.8.5-prerelease.dc1d5e4d.0

12 months ago

5.8.4-prerelease.f5f66c17.0

12 months ago

5.8.8-prerelease.130cde89.0

11 months ago

5.8.3

1 year ago

5.8.2

1 year ago

5.4.4-prerelease.9b022cf1.0

1 year ago

5.7.0-prerelease.5c23979f.0

1 year ago

5.6.1-prerelease.998593cd.0

1 year ago

5.8.1

1 year ago

5.8.0

1 year ago

5.4.4

1 year ago

5.6.0-prerelease.b5ab209e.0

1 year ago

5.5.2-prerelease.7efd46da.0

1 year ago

5.7.0-prerelease.fa761114.0

1 year ago

5.5.4

1 year ago

5.5.3

1 year ago

5.5.2

1 year ago

5.5.0

1 year ago

5.4.4-prerelease.d720afd4.0

1 year ago

5.6.0

1 year ago

5.8.1-prerelease.16fc4f78.0

1 year ago

5.7.0-prerelease.134377fa.0

1 year ago

5.7.3

1 year ago

5.7.2

1 year ago

5.7.0

1 year ago

5.4.3

1 year ago

5.4.2-prerelease.95fe706c.0

1 year ago

5.4.2

1 year ago

5.4.3-prerelease.9ea3f1fa.0

1 year ago

5.4.2-rc.2f5c8d8f.0

1 year ago

5.3.2-rc.7c739ee7.0

1 year ago

5.4.2-prerelease.8d022440.0

1 year ago

5.3.1

1 year ago

5.3.1-rc.bb22ab95.0

1 year ago

5.4.1-rc.49c54f24.0

1 year ago

5.4.1

1 year ago

5.4.0

1 year ago

5.3.1-rc.f06e704e.0

1 year ago

5.4.0-rc.210b1663.0

1 year ago

5.3.1-rc.68148171.0

1 year ago

5.3.1-rc.cc42293f.0

1 year ago

5.3.0

1 year ago

5.2.2-rc.cb7c4656.0

1 year ago

5.2.2-rc.e6ecb284.0

1 year ago

5.2.2-rc.e7520e82.0

1 year ago

5.3.0-rc.2e513cd9.0

1 year ago

5.2.1

1 year ago

5.2.0

1 year ago

5.2.2-rc.e744c9f0.0

1 year ago

5.2.0-rc.762d61f8.0

1 year ago

5.0.0-alpha.3

1 year ago

5.0.0-alpha.2

1 year ago

5.2.0-rc.d8d91b51.0

1 year ago

5.0.2

1 year ago

5.0.1

1 year ago

5.0.0

1 year ago

5.1.0

1 year ago

5.0.0-rc.8558283.0

1 year ago

5.0.0-rc.704ada9.0

1 year ago

5.2.0-rc.aeafee14.0

1 year ago

4.10.0-rc.a870190.0

2 years ago

4.10.0-rc.18d1cd5.0

2 years ago

4.10.0-rc.a11e1b6.0

1 year ago

4.10.0-rc.acdda60.0

2 years ago

4.9.4-rc.db88d02.0

2 years ago

5.0.0-alpha.1

1 year ago

4.10.0-rc.d26e1ca.0

2 years ago

4.10.0-rc.801e910.0

2 years ago

4.10.0-rc.43623be.0

2 years ago

4.9.3-rc.04b22e6.0

2 years ago

4.10.0-rc.a50bdc6.0

2 years ago

4.9.3-rc.23424f3.0

2 years ago

4.10.0-rc.72ff5c5.0

2 years ago

4.9.3-rc.730f576.0

2 years ago

4.10.0-rc.f068ae1.0

2 years ago

4.9.3-rc.d287ae9.0

2 years ago

4.10.0-rc.9985531.0

2 years ago

4.9.3-rc.e39950d.0

2 years ago

4.9.3-rc.128edeb.0

2 years ago

4.9.3-rc.ad9d2a4.0

2 years ago

4.9.3-rc.85a5b73.0

2 years ago

4.9.4-rc.6a51a7a.0

1 year ago

4.9.4-rc.7fe4de1.0

1 year ago

4.10.0-rc.d9fac95.0

2 years ago

4.10.0-rc.578d1d0.0

2 years ago

4.9.4-rc.bc0a538.0

2 years ago

4.10.0-rc.66ab647.0

2 years ago

4.9.4-rc.b877d55.0

2 years ago

4.10.0-rc.4a0f1a6.0

2 years ago

5.0.0-rc.0b3e627.0

2 years ago

4.9.0

2 years ago

4.9.2

2 years ago

4.9.1

2 years ago

4.9.0-rc.b7a4088.0

2 years ago

4.10.0-rc.2b55a5c.0

2 years ago

5.0.0-rc.af99eec.0

2 years ago

4.8.5

2 years ago

4.8.4

2 years ago

4.8.6

2 years ago

4.10.0-rc.14ca700.0

2 years ago

4.8.3

2 years ago

4.8.6-rc.8439ca3.0

2 years ago

4.8.3-rc.a861236.0

2 years ago

5.0.0-rc.9be0f0e.0

2 years ago

4.8.2

2 years ago

4.7.2

2 years ago

4.7.3

2 years ago

4.7.2-rc.896ee06.0

2 years ago

4.7.2-rc.6a39b4d.0

2 years ago

4.7.4-rc.1a63ba95.0

2 years ago

4.7.3-rc.0f00ce9.0

2 years ago

4.8.0

2 years ago

4.7.3-rc.c880d75c.0

2 years ago

4.7.0-rc.9928cac.0

2 years ago

4.6.1-rc.c466f12.0

2 years ago

4.7.1

2 years ago

4.6.1-rc.67b132a.0

2 years ago

4.6.0-rc.30a9509.0

2 years ago

4.6.0-rc.f5a646c.0

2 years ago

4.7.0-rc.8f81f5b.0

2 years ago

4.6.0-rc.03177a3.0

2 years ago

4.6.0-rc.2e9d3c7.0

2 years ago

4.6.1

2 years ago

4.6.0

2 years ago

4.6.0-rc.7a3a82b.0

2 years ago

4.7.0-rc.c451c95.0

2 years ago

4.6.0-rc.b9eec4f.0

2 years ago

4.6.0-rc.6a7caf3.0

2 years ago

4.6.0-rc.ec9dda1.0

2 years ago

4.7.0

2 years ago

4.6.1-rc.a5b97b8.0

2 years ago

4.5.0

2 years ago

4.3.0-rc.10eeecf.0

2 years ago

4.3.0-rc.5103942.0

2 years ago

4.3.0-rc.3106ab8.0

2 years ago

4.3.0-rc.6d9042d.0

2 years ago

4.3.0-rc.2874848.0

2 years ago

4.4.0

2 years ago

4.3.0

2 years ago

4.2.1

2 years ago

4.1.2-rc.1085d75.0

2 years ago

3.6.0

2 years ago

4.0.0-rc.69d2a92.0

2 years ago

4.1.0

2 years ago

4.0.0

2 years ago

4.2.0

2 years ago

3.6.1-rc.fb16d2e.0

2 years ago

3.3.0-prerelease-07e7034.0

2 years ago

3.3.0-prerelease-a220912.0

2 years ago

3.3.0-rc.4b434d2.0

2 years ago

3.4.0-rc.335d537.0

2 years ago

3.3.0-rc.0

2 years ago

3.1.3

2 years ago

3.3.0

2 years ago

3.2.0

2 years ago

3.5.0

2 years ago

3.3.0-prerelease-7dd4060.0

2 years ago

3.3.0-prerelease-e8f9afe6a3a656fda722c8e9a5857ce2554a82d5.0

2 years ago

3.1.2

2 years ago

3.1.1

2 years ago

3.0.1

2 years ago

3.0.0

2 years ago

2.8.2

2 years ago

2.8.1

2 years ago

2.8.0

2 years ago

2.7.0

2 years ago

2.5.1

2 years ago

2.4.1

2 years ago

2.4.0

2 years ago

2.2.0

2 years ago