Angular Data Grid Language change in Angular

Change the default language of the context menu from English to any of the built-in translations, using the language property.

In this article

• Example
• Related articles
  • Related guides
  • Related API reference

Example

The following example is an implementation of the @handsontable/angular component with an option to change the Context Menu language.

Select a language from the selector above the table and open the Context Menu to see the result.

/* file: app.component.ts */ import { Component } from '@angular/core'; import { registerLanguageDictionary, getLanguagesDictionaries, deCH, deDE, esMX, frFR, itIT, jaJP, koKR, lvLV, nbNO, nlNL, plPL, ptBR, ruRU, zhCN, zhTW } from 'handsontable/i18n'; import Handsontable from 'handsontable/base'; registerLanguageDictionary(deCH); registerLanguageDictionary(deDE); registerLanguageDictionary(esMX); registerLanguageDictionary(frFR); registerLanguageDictionary(itIT); registerLanguageDictionary(jaJP); registerLanguageDictionary(koKR); registerLanguageDictionary(lvLV); registerLanguageDictionary(nbNO); registerLanguageDictionary(nlNL); registerLanguageDictionary(plPL); registerLanguageDictionary(ptBR); registerLanguageDictionary(ruRU); registerLanguageDictionary(zhCN); registerLanguageDictionary(zhTW); @Component({ selector: 'app-root', template: ` <div class="controls select-language"><label>Select language of the context menu: <select [(ngModel)]="language"> <option *ngFor="let l of languages" [value]="l.languageCode">{{l.languageCode}}</option> </select></label></div> <div> <hot-table [language]="language" [settings]="hotSettings"></hot-table> </div> `, }) export class AppComponent { hotSettings: Handsontable.GridSettings = { data: [ ['A1', 'B1', 'C1', 'D1', 'E1'], ['A2', 'B2', 'C2', 'D2', 'E2'], ['A3', 'B3', 'C3', 'D3', 'E3'], ['A4', 'B4', 'C4', 'D4', 'E4'], ['A5', 'B5', 'C5', 'D5', 'E5'], ], colHeaders: true, rowHeaders: true, contextMenu: true, height: 'auto', autoWrapRow: true, autoWrapCol: true, licenseKey: 'non-commercial-and-evaluation' }; language = 'en-US'; languages = getLanguagesDictionaries(); } /* file: app.module.ts */ import { NgModule } from '@angular/core'; import { FormsModule } from '@angular/forms'; import { BrowserModule } from '@angular/platform-browser'; import { HotTableModule } from '@handsontable/angular'; import { registerAllModules } from 'handsontable/registry'; // register Handsontable's modules registerAllModules(); @NgModule({ imports: [ BrowserModule, FormsModule, HotTableModule ], declarations: [ AppComponent ], bootstrap: [ AppComponent ] }) export class AppModule { } import { platformBrowserDynamic } from '@angular/platform-browser-dynamic'; platformBrowserDynamic() .bootstrapModule(AppModule) .catch(err => { console.error(err) }); <script src="https://cdn.jsdelivr.net/npm/handsontable@14.1/dist/handsontable.full.min.js"></script> <link type="text/css" rel="stylesheet" href="https://cdn.jsdelivr.net/npm/handsontable@14.1/dist/handsontable.full.min.css" /> <script src="https://cdn.jsdelivr.net/npm/handsontable@14.1/languages/all.js"></script> <script src="https://handsontable.com/docs/14.1/scripts/fixer.js"></script> <script src="https://cdn.jsdelivr.net/npm/rxjs@6/bundles/rxjs.umd.js"></script> <script src="https://cdn.jsdelivr.net/npm/core-js@2/client/core.min.js"></script> <script src="https://cdn.jsdelivr.net/npm/zone.js@0.11.4/dist/zone.min.js"></script> <script src="https://cdn.jsdelivr.net/npm/@angular/compiler@12/bundles/compiler.umd.min.js"></script> <script src="https://cdn.jsdelivr.net/npm/@angular/core@12/bundles/core.umd.min.js"></script> <script src="https://cdn.jsdelivr.net/npm/@angular/common@12/bundles/common.umd.min.js"></script> <script src="https://cdn.jsdelivr.net/npm/@angular/forms@12/bundles/forms.umd.min.js"></script> <script src="https://cdn.jsdelivr.net/npm/@angular/platform-browser@12/bundles/platform-browser.umd.min.js"></script> <script src="https://cdn.jsdelivr.net/npm/@angular/platform-browser-dynamic@12/bundles/platform-browser-dynamic.umd.min.js"></script> <script src="https://cdn.jsdelivr.net/npm/@handsontable/angular@14.1/bundles/handsontable-angular.umd.js"></script> <app-root></app-root>

