Локализация

Локализация позволяет представлять интерфейс диаграммы Гantt в нужном вам языке: английском, испанском, французском и т. д. По умолчанию dhtmlxGantt использует английскую локаль.

Активация локали

Чтобы реализовать диаграмму Гantt на языке, отличном от английского, вам нужно активировать нужную локаль через метод setLocale объекта gantt.i18n.

gantt.i18n.setLocale("fr");    

Вы можете использовать и обновлять любую из более чем 50 предопределённых локалей, которые идут в комплекте с файлом dhtmlxgantt.js, или определить собственную локаль.

заметка

Локаль можно переключать динамически, но изменения будут применены только после полного перерисовки диаграммы Гantt, либо вызовом gantt.render(), либо gantt.init().

gantt.i18n.setLocale("fr");
gantt.init("gantt_here");

Связанный пример: Localization

Предопределённые локали

заметка

Набор локалей, входящих в дистрибутив, был значительным образом расширен и переводы переработаны в версии v10.0, поэтому все предопределённые локали теперь поставляются с полным набором ярлыков.

Язык	Код языка	Статус перевода
африкаанс	af	полный
албанский	sq	полный
арабский	ar	полный
белорусский	be	полный
боснийский	bs	полный
болгарский	bg	полный
каталанский	ca	полный
китайский (упрощённый)	cn	полный
китайский (Гонконг)	zh_hk	полный
китайский (Тайвань)	zh_tw	полный
хорватский	hr	полный
чешский	cs	полный
датский	da	полный
голландский	nl	полный
голландский (Бельгия)	nl_be	полный
английский	en	полный
эстонский	et	полный
финский	fi	полный
французский (Франция)	fr	полный
французский (Канада)	fr_ca	полный
немецкий (Германия)	de	полный
немецкий (Австрия)	de_at	полный
греческий	el	полный
иврит	he	полный
венгерский	hu	полный
индонезийский	id	полный
ирландский	ga	полный
итальянский	it	полный
японский	jp	полный
корейский	kr	полный
латышский	lv	полный
литовский	lt	полный
македонский	mk	полный
малайский	ms	полный
норвежский (Бокмол)	nb	полный
норвежский (Нynorsk)	no	полный
персидский	fa	полный
польский	pl	полный
португальский (Португалия)	pt	полный
португальский (Бразилия)	pt_br	полный
румынский	ro	полный
русский	ru	полный
словацкий	sk	полный
словенский	si	полный
испанский (Испания)	es	полный
испанский (Мексика)	es_mx	полный
шведский	sv	полный
тайский	th	полный
турецкий	tr	полный
украинский	ua	полный
вьетнамский	vi	полный

Создание собственной локали

заметка

Объект gantt.i18n добавлен в v7.0. В предыдущих версиях использовался объект gantt.locale. Для получения дополнительной информации смотрите статью миграции (migration.md#63---70).

Самый простой способ создать собственную локаль — сделать копию локали по умолчанию (английской) из образца ниже и перевести все строки из неё на нужный язык.

Пользовательская локаль может применяться к диаграмме Гantt двумя способами:

• либо переопределить текущую локаль, передав объект локали в качестве параметра методу setLocale:

gantt.i18n.setLocale(localeObject);    

Примечание: если вы передаёте частичный объект локали, gantt добавит ваши ярлыки в текущую локаль:

gantt.i18n.setLocale({
    labels: {
        new_task: "Новая задача"
    }
});    

• или, если вам нужно переключаться между несколькими локалями, определить локаль с пользовательским языковым кодом и затем переключить диаграмму Гantt на неё позже:

gantt.i18n.addLocale("lang", localeObject);    
gantt.i18n.setLocale("lang");

Примечание,

• Вы можете отправить ваш файл пользовательской локали на support@dhtmlx.com — и мы включим его в следующий релиз.
• Текущая активная локаль также доступна в объекте gantt.locale
• month_full — полные названия месяцев, начиная с января;
• month_short — краткие названия месяцев, начиная с января;
• day_full — полные названия дней недели, начиная с воскресенья;
• day_short — краткие названия дней недели, начиная с воскресенья.

Определение английской локали

gantt.i18n.setLocale({
    date: {
        month_full: ["January", "February", "March", "April", "May", "June", 
            "July", "August", "September", "October", "November", "December"],
        month_short: ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", 
            "Aug", "Sep", "Oct", "Nov", "Dec"],
        day_full: ["Sunday", "Monday", "Tuesday", "Wednesday", "Thursday",
             "Friday", "Saturday"],
        day_short: ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"]
    },
    labels: {
        new_task: "New task",
        icon_save: "Save",
        icon_cancel: "Cancel",
        icon_details: "Details",
        icon_edit: "Edit",
        icon_delete: "Delete",
        confirm_deleting: "Task will be deleted permanently, are you sure?",
        section_description: "Description",
        section_time: "Time period",
        section_type: "Type",
        section_deadline: "Deadline",
        section_baselines: "Baselines",
        section_new_resources: "Resources",

        /* grid columns */
        column_wbs: "WBS",
        column_text: "Task name",
        column_start_date: "Start time",
        column_duration: "Duration",
        column_add: "",

        /* link confirmation */
        link: "Link",
        confirm_link_deleting: "will be deleted",
        link_start: " (start)",
        link_end: " (end)",

        type_task: "Task",
        type_project: "Project",
        type_milestone: "Milestone",

        minutes: "Minutes",
        hours: "Hours",
        days: "Days",
        weeks: "Weeks",
        months: "Months",
        years: "Years",

        /* message popup */
        message_ok: "OK",
        message_cancel: "Cancel",

        /* constraints */
        section_constraint: "Constraint",
        constraint_type: "Constraint type",
        constraint_date: "Constraint date",
        asap: "As Soon As Possible",
        alap: "As Late As Possible",
        snet: "Start No Earlier Than",
        snlt: "Start No Later Than",
        fnet: "Finish No Earlier Than",
        fnlt: "Finish No Later Than",
        mso: "Must Start On",
        mfo: "Must Finish On",

        /* resource control */
        resources_add_button: "Add Assignment",
        resources_filter_placeholder: "Search...",
        resources_filter_label: "hide empty",
        resources_section_placeholder: "Nothing assigned yet. Click 'Add Assignment' to assign resources.",

        /* empty state screen */
        empty_state_text_link: "Click here",
        empty_state_text_description: "to create your first task",

        /* baselines control */
        baselines_section_placeholder: "Start adding a new baseline",
        baselines_add_button: "Add Baseline",
        baselines_remove_button: "Remove",
        baselines_remove_all_button: "Remove All",

        /* deadline control */
        deadline_enable_button: "Set",
        deadline_disable_button: "Remove"
    }
});

• Если метка confirm_closing или confirm_deleting не определена — соответствующий диалог подтверждения вообще не будет отображаться (авто-подтверждение);
• Метка section_(name) относится к разделу lightbox соответствующего имени.
• Метка new_task задаёт текст по умолчанию для нового события.