addMarkedTimespan

markiert Daten und kann mit bestimmten Einstellungen diese blockieren (ermöglicht das Anwenden benutzerdefinierter Styles auf die Grenzen)

number addMarkedTimespan(object config);

config

object

Das Konfigurationsobjekt, das den zu markierenden oder blockierenden Zeitraum definiert

number

Die ID des hinzugefügten Zeitraums

Example

//markiert Daten
scheduler.addMarkedTimespan({  
    days:  5,               // markiert jeden Freitag
    zones: "fullday",       // markiert den ganzen Tag
    css:   "gray_section"   // angewandte CSS-Klasse
});
scheduler.updateView();
 
//markiert und blockiert Daten
scheduler.addMarkedTimespan({  
    days:  5,
    zones: "fullday",
    css:   "gray_section",
    type:  "dhx_time_block" //dies ist ein fester Wert
});
scheduler.updateView();

Related samples

Details

Diese Methode ist seit Version 3.5 verfügbar.

Die Methode erfordert, dass das limit Plugin aktiviert ist.

Beachten Sie, dass das Markieren (Blockieren) nicht sofort nach dem Aufruf dieser Methode wirksam wird. Sie müssen updateView aufrufen, um die Änderungen anzuwenden.

Eigenschaften des Konfigurationsobjekts

Das Konfigurationsobjekt kann die folgenden Eigenschaften enthalten:

Eigenschaft	Beschreibung
start_date	ein Date-Objekt, das den Beginn der Einschränkung definiert
start_date	`//verhindert das Erstellen von Events ab dem 3. Mai 2012 bis 'end_date' start_date:new Date(2012,4,3)`
end_date	ein Date-Objekt, das das Ende der Einschränkung definiert
end_date	`//verhindert das Erstellen von Events von 'start_date' // bis zum 3. September 2012 end_date:new Date(2012,8,3)`
days	zu beschränkende Tage
days	`days:[0, 2, 6] //beschränkt Sonntag, Dienstag und Samstag days:"fullweek" //beschränkt die gesamte Woche days:new Date(2012,6,1) //blockiert den 1. Juli 2012`
zones	die zu beschränkenden Zeitperioden (in Minuten)
zones	`//zwei Beschränkungsblöcke: 04:00-08:00 und 12:00-15:00 zones:[460,860,1260,1560] zones:"fullday" //beschränkt den ganzen Tag`
css	der anzuwendende CSS-Klassenname
css	`css:"gray" //zeichnet ein DIV mit der CSS-Klasse 'gray'`
html	HTML-Inhalt, der innerhalb des markierten Bereichs angezeigt wird
html	`//zeichnet ein DIV mit diesem Text über dem markierten Bereich html:"<b>Blocked</b>"`
type	gibt den Typ des Zeitraums an. Wird 'dhx_time_block' gesetzt, erfolgt eine Blockierung. Jeder andere Wert markiert den Zeitraum nur ohne Blockierung.
type	`type: "dhx_time_block" //Zeitraum wird markiert und blockiert`
invert_zones	gibt an, ob die Zeitfenster (in 'zones' gesetzt) invertiert werden sollen (Standard ist false)
invert_zones	`//ergibt zwei Beschränkungsblöcke: 00:00-08:00 und 17:00-24:00 zones: [860, 1760], invert_zones: true //ergibt zwei Beschränkungsblöcke: 00:00-08:00 und 17:00-24:00 zones: [0, 860, 1760, 24*60], invert_zones: false`
sections	beschränkt die Blockierung auf bestimmte Items in bestimmten Views. Die Daten werden nur in den angegebenen View(s) blockiert.
sections	`//blockiert Daten nur für das Item mit id=5 im Unit-View //und Items mit den IDs 2 und 3 im Timeline-View sections: { unit: 5, timeline: [2,3]}`

Akzeptable Kombinationen von Konfigurationseigenschaften

Beachten Sie, dass days und zones zusammen verwendet werden müssen, ebenso wie start_date und end_date als Paar, um das Blockierungsintervall zu definieren. Diese Paare dürfen nicht anders kombiniert werden. Zum Beispiel können Sie zones nicht mit start_date kombinieren oder days gleichzeitig mit start_date und end_date verwenden.

Deshalb gibt es zwei gültige Eigenschaftskombinationen:

Eigenschaftensatz Beispiel

Eigenschaftensatz	Beispiel
days zones invert_zones css html type sections	`var config ={ days: 1, zones: [960, 1560], css: "cssClassName", sections: { unit: 5 } }`
start_date end_date css html type sections	`var config ={ start_date: new Date(2013,7,13), end_date: new Date(2013,7,14), css: "cssClassName", sections: { unit: 5 } }`

days
zones
invert_zones
css
html
type
sections

var config ={
    days:  1, 
    zones: [9*60, 15*60], 
    css: "cssClassName", 
    sections: {
         unit: 5
    }
}

start_date
end_date
css
html
type
sections

var config ={
    start_date: new Date(2013,7,13),
    end_date:   new Date(2013,7,14),
    css: "cssClassName",
    sections: {
         unit: 5
    }
}

Vergleich von markTimespan() und addMarkedTimespan()

addMarkedTimespan	markTimespan
erfordert den Aufruf von updateView, um ein DIV für den Zeitraum zu rendern	zeichnet automatisch ein DIV für den Zeitraum
die Zeitspanne(n) bleiben unbegrenzt bestehen	Zeiträume werden sofort nach jeder internen Aktualisierung in der App ausgeblendet
gibt die ID der konfigurierten Zeitspanne(n) zurück	gibt ein DIV-Element oder ein Array von DIVs zurück