DocEditor编辑器内置了8种模板,分别是:
- standard (标准公文类);
- meeting (纪要通报类);
- party-meeting (党委纪要类);
- letter (函类);
- command (命令类);
- party(党委纪委类);
- combine(联合发文类);
- empty (空模板(仅正文))
这8类模板在样式和版面元素上有一些不同,但使用上并不局限于它的名称,比如“纪要通报类”模板并不是只能使用在会议纪要和通报类公文,而是只要在格式上相近,然后通过对版面元素的合理配置,就可以有更多的文中覆盖。在我们实际使用中,这8种模板能满足大部分的文种需求。当然DocEditor也允许自己定义模板。
本章就来介绍如何确定要使用的模板,以及如何在使用中切换模板。
在配置相中确定要使用的模板
options参数中有三个配置项,用于确定要使用的模板:documentTempleteType、documentTempleteName和documentTempleteUrl。
documentTempleteType
设置获取模板的方式,是使用内置模板还是自定义模板,取值为:
'sys':(默认)表示使用内置模板,此时documentTempleteName配置项生效。
'cus':表示使用自定义模板,此时documentTempleteUrl配置项生效。
documentTempleteName
设置要使用的内置模板名称。只有在documentTempleteType为'sys'时生效。默认为:'standard '。
documentTempleteUrl
设置要使用的自定义模板url路径。只有在documentTempleteType为'cus'时生效。
样例
如果需要使用“函类”模板作为本次打开编辑器的模板,代码如下:
const editor = await DocEditor.createEditor(div, {
//其他配置项
//...
//因为documentTempleteType默认为'sys',所以只需要配置documentTempleteName
documentTempleteName: 'letter '
}).load();
如果需要使用某个自定义模板作为本次打开编辑器的模板,代码如下:
const editor = await DocEditor.createEditor(div, {
//其他配置项
//...
documentTempleteType: 'cus',
//documentTempleteUrl配置为模板html文件的路径
documentTempleteUrl: 'mypath/myTemplete.html'
}).load();
关于自定义模板如何制作,将在后续章节中介绍。
在使用中切换模板
除了在编辑器初始化时确定所使用的模板外,还有可能在编辑器初始化后,需要切换模板,那就可以使用编辑器的reload方法重新渲染编辑器,并传入模板相关配置参数:
//切换为“函类”模板
editor.reload({
documentTempleteType: 'sys',
documentTempleteName: 'letter'
});
//切换为自定义模板
editor.reload({
documentTempleteType: 'cus',
documentTempleteName: 'mypath/myTemplete.html'
});
您可以在在线编辑器中尝试切换模板样例:在线运行样例