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 参数进行控制