Word模板引擎使用指南

最新推荐文章于 2024-10-09 09:28:37 发布

置顶 xdocs

最新推荐文章于 2024-10-09 09:28:37 发布

阅读量2.8k

点赞数

文章标签：模板引擎 word

本文链接：https://blog.csdn.net/xdocs/article/details/78514679

版权

1.简介

　　 Docx模板是一个带标记的Word文档，模板引擎用数据替换这些标记生成新的Word文档。

　　这是一份文档，同时也是一个模板，后面的示例将会使用本模板。

Word文档地址：http://www.xdocin.com/DocxEngine.docx

2.特点

使用Word可视化编辑，操作简单
标记语法简单易学
文档样式100%兼容
数据格式丰富
基于云服务，无需安装维护

3.标记语法

　　 ${名称}

　　前后标记符合必须是半角的，传入的数据会依照下面的规则自动识别：

识别规则

以“http:”、“https：”、“ftp:”、“data：”开头的文本表示网络资源，自动识别为图片或文档
以“text:”开始的数据，去掉“text:”后识别为文本
包含回车符的值识别为多行文本
表格、文本框的可选文字-标题标记识别为CSV列表数据
其他识别为单行文本

4.文本标记

文本标记在文档中直接输入。

示例

单行文本： ${单行文本}

多行文本： ${多行文本}

图片： ${图片}

文本框中的图片：

　　当文本框中只有一个图片时，图片会根据文本框的大小做大小适应

HTML： ${HTML}

URL地址： ${URL地址}

网络文档： ${文档}

5.【可选文字】-【标题】标记

图片

设置

插入示例图片，打开【设置图片格式】，在【可选文字】-【标题】中输入标记，如下图：

示例

表格

设置

插入表格，打开【表格属性】对话框，在【可选文字】-【标题】中输入标记，如下图：

通过设置【重复标题行】定义表头，表头可以是多行，如下图：

表头下的第一行是数据行，数据行会根据传入的数据条数，重复显示。

如果不设置表头，第一行就是数据行。

在数据行中输入标记，标记的名称是列表的字段名，也可以引用全局的标记。

数据行下是表尾，可以没有。

如果无数据传入，表格不显示。

示例

名称	信息
徽标	市值（亿美元）
${名称}		${市值}
公司信息

文本框

设置

插入文本框，将文本框的【位置】设置为【嵌入文本行中】，如下图：

打开【设置形状格式】，在【可选文字】-【标题】中输入标记，如下图：

在文本框中输入标记，标记的名称是列表的字段名，也可以引用全局的标记。

数据行会根据传入的数据条数，重复显示。如果无数据传入，文本框不显示。

示例

6.调用

Java

程序库

　　 http://www.xdocin.com/XDocService.jar

示例

    Java代码   
    
  
 import java.io.File;  
 import java.util.HashMap;  
 import java.util.Map;  
   
 import com.hg.xdoc.XDocService;  
   
 public class DocxEngineDemo {  
     public static void main(String[] args) {  
         Map<String, Object> params = new HashMap<String, Object>();  
         try {  
             params.put("单行文本", "你好!");  
             params.put("多行文本", "一行\n两行\n三行");  
             params.put("图片", "http://www.xdocin.com/xdoc.png");  
             params.put("HTML", "<html><li>张小三</li><li>李小四</li><li>王小五</li></html>");  
             params.put("URL地址", "text:http://www.baidu.com");  
             params.put("文档", "http://www.xdocin.com/xdoc?_func=hi&_rformat=html");  
             params.put("公司", "名称,徽标,市值\n"  
                     + "腾讯,http://www.logodashi.com/OldPic/635467462172730000.gif,3000\n"  
                     + "阿里巴巴,http://www.logodashi.com/OldPic/635521864517328000.jpg,2900\n"  
                     + "百度,http://www.logodashi.com/OldPic/635467448562000000.gif,600");  
             new XDocService().run("http://www.xdocin.com/DocxEngine.docx", params,  
                     new File("d:/DocxEngineResult.docx"));  
         } catch (Exception e) {  
             e.printStackTrace();  
         }  
     }  
 }  

注意：模板为本地文件或URL。

Web

示例

    Html代码   
    
  
 <script type= "text/javascript"  src= "http://www.xdocin.com/xdoc.js" ></script>  
 <script type= "text/javascript" >  
 XDoc.run( "http://www.xdocin.com/DocxEngine.docx" ,  "docx" ,  
 { "单行文本" :  "你好!" , "多行文本" :  "一行\n两行\n三行" , "图片" :  "http://www.xdocin.com/xdoc.png" ,  
 "HTML" :  "<html><li>张小三</li><li>李小四</li><li>王小五</li></html>" ,  
 "URL地址" :  "text:http://www.baidu.com" , "文档" :  "http://www.xdocin.com/xdoc?_func=hi&_rformat=html" ,  
 "公司" :  "名称,徽标,市值\n"  
 　　+  "腾讯,http://www.logodashi.com/OldPic/635467462172730000.gif,3000\n"  
 　　+  "阿里巴巴,http://www.logodashi.com/OldPic/635521864517328000.jpg,2900\n"  
 　　+  "百度,http://www.logodashi.com/OldPic/635467448562000000.gif,600"  
 },  "_blank" );  
 </script>  