* update i18n

* update i18n
This commit is contained in:
Harvey Zack authored and GitHub committed 2023-08-26 13:22:19 +08:00
1 parent 9ba838aa52
commit e71a683dfd
38 files changed
+12194 -9690

No files matched your search

@@ -0,0 +1,104 @@
# 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](https://github.com/zhw2590582/ArtPlayer/blob/master/packages/artplayer/types/i18n.d.ts)
:::
## Default language
The default languages are: `en`, `zh-cn`, no need to import manually
```js{4}
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
```js [import]
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]
<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{4-9}
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'
},
},
});
```
@@ -1012,7 +1012,7 @@ var art = new Artplayer({
- Type: `String`
- Default: `navigator.language.toLowerCase()`
The default display language currently supports: `en`, `zh-cn`, `zh-tw`, `cs`, `pl`, `es`, `fa`, `fr`, `id`, `ru`
The default display language currently supports: `en`, `zh-cn`
<div className="run-code">▶ Run Code</div>
@@ -1024,6 +1024,12 @@ var art = new Artplayer({
});
```
:::warning More language setting
[/en/start/i18n.html](/en/start/i18n.html)
:::
## `i18n`
- Type: `Object`
@@ -1067,9 +1073,9 @@ var art = new Artplayer({
});
```
:::warning `i18n` definitions
:::warning More language setting
[artplayer/types/i18n.d.ts](https://github.com/zhw2590582/ArtPlayer/blob/master/packages/artplayer/types/i18n.d.ts)
[/en/start/i18n.html](/en/start/i18n.html)
:::