@mescius/activereportsjs-i18n/readme.md

Localization resources for ActiveReportsJS

# ActiveReportsJS Localization

This package is part of [ActiveReportsJS](https://www.npmjs.com/package/@mescius/activereportsjs) and provides localization resources for both the Report Viewer and Report Designer components.

## Supported Languages

Localization support varies between components. Please refer to the lists below for the languages currently available:

### Report Viewer Component

The Report Viewer supports the following localizations:

-   English (`en`)
-   Japanese (`ja`)
-   Chinese (`zh`)
-   Korean (`ko`)
-   Dutch (`nl`)
-   German (`de`)
-   Italian (`it`)
-   Brazilian Portuguese (`pt-BR`)
-   French (`fr`)

### Report Designer Component

The Report Designer currently supports a more limited set of localizations:

-   English (`en`)
-   Japanese (`ja`)
-   Chinese (`zh`)
-   Korean (`ko`)
-   French (`fr`)
-   Italian (`it`)

## Installation and Usage

Install ARJS Localization package

```bash
npm install @mescius/activereportsjs-i18n
```

# ActiveReportsJS Viewer

1. Add reference to localization package

using html script tag:

```html
<script type="text/javascript" src="./dist/ar-js-locales.js"></script>
```

or import:

```javascript
import '@mescius/activereportsjs-i18n';
```

2. Pass necessary language to viewer using `language` property:

```javascript
var viewer = new MESCIUS.ActiveReportsJS.ReportViewer.Viewer('#root', { language: 'ja' });
```

or in components

```javascript
<Viewer language="ja" />
```

3. Also you can pass `language` property to `PageReport` ctr (can be used in exporting/printing reports without viewer):

```javascript
var pageReport = new ARJS.PageReport({ language: 'ja' });
```

# ActiveReportsJS Designer

1. Add reference to localization package

using html script tag:

```html
<script type="text/javascript" src="./dist/designer/ja-locale.js"></script>
```

2. Pass necessary language to designer using `language` property:

```javascript
var designer = new MESCIUS.ActiveReports.ReportDesigner.Designer('#designer-host', { language: 'ja' });
```

## Documentation

For more information on how to use ActiveReportsJS and available tools, refer to the [Documentation](https://developer.mescius.com/activereportsjs/docs/) or [API reference](https://developer.mescius.com/activereportsjs/api/) for guidance.