Skip to main content

moveTask()

Description​

Moves a task to the specified position

A parent task is moved together with its children.

Usage​

moveTask({
    id?: string | number,
    parent?: string | number | null,
    project?: string | number | null,
    targetId?: string | number,
    reverse?: boolean
}): void;

Parameters​

  • id - (optional) the ID of the task to be moved
  • project - (optional) the ID of the project
info

To move a task to the No project section, specify the value of the parameter to null

  • parent - (optional) the ID of the parent task
  • targetId - (optional) the ID of the target task where the moved task will be pasted
  • reverse - (optional) defines the position where the moved task will be pasted: before the target task (true) or after it (false by default)

Example​

Example 1. Moving one task
const { ToDo, Toolbar } = todo;

const list = new ToDo("#root", {
    tasks: [
        { id: "1", text: "Task 1", project: "p_1"},
        { id: "1.1", text: "Task 1.1", parent: "1", project: "p_1" },
        { id: "2", text: "Task 2", project: "p_2" },
        { id: "2.1", text: "Task 2.1", parent: "2", project: "p_2" },
        { id: "2.1.1", text: "Task 2.1.1", parent: "2.1", project: "p_2" },
    ],
    projects: [
        { "id": "p_1", "label": "Project 1" },
        { "id": "p_2", "label": "Project 2" },
    ]
});

const toolbar = new Toolbar("#toolbar", {
    api: list.api,
});

// move "Task 1.1" to "Project 2" and place it before "Task 2.1.1" as a child of "Task 2.1"
list.moveTask({ 
    id: "1.1",
    project:"p_2",
    parent: "2.1",
    targetId: "2.1.1",
    reverse: true
});

The example below shows where the task will be moved if you specify only the parent and, optionally, reverse parameters:

// move "Task 1.1" to "Project 2" and place it after "Task 2.1" as a child of "Task 2"
list.moveTask({ 
    id: "1.1",
    project:"p_2",
    parent: "2",
});

// move "Task 1.1" to "Project 2" and place it before "Task 2.1" as a child of "Task 2"
list.moveTask({ 
    id: "1.1",
    project:"p_2",
    parent: "2",
    reverse: true
});

The example below shows where the task will be moved if you specify only the targetId and, optionally, reverse parameters:

// move "Task 1.1" to "Project 2" and place it after "Task 2" as a root task
list.moveTask({ 
    id: "1.1",
    project:"p_2",
    targetId: "2",
});

// move "Task 1.1" to "Project 2" and place it before "Task 2" as a root task
list.moveTask({ 
    id: "1.1",
    project:"p_2",
    targetId: "2",
    reverse: true
});
Example 2. Moving multiple tasks
const list = new ToDo("#root", {
    tasks: [
        { id: "1", text: "Task 1" },
        { id: "1.1", text: "Task 1.1" },
        { id: "1.1.1", text: "Task 1.1.1", parent: "1.1" },
        { id: "1.2", text: "Task 1.2", parent: "1" },
        { id: "2", text: "Task 2" },
        { id: "2.1", text: "Task 2.1", parent: "2" },
        { id: "2.1.1", text: "Task 2.1.1", parent: "2.1" },
        { id: "2.2", text: "Task 2.2" },
    ],
    selected: ["1.1", "2.2"],
});

// move selected tasks
list.eachSelected(id => {
    list.moveTask({ 
        id,
        parent: "2.1.1"
    });
}, true);

Related articles: