serverList

Description

Определяет именованную коллекцию, которую можно загрузить в Units, Timeline views или Lightbox

serverList: (list_name: string, options?: any[]) => any[]

Parameters

• list_name - (required) string - имя списка
• options - (optional) array - необязательно, массив опций

Returns

• list - (array) - список опций

Example

// получает список опций по имени 'my_list'
var list = scheduler.serverList("my_list"); 
...
// создаёт и возвращает список с указанными опциями
var list = scheduler.serverList("options", [
    {key: 1, label: "John"},
    {key: 2, label: "Adam"},
    {key: 3, label: "Diane"}
]);

Related samples

• Populating a select editor from the server
• Loading Units sections from the server
• Multiselect control in the lightbox

Details

• При вызове с одним параметром метод возвращает список, связанный с этим именем, если он существует.
• При вызове с двумя параметрами создаётся новый список с заданным именем или перезаписывается существующий список с этим именем.

Списки, созданные с помощью этого метода, можно позже обновлять через метод scheduler.updateCollection.

В сценариях, когда необходимо обновлять коллекции, такие как опции select или списки units в Timeline или Units view, удобным решением является определение их как именованных списков опций.

scheduler.serverList("sections", [
    { key: 1, label: "Section A" },
    { key: 2, label: "Section B" },
    { key: 3, label: "Section C" },
    { key: 4, label: "Section D" }
]);

scheduler.config.lightbox.sections = [
    { 
        name: "description", height: 130, map_to: "text", type: "textarea", 
          focus: true 
    },
    { 
        name: "sections", type: "select",
          options: scheduler.serverList("sections"), map_to: "section_id"  /*!*/
    },
    { 
        name: "time", height: 72, type: "time", map_to: "auto" 
    }
]; 
...
// аналогично, используя список "units"
scheduler.createUnitsView({
    name: "unit",
    property: "section_id",
    list: scheduler.serverList("sections") /*!*/ 
});

scheduler.createTimelineView({
    name: "timeline",
    x_unit: "minute",
    x_date: "%H:%i",
    x_step: 30,
    x_size: 24,
    x_start: 16,
    x_length: 48,
    y_unit: scheduler.serverList("sections"), /*!*/
    y_property: "section_id",
    render: "bar"
});

scheduler.init("scheduler_here", new Date(), "unit");

Позже можно обновить опции везде с помощью метода scheduler.updateCollection:

scheduler.updateCollection("sections", [
    { key: 5, label: "Section E" },
    { key: 6, label: "Section F" },
    { key: 7, label: "Section G" }
]);

Related API

• updateCollection