Локализация

Библиотека поддерживает локализацию планировщика, предоставляя набор предопределённых локалей и способ создания пользовательских. По умолчанию DHTMLX Scheduler использует английскую локаль.

Активация

Чтобы задать желаемый язык для планировщика, активируйте необходимую локаль через метод setLocale() объекта scheduler.i18n.

scheduler.i18n.setLocale("fr");

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

примечание

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

scheduler.i18n.setLocale("fr");
scheduler.init("scheduler_here");

Связанные образцы

• Localization

Включённые локали

примечание

И Common, и Recurring локали хранятся внутри файла dhtmlxscheduler.js.

dhtmlxScheduler включает локализацию для следующих языков:

Язык	Код языка
Арабский	ar
Белорусский	be
Каталанский	ca
Китайский	cn
Чешский	cs
Датский	da
Нидерландский	nl
Английский	en (default)
Финский	fi
Французский	fr
Немецкий	de
Греческий	el
Иврит	he
Венгерский	hu
Индонезийский	id
Итальянский	it
Японский	jp
Норвежский	no
Норвежский Бокмаль	nb
Польский	pl
Португальский	pt
Румынский	ro
Русский	ru
Словацкий	sk
Словенский	si
Испанский	es
Шведский	sv
Турецкий	tr
Украинский	ua

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

примечание

Объект scheduler.i18n добавлен в версии v6.0. В предыдущих версиях использовался объект scheduler.locale. Для дополнительной информации см. статью миграции в разделе Migration article (migration.md#53---60).

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

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

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

scheduler.i18n.setLocale(localeObject);

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

scheduler.i18n.setLocale({
    labels: {
        day_tab: "Day",
    }
});

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

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

примечание

Обратите внимание: активация пользовательской локали в приложении приведёт к изменениям во внешнем виде интерфейса. Проверьте и при необходимости переопределите все элементы, зависящие от локали, чтобы планировщик выглядел корректно на новом языке.

Примечание

• Вы можете прислать свой файл локали на support@dhtmlx.com, чтобы мы могли включить его в следующий релиз.
• Активная локаль также доступна в объекте scheduler.locale.
• monthFull - полные названия месяцев, начиная с января
• monthShort - сокращённые названия месяцев, начиная с января
• dayFull - полные названия дней недели, начиная с воскресенья
• dayShort - сокращённые названия дней недели, начиная с воскресенья

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

scheduler.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: {
        dhx_cal_today_button: "Today",
        day_tab: "Day",
        week_tab: "Week",
        month_tab: "Month",
        new_event: "New event",
        icon_save: "Save",
        icon_cancel: "Cancel",
        icon_details: "Details",
        icon_edit: "Edit",
        icon_delete: "Delete",
        confirm_closing: "", // Your changes will be lost, are your sure?
        confirm_deleting: "Event will be deleted permanently, are you sure?",
        section_description: "Description",
        section_time: "Time period",
        full_day: "Full day",

        /* recurring events */
        confirm_recurring: "Edit recurring event",
        section_recurring: "Repeat event",
        button_recurring: "Disabled",
        button_recurring_open: "Enabled",
        button_edit_series: "All events",
        button_edit_occurrence: "This event",
        button_edit_occurrence_and_following: "This and following events",

        /* agenda view extension */
        agenda_tab: "Agenda",
        date: "Date",
        description: "Description",

        /* year view extension */
        year_tab: "Year",

        /* week agenda extension */
        week_agenda_tab: "Agenda",

        /* grid view extension */
        grid_tab: "Grid",

        /* touch tooltip */
        drag_to_create: "Drag to create",
        drag_to_move: "Drag to move",

        /* dhtmlx message default buttons */
        message_ok: "OK",
        message_cancel: "Cancel",

        /* wai aria labels for non-text controls */
        next: "Next",
        prev: "Previous",
        year: "Year",
        month: "Month",
        day: "Day",
        hour: "Hour",
        minute: "Minute",

        /* legacy  recurring event components */
        repeat_radio_day: "Daily", // name="repeat" value="day"
        repeat_radio_week: "Weekly", // name="repeat" value="week
        repeat_radio_month: "Monthly",
        repeat_radio_year: "Yearly",
        repeat_radio_day_type: "Every",
        repeat_text_day_count: "day",
        repeat_radio_day_type2: "Every workday",
        repeat_week: " Repeat every",
        repeat_text_week_count: "week next days:",
        repeat_radio_month_type: "Repeat",
        repeat_radio_month_start: "On",
        repeat_text_month_day: "day every",
        repeat_text_month_count: "month",
        repeat_text_month_count2_before: "every",
        repeat_text_month_count2_after: "month",
        repeat_year_label: "On",
        select_year_day2: "of",
        repeat_text_year_day: "day",
        select_year_month: "month",
        repeat_radio_end: "No end date",
        repeat_text_occurrences_count: "occurrences",
        repeat_radio_end2: "After",
        repeat_radio_end3: "End by",

        /* recurring event components */
        repeat_never: "Never",
        repeat_daily: "Every day",
        repeat_workdays: "Every weekday",
        repeat_weekly: "Every week",
        repeat_monthly: "Every month",
        repeat_yearly: "Every year",
        repeat_custom: "Custom",
        repeat_freq_day: "Day",
        repeat_freq_week: "Week",
        repeat_freq_month: "Month",
        repeat_freq_year: "Year",
        repeat_on_date: "On date",
        repeat_ends: "Ends",
        month_for_recurring: ["January", "February", "March", "April", "May", "June",
            "July", "August", "September", "October", "November", "December"],
        day_for_recurring: ["Sunday", "Monday", "Tuesday", "Wednesday", "Thursday",
            "Friday", "Saturday"]
    }
});

Связанные образцы

• Localization

Дополнительные заметки

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