getTaskBy

осуществляет поиск задачи на основе заданных критериев

Array <Task> getTaskBy(string | function propertyName, [string | number | boolean | array propertyValue,object types] );

propertyName	string \| function	свойство для поиска или функция фильтрации
propertyValue	string \| number \| boolean \| array	значение для совпадения по свойству
types	object	объект, указывающий, какие типы задач включать в результаты

Array <Task>

массив объектов задач, соответствующих критериям

Example

// базовый поиск
const userTasks = gantt.getTaskBy("user_id", [5]);
 
// использование функции фильтрации
let userTasks = gantt.getTaskBy(function(task){
   return task.user_id == 5 || !task.user_id;
});
 
userTasks = gantt.getTaskBy(task => task.user_id == 5);

Related samples

Templates of the Resource diagram

Details

Этот метод позволяет выбрать задачи на основе значения свойства, например, найти задачи, назначенные определённому пользователю, или задачи, которые завершены.
При вызове gantt.getTaskBy(propertyName, propertyValue) используется нестрогое сравнение ("двойное равно", ==).
Результаты вызова gantt.getTaskBy(propertyName, propertyValue) могут кэшироваться gantt, что делает этот вариант потенциально более быстрым по сравнению с использованием функции фильтрации gantt.getTaskBy((task: object) => boolean).

По умолчанию gantt.getTaskBy() возвращает только задачи и вехи, соответствующие критериям, исключая элементы проектов.

Чтобы включить все типы записей, используйте третий параметр:

gantt.getTaskBy("progress", 1, { task: true, project: true, milestone: true });

Чтобы получить только определённый тип элемента, укажите его в третьем параметре:

gantt.getTaskBy("progress", 1, { project: true})