/* file: app.component.ts */
import { Component } from '@angular/core';
import {
  registerLanguageDictionary,
  getLanguagesDictionaries,
  deCH,
  deDE,
  esMX,
  frFR,
  itIT,
  jaJP,
  koKR,
  lvLV,
  nbNO,
  nlNL,
  plPL,
  ptBR,
  ruRU,
  zhCN,
  zhTW
} from 'handsontable/i18n';
import Handsontable from 'handsontable/base';

registerLanguageDictionary(deCH);
registerLanguageDictionary(deDE);
registerLanguageDictionary(esMX);
registerLanguageDictionary(frFR);
registerLanguageDictionary(itIT);
registerLanguageDictionary(jaJP);
registerLanguageDictionary(koKR);
registerLanguageDictionary(lvLV);
registerLanguageDictionary(nbNO);
registerLanguageDictionary(nlNL);
registerLanguageDictionary(plPL);
registerLanguageDictionary(ptBR);
registerLanguageDictionary(ruRU);
registerLanguageDictionary(zhCN);
registerLanguageDictionary(zhTW);

@Component({
  selector: 'app-root',
  template: `
    <div class="controls select-language"><label>Select language of the context menu:
    <select [(ngModel)]="language">
      <option *ngFor="let l of languages" [value]="l.languageCode">{{l.languageCode}}</option>
    </select></label></div>
    <div>
      <hot-table [language]="language" [settings]="hotSettings"></hot-table>
    </div>
  `,
})
export class AppComponent {
  hotSettings: Handsontable.GridSettings = {
    data: [
      ['A1', 'B1', 'C1', 'D1', 'E1'],
      ['A2', 'B2', 'C2', 'D2', 'E2'],
      ['A3', 'B3', 'C3', 'D3', 'E3'],
      ['A4', 'B4', 'C4', 'D4', 'E4'],
      ['A5', 'B5', 'C5', 'D5', 'E5'],
    ],
    colHeaders: true,
    rowHeaders: true,
    contextMenu: true,
    height: 'auto',
    autoWrapRow: true,
    autoWrapCol: true,
    licenseKey: 'non-commercial-and-evaluation'
  };
  language = 'en-US';
  languages = getLanguagesDictionaries();
}

/* file: app.module.ts */
import { NgModule } from '@angular/core';
import { FormsModule } from '@angular/forms';
import { BrowserModule } from '@angular/platform-browser';
import { HotTableModule } from '@handsontable/angular';
import { registerAllModules } from 'handsontable/registry';
import { AppComponent } from './app.component';

// register Handsontable's modules
registerAllModules();

@NgModule({
  imports: [ BrowserModule, FormsModule, HotTableModule ],
  declarations: [ AppComponent ],
  bootstrap: [ AppComponent ]
})
export class AppModule { }

<app-root></app-root>

Related articles

Related guides

• Language
• Layout direction
• Locale

Related API reference

• Configuration options:
  • language
  • layoutDirection
  • locale
• Core methods:
  • getDirectionFactor()
  • getTranslatedPhrase()
  • isLtr()
  • isRtl()
• Hooks:
  • afterLanguageChange
  • beforeLanguageChange