同一段文字,换一种字符格式,呈现的气质就不同:封面标题去掉填充只留轮廓,海报标语加上阴影,化学式与面积单位离不开上标与下标,法律条文与注音文本则习惯在文字上方加点。这些效果都不改变文字内容,只改变渲染方式,因此适合在文档生成阶段一次性写入,不必回到 Word 里逐字调整。
本文用 Spire.Doc for JavaScript 完成四类字符效果:轮廓与阴影、阳文与阴文、上标与下标、强调符号。整个过程基于 WebAssembly 在浏览器端运行,不依赖后端,文件留在用户的设备上。
本文介绍四个功能点:
下面的示例统一使用输入文档 Typography.docx。它是一页排版样张,代码把生成的效果追加在文档末尾的“示例区”:

字符格式挂在哪里
上述效果都属于字符级属性,统一挂在 CharacterFormat 上。取得 CharacterFormat 有两种常见方式:
| 方式 | 典型代码 | 适用场景 |
|---|---|---|
| 新建文本后直接设置 | paragraph.AppendText('标题').CharacterFormat |
向文档追加示例文字 |
| 查找已有文字后设置 | doc.FindString('标题', false, false).GetAsOneRange().CharacterFormat |
修改正文中已有的文字 |
各属性的取值与作用如下:
| 属性 | 取值 | 效果 |
|---|---|---|
IsOutLine |
true / false |
文字只显示轮廓,内部填充被去掉 |
IsShadow |
true / false |
文字右下方出现阴影 |
Emboss |
true / false |
阳文,文字呈凸起效果 |
Engrave |
true / false |
阴文,文字呈凹陷效果 |
SubSuperScript |
SubSuperScript 枚举 |
上标、下标或普通位置 |
EmphasisMark |
Emphasis 枚举 |
文字上方或下方的强调符号 |
有关安装和项目配置,请参考 React 项目中集成 Spire.Doc for JavaScript。下面的示例假定 Spire.Doc 已安装、WebAssembly 模块已初始化。第一个功能点给出完整的 React 组件;后面三个功能点沿用同样的加载、保存与下载代码,只展示追加内容与格式设置的部分。
为文字设置轮廓与阴影
IsOutLine 去掉字形的内部填充,只保留边缘线条;IsShadow 在文字右下方生成一层阴影。两者都是布尔属性,打开与关闭只取决于赋 true 还是 false。轮廓适合笔画较粗的封面标题,阴影适合需要一点立体感的标语或品牌名。
具体操作步骤如下:
- 获取 Spire.Doc 的 WASM 模块,确认已就绪。
- 载入示例文档
Typography.docx,创建Document对象并加载该文件。 - 在第一节末尾追加一个段落,写入“轮廓标题”。
- 通过
TextRange.CharacterFormat设置IsOutLine,再追加“阴影标题”并设置IsShadow。 - 使用
SaveToFile()保存结果,从 VFS 读出文件并触发浏览器下载。
为文字设置轮廓与阴影的代码如下:
function App() {
const setOutlineAndShadow = async () => {
// 获取 Spire.Doc 的 WASM 模块
const docModule = window.wasmModule?.spiredoc;
if (!docModule) {
alert('Spire.Doc is not ready yet');
return;
}
await window.spire.FetchFileToVFS('Typography.docx', '', `${process.env.PUBLIC_URL}/data/`);
const doc = new docModule.Document();
doc.LoadFromFile('Typography.docx');
const paragraph = doc.Sections.get_Item(0).AddParagraph();
// 轮廓:只保留字形边缘,去掉内部填充
const outline = paragraph.AppendText('轮廓标题');
outline.CharacterFormat.IsOutLine = true;
outline.CharacterFormat.FontSize = 26;
paragraph.AppendText(' ');
// 阴影:在文字右下方投下阴影
const shadow = paragraph.AppendText('阴影标题');
shadow.CharacterFormat.IsShadow = true;
shadow.CharacterFormat.FontSize = 26;
const outputFileName = 'TextEffects.docx';
doc.SaveToFile({ fileName: outputFileName, fileFormat: docModule.FileFormat.Docx2013 });
doc.Dispose();
// 从 VFS 读取生成的文件,触发下载
const fileArray = window.dotnetRuntime.Module.FS.readFile(outputFileName);
const blob = new Blob([fileArray], {
type: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
});
const url = URL.createObjectURL(blob);
const a = document.createElement('a');
a.href = url;
a.download = outputFileName;
a.click();
URL.revokeObjectURL(url);
};
return (
<div style={{ textAlign: 'center', height: '300px' }}>
<h1>设置轮廓与阴影</h1>
<button onClick={setOutlineAndShadow}>生成</button>
</div>
);
}
export default App;
生成文档的末尾会追加两个标题示例:

轮廓与阴影能否同时开启
两个属性互相独立,可以同时设为 true:
// 同一段文字同时打开轮廓与阴影
outline.CharacterFormat.IsOutLine = true;
outline.CharacterFormat.IsShadow = true;
同时开启后,阴影会叠加在空心字形上,笔画密集时容易显得浑浊。标题通常只保留其中一种;需要更强的层次感时,可以给文字换用更粗的字重,而不是把两种效果堆在一起。
为文字设置阳文与阴文
Emboss 与 Engrave 是一组方向相反的效果:阳文让文字看起来从纸面凸起,阴文让文字看起来凹进纸面,常用来模拟印章、钢印或底纹文字。两者同样是布尔属性,设置方式与轮廓、阴影一致。
具体操作步骤如下:
- 载入
Typography.docx,取出第一节。 - 在末尾追加一个段落,写入“阳文”。
- 把该文本的
CharacterFormat.Emboss设为true。 - 追加“阴文”,把
CharacterFormat.Engrave设为true。 - 保存结果并触发下载。
为文字设置阳文与阴文的代码如下:
const paragraph = doc.Sections.get_Item(0).AddParagraph();
// 阳文:文字凸起
const emboss = paragraph.AppendText('阳文');
emboss.CharacterFormat.Emboss = true;
emboss.CharacterFormat.FontSize = 22;
paragraph.AppendText(' ');
// 阴文:文字凹陷
const engrave = paragraph.AppendText('阴文');
engrave.CharacterFormat.Engrave = true;
engrave.CharacterFormat.FontSize = 22;
生成文档的末尾会并排出现阳文与阴文示例:

为已有文字设置阳文或阴文
上面的写法面向新追加的文字。如果正文中已经有目标文字,可以用 FindString() 找到它,再通过 GetAsOneRange() 取得文本区间:
// 找到正文中已有的“印章”两个字,只改这两个字的格式
const seal = doc.FindString('印章', false, false).GetAsOneRange();
seal.CharacterFormat.Emboss = true;
FindString() 返回的是一个文本选择对象,GetAsOneRange() 适合匹配内容落在同一个文本区间的情况。若目标文字在文档中被拆成多个区间,可以改用 GetAsRange() 取得区间集合,再逐个设置。
为文字插入上标与下标
上标与下标是公式与单位书写的刚需:H₂O、x²、10⁻³ 都依赖字符位置与字号的配合。SubSuperScript 枚举提供四种取值:
| 取值 | 含义 |
|---|---|
SuperScript |
上标,缩小字号并抬高基线 |
SubScript |
下标,缩小字号并降低基线 |
BaseLine |
按基准线排布,即普通位置 |
None |
不设置上标或下标属性 |
具体操作步骤如下:
- 载入
Typography.docx,在第一节末尾追加一个段落。 - 写入正常文字,再写入需要成为下标的字符。
- 把该字符的
CharacterFormat.SubSuperScript设为SubScript。 - 继续写入正常文字与上标字符,把
SubSuperScript设为SuperScript。 - 保存结果并触发下载。
为文字插入上标与下标的代码如下:
const paragraph = doc.Sections.get_Item(0).AddParagraph();
// 统一字号,便于观察上标与下标的位置
const addText = (text) => {
const run = paragraph.AppendText(text);
run.CharacterFormat.FontSize = 12;
return run;
};
addText('水分子式为 H');
const sub = addText('2');
sub.CharacterFormat.SubSuperScript = docModule.SubSuperScript.SubScript;
addText('O,面积为 25 m');
const sup = addText('2');
sup.CharacterFormat.SubSuperScript = docModule.SubSuperScript.SuperScript;
addText(',体积为 1.2 × 10');
const minus3 = addText('-3');
minus3.CharacterFormat.SubSuperScript = docModule.SubSuperScript.SuperScript;
addText(' m');
const sup3 = addText('3');
sup3.CharacterFormat.SubSuperScript = docModule.SubSuperScript.SuperScript;
addText('。');
生成文档的末尾会追加一行包含上标、下标与数量级的示例:

批量写入多组上标与下标
公式往往由普通文字、上标与下标交替组成。把“文字 + 脚本类型”写成数组,再用一个循环写入,可以避免重复代码:
function appendFormula(paragraph, parts) {
for (const [text, script] of parts) {
const run = paragraph.AppendText(text);
run.CharacterFormat.FontSize = 12;
if (script) {
run.CharacterFormat.SubSuperScript = docModule.SubSuperScript[script];
}
}
}
const paragraph = doc.Sections.get_Item(0).AddParagraph();
appendFormula(paragraph, [
['水分子式为 H', null], ['2', 'SubScript'], ['O', null],
[',面积为 25 m', null], ['2', 'SuperScript'], ['。', null],
]);
枚举名可以直接用字符串下标访问,script 传 null 或空字符串时保持普通位置。
为文字添加强调符号
强调符号是文字上方或下方的小圆点、逗号等标记,常见于中文注音、日语振假名标注与部分法律文本。EmphasisMark 属性接受 Emphasis 枚举:
| 取值 | 标记位置与形状 |
|---|---|
Dot |
文字上方的圆点 |
CommaAbove |
文字上方的逗号 |
CircleAbove |
文字上方的圆圈 |
DotBelow |
文字下方的圆点 |
None |
不加标记 |
具体操作步骤如下:
- 载入
Typography.docx,在第一节末尾追加一个段落。 - 写入需要标注的“重点条款”,设置
EmphasisMark为Dot。 - 换行后写入“补充说明”,设置
CommaAbove。 - 继续写入“注意事项”与“参考内容”,分别设置
CircleAbove与DotBelow。 - 保存结果并触发下载。
为文字添加强调符号的代码如下:
const paragraph = doc.Sections.get_Item(0).AddParagraph();
const dot = paragraph.AppendText('重点条款');
dot.CharacterFormat.EmphasisMark = docModule.Emphasis.Dot;
paragraph.AppendText(':本条自发布之日起施行。');
paragraph.AppendText('\n');
const comma = paragraph.AppendText('补充说明');
comma.CharacterFormat.EmphasisMark = docModule.Emphasis.CommaAbove;
paragraph.AppendText(':本细则由综合管理部负责解释。');
paragraph.AppendText('\n');
const circle = paragraph.AppendText('注意事项');
circle.CharacterFormat.EmphasisMark = docModule.Emphasis.CircleAbove;
paragraph.AppendText(':引用时请注明来源。');
paragraph.AppendText('\n');
const below = paragraph.AppendText('参考内容');
below.CharacterFormat.EmphasisMark = docModule.Emphasis.DotBelow;
paragraph.AppendText(':详见附录与相关标准。');
生成文档的末尾会追加四种强调符号的对照示例:

为已有文字添加强调符号
如果强调符号要加在正文已有的文字上,同样可以先用 FindString() 定位:
// 找到正文中已有的“重点条款”,只给这四个字加圆点
const range = doc.FindString('重点条款', false, false).GetAsOneRange();
range.CharacterFormat.EmphasisMark = docModule.Emphasis.Dot;
强调符号属于字符属性,删除或修改它不会改变文字内容;保存后再次读取文档,CharacterFormat.EmphasisMark 仍会返回对应的枚举值。
常见问题
轮廓或阴影导出为 PDF 后显示异常,是什么原因
原因:轮廓与阴影都依赖字形边缘和字体渲染。字体子集不完整、字体本身笔画过细,或 PDF 渲染器不支持对应的字符效果时,显示结果可能与 Word 中不同。
解决:换用笔画较粗、字形完整的字体,先在 Word 中预览效果,再导出 PDF;标题字号较小时,轮廓线容易断裂,适当放大字号通常更容易看清。
上标与下标会让行距变大吗
会占用行高。上标与下标字符虽然缩小了字号,但仍参与行高计算,连续出现或字号较大时,整段行距可能被撑开。若排版要求严格,可以给上标与下标分别设置较小字号,或在段落格式中固定行距,减少行高变化。
强调符号显示为空白或方框怎么办
这通常是字体缺少对应字形导致的。强调符号由字体中的标记字形绘制,换用覆盖这些符号的字体(例如宋体或微软雅黑),再在 Word 中确认显示效果即可。单纯放大字号一般不会让缺失的字形出现。
可以一次给多处文字设置同一种效果吗
可以。FindAllString() 会返回文档中的全部匹配项,逐个取得文本区间后统一设置属性即可。匹配项较多时,建议先确认目标文字的上下文,避免把表格、页眉或目录中的同名文字一并改掉。
阳文与阴文可以同时用在一段文字上吗
两个属性可以分别设为 true,但它们都靠字形边缘的明暗模拟立体感,叠加后容易互相干扰,实际排版中通常只选一种。需要更强的对比时,可以改用轮廓、阴影或不同的文字颜色。
获取免费许可证
如果您希望删除结果文档中的评估消息,或者摆脱功能限制,请该Email地址已收到反垃圾邮件插件保护。要显示它您需要在浏览器中启用JavaScript。获取有效期 30 天的临时许可证。







