原来,这才是 HTML+CSS 导出 Word 最佳方式!

转个word很难吗?

对于任何一个在线富文本写作产品,导出功能是必不可少的,其中导出word是其中最常见的选项,但是很多产品导出的word,比如说Jira,格式就有不同程度的失真.

仔细分析下来,解决这个思路的主要有两种:

  • 硬转:使用OpenXml的SDK,逐一匹配html标签和样式css,相当于用OpenXml实现了一个html+css的渲染层。
  • 偷懒:想办法把html+css的内容当成word的一部分,相当于用web视图打开。

当时,我花了一定的时间,在两个方向上分别做了调研。

硬转的思路,直觉上工作量就极大,而且很容易出Bug,毕竟那么多组合情况需要考虑。值得参考的项目是html2openxml,1W多行只能实现html的转换,还不包括css。

不是没想过,限制输出html的排版,比如用固定的id代表固定的部分,css样式也只支持特定的几种,但后来讨论下来,觉得这种方法,需要前后端确定好规则,而在当时快速迭代的时期,这无疑会增加开发成本。

偷懒这条路,能够搜索到项目,都是借用了word中altchunks的特性,比如:html-docx-jshtml2docx

问题也很明显,

  • 不支持float之类的样式,对图片的支持也需要自己写代码转base64,然后嵌进标签里。这些虽然麻烦些,但是还是可以tweak。
  • 最麻烦的是,这种格式的word,兼容性很差,在微信中、mac上打不开。

于是,我一度卡在这里很久,直到我发现……

原来,word才是转word的最佳工具

转机来的也很突然,就是我发现用word打开一个带html+css的文件后,再另存成word,不仅格式得到了保留,图片也在,而且兼容性也还不错!真是

踏破铁鞋无觅处,得来全不费工夫。

问题来了,怎么把这一步程序化呢?

这下终于可以用上过去.net的开发经验了,C#是可以通过com组件的方式操作word,但前提是运行程序的机器上必须装word才行。

核心代码,也是非常的简单:

首先引用Microsoft.Office.Interop.Word,调用的代码如下:

var word = new Application {Visible = false};
var doc = word.Documents.Open(htmlFilePath, Format: WdOpenFormat.wdOpenFormatWebPages,
                    ReadOnly: false);
doc.SaveAs2000(wordFilePath, WdSaveFormat.wdFormatDocumentDefault,
                    ReadOnlyRecommended: false);
                doc.Close();
word.quit()

是不是很简单呢?

而这里唯一还需要处理的就是图片,如果不做处理,图片还是以链接的方式存储的。

一方面,每次打开的时候需要重复下载,好处是word文件比较小,但缺点是受限于网速,可能会出现图片加载不出来的情况;

另一方面时,如果图片没有指定宽度和高度,当图片的尺寸大于文档的尺寸时,显示的效果就很差。

估化的思路很简单,即强行把图片的尺寸拉伸到一页可以显示下,同时将图片链接转成内嵌的图片。

foreach (InlineShape s in doc.InlineShapes)
{
    var inlineShape = s;

    if (inlineShape.Type != WdInlineShapeType.wdInlineShapePicture &&
        inlineShape.Type != WdInlineShapeType.wdInlineShapeLinkedPicture)
    {
        continue;
    }

    if (inlineShape.Type == WdInlineShapeType.wdInlineShapeLinkedPicture)
    {
        inlineShape.LinkFormat.SavePictureWithDocument = true;
        inlineShape.LinkFormat.BreakLink();
    }

    if (inlineShape.Width > this._documentWidth)
    {
        inlineShape.LockAspectRatio = MsoTriState.msoTrue;
        inlineShape.Width = this._documentWidth;
    }

    if (inlineShape.Height > this._documentHeight)
    {
        inlineShape.LockAspectRatio = MsoTriState.msoTrue;
        inlineShape.Height = this._documentHeight;
    }
}

到此,核心的转换代码就已经完成。(需要提醒各位看官的是,这种方法是不支持float和flex的css样式的。

剩下的工作

请注意:上述代码是基于.net framework写的,运行的机器上还必须有word。

如果要对外提供服务的话,考虑到跨语言跨平台,最好的方式即提供http接口。

而这对一个不熟悉.net的人,那要学习的东西还是不少的。

楼主我就好人做到底,在上述的核心代码上用WCF的webHttpBinding实现了一个的http服务,同时使用log4net实现了日志功能。

最终的程序的workflow是

  • 用户发送html+css内容到http服务
  • 先把html+css存成文件
  • 读取html文件,然后另存为word文件
  • 返回下载链接
  • 使用nginx映射目录中的文件,实现下载功能

所有代码开源在HtmlToWord,如果它对你有用,欢迎点个star.

本作品采用《CC 协议》,转载必须注明作者和本文链接
讨论数量: 0
(= ̄ω ̄=)··· 暂无内容!

讨论应以学习和精进为目的。请勿发布不友善或者负能量的内容,与人为善,比聪明更重要!