markTimespan

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.

array markTimespan(object config);

config

object

Konfigurationsdetails für den zu markierenden oder blockierenden Zeitraum

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

Diese Methode ist seit Version 3.5 verfügbar.

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
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 angibt, wann die Einschränkung endet
end_date	`//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	`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	`zones:[460,860,1260,1560] // zwei begrenzte Intervalle: 04:00-08:00, 12:00-15:00 zones:"fullday" // begrenzt den ganzen Tag`
css	der anzuwendende CSS-Klassenname
css	`css:"gray" // erzeugt ein DIV mit der angewandten CSS-Klasse 'gray'`
html	HTML-Inhalt, der innerhalb des markierten Bereichs angezeigt wird
html	`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	`type: "dhx_time_block" // markiert und blockiert den Zeitraum`
invert_zones	bestimmt, ob die Zeitabschnitte (gesetzt durch 'zones') invertiert werden sollen (Standard ist false)
invert_zones	`// ergibt zwei begrenzte Intervalle: 00:00-08:00, 17:00-24:00 zones: [860, 1760], invert_zones: true // ergibt zwei begrenzte Intervalle: 00:00-08:00, 17:00-24:00 zones: [0, 860, 1760, 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
sections	`// 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

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

Eigenschaftenset	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(2012,7,13), end_date: new Date(2012,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(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