本地化

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

激活语言环境

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

gantt.i18n.setLocale("fr");    

你可以使用并更新随 dhtmlxgantt.js 文件打包的 50 多个 预定义语言环境 中的任一语言环境，或定义一个自定义语言环境。

注释

语言环境可以动态切换，但更改将仅在对甘特图进行完整重绘后生效，重绘方式为 gantt.render() 或 gantt.init() 调用。

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

相关示例: Localization

预定义语言环境

注释

在 v10.0 版本中，随包提供的语言环境集合得到了显著扩展，翻译也重新整理，因此所有预定义语言环境现在都带有完整的标签集。

Language	Language code	Translation status
非洲荷兰语	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	完整
挪威语（Bokmål）	nb	完整
挪威语（Nynorsk）	no	完整
波斯语	fa	完整
波兰语	pl	完整
葡萄牙语（葡萄牙）	pt	完整
葡萄牙语（巴西）	pt_br	完整
罗马尼亚语	ro	完整
俄语	ru	完整
斯洛伐克语	sk	完整
斯洛文尼亚语	si	完整
西班牙语（西班牙）	es	完整
西班牙语（墨西哥）	es_mx	完整
瑞典语	sv	完整
泰语	th	完整
土耳其语	tr	完整
乌克兰语	ua	完整
越南语	vi	完整

创建自定义语言环境

注释

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

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

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

• 要么通过将语言环境对象作为参数传递给 setLocale 方法来覆盖当前语言环境：

gantt.i18n.setLocale(localeObject);    

注意，如果你提供了部分语言环境对象，gantt 会将你的标签添加到当前语言环境中：

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

• 或者，如果你需要在多种语言环境之间切换，请使用自定义语言代码定义语言环境，然后稍后将 gantt 切换到它：

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

注，

• 你可以将你的自定义语言环境文件发送至 support@dhtmlx.com - 我们将在下一个版本中将其包含。
• 当前活动的语言环境也可在 gantt.locale 对象中访问
• month_full - 从一月开始的月份全名；
• month_short - 从一月开始的月份简称；
• day_full - 从星期日开始的一周日名称的全称；
• day_short - 从星期日开始的一周日名称的简称。

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",
        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) 标签指的是相关名称的灯箱中的部分。
• new_task 标签定义了新事件的默认文本。