Локализация File Manager

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

  • названия действий ("Open", "Delete", etc.)
  • названия колонок
  • форматы дат
  • текст кнопок
  • имена папок по умолчанию

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

Структура локалей

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

export default {
    Save: "Save",
    "Save all": "Save all",
    Rename: "Rename",
    Open: "Open",
    Edit: "Edit",
    Delete: "Delete",
    Folder: "Folder",
    "Add New": "Add New",
    "My Files": "My Files",
    Size: "Size",
    Date: "Date",
    "back to parent folder": "back to parent folder",
    Download: "Download",
    Type: "Type",
    Information: "Information",
    Files: "Files",
    Table: "Table",
    Cards: "Cards",
    Total: "Total",
    "Are you sure ?": "Are you sure ?",
    Details: "Details",
    "Enter a new name": "Enter a new name",
    Add: "Add",
    "Select something": "Select something",
    "Download file": "Download file",
    Preview: "Preview",
    Refresh: "Refresh",
    "Are you sure you want to exit without saving?":
        "Are you sure you want to exit without saving?",
    "Save before closing?": "Save before closing?",
    Copy: "Copy",
    Cut: "Cut",
    Paste: "Paste",
    "Deleting...": "Deleting...",
    "Copying...": "Copying...",
    "Moving...": "Moving...",
    Folders: "Folders",
    "Search results": "Search results",
    "Search results in": "Search results in",
    "Search files and folders": "Search files and folders",
    "Add new file": "Add new file",
    "Add new folder": "Add new folder",
    "Upload file": "Upload file",
    "Upload folder": "Upload folder",
    folder: "folder",
    file: "file",
    archive: "archive",
    audio: "audio",
    image: "image",
    video: "video",
    code: "code",
    document: "document",
    of: "of",
    used: "used",
    "Open item location": "Open item location",
    "Are you sure you want to delete": "Are you sure you want to delete",
    "these items:": "these items:",
    "this item:": "this item:",
    "Delete files": "Delete files",
    and: "and",
    "more file(s)": "more file(s)",
    "Close the editor": "Close the editor",
    "Close this file": "Close this file",
};

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

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

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

// Русский перевод
fileManager.locales.ru = {
    Files: "Файлы",
    "My Files": "Моя полка"
};

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

webix.ready(function() {
    // пользовательский скролл, необязательно
    webix.CustomScroll.init();
 
    const fm = {
        view: "filemanager",
        id: "fm1",
        url: "//demo-wfs-ls.webix.dev/",
        locale: {
            lang: "ru"
        }
    };
 
    webix.ui(fm);
});

Related sample:  File Manager: Custom Locale

Как менять локали динамически

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

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

fileManager.locales.ru = {  // Русский
    Files: "Файлы", "My Files": "Моя полка", ...
};
 
fileManager.locales.zh = {  // Китайский
    Files: "檔案", "My Files": "我的檔案", ...
};

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

{
    rows: [
        {
            view: "segmented", options: ["en", "ru", "zh"],
            click: function() {
                const locale = $$("fm1").getService("locale");
                locale.setLang(this.getValue()); // zh, ru or en
            }
        },
        { view:"filemanager", id:"fm1" }
    ]
}

Related sample:  File Manager: Switching Locales

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

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

{
    view:"filemanager",
    id:"fm1",
    url:"https://demo-wfs-ls.webix.dev/",
    locale: {
        lang: "en",
        webix: {
            // смена Webix локалей
            en: "en-US",
            zh: "zh-CN"
        }
    }
}

Related sample:  File Manager: Switching Locales

Наверх
If you have not checked yet, be sure to visit site of our main product Webix web ui framework and page of javascript file explorer product.