本地化

本地化允许你将甘特图的界面以你希望的语言呈现：英语、西班牙语、法语等。 默认情况下，dhtmlxGantt 使用 English locale。

激活语言环境

要用非英语语言实现甘特图界面，你需要通过 gantt.i18n 对象的 setLocale 方法来激活所需的语言环境。

gantt.i18n.setLocale("fr");    

你可以使用并更新随 dhtmlxgantt.js 文件捆绑的任意 预定义语言环境，也可以定义自定义语言环境。

注释

语言环境可以动态切换，但只有在对甘特图进行一次完整的重绘后才会生效，重绘可通过 gantt.render() 或 gantt.init() 调用完成。

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

相关示例: 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	部分完成

创建自定义语言环境

注释

在 v7.0 中引入了 gantt.i18n 对象。在早期版本中，使用的是 gantt.locale 对象。更多信息，请参阅 迁移文章。

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

自定义语言环境可以通过两种方式应用到甘特图：

• 要么通过把语言环境对象作为参数传递给 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 标签定义了新事件的默认文本。