Libreria JavaScript Open Source per PowerPoint

Iniziare con pptx

Installa @office-kit/pptx tramite npm, pnpm o yarn. La libreria è distribuita come bundle ESM e supporta il tree‑shaking per un ingombro minimo. Dopo l'installazione, importa funzioni come `loadPresentation`, `savePresentation` o `createPresentation` per iniziare a creare o modificare file PPTX. L'API è coerente sia negli ambienti Node.js sia nei browser, e il repository ufficiale [GitHub di pptx](https://github.com/office-kit/pptx) include esempi di utilizzo dettagliati, strumenti di validazione e una guida di competenze per lo sviluppo assistito dall'IA.

# npm
npm install @office-kit/pptx

# pnpm
pnpm add @office-kit/pptx

# yarn
yarn add @office-kit/pptx

Modifica i modelli PowerPoint

La modifica dei modelli è un punto di forza principale di @office-kit/pptx. Puoi caricare un file PPTX esistente, individuare i segnaposto (ad es., titolo, corpo) e sostituire il testo programmaticamente—ideale per la generazione dinamica di report. La libreria supporta la sostituzione basata su token su tutte le diapositive, rendendo gli aggiornamenti batch senza sforzo. Preserva l'integrità del layout e garantisce che l'output rimanga compatibile con PowerPoint, Keynote e Google Slides. Questo flusso di lavoro è particolarmente utile per presentazioni basate su modelli in cui solo il contenuto cambia tra le esecuzioni.

import {
  findSlidePlaceholder,
  getSlides,
  loadPresentation,
  savePresentation,
  setShapeText,
} from '@office-kit/pptx';

const pres = await loadPresentation(existingPptxBytes);
const cover = getSlides(pres)[0]!;
const title = findSlidePlaceholder(cover, 'title');
if (title) setShapeText(title, 'Q3 Review');
const body = findSlidePlaceholder(cover, 'body');
if (body) setShapeText(body, 'Numbers up and to the right.');
const out: Uint8Array = await savePresentation(pres);

Crea presentazioni da zero

Con `createPresentation()`, puoi creare un intero deck PowerPoint da zero—nessun modello richiesto. La funzione restituisce un deck completamente strutturato con un master, tema e layout predefiniti (`Blank`, `Title Slide`, `Title and Content`). Puoi quindi aggiungere diapositive, inserire caselle di testo, immagini, tabelle e grafici utilizzando API tipizzate. Questo approccio offre il pieno controllo su design e contenuto, consentendo la generazione programmatica di presentazioni per dashboard, report o deck di diapositive guidati dall'IA, mantenendo la conformità ECMA-376.

import {
  addTitleSlide,
  createPresentation,
  savePresentation,
} from '@office-kit/pptx';

const pres = createPresentation();
addTitleSlide(pres, 'Q3 Business Review');
const out: Uint8Array = await savePresentation(pres);

Grafici, animazioni e commenti

@office-kit/pptx supporta elementi diapositive ricchi, inclusi grafici (a barre, a linee, a torta, ad area), animazioni (fadeIn, fadeOut, appear) e commenti. I grafici incorporano dati Excel live per la modifica in PowerPoint, mentre le animazioni utilizzano effetti predefiniti con durate configurabili. I commenti consentono di aggiungere note del revisore con metadati dell'autore e posizionamento opzionale. Queste funzionalità rendono la libreria adatta alla creazione di presentazioni interattive e ricche di dati che soddisfano gli standard professionali e superano la validazione dello schema.

import {
  addSlideChart,
  getSlides,
  loadPresentation,
  setShapeAnimation,
  savePresentation,
  inches,
} from '@office-kit/pptx';

const pres = await loadPresentation(templateBytes);
const slide = getSlides(pres)[0]!;
addSlideChart(slide!, {
  x: inches(0.5),
  y: inches(0.5),
  w: inches(8),
  h: inches(4.5),
  spec: {
    kind: 'column',
    categories: ['Q1', 'Q2', 'Q3', 'Q4'],
    series: [
      { name: 'Revenue', values: [120, 180, 240, 300] },
      { name: 'Cost', values: [80, 90, 130, 160] },
    ],
    title: 'FY26 plan',
  },
});
const shape = getSlideShapes(slide)[0]!;
setShapeAnimation(shape, { effect: 'fadeIn', durationMs: 800 });
await savePresentation(pres);

Validazione e conformità allo schema

Assicurare che i file PPTX siano conformi a ECMA-376 è fondamentale per la compatibilità tra gli strumenti. @office-kit/pptx include `validatePresentation()` per rilevare problemi come relazioni mancanti, ID delle diapositive non validi o riferimenti di layout interrotti. Utilizza anche `xmllint` nella CI, quando disponibile, per convalidare l'XML generato rispetto agli schemi ufficiali. Questo livello di validazione aiuta a individuare errori sottili prima della distribuzione, garantendo che le presentazioni si aprano in modo affidabile in PowerPoint, Keynote, Google Slides e LibreOffice—senza fare affidamento sul comportamento "open and pray".

import { validatePresentation } from '@office-kit/pptx';

const issues = validatePresentation(pres);
for (const i of issues) console.error(i.severity, i.message);
// Catches missing rels, dangling slide ids, layouts without masters, etc.