svelte-i18n

svelte-i18n

Internationalization for Svelte.

svelte-i18n helps you localize your app using the reactive tools Svelte provides. By using stores to keep track of the current locale, dictionary of messages and to format messages, we keep everything neat, in sync and easy to use on your svelte files.

Requirements

• Node: >= 11.15.0
• Browsers: Chrome 38+, Edge 12+, Firefox 13+, Opera 25+, Safari 8+.

<script>
  import { _ } from 'svelte-i18n'
</script>

<h1>{$_('page.home.title')}</h1>

<nav>
  <a>{$_('page.home.nav', { default: 'Home' })}</a>
  <a>{$_('page.about.nav', { default: 'About' })}</a>
  <a>{$_('page.contact.nav', { default: 'Contact' })}</a>
</nav>

// en.json
{
  "page": {
    "home": {
      "title": "Homepage",
      "nav": "Home"
    },
    "about": {
      "title": "About",
      "nav": "About"
    },
    "contact": {
      "title": "Contact",
      "nav": "Contact Us"
    }
  }
}

Go to documentation

Changelog

2.1.0 (2019-11-30)

Bug Fixes

• 🐛 allow to wait for initial locale load (0b7f61c)
• 🐛 fallback behaviour and simplify API contact points (64e69eb)
• 🐛 consider generic locales when registering loaders (1b0138c)
• 🐛 flush use the same promise if it wasn't resolved yet (66972d4)
• client locale parameters typo (#11) (d1adf4c)

Features

• 🎸 add warnOnMissingMessages (efbe793)

• 🐛 fallback behaviour and simplify API contact points (6e0df2f

• 🎸 addMessagesTo method (d6b8664)

• 🎸 add $loading indicator store (bd2b350)

• 🎸 add custom formats support (d483244)

• 🎸 add pathname and hostname pattern matching (b19b690)

• 🎸 add preloadLocale method (0a0e4b3)

• 🎸 add waitInitialLocale helper (6ee28e7)

• 🎸 also look for message in generic locale (e5d7b84), closes #19

• 🎸 export a store listing all locales available (f58a20b)

• 🎸 locale change automatically updates the document lang (64c8e55)

Performance Improvements

• ⚡️ delay the $loading state change for quick loadings (6573f51)

BREAKING CHANGES

• This PR modifies the formatter method arguments.