markTimespan

Description

Markiert oder blockiert spezifische Daten, indem entweder ein Standard- oder ein benutzerdefinierter Stil angewendet wird. Die Hervorhebung wird unmittelbar nach jeder internen Aktualisierung in der App entfernt. Dies kann nützlich sein, um bestimmte Daten hervorzuheben.

markTimespan: (config: any) => any[]

Parameters

• config - (required) object - Konfigurationsdetails für den zu markierenden oder blockierenden Zeitraum

Returns

• divs - (array) - ein Array von HTML-Elementen wird zurückgegeben

Example

//bestimmte Daten hervorheben
scheduler.markTimespan({  
    days:  5,               // hebt jeden Freitag hervor  
    zones: "fullday",       // hebt den ganzen Tag hervor
    css:   "gray_section"   // angewandte CSS-Klasse
});

//bestimmte Daten hervorheben und blockieren
scheduler.markTimespan({  
    days:  5,
    zones: "fullday",
    css:   "gray_section",
    type:  "dhx_time_block" // fester Wert zum Blockieren des Zeitraums
});

Related samples

• Handling the pointer highlighting

Details

Hinweis

Diese Methode ist seit Version 3.5 verfügbar.

Hinweis

Diese Methode erfordert, dass das limit Plugin aktiviert ist.

Eigenschaften des Konfigurationsobjekts

Das Konfigurationsobjekt unterstützt die folgenden Eigenschaften:

Eigenschaft	Beschreibung
start_date	ein Date-Objekt, das angibt, wann die Einschränkung beginnt
	//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 angibt, wann die Einschränkung endet
	//verhindert das Erstellen von Events vom 'start_date' bis zum 3. September 2012 end_date:new Date(2012,8,3)
days	die zu begrenzenden Tage
	days:[0, 2, 6] // begrenzt Sonntag, Dienstag und Samstag days:"fullweek" // begrenzt die ganze Woche days:new Date(2012,6,1) // blockiert den 1. Juli 2012
zones	die zu begrenzenden Zeitabschnitte in Minuten
	zones:[4*60,8*60,12*60,15*60] // zwei begrenzte Intervalle: 04:00-08:00, 12:00-15:00 zones:"fullday" // begrenzt den ganzen Tag
css	der anzuwendende CSS-Klassenname
	css:"gray" // erzeugt ein DIV mit der angewandten CSS-Klasse 'gray'
html	HTML-Inhalt, der innerhalb des markierten Bereichs angezeigt wird
	html:"<b>Blocked</b>" // fügt diesen Text innerhalb des DIV für den markierten Bereich hinzu
type	legt den Typ des Zeitraums fest. Wird er auf 'dhx_time_block' gesetzt, wird der Zeitraum blockiert. Jeder andere Wert markiert den Zeitraum nur, ohne ihn zu blockieren
	type: "dhx_time_block" // markiert und blockiert den Zeitraum
invert_zones	bestimmt, ob die Zeitabschnitte (gesetzt durch 'zones') invertiert werden sollen (Standard ist false)
	// ergibt zwei begrenzte Intervalle: 00:00-08:00, 17:00-24:00 zones: [8*60, 17*60], invert_zones: true // ergibt zwei begrenzte Intervalle: 00:00-08:00, 17:00-24:00 zones: [0, 8*60, 17*60, 24*60], invert_zones: false
sections	beschränkt das Blockieren auf bestimmte Items innerhalb bestimmter Views. Die Blockierung gilt nur in diesen zugehörigen Views
	// blockiert Daten nur für das Item mit id=5 in der Units-Ansicht // und Items mit den IDs 2 und 3 in der Timeline-Ansicht sections: { unit: 5, timeline: [2,3]}

Akzeptable Kombinationen von config-Eigenschaften

Hinweis

Beachte, dass days, zones und start_date, end_date gepaart sind, um das Blockierungsintervall zu definieren und nicht anders kombiniert werden sollten. Zum Beispiel kann zones nicht mit start_date verwendet werden, und days darf nicht gleichzeitig mit start_date und end_date kombiniert werden.

Es gibt zwei gültige Eigenschaftensets, die verwendet werden können:

Eigenschaftenset	Beispiel
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(2012,7,13), end_date: new Date(2012,7,14), css: "cssClassName", sections: { unit: 5 } }

Vergleich von markTimespan() und addMarkedTimespan()

addMarkedTimespan	markTimespan
erfordert den Aufruf der updateView Methode, um ein DIV für den Zeitraum zu rendern	rendert automatisch ein DIV für den Zeitraum
der/die Zeitraum(e) bleiben dauerhaft sichtbar	der/die Zeitraum(e) werden unmittelbar nach jeder internen Aktualisierung in der App ausgeblendet
gibt die ID des/der erstellten Zeitraums/Zeitspannen zurück	gibt ein DIV oder ein Array von DIVs zurück

Related Guides

• Blockieren und Markieren von Daten