Internationalization

JSON Schema just a JSON object, it's support for internationalization. In addition, sf also supports some faster internationalization methods, but the elements it supports are based on the following: title, description, optionalHelp

Examples

Basic Usage

The name element uses built-in i18n method; password uses external i18n method.

expand codeexpand code
import { Component, Inject, ViewChild } from '@angular/core';
import { I18NService } from '@core';
import { SFComponent, SFSchema } from '@delon/form';
import { ALAIN_I18N_TOKEN } from '@delon/theme';
import { NzMessageService } from 'ng-zorro-antd/message';

@Component({
  selector: 'form-i18n-simple',
  template: `
    <button nz-button type="button" (click)="changeLang('srv')">Change Language Via Service</button>
    <button nz-button type="button" (click)="changeLang('ref')">Change Language Via call refresh schema</button>
    <sf #sf [schema]="schema" (formSubmit)="submit($event)"></sf>
  `,
})
export class FormI18nSimpleComponent {
  @ViewChild('sf', { static: true }) comp!: SFComponent;
  schema = this.i18nSchema;

  private get i18nSchema(): SFSchema {
    return {
      properties: {
        name: {
          type: 'string',
          ui: {
            i18n: 'sf.name',
            descriptionI18n: 'sf.description',
            optionalHelp: {
              i18n: 'sf.description',
            },
          },
        },
        password: {
          type: 'string',
          title: this.i18n.fanyi('sf.name'),
          description: this.i18n.fanyi('sf.description'),
          ui: {
            type: 'password',
          },
        },
      },
      required: ['name', 'password'],
    };
  }

  constructor(private msg: NzMessageService, @Inject(ALAIN_I18N_TOKEN) private i18n: I18NService) {}

  changeLang(type: 'srv' | 'ref'): void {
    this.i18n.use(this.i18n.zone === 'zh' ? 'en-US' : 'zh-CN');
    if (type === 'ref') {
      this.comp.refreshSchema(this.i18nSchema);
    }
  }

  submit(value: {}): void {
    this.msg.success(JSON.stringify(value));
  }
}