lightbox

spezifiziert das lightbox-Objekt

LightboxSections lightbox;

Example

gantt.config.lightbox.sections = [
    {name:"description", height:38, map_to:"text", type:"textarea",focus:true},
    {name:"priority", height:22, map_to:"priority",type:"select",options:opts},                                                                        
    {name:"time", height:72, type:"duration", map_to:"auto"}
];
 
gantt.init("gantt_here");

Details

Das lightbox-Objekt beinhaltet eine Haupteigenschaft:

sections - (array) - definiert die Sektionen innerhalb der lightbox

// Standard-Lightbox-Definition   
gantt.config.lightbox.sections=[
    {name:"description", height:70, map_to:"text", type:"textarea", focus:true},
    {name:"time",        height:72, map_to:"auto", type:"duration"}
];

Jedes Objekt im sections Array kann je nach Sektionstyp unterschiedliche Eigenschaften besitzen:

Gemeinsam für alle Sektionen

name - (string) - der Bezeichner der Sektion (wird von dhtmlxGantt verwendet, um das Label aus der locale.labels Sammlung zu holen). Beispielsweise verwendet die time Sektion das Label unter gantt.locale.labels.section_time.
map_to - (string) - der Name der Daten-Eigenschaft, mit der die Sektion verknüpft ist.
type - (string) - der Steuerungstyp, der in der Sektion verwendet wird.
height? - (number) - optional, legt die Höhe der Sektion fest. Diese Eigenschaft gilt nicht für checkbox und radio Sektionen.
focus? - (boolean) - optional, wenn true, wird die Sektion fokussiert, wenn die lightbox geöffnet wird.
formatter? - (DurationFormatter | LinkFormatter) - optional, spezifiziert einen Formatter für die Sektion.

Zeit- und Dauer-Steuerelemente

readonly? - (boolean) - optional, wenn auf true gesetzt, wird die Sektion schreibgeschützt.
year_range? - (number | number[]) - optional, definiert den Bereich für den Jahresauswahl-Selector. Es kann auf zwei Arten angegeben werden:
- year_range: [2005, 2025] - wählt Jahre von 2005 bis 2025 aus.
- year_range: 10 - wählt einen Bereich von 10 Jahren vor bis 10 Jahren nach dem aktuellen Jahr.
single_date? - (boolean) - optional, wenn true, wird nur der 'Startdatum'-Selector angezeigt. Bearbeitete Aufgaben haben dann nur ein Startdatum mit null Dauer. Dies ist hauptsächlich für Meilensteine nützlich.
time_format? - (string[]) - optional, definiert die Reihenfolge der Datums- und Zeit-Selectoren.
autofix_end? - (boolean) - optional, steuert, ob das Enddatum automatisch angepasst wird, wenn das Startdatum nach dem Enddatum gesetzt wird. Standardmäßig ist dies aktiviert. Wird es deaktiviert, ist manuelle Validierung möglich, aber ohne Validierung können Aufgaben eine Dauer von null erhalten, falls das Startdatum später als das Enddatum liegt.

Select-Steuerelement

onchange? (e): any - optional, setzt einen 'onChange' Event-Handler für das Steuerelement der Sektion.
- e - (Event) - das native Event-Objekt.

Select-, Checkbox-, Radio- und Ressourcen-Steuerelemente

options? - (object[]) - optional, listet die Optionen für das Steuerelement auf. Jedes Objekt im Array repräsentiert eine Option mit folgenden Eigenschaften:
- key - (number | string) - der Bezeichner der Option, der verwendet wird, um die Daten-Eigenschaft der Aufgabe abzugleichen.
- label - (string) - die Anzeige-Beschriftung der Option.
- unit? - (string | number) - optional, Maßeinheit für Ressourcen (verwendet im Resources-Steuerelement).
default_value? - (any) - optional, der Standardwert, der verwendet wird, wenn der Eingabewert undefiniert ist. Für das Resources-Steuerelement gilt dies, wenn der Ressourcenwert undefiniert ist.

Parent-Steuerelement

allow_root? - (boolean) - optional, wenn true, wird eine zusätzliche Option hinzugefügt, um die oberste Ebene als übergeordnete Aufgabe auszuwählen. Dies funktioniert zusammen mit der Eigenschaft root_label.
root_label? - (string) - optional, definiert die Beschriftung für die Option der obersten Ebene. Wird zusammen mit allow_root verwendet.
sort? (task1, task2): number - optional, stellt eine Sortierfunktion für die Select-Optionen bereit.
- task1 - (Task) - das erste Task-Objekt zum Vergleichen.
- task2 - (Task) - das zweite Task-Objekt zum Vergleichen.
filter? (id, task): boolean - optional, liefert eine Filterfunktion für die Select-Optionen, die die Task-ID und das Task-Objekt erhält.
- id - (string | number) - die ID der Aufgabe.
- task - (Task) - das Task-Objekt.
template? (start_date, end_date, task): string|number - optional, definiert eine Vorlage für die Select-Optionen.
- start_date - (Date | number) - das Startdatum der Aufgabe.
- end_date - (Date | number) - das Enddatum der Aufgabe.
- task - (Task) - das Task-Objekt.

Typeselect-Steuerelement

filter - (function) - setzt eine Filterfunktion für die Aufgabentypen, die den Typnamen als Parameter erhält.