本地化（Localization）
本地化功能允许您将 Gantt 图界面显示为您偏好的语言，如英语、西班牙语、法语等。默认情况下，dhtmlxGantt 使用 English locale。
启用语言环境
若需将 Gantt 图切换为英语以外的其他语言，只需通过 gantt.i18n 对象的 setLocale 方法激活所需的语言环境。
gantt.i18n.setLocale("fr");
您可以使用 dhtmlxgantt.js 文件中包含的任何预定义语言环境，也可以创建自定义语言环境。
注释
语言环境可以动态切换，但只有在 Gantt 图完全重绘（通过 gantt.render() 或 gantt.init()）后，更新才会生效。
gantt.i18n.setLocale("fr");
gantt.init("gantt_here");
预定义语言环境
| 语言 | 语言代码 | 翻译状态 |
| 阿拉伯语 | 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.i18n 对象从 v7.0 版本引入。早期版本使用 gantt.locale 对象。详情请参阅 迁移指南。
创建自定义语言环境最简单的方法是复制以下示例中的默认英语语言环境，然后将所有字符串翻译成所需语言。
您可以通过以下两种方式将自定义语言环境应用到 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 标签设置新任务的默认文本。