createTimelineView

richtet die Timeline-Ansicht im Scheduler ein

void createTimelineView(object config);
configobjectDas Konfigurationsobjekt für die Timeline-Ansicht

Available only in PRO Edition

Example

// Zeitskala von 8 Uhr bis 20 Uhr mit 30-Minuten-Intervallen
scheduler.createTimelineView({
    name: "timeline",
    x_unit: "minute",
    x_date: "%H:%i",
    x_step: 30,
    x_size: 24,
    x_start: 16,
    x_length: 48,
    fit_events_offset: 15,
    y_unit:[    
        {key:1, label:"Section A"},
        {key:2, label:"Section B"},
        {key:3, label:"Section C"},
        {key:4, label:"Section D"}  
    ],
    y_property: "section_id",
    render: "bar"
});

Applicable views:Timeline-Ansicht

Related samples

Details

Dieses Feature ist nur in der PRO-Edition verfügbar.

Die Methode setzt voraus, dass das timeline Plugin aktiviert ist.

Das Konfigurationsobjekt der Timeline-Ansicht unterstützt folgende Eigenschaften:

  • name- (string) der Bezeichner der Ansicht. Die Definition eines Namens, der mit einer bestehenden Timeline-Ansicht übereinstimmt, überschreibt diese
  • render - ('cell', 'bar', 'tree', 'days') definiert den Modus der Ansicht. Standard ist 'cell'
  • y_property - (string) die Dateneigenschaft, die verwendet wird, um Events bestimmten Abschnitten zuzuordnen
  • y_unit - (Array von Objekten) definiert die Abschnitte in der Ansicht.
    Jedes Objekt repräsentiert einen Abschnitt mit folgenden Eigenschaften:
    • children - (Array) verschachtelte Einträge nur für den 'Tree'-Modus
    • key - (string) die ID des Abschnitts, die mit der Event-Eigenschaft abgeglichen wird, um Events zuzuordnen
    • label - (string) die Anzeige-Bezeichnung des Abschnitts
    • open - (boolean) ob der Abschnitt initial geöffnet ist (für 'Tree'-Modus)
  • days - (number) Anzahl der Elemente (Tage) auf der Y-Achse, relevant nur für den 'Days'-Modus
  • x_unit - (minute, hour, day, week, month, year) Maßeinheit für die X-Achse. Standard ist 'minute'
  • x_date - (string) Datumsformat für die X-Achse (siehe Datumsformat-Spezifikation). Falls nicht gesetzt, wird das Format aus hour_date verwendet
  • x_step - (number) Schrittgröße auf der X-Achse in Einheiten von 'x_unit'. Standard ist 1
  • x_start - (number) Offset auf der X-Achse in Einheiten von 'x_unit'. Standard ist 0
  • x_size - (number) Gesamtlänge der X-Achse, ausgedrückt als Anzahl von 'x_step'-Schritten. Standard ist 24
  • x_length - (number) Anzahl der 'x_step'-Schritte, die beim Klick auf den 'next'-Button im Scheduler-Header gescrollt werden. Optional, Standard ist 1.
    Dieser Parameter ist etwas komplex; beachten Sie:
    • Er gilt nur, wenn x_unit='minute' oder x_unit='hour' gesetzt ist. Andernfalls kann er weggelassen werden.
    • Ohne gesetztes x_length für diese Einheiten zeigt die Timeline ein Teilintervall des Tages basierend auf anderen Skalierungsparametern (x_start, x_step, x_size) und ermöglicht das Scrollen durch Tagesabschnitte.
    • Wird x_length gesetzt, sollte es den gesamten Tag abdecken (Anzahl der x_steps, die den Tag füllen), damit der 'next'-Button korrekt funktioniert.
  • first_hour - (number) Startstunde des Zeitintervalls in einer Zelle, nur verwendet wenn x_unit="day" ist
  • last_hour - (number) Endstunde des Zeitintervalls in einer Zelle, nur verwendet wenn x_unit="day" ist
  • show_unassigned (boolean) wenn false, werden Events ohne Abschnittszuordnung nicht angezeigt; wenn true, erscheinen diese Events im ersten Abschnitt. Standard ist false. Optional
  • section_autoheight - (boolean) aktiviert automatische Höhenanpassung der Zellen. Standard ist true
  • dy - (number) minimale Zellhöhe (wenn section_autoheight false ist, haben Zellen diese feste Höhe; sonst dehnt sich die Höhe aus, um den Raum zu füllen). Standard ist 50
  • dx - (number) Breite der Spalte, die Abschnittsnamen anzeigt. Standard ist 200
  • event_dy - (number/string) Höhe der Events; kann 'full' sein, um die gesamte Zelle auszufüllen. Standard ist scheduler.xy.bar_height-5
  • event_min_dy - (number) minimale Event-Höhe. Standard ist scheduler.xy.bar_height-5
  • resize_events - (boolean) ob einzelne Event-Höhen verkleinert werden können, um in eine einzelne Event-Höhe zu passen (nicht kleiner als event_min_dy). Standard ist true
  • fit_events - (boolean) ob die Abschnittshöhe erweitert wird, um alle Events aufzunehmen, oder ob sie fix bleibt (dy). Verfügbar seit Version 3.0. Standard ist true
  • fit_events_offset - (number) zusätzlicher Abstand (Pixel) unter dem letzten Event, angewandt wenn fit_events true ist
  • round_position - (boolean) dehnt Events über die gesamte Zellbreite aus, unabhängig von der Dauer. Standard ist false. Gilt nur für 'Bar' und 'Tree' Modi
  • folder_events_available - (boolean) erlaubt das Zuweisen von Events an ganze Ordner (beliebige Ebene), nicht nur an einzelne Holder. Nur für 'Tree'-Modus. Standard ist false
  • folder_dy - (number) Höhe in Pixel von Ordnern (Abschnitte mit Kindabschnitten). Nur für 'Tree'-Modus
  • second_scale - (object) fügt eine zweite X-Achse oberhalb der Standardachse hinzu, um Zeitintervalle zu gruppieren. Optional. Verfügbar ab Version 3.0.
    Dieses Objekt beinhaltet:
    • x_unit - (minute, hour, day, week, month, year) Maßeinheit. Standard ist 'minute'
    • x_date - (string) Datumsformat (siehe Datumsformat-Spezifikation). Falls nicht gesetzt, wird das Format aus hour_date verwendet
  • scrollable - (boolean) aktiviert horizontales Scrollen in der Timeline-Ansicht; standardmäßig false. Wenn false oder undefiniert, schrumpfen die Datums-Spalten, um in die Viewport-Breite zu passen. Wenn true, schrumpfen die Spalten nicht unter column_width und eine horizontale Scrollbar erscheint bei Bedarf.
  • column_width - (number) minimale Breite der Timeline-Datumsspalten; Standard ist 100
  • scroll_position - (Date) scrollt die Timeline nach dem Rendern zu einem bestimmten Datum; akzeptiert dieselben Argumente wie timeline.scrollTo()
  • autoscroll - (object) konfiguriert Empfindlichkeit und Geschwindigkeit des Autoscrolls mit folgenden Eigenschaften:
    • range_x - (number) horizontaler Autoscroll-Abstand von den Rändern des Datenbereichs
    • range_y - (number) vertikaler Autoscroll-Abstand von den Rändern des Datenbereichs
    • speed_x - (number) horizontale Autoscroll-Geschwindigkeit
    • speed_y - (number) vertikale Autoscroll-Geschwindigkeit
  • cell_template - (boolean) aktiviert das Rendern einer benutzerdefinierten Vorlage für Timeline-Zellen
  • smart_rendering - (boolean) aktiviert Smart Rendering, das nur sichtbare Reihen, Spalten und Events rendert und andere beim Scrollen lädt. Standardmäßig in scrollbaren Timelines aktiviert.
  • columns- (array) definiert Spalten für das linke Panel. Wenn nicht angegeben, wird die timeline_scale_label Vorlage verwendet.

Dynamische Änderung von Eigenschaften

Alle Timeline-Views werden in scheduler.matrix gespeichert. Sie können jede Timeline-View-Konfiguration über ihren Namen abrufen und ändern. Die Änderungen werden nach dem Neuzeichnen des Schedulers wirksam:

scheduler.getView('timeline').x_size = 12;
scheduler.setCurrentView(); // zeichnet den Scheduler neu

Hier ist "timeline" der Name, der der Timeline-Ansicht in der createTimelineView Methode zugewiesen wurde:

scheduler.createTimelineView({
    name:"timeline",
    ...
});
Nach oben