本地化（Localization）

本地化功能允许您将 Gantt 图界面显示为您偏好的语言，如英语、西班牙语、法语等。默认情况下，dhtmlxGantt 使用 English locale。

启用语言环境

若需将 Gantt 图切换为英语以外的其他语言，只需通过 gantt.i18n 对象的 setLocale 方法激活所需的语言环境。

gantt.i18n.setLocale("fr");

您可以使用 dhtmlxgantt.js 文件中包含的任何预定义语言环境，也可以创建自定义语言环境。

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

Related sample:  Localization

预定义语言环境

语言	语言代码	翻译状态
阿拉伯语	ar	部分
白俄罗斯语	be	完整
英语	en	完整
加泰罗尼亚语	ca	部分
中文	cn	部分
克罗地亚语	hr	完整
捷克语	cs	部分
丹麦语	da	部分
荷兰语	nl	部分
芬兰语	fi	部分
法语	fr	完整
德语	de	完整
希腊语	el	部分
希伯来语	he	部分
匈牙利语	hu	部分
印度尼西亚语	id	部分
意大利语	it	部分
日语	jp	部分
韩语	kr	部分
挪威语	no	部分
挪威书面语	nb	部分
波斯语	fa	完整
波兰语	pl	部分
葡萄牙语	pt	部分
罗马尼亚语	ro	部分
俄语	ru	完整
斯洛伐克语	sk	部分
斯洛文尼亚语	si	部分
西班牙语	es	部分
瑞典语	sv	部分
土耳其语	tr	部分
乌克兰语	ua	部分

创建自定义语言环境

创建自定义语言环境最简单的方法是复制以下示例中的默认英语语言环境，然后将所有字符串翻译成所需语言。

您可以通过以下两种方式将自定义语言环境应用到 Gantt 图：

• 通过 setLocale 方法传递自定义语言对象，覆盖当前语言环境：

gantt.i18n.setLocale(localeObject);

如果只提供了部分语言对象，gantt 会将您的标签与现有语言环境合并：

gantt.i18n.setLocale({
    labels: {
        new_task: "New task"
    }
});

• 或者，如果需要在多个语言环境之间切换，可以使用自定义语言代码定义新语言环境，稍后再切换：

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

注意：

• 您可以将自定义语言文件发送到 support@dhtmlx.com，以便将其纳入未来版本。
• 当前激活的语言环境可通过 gantt.locale 对象访问。
• monthFull 包含从一月开始的完整月份名称；
• monthShort 包含从一月开始的月份缩写；
• dayFull 包含从星期天开始的完整星期名称；
• dayShort 包含从星期天开始的星期缩写。

English locale definition

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",
        gantt_save_btn: "New Label",
        gantt_cancel_btn: "New Label",
        gantt_delete_btn: "New Label",
        confirm_closing: "",// Your changes will be lost, are you sure?
        confirm_deleting: "Task will be deleted permanently, are you sure?",
        section_description: "Description",
        section_time: "Time period",
        section_type: "Type",
 
        /* 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: "Week",
        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_filter_placeholder: "type to filter",
        resources_filter_label: "hide empty"
    }
});

• 如果缺少 confirm_closing 或 confirm_deleting 标签，相应的确认对话框将不会显示（自动确认）。
• section_{name} 标签与 lightbox 中名称相同的分区对应。
• new_task 标签设置新任务的默认文本。

Back to top