CORE
@office-open/core
共享 XML 组件、值验证、格式化和单位转换器
通常不需要直接安装此包 — 它是 @office-open/docx 和 @office-open/pptx 的依赖项。如果你正在构建自定义 OOXML 元素或扩展库，@office-open/core 提供了构建模块。
模块概览
XML 组件
所有 OOXML XML 元素都基于 XmlComponent 构建。.docx 或 .pptx 文件中的每个元素最终都继承此基类。
import { XmlComponent } from "@office-open/core";
class MyElement extends XmlComponent {
constructor() {
super("w:myElement");
}
}
值与验证
OOXML 规范值类型的运行时验证函数：
| 函数 | 说明 |
|---|---|
decimalNumber(val) | 验证并向下取整 |
hexColorValue(val) | 验证十六进制颜色 |
twipsMeasureValue(val) | TWIP 测量值 |
hpsMeasureValue(val) | 半磅测量值（字号） |
percentageValue(val) | 标准化百分比字符串 |
单位转换器
import {
convertMillimetersToTwip,
convertInchesToTwip,
convertPixelsToEmu,
convertPointsToEmu,
} from "@office-open/core";
convertMillimetersToTwip(25.4); // 1440 (1 英寸)
convertPixelsToEmu(100); // 952500
convertPointsToEmu(12); // 152400
图表与 SmartArt
@office-open/docx 和 @office-open/pptx 共享的图表组件（BarChart、LineChart、PieChart、AreaChart、ScatterChart）和 SmartArt 组件。
DrawingML
颜色、填充、轮廓、效果和几何形状的共享基元。