Add altText attribute to elementInfo

__tests__/read-image-alt-text.test.ts

@@ -0,0 +1,36 @@
+import Automizer from '../src/index';
+import { ElementInfo } from '../src/types/xml-types';
+
+test('read alt text info', async () => {
+  const automizer = new Automizer({
+    templateDir: `${__dirname}/pptx-templates`,
+    outputDir: `${__dirname}/pptx-output`,
+  });
+
+  const pres = automizer
+    .loadRoot(`RootTemplate.pptx`)
+    .load(`SlideWithImages.pptx`, 'images')
+    .load(`ChartBarsStacked.pptx`, 'charts');
+
+  // A simple helper to get/set ElementInfo
+  const info = {
+    element: <Promise<ElementInfo>>{},
+    set: (elementInfo: Promise<ElementInfo>) => {
+      info.element = elementInfo;
+    },
+    get: async (): Promise<ElementInfo> => {
+      return info.element;
+    },
+  };
+let altText = '';
+  pres
+    .addSlide('images', 1, async (slide) => {
+      // Read another shape and print its text fragments:
+      const eleInfo = await slide.getElement('Grafik 5');
+      altText = eleInfo.altText;
+    });
+
+  await pres.write(`read-alt-text.test.pptx`);
+
+  expect(altText).toBe('picture');
+});

src/helper/xml-slide-helper.ts

@@ -111,6 +111,7 @@ export class XmlSlideHelper {
       id: XmlSlideHelper.getElementCreationId(slideElement),
       type: XmlSlideHelper.getElementType(slideElement),
       position: XmlSlideHelper.parseShapeCoordinates(slideElement),
+      altText: XmlSlideHelper.getImageAltText(slideElement),
       hasTextBody: !!XmlSlideHelper.getTextBody(slideElement),
       getText: () => XmlSlideHelper.parseTextFragments(slideElement),
       getXmlElement: () => slideElement,
@@ -157,6 +158,13 @@ export class XmlSlideHelper {
     return shapeNode.getElementsByTagNameNS(nsMain, 'cNvPr').item(0);
   }
 
+  static getImageAltText(slideElement: XmlElement) {
+    const cNvPr = XmlSlideHelper.getNonVisibleProperties(slideElement);
+    if (cNvPr) {
+      return cNvPr.getAttribute('descr');
+    }
+  }
+
   static getElementName(slideElement: XmlElement) {
     const cNvPr = XmlSlideHelper.getNonVisibleProperties(slideElement);
     if (cNvPr) {

src/types/xml-types.ts

@@ -72,6 +72,7 @@ export type ElementInfo = {
     cx: number;
     cy: number;
   };
+  altText: string;
   hasTextBody: boolean;
   getText: () => string[];
   getXmlElement: () => XmlElement;