Кастомизация Scheduler

Scheduler это комплексный виджет, разработанный с помощью MV* фреймворка Webix Jet. Это готовое приложение с минимальной конфигурацией и специальным API для переопределения логики внутренних модулей.

Jet приложение и внутренние модули

Scheduler построен как Jet приложение в обёртке Webix компонента, поэтому вы можете инициализировать его любым из двух способов.

Компоненты

Интерфейс Scheduler разбит по частям (компонентам). Каждый компонент, это класс, который наследуется от класса JetView и имеет свои методы и конфигурацию.

Исходный код частей интерфейса (компонентов Jet) находится в папке sources/views.

views
  events
  bars
    nav.js
    date.js
  ...

Модели/Сервисы

В моделях Scheduler описана логика для работы с календарями и событиями. В Webix Jet модели называются сервисами.

Исходный код для моделей (сервисов Jet) находятся в папке sources/models.

models
  LocalData.js
  Operations.js
  Backend.js

Методы сервисов вызываются самим интерфейсом, но также могут быть вызваны программистом напрямую:

$$('scheduler').getService('operations').addCalendar(obj);

Кастомизация компонентов

При кастомизации компонента вы можете:

• переопределить метод config(), чтобы изменить UI
• переопределить метод init(), чтобы изменить UI и поведение компонента
• переопределить любой существующий метод, но делайте это с осторожностью
• добавлять и вызывать свои методы

Чтобы определить, какой компонент отвечает за нужную часть интерфейса, обратитесь к карте классов.

Для начала создайте класс и наследуйте его от класса по умолчанию или от scheduler.views.JetView:

class CustomHours extends scheduler.views["modes/common/hourscale"] {
  config(){
    // получаем JSON объект с конфигурацией
    const ui = super.config();
    // изменения конкретного компонента
    ui.width = 60;
    return ui;
  }
  init() {
    // вызываем логику по умолчанию 
    super.init();
    // а это уже пользовательский метод
    this.doSomething();
  }
  doSomething(){
    // делаем что-то при инициализации
  }
}

Затем переопределите компонент (класс) по умолчанию с помощью свойства override:

webix.ui({
    view: 'scheduler',
    url: 'https://docs.webix.com/calendar-backend/',
    override: new Map([[scheduler.views['modes/common/hourscale'], CustomHours]]),
});

Как убрать режимы работы с панели

Чтобы убрать какие-либо вкладки (контролы для переключения режима работы) с верхнего тулбара, вам необходимо переопределить опции для NavBarView. Обратите внимание, что ID вкладок должны совпадать с названиями режимов работы.

class CustomBarsView extends scheduler.views['bars/nav'] {
    config() {
        const ui = super.config();
        ui.options = [
            { id: 'week', value: 'Week' },
            { id: 'month', value: 'Month' },
        ];
        return ui;
    }
}

Related sample:  Scheduler: Limited Tabs

Рекомендации

Скрытие компонентов

Мы не рекомендуем удалять компоненты из интерфейса, т.к. внутренняя логика может всё ещё обращаться к ним. Вместо этого вы можете скрывать компоненты.

class CustomBar extends scheduler.views["bars/add"] {
  init(view) {
    // логика по умолчанию 
    super.init(view);
    // прячем календарь на боковой панели
    view.queryView("calendar").hide();
  }
}

Доступ к экземплярам компонентов

Внутри Jet-компонента получить экземпляр компонента можно двумя способами.

Метод $$(id) у JetView работает для внутреннего компонента, у которого задана настройка localId:

init() {
    // исходная логика
    super.init();
    // получаем экземпляр компонента с localId = "form"
    const form = this.$$("form");
}

Если localId не задан, используйте queryView:

init(view) {
    // исходная логика
    super.init();
    // получаем экземпляр первой кнопки 
    const button = view.queryView("button");
}

Проверка компактного режима

Определить, в компактном ли режиме находится приложение, можно из любого компонента или сервиса:

const compact = this.getParam('compact', true);

Получение свойств состояния

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

const state = this.app.getState();
// или 
const state = this.getParam("state");

Кастомизация сервисов Jet

При кастомизации сервиса вы можете:

• добавлять и вызывать свои методы
• переопределить любой существующий метод, но делайте это с осторожностью

Прежде всего создайте свой класс сервиса и наследуйте его от класса сервиса по умолчанию:

class MyBackend extends scheduler.services.Backend {
    calendars() {
        // клиентские данные
        return webix.promise.resolve(calendars);
    }
}

Затем переопределите класс по умолчанию вашим с помощью свойства override:

webix.ui({
    view: 'scheduler',
    url: 'http://localhost:3200/',
    override: new Map([[scheduler.services.Backend, MyBackend]]),
});

Related sample:  Scheduler: Local Data

Обратная совместимость

Scheduler - это гибкий компонент: вы можете менять в нём практически всё. Однако помните о следующем:

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

Наверх