pptxtojson 1.1.0 → 1.2.0

package/README.md

@@ -9,9 +9,9 @@
 
 # 🎯 注意事项
 ### ⚒️ 使用场景
-本仓库诞生于项目 [PPTist](https://github.com/pipipi-pikachu/PPTist) ，希望为其“导入 .pptx 文件功能”提供一个参考示例。不过就目前来说，解析出来的PPT信息与源文件在样式上还是存在不少差距，还不足以直接运用到生产环境中。
+本仓库诞生于项目 [PPTist](https://github.com/pipipi-pikachu/PPTist) ，希望为其“导入 .pptx 文件功能”提供一个参考示例。不过就目前来说，解析出来的PPT信息与源文件在样式上还是存在差距，还不足以直接运用到生产环境中。
 
-但如果你只是需要提取PPT文件的文本内容和媒体资源信息，对排版精准度/样式信息没有特别高的要求，那么 pptxtojson 可能会对你有一些帮助。
+但如果你只是需要提取PPT文件的文本内容、媒体资源信息、结构信息等，对排版/样式精准度没有特别高的要求，那么 pptxtojson 可能会对你有帮助。
 
 ### 📏 长度值单位
 输出的JSON中，所有数值长度值单位都为`pt`（point）
@@ -45,35 +45,45 @@ document.querySelector('input').addEventListener('change', evt => {
 ```javascript
 // 输出示例
 {
-	"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"
+	"slides": [
+		{
+			"fill": {
+				"type": "color",
+				"value": "#FF0000"
 			},
-			// more...
-		],
-		"note": "演讲者备注内容..."
-	},
+			"elements": [
+				{
+					"left":	0,
+					"top": 0,
+					"width": 72,
+					"height":	72,
+					"borderColor": "#1F4E79",
+					"borderWidth": 1,
+					"borderType": "solid",
+					"borderStrokeDasharray": 0,
+					"fill": {
+						"type": "color",
+						"value": "#FF0000"
+					},
+					"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...
+			],
+			"layoutElements": [
+				// more...
+			],
+			"note": "演讲者备注内容..."
+		},
+		// more...
+	],
+	"themeColors": ['#4472C4', '#ED7D31', '#A5A5A5', '#FFC000', '#5B9BD5', '#70AD47'],
 	"size": {
 		"width": 960,
 		"height": 540
@@ -83,18 +93,18 @@ document.querySelector('input').addEventListener('change', evt => {
 
 # 📕 完整功能支持
 
+### 幻灯片主题色 `themeColors`
+
 ### 幻灯片尺寸 `size`
 - 幻灯片宽度 `width`
 - 幻灯片高度 `height`
 
 ### 幻灯片页面 `slides`
-#### 页面背景填充 `fill`
-- 背景类型（颜色、图片、渐变） `type`
-- 背景值 `value`
+#### 页面背景填充（颜色、图片、渐变） `fill`
 
 #### 页面备注 `note`
 
-#### 页面内元素 `elements`
+#### 页面内元素 `elements` / 母版元素 `layoutElements`
 ##### 文字
 - 类型 `type='text'`
 - 水平坐标 `left`
@@ -106,7 +116,7 @@ document.querySelector('input').addEventListener('change', evt => {
 - 边框类型（实线、点线、虚线） `borderType`
 - 非实线边框样式 `borderStrokeDasharray`
 - 阴影 `shadow`
-- 填充色 `fillColor`
+- 填充（颜色、图片、渐变） `fill`
 - 内容文字（HTML富文本） `content`
 - 垂直翻转 `isFlipV`
 - 水平翻转 `isFlipH`
@@ -135,7 +145,7 @@ document.querySelector('input').addEventListener('change', evt => {
 - 边框类型（实线、点线、虚线） `borderType`
 - 非实线边框样式 `borderStrokeDasharray`
 - 阴影 `shadow`
-- 填充色 `fillColor`
+- 填充（颜色、图片、渐变） `fill`
 - 内容文字（HTML富文本） `content`
 - 垂直翻转 `isFlipV`
 - 水平翻转 `isFlipH`
@@ -163,6 +173,7 @@ document.querySelector('input').addEventListener('change', evt => {
 - 宽度 `width`
 - 高度 `height`
 - 图表数据 `data`
+- 图表主题色 `colors`
 - 图表类型 `chartType`
 - 柱状图方向 `barDir`
 - 是否带数据标记 `marker`
@@ -219,4 +230,11 @@ document.querySelector('input').addEventListener('change', evt => {
 > 与它们不同的是，PPTX2HTML 和 PPTXjs 是将PPT文件转换为能够运行的 HTML 页面，而 pptxtojson 做的是将PPT文件转换为干净的 JSON 数据
 
 # 📄 开源协议
-MIT License | Copyright © 2020-PRESENT [pipipi-pikachu](https://github.com/pipipi-pikachu)
+MIT License | Copyright © 2020-PRESENT [pipipi-pikachu](https://github.com/pipipi-pikachu)
+
+# ☕ 打赏
+如果该项目帮到了您，还请您不吝打赏！
+
+<p align="left">
+    <img src='/dist/wx.png' />
+</p>

package/dist/index.d.ts

@@ -5,6 +5,32 @@ export interface Shadow {
   color: string
 }
 
+export interface ColorFill {
+  type: 'color'
+  value: string
+}
+
+export interface ImageFill {
+  type: 'image'
+  value: {
+    picBase64: string
+    opacity: number
+  }
+}
+
+export interface GradientFill {
+  type: 'gradient'
+  value: {
+    rot: number
+    colors: {
+      pos: string
+      color: string
+    }[]
+  }
+}
+
+export type Fill = ColorFill | ImageFill | GradientFill
+
 export interface Shape {
   type: 'shape'
   left: number
@@ -16,7 +42,7 @@ export interface Shape {
   borderType: 'solid' | 'dashed' | 'dotted'
   borderStrokeDasharray: string
   shadow?: Shadow
-  fillColor: string
+  fill: Fill
   content: string
   isFlipV: boolean
   isFlipH: boolean
@@ -25,6 +51,7 @@ export interface Shape {
   vAlign: string
   path?: string
   name: string
+  order: number
 }
 
 export interface Text {
@@ -38,7 +65,7 @@ export interface Text {
   borderType: 'solid' | 'dashed' | 'dotted'
   borderStrokeDasharray: string
   shadow?: Shadow
-  fillColor: string
+  fill: Fill
   isFlipV: boolean
   isFlipH: boolean
   isVertical: boolean
@@ -46,6 +73,7 @@ export interface Text {
   content: string
   vAlign: string
   name: string
+  order: number
 }
 
 export interface Image {
@@ -58,6 +86,7 @@ export interface Image {
   rotate: number
   isFlipH: boolean
   isFlipV: boolean
+  order: number
 }
 
 export interface TableCell {
@@ -80,6 +109,7 @@ export interface Table {
   borderColor: string
   borderWidth: number
   borderType: 'solid' | 'dashed' | 'dotted'
+  order: number
 }
 
 export type ChartType = 'lineChart' |
@@ -118,12 +148,14 @@ export interface CommonChart {
   width: number
   height: number
   data: ChartItem[]
+  colors: string[]
   chartType: Exclude<ChartType, 'scatterChart' | 'bubbleChart'>
   barDir?: 'bar' | 'col'
   marker?: boolean
   holeSize?: string
   grouping?: string
   style?: string
+  order: number
 }
 export interface ScatterChart {
   type: 'chart'
@@ -131,8 +163,10 @@ export interface ScatterChart {
   top: number
   width: number
   height: number
-  data: ScatterChartData,
+  data: ScatterChartData
+  colors: string[]
   chartType: 'scatterChart' | 'bubbleChart'
+  order: number
 }
 export type Chart = CommonChart | ScatterChart
 
@@ -144,6 +178,7 @@ export interface Video {
   height: number
   blob?: string
   src?: string
+  order: number
 }
 
 export interface Audio {
@@ -153,6 +188,7 @@ export interface Audio {
   width: number
   height: number
   blob: string
+  order: number
 }
 
 export interface Diagram {
@@ -162,6 +198,7 @@ export interface Diagram {
   width: number
   height: number
   elements: (Shape | Text)[]
+  order: number
 }
 
 export interface Math {
@@ -171,6 +208,7 @@ export interface Math {
   width: number
   height: number
   latex: string
+  order: number
 }
 
 export type BaseElement = Shape | Text | Image | Table | Chart | Video | Audio | Diagram | Math
@@ -183,38 +221,14 @@ export interface Group {
   height: number
   rotate: number
   elements: BaseElement[]
+  order: number
 }
 export type Element = BaseElement | Group
 
-export interface SlideColorFill {
-  type: 'color'
-  value: string
-}
-
-export interface SlideImageFill {
-  type: 'image'
-  value: {
-    picBase64: string
-    opacity: number
-  }
-}
-
-export interface SlideGradientFill {
-  type: 'gradient'
-  value: {
-    rot: number
-    colors: {
-      pos: string
-      color: string
-    }[]
-  }
-}
-
-export type SlideFill = SlideColorFill | SlideImageFill | SlideGradientFill
-
 export interface Slide {
-  fill: SlideFill
+  fill: Fill
   elements: Element[]
+  layoutElements: Element[]
   note: string
 }
 
@@ -225,6 +239,7 @@ export interface Options {
 
 export const parse: (file: ArrayBuffer, options?: Options) => Promise<{
   slides: Slide[]
+  themeColors: string[]
   size: {
     width: number
     height: number