isLinkAllowed

prüft, ob der angegebene Link gültig ist

boolean isLinkAllowed(string | number | LinkForValidation linkOrFrom, [boolean from_start,string | number | null | undefined to,boolean to_start] );
linkOrFromstring | number | LinkForValidationkann entweder die ID der Quell-(Vorgänger-)Aufgabe oder ein Link-Objekt mit folgenden Eigenschaften sein:
from_startbooleanoptional, gibt an, ob der Link vom Anfang der Quell-(Vorgänger-)Aufgabe (*true*) oder ihrem Ende (*false*) gezogen wird. Nicht erforderlich, wenn der erste Parameter ein Objekt ist
tostring | number | null | undefinedoptional, die ID der Ziel-(Nachfolger-)Aufgabe. Kann *null* oder *undefined* sein, falls die Zielaufgabe noch nicht angegeben wurde. Nicht erforderlich, wenn der erste Parameter ein Objekt ist
to_startbooleanoptional, gibt an, ob der Link zum Anfang der Ziel-(Nachfolger-)Aufgabe (*true*) oder zu ihrem Ende (*false*) gezogen wird. Nicht erforderlich, wenn der erste Parameter ein Objekt ist
booleantrue, wenn der Link gültig ist. Andernfalls false

Example

const link = {
    source:2,
    target:2,
    type:gantt.config.link.start_to_start
};
if(gantt.isLinkAllowed(link))// -> false (weil source==target)
    gantt.addLink(link);

Details

Das Link-Objekt hier unterscheidet sich vom Link Objekt und enthält nur 3 Eigenschaften:

  • source - (string | number) - die ID der Quell-(Vorgänger-)Aufgabe.
  • target - (string | number) - die ID der Ziel-(Nachfolger-)Aufgabe.
  • type - (string) - der Link-Typ.

Ein Link gilt in folgenden Fällen als ungültig:

  1. Die ID der Quellaufgabe ist dieselbe wie die der Zielaufgabe.
  2. Der Typ ist auf einen Wert gesetzt, der nicht 0, 1, 2 oder 3 ist.
  3. Der Link besteht die Validierung nicht.
  4. Der Link wird von einer Projektaufgabe zu ihrer Unteraufgabe erstellt, da die Datumsangaben der Projektaufgabe von ihren Kindern abhängen.

Diese Methode löst das Event onLinkValidation aus. Wenn dieses Event false zurückgibt, wird der Link ebenfalls als ungültig betrachtet.


Alternativ kann die Methode auch so aufgerufen werden:

gantt.isLinkAllowed(from, from_start, to, to_start )

Die Argumente bedeuten:

  • from - (string | number | object) - entweder die ID der Quell-(Vorgänger-)Aufgabe oder ein Link-Objekt mit diesen Eigenschaften:
  • from_start? - (boolean) - optional, gibt an, ob der Link vom Anfang der Quellaufgabe (true) oder deren Ende (false) gezogen wird. Nicht erforderlich, wenn der erste Parameter ein Objekt ist
  • to? - (string | number | null | undefined) - optional, die ID der Ziel-(Nachfolger-)Aufgabe. Kann null oder undefined sein, wenn noch nicht angegeben. Nicht erforderlich, wenn der erste Parameter ein Objekt ist
  • to_start? - (boolean) - optional, gibt an, ob der Link zum Anfang der Zielaufgabe (true) oder zu deren Ende (false) gezogen wird. Nicht erforderlich, wenn der erste Parameter ein Objekt ist

Zum Beispiel kann das obige Beispiel so umgeschrieben werden:

//var link = {
//    source:2,
//    target:2,
//    type:gantt.config.link.start_to_start
//};
 
if(gantt.isLinkAllowed(2, true, 2, true))// -> false (weil source==target)
    //etwas tun
Zurück nach oben