Word模板引擎使用指南

阅读更多

1.简介

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

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

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

2.特点

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

3.标记语法

　　 ${名称}

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

4.识别规则 

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

5.文本标记

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

示例

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

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

图片： ${图片}

文本框中的图片：

　　

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

HTML： ${HTML}

URL地址： ${URL地址}

网络文档： ${文档}

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

图片

设置

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

示例

表格

设置

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

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

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

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

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

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

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

示例

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

文本框

设置

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

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

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

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

示例

7.调用

Java

程序库

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

示例

 

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 params = new HashMap();
		try {
			params.put("单行文本", "你好!");
			params.put("多行文本", "一行\n两行\n三行");
			params.put("图片", "http://www.xdocin.com/xdoc.png");
			params.put("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

示例

 

 

 

注意：模板地址需要外网能访问，或者为DataURI。

http

调用地址

http://www.xdocin.com/xdoc?_func=run&_format=docx&_xdoc=模板&标记名称=标记值

　　 模板、标记名称、标记值必须用UTF-8编码，参数比较多时，请以POST方式调用。

注意：模板地址需要外网能访问，或者为DataURI。