openTemplateList(打开模板列表)
打开模板列表供用户选择模板, 该方法为 2.0 版本添加
const { id, categoryId } = await editor.openTemplateList();
if (id) {
editor.createDesign({
templateId: id,
// 分类ID的传递需要sdk版本2.2.4及以上
categoryId,
})
}
参数
options.categories
版本: 2.0+
类型: number[]
需要细化展示的模板分类。如果没传默认展示所有分类, 具体分类信息可看 模板分类
// 打开海报和动图海报的分类
editor.openTemplateList({
categories: [4809763, 4809767]
});
options.onSelectTemplate
版本: 2.0+
类型: (info: { id: string | number, categoryId: string | number })=>void
点击模板时触发
// 打开海报和动图海报的分类
editor.openTemplateList({
onSelectTemplate({ id, categoryId }) {
alert(`点击了${id}模板`);
eidtor.createDesign({
templateId: id,
categoryId,
})
}
});
返回值
类型: Promise<false | { id: string | number, categoryId: string | number }>
如果返回 false
表示关闭了默认的弹窗。反之返回用户点击的模板的ID以及当前选择的分类ID
注意项: 因为返回的是Promise 所以无论用户点击几次,只会返回第一次点击的模板,所以要对用户多次选择模板处理请使用 onSelectTemplate
参数进行控制