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]);
 
// (task: object) => boolean
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})