createTimelineView
richtet die Timeline-Ansicht im Scheduler ein
void createTimelineView(object config);
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
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