jQWidgets jqxKanban addItem() 方法

jQWidgets是一个流行的JavaScript框架，提供各种UI组件和工具。其中jqxKanban是一个可视化的看板控件，用于组织任务和管理工作流程。addItem()方法是jqxKanban控件中的一个重要API，用于在看板中添加新的卡片。

方法介绍

addItem()方法用于向jqxKanban控件中添加新的卡片。该方法需要传入一个JavaScript对象，该对象包含卡片的属性。具体来说，该对象至少需要包含一个“text”属性，表示卡片的文本内容。除此之外，还可以指定其他属性，如“color”、“status”、“tags”等。

方法定义

addItem(item: any, refresh: boolean): any;

参数说明：

• item: 新添加的卡片数据，必须满足看板定义中的属性要求。
• refresh: 是否在添加完成后刷新看板数据。如果设置为false，则需要手动调用refresh()方法来更新数据。

返回值：

• 返回新添加的卡片的id。

使用示例

// 创建看板控件
$("#jqxKanban").jqxKanban({
    source: kanbanData,
    ...
});

// 添加卡片
var newItem = {text: "新的任务", color: "#7FBF7F", status: "doing", tags: ["urgent", "important"]};
var itemId = $("#jqxKanban").jqxKanban("addItem", newItem, true);

// 刷新看板数据
$("#jqxKanban").jqxKanban("refresh");

上述示例中，首先创建一个名为”jqxKanban“的看板控件，并将其数据源设置为“kanbanData”。然后使用addItem()方法向看板中添加一个新的卡片，该卡片的文本内容为“新的任务”，颜色为“#7FBF7F”，状态为“doing”，并拥有两个标签“urgent”和“important”。最后使用refresh()方法刷新看板数据，以展现新添加的卡片。

注意事项

• 在使用addItem()方法之前，必须确保看板控件已经被创建并且数据源已经加载完成。
• 在添加完成之后，如果设置了refresh参数为false，则需要手动调用refresh()方法来更新看板数据，否则新添加的卡片将不会被展现在看板上。
• 如果需要对新增的卡片进行一系列定制化的操作，可以在添加完成之后，获取到新卡片的id，并使用jqxKanban的其他API对该卡片进行设置和调整。