createTimelineView

richtet die Timeline-Ansicht im Scheduler ein

config

object

Das 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"
});

Related samples

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