vant/src/locale

Internationalization

Intro

Vant uses Chinese as the default language. If you want to use other languages, please follow the instructions below.

Usage

Switch languages

Vant supports multiple languages with the Locale component, and the Locale.use method allows you to switch to different languages.

import { Locale } from 'vant';
import enUS from 'vant/es/locale/lang/en-US';

Locale.use('en-US', enUS);

Override default configs

Use Locale.add method to modify the default configs.

import { Locale } from 'vant';

const messages = {
  'en-US': {
    vanPicker: {
      confirm: 'Close',
    },
  },
};

Locale.add(messages);

Config files

Current supported languages:

Language	Filename
Chinese	zh-CN
Traditional Chinese (HK)	zh-HK
Traditional Chinese (TW)	zh-TW
German	de-DE
German (formal)	de-DE-formal
English	en-US
Spanish (Spain)	es-ES
Japanese	ja-JP
Norwegian	nb-NO
Romanian	ro-RO
Turkish	tr-TR
Thai	th-TH

View all language configs Here.

Add new language

If you can’t find the language you need, please send us a Pull Request to add the new language pack, you can refer to Add German language pack PR.