UI Internationalization

The @qualtrics/ui-i18n package contains translations for the Qualtrics Design System UI component libraries.

Usage

Install the package as a dependency

npm install --save @qualtrics/ui-i18n

There are various ways to import depending on the use case.

1. The default includes all the languages that have been translated for the module.

   import '@qualtrics/ui-i18n';

2. A single translation.

   import '@qualtrics/ui-i18n/dist/lang/DE.js';

Translation Generator

A generic translation generator has been included with this package and can be consumed by any other project to generate translations in the same way.

A config file is required to use the generator.

Usage

node node_modules/@qualtrics/ui-i18n/generate --config ./path/to/i18n.config.js

Command Line Arguments

• --config: Default: i18n.config.js. Specifies the location of the config file.

Configuration

• outputPath: The location to output the generated translations.
• teamId: The identifier for your team when consuming translations. See the Translations repo's README for more info.
• appId: A unique string identifier for the application that is accessing this endpoint. See the Translations repo's README for more info.
• data: The namespaces to consume. See the Translations repo's README for more info.

Example Config

i18n.config.js

module.exports = {
    outputPath: 'lang',
    teamId: 'cfe',
    appId: 'ui-i18n',
    data: ['QualtricsDesignSystemUI'],
};