pptxtojson

v1.0.3

Published

2 months ago

A javascript tool for parsing .pptx file

Downloads

1,012

0High
0Medium
0Low

pipipi-pikachu

ppt pptx json

🎨 pptxtojson

一个运行在浏览器中，可以将 .pptx 文件转为可读的 JSON 数据的 JavaScript 库。

与其他的pptx文件解析工具的最大区别在于：
直接运行在浏览器端；
解析结果是可读的 JSON 数据，而不仅仅是把 XML 文件内容原样翻译成难以理解的 JSON。

在线DEMO：https://pipipi-pikachu.github.io/pptxtojson/

🪧 注意事项

⚒️ 使用场景

本仓库诞生于项目 PPTist ，希望为其“导入 .pptx 文件功能”提供一个参考示例。不过就目前来说，解析出来的PPT信息与源文件在样式上还是存在不少差距，还不足以直接运用到生产环境中。

但如果你只是需要提取PPT文件的文本内容和媒体资源信息，对排版精准度/样式信息没有特别高的要求，那么 pptxtojson 可能会对你有一些帮助。

📏 长度值单位

输出的JSON中，所有数值长度值单位都为pt（point）

注意：在0.x版本中，所有输出的长度值单位都是px（像素）

🔨安装

npm install pptxtojson

💿用法

<input type="file" accept="application/vnd.openxmlformats-officedocument.presentationml.presentation"/>

import { parse } from 'pptxtojson'

document.querySelector('input').addEventListener('change', evt => {
	const file = evt.target.files[0]
	
	const reader = new FileReader()
	reader.onload = async e => {
		const json = await parse(e.target.result)
		console.log(json)
	}
	reader.readAsArrayBuffer(file)
})

// 输出示例
{
	"slides": {
		"fill": {
			"type": "color",
			"value": "#FF0000"
		},
		"elements": [
			{
				"left":	0,
				"top": 0,
				"width": 72,
				"height":	72,
				"borderColor": "#1f4e79",
				"borderWidth": 1,
				"borderType": "solid",
				"borderStrokeDasharray": 0,
				"fillColor": "#5b9bd5",
				"content": "<p style=\"text-align: center;\"><span style=\"font-size: 18pt;font-family: Calibri;\">TEST</span></p>",
				"isFlipV": false,
				"isFlipH": false,
				"rotate": 0,
				"vAlign": "mid",
				"name": "矩形 1",
				"type": "shape",
				"shapType": "rect"
			},
			// more...
		],
	},
	"size": {
		"width": 960,
		"height": 540
	}
}

📕 功能支持

幻灯片尺寸

| prop | type | 描述
|------------------------|--------------------------------|--------------- | width | number | 宽度
| height | number | 高度

页面背景

| prop | type | 描述
|------------------------|---------------------------------|--------------- | type | 'color' 丨 'image' 丨 'gradient' | 背景类型
| value | SlideColorFill 丨 SlideImageFill 丨 SlideGradientFill| 背景值

页内元素

文字

| prop | type | 描述
|------------------------|--------------------------------|--------------- | type | 'text' | 类型
| left | number | 水平坐标
| top | number | 垂直坐标
| width | number | 宽度
| height | number | 高度
| borderColor | string | 边框颜色
| borderWidth | number | 边框宽度
| borderType | 'solid' 丨 'dashed' 丨 'dotted' | 边框类型
| borderStrokeDasharray | string | 非实线边框样式
| shadow | Shadow | 阴影
| fillColor | string | 填充色
| content | string | 内容文字（HTML富文本） | isFlipV | boolean | 垂直翻转
| isFlipH | boolean | 水平翻转
| rotate | number | 旋转角度
| vAlign | string | 垂直对齐方向
| isVertical | boolean | 是否为竖向文本
| name | string | 元素名

图片

| prop | type | 描述
|------------------------|--------------------------------|--------------- | type | 'image' | 类型
| left | number | 水平坐标
| top | number | 垂直坐标
| width | number | 宽度
| height | number | 高度
| src | string | 图片地址（base64）
| rotate | number | 旋转角度

形状

| prop | type | 描述
|------------------------|--------------------------------|--------------- | type | 'shape' | 类型
| left | number | 水平坐标
| top | number | 垂直坐标
| width | number | 宽度
| height | number | 高度
| borderColor | string | 边框颜色
| borderWidth | number | 边框宽度
| borderType | 'solid' 丨 'dashed' 丨 'dotted' | 边框类型
| borderStrokeDasharray | string | 非实线边框样式
| shadow | Shadow | 阴影
| fillColor | string | 填充色
| content | string | 内容文字（HTML富文本） | isFlipV | boolean | 垂直翻转
| isFlipH | boolean | 水平翻转
| rotate | number | 旋转角度
| shapType | string | 形状类型
| vAlign | string | 垂直对齐方向
| path | string | 路径（仅自定义形状存在）
| name | string | 元素名

表格

| prop | type | 描述
|------------------------|--------------------------------|--------------- | type | 'table' | 类型
| left | number | 水平坐标
| top | number | 垂直坐标
| width | number | 宽度
| height | number | 高度
| borderColor | string | 边框颜色
| borderWidth | number | 边框宽度
| borderType | 'solid' 丨 'dashed' 丨 'dotted' | 边框类型
| data | TableCell[][] | 表格数据

图表

| prop | type | 描述
|------------------------|--------------------------------|--------------- | type | 'chart' | 类型
| left | number | 水平坐标
| top | number | 垂直坐标
| width | number | 宽度
| height | number | 高度
| data | ChartItem[] 丨 ScatterChartData | 图表数据
| chartType | ChartType | 图表类型
| barDir | 'bar' 丨 'col' | 柱状图方向
| marker | boolean | 是否带数据标记
| holeSize | string | 环形图尺寸
| grouping | string | 分组模式
| style | string | 图表样式

视频

| prop | type | 描述
|------------------------|--------------------------------|--------------- | type | 'video' | 类型
| left | number | 水平坐标
| top | number | 垂直坐标
| width | number | 宽度
| height | number | 高度
| blob | string | 视频blob
| src | string | 视频src

音频

| prop | type | 描述
|------------------------|--------------------------------|--------------- | type | 'audio' | 类型
| left | number | 水平坐标
| top | number | 垂直坐标
| width | number | 宽度
| height | number | 高度
| blob | string | 音频blob

Smart图

| prop | type | 描述
|------------------------|--------------------------------|--------------- | type | 'diagram' | 类型
| left | number | 水平坐标
| top | number | 垂直坐标
| width | number | 宽度
| height | number | 高度
| elements | (Shape 丨 Text)[] | 子元素集合

多元素组合

| prop | type | 描述
|------------------------|--------------------------------|--------------- | type | 'group' | 类型
| left | number | 水平坐标
| top | number | 垂直坐标
| width | number | 宽度
| height | number | 高度
| elements | Element[] | 子元素集合

🙏 感谢

本仓库大量参考了 PPTX2HTML 和 PPTXjs 的实现。

与它们不同的是，PPTX2HTML 和 PPTXjs 是将PPT文件转换为能够运行的 HTML 页面，而 pptxtojson 做的是将PPT文件转换为干净的 JSON 数据

Published

Vulnerabilities

Links

Maintainers

Keywords

Readme