Skip to content
On this page

Language ​

DANGER

In view of the fact that more and more languages are bundled, starting from version 5.1.0, the core code of artplayer.js will no longer bundle other languages except Simplified Chinese and English, and you need to import the required language.

WARNING

When the language cannot be matched, English will be displayed by default, i18n writing reference: artplayer/types/i18n.d.ts

Default language ​

The default languages are: en, zh-cn, no need to import manually

js
var art = new Artplayer({
    container: '.artplayer-app',
    url: '/assets/sample/video.mp4',
    lang: 'zh-cn', // or 'en'
});

Import language ​

The language files before packaging are stored in: artplayer/src/i18n/*.js, welcome to add your language

The packaged language files are stored in: artplayer/dist/i18n/*.js

Manually imported languages are: cs, es, fa, fr, id, pl, ru, zh-tw

js
import id from 'artplayer/dist/i18n/id.js';
import zhTw from 'artplayer/dist/i18n/zh-tw.js';

var art = new Artplayer({
    container: '.artplayer-app',
    url: '/assets/sample/video.mp4',
    i18n: { 
        id: id,
        'zh-tw': zhTw,
    },
    lang: 'zh-tw',
});
js
<script src="artplayer/dist/i18n/id.js"></script>
<script src="artplayer/dist/i18n/zh-tw.js"></script>

var art = new Artplayer({
    container: '.artplayer-app',
    url: '/assets/sample/video.mp4',
    i18n: { 
        id: window['artplayer-i18n-id'],
        'zh-tw': window['artplayer-i18n-zh-tw'],
    },
    lang: 'zh-tw',
});

New language ​

js
var art = new Artplayer({
    container: '.artplayer-app',
    url: '/assets/sample/video.mp4',
    lang: 'your-lang',
    i18n: {
        'your-lang': {
            Play: 'Your Play'
        },
    },
});

Change language ​

js
import zhTw from 'artplayer/i18n/zh-tw.js';

var art = new Artplayer({
    container: '.artplayer-app',
    url: '/assets/sample/video.mp4',
    i18n: {
        // Change the default language
        'zh-cn': {
            Play: 'Your Play'
        },
        // Change the imported language
        'zh-tw': {
            ...zhTw,
            Play: 'Your Play'
        },
    },
});