添加文字
添加方法
add(String text, String css)
添加一段带有样式的文本
text:文本内容,\n 或 \r会被视为换行(直接写,无需添加\)
css:样式表内容,支持的样式后面介绍
WordGo wordGo = new WordGo();
//创建一个wordGo对象
wordGo.add("Hello", "font-size: 20; background-color: blue;");
//添加文字“Hello”,字号用20号,背景颜色选择blue
wordGo.create("C:\\demo.docx");
//将docx文件输出到C盘根目录下,命名为demo.docx
addLine(String text, String css)
添加文本并且在最后添加一个换行表示。实际上底层就是调用额add方法,可以省略最后的\n而已。
示例:
WordGo wordGo = new WordGo();
//创建一个wordGo对象
wordGo.addLine("Hello", "font-size: 15; color: #FF0000;");
//添加一行文字“Hello”,字号用15号,颜色选择红色
wordGo.create("C:\\demo.docx");
//将docx文件输出到C盘根目录下,命名为demo.docx
换页方法
newPage()
切换到新的一页,不管这一页写没写完。
WordGo wordGo = new WordGo();
wordGo.add("page1", "");
wordGo.newPage();
//直接跳转到下一页
wordGo.add("page2", "");
wordGo.create("C:\\demo.docx");
支持样式
font-size 文字大小
设定文字大小,支持数字,也支持我们常用的表示字号文字:
“初号”, “小初”, “一号”, “小一”, “二号”, “小二”, “三号”, “小三”, “四号”, “小四”, “五号”,”小五”, “六号”, “小六”, “七号”, “八号”
数字不需要带单位,如果希望知道数字对应多大可以打开word试一下(如图)。无法识别的font-size将会设置成默认的五号字
示例:font-size:12
font-size:五号
font-family 字体
直接写字体名称即可,如果打开的用户电脑有这个字体将会展示,没有的话将会展示默认字体。WPS可能会帮助用户自动下载或提示替换。
示例:font-family:宋体
font-family:思源黑体
font-weight 文字加粗
支持normal和bold,不写此属性默认为normal
示例:font-width:bold
font-width:normal
font-style 字体样式
支持normal、italic、oblique。normal是默认不倾斜样式,italic 和 oblique都会让文字倾斜,底层实现没有差别,只是为了照顾不同css书写习惯用户。
示例:font-style:italic
font-style:oblique
color 文字颜色
文字颜色属性,仅支持16位表示法,不支持带透明度。# 带不带都行。
示例:color:#FF0000
color:#008000
color:00FF00
background-color 文字背景色
注意,word中文字背景色仅支持固定几种(如图),受支持的颜色有(顺序如图):
“yellow”, “green”, “cyan”, “magenta”, “blue”, “red”, “darkBlue”,”darkCyan”, “darkGreen”, “darkMagenta”, “darkRed”, “darkYellow”, “darkGray”, “lightGray”, “black”
示例:background-color:yellow
background-color:red
text-decoration 文字下划线
文字下划线支持多种样式,不写则为没有下划线。划线样式不区分大小写。支持的样式有:
“single”, “double”, “thick”, “dotted”, “dash”, “dotDash”, “dotDotDash”,”wave”
示例:text-decoration:single
text-decoration:double
对应关系:
text-decoration-color 文字下划线颜色
如果设定了下划线,默认和文字一个颜色。如果设置了独特颜色当然也被支持。仅支持16位表示法,不支持带透明度。# 带不带都行。
示例:text-decoration-color:#FF0000
text-decoration-color:#008000
text-decoration-color:00FF00
font-emphasis 文字着重号
他用来表示文字下方有小圆点着重强调。支持normal和point属性,当属性值为point表示有着重号,不写默认为normal,即没有着重号。
示例:font-emphasis:point
font-emphasis:normal
font-scale 文字水平缩放
文字的水平缩放比率,支持0~100(不支持0,不写默认为100)的整数。写不写%都可以解析。
示例:font-scale:90
font-scale:50%
line-height 行高
行高是整行文本的整体属性,建议只设置一个,设置多个我们也无法保证解析的是哪一个。
支持百分比形式和固定磅值形式。百分比必须带%,固定磅值支持以px或pt为单位(都会解析为磅,防止单位写错解析不了)。只有数字不写单位视为固定值。固定值支持 1 - 500(含)磅。
示例:line-height:150%
line-height:18pt
text-align 对齐方式
支持的参数有:left(左对齐)、right(右对齐)、center(居中对齐),默认为左对齐
示例:text-align:center
常见问题
Q:错误的css是否会被解析报错?
A:错误的css不会被解析,会被直接忽略,和html一样,很难写出错误
Q:css分割符号和html是否一样?
A:一样的,示例:text-align: center;
Q:一个属性重复定义会以最后一个为准吗?
A:不一定,只能保证解析出来的效果是您定义中的一个,是哪个无法确定