Локализация Pivot

По умолчанию все ярлыки Pivot на английском языке. Некоторые из них можно перевести на желаемый язык:

ярлыки кнопок ("Table", "Chart", "Group By", и др.)
типы чартов ("Line", "Radar", "Bar", и др.)
операции ("min", "max", "sum", и др.)

В пакете Pivot присутствует только en-US локаль. Ознакомьтесь с нашим репозиторием. Здесь вы можете найти интересующую вас локаль или же создать свою.

Структура локали

Названия хранятся в объекте:

export default {
    // общее
    Done: "Done",
    Table: "Table",
    Tree: "Tree",
    Chart: "Chart",
    "Click to configure": "Click to configure",
    "Configure Pivot": "Configure Pivot",
    Total: "Total",
    // настройки
    Fields: "Fields",
    Methods: "Methods",
    Columns: "Columns",
    "Add column": "Add column",
    Rows: "Rows",
    "Add row": "Add row",
    "Clean rows": "Clean rows",
    Filters: "Filters",
    "Add filter": "Add filter",
    "Group By": "Group By",
    "Chart type": "Chart type",
    "Logarithmic scale": "Logarithmic scale",
    "X axis title": "X axis title",
    "Y axis title": "Y axis title",
    "Scale color": "Scale color",
    "Circled lines": "Circled lines",
    Horizontal: "Horizontal",
    Stacked: "Stacked",
    Lines: "Lines",
    Line: "Line",
    Radar: "Radar",
    Bar: "Bar",
    Area: "Area",
    Spline: "Spline",
    "Spline Area": "Spline Area",
    Pie: "Pie",
    Donut: "Donut",
    Values: "Values",
    "Add value": "Add value",
    "Field not defined": "Field not defined",
    Highlight: "Highlight",
    "Min X": "Min X",
    "Max X": "Max X",
    "Min Y": "Min Y",
    "Max Y": "Max Y",
    Footer: "Footer",
    "Total Column": "Total Column",
    Off: "Off",
    On: "On",
    "Sum Only": "Sum Only",
    "3D": "3D",
    "Show values inside": "Show values inside",
    // операции
    count: "count",
    max: "max",
    min: "min",
    avg: "avg",
    wavg: "wavg",
    any: "any",
    sum: "sum",
    complex: "complex",
    "Incorrect formula in values": "Incorrect formula in values",
};

Как задать свою локаль

Чтобы изменить локаль по умолчанию, необходимо:

1. Создать локаль с переводами внутри объекта pivot.locales следующим образом:

// русская локаль
pivot.locales.ru = {
    Table: "Таблица",
    Tree: "Дерево",
};

2. Задать текущую локаль для Pivot с помощью свойства locale внутри конструктора:

// настройка скролла (необязательно)
webix.CustomScroll.init();
 
webix.ui({
  view: "pivot",
  locale: {
    lang: "ru",
    webix: {
      // переключаем все виджеты в указанную локаль
      ru: "ru-RU"
    },
  },
  url:"https://docs.webix.com/pivot-backend/"
});

Related sample: Pivot: Custom Locale

Как переключать локали динамически

Вы можете менять языки динамически, например, при клике по соответствующим кнопкам на панели инструментов.

1. Создайте локали с переводом желаемых ярлыков:

// Русский
pivot.locales.ru = {  
    Table: "Таблица",
    Tree: "Дерево",
};
 
// Итальянский
pivot.locales.it = {
    Table: "Tabella",
    Tree: "Albero",
}

2. Меняйте языки с помощью метода setLang() сервиса "locale":

{
  view: "segmented",
  options: ["en", "ru", "it"],
  width: 250,
  click: function() {
    const locale = $$("pivot1").getService("locale");
    locale.setLang(this.getValue());
  }
}

Как синхронизировать Pivot и Webix локали

Маркеры Webix компонентов внутри Pivot, а также локализация дат и чисел зависят от текущей локали Webix. Чтобы синхронизировать локализацию Pivot и Webix, создайте объект webix внутри свойства locale:

{
  view:"pivot",
  url:"https://docs.webix.com/pivot-backend/",
  locale: {
    lang: "en",
    webix: {
      // переключаем текущую локаль Webix
      en: "en-US",
      it: "it-IT"
    }
  }
}

Наверх