ArtPlayer/packages/artplayer-vitepress/docs/en/start/i18n.md

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

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

::: code-group

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',
});

<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

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

Change language

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'
        },
    },
});