Bibliotecă JavaScript Open Source pentru PowerPoint

Începerea cu pptx

Instalați @office-kit/pptx prin npm, pnpm sau yarn. Biblioteca este distribuită ca un pachet ESM și suportă tree-shaking pentru o amprentă minimă. După instalare, importați funcții precum `loadPresentation`, `savePresentation` sau `createPresentation` pentru a începe să creați sau să editați fișiere PPTX. API-ul este consistent în mediile Node.js și browser, iar depozitul oficial [pptx GitHub](https://github.com/office-kit/pptx) include exemple detaliate de utilizare, instrumente de validare și un ghid de abilități pentru dezvoltare asistată de AI.

# npm
npm install @office-kit/pptx

# pnpm
pnpm add @office-kit/pptx

# yarn
yarn add @office-kit/pptx

Editați șabloanele PowerPoint

Editarea șabloanelor este un punct forte al @office-kit/pptx. Puteți încărca un fișier PPTX existent, să localizați marcajele (de exemplu, titlu, corp) și să înlocuiți textul programatic—ideal pentru generarea dinamică de rapoarte. Biblioteca suportă înlocuirea bazată pe tokenuri pe toate diapozitivele, facilitând actualizările în lot. Păstrează integritatea aspectului și asigură că rezultatul rămâne compatibil cu PowerPoint, Keynote și Google Slides. Acest flux de lucru este deosebit de util pentru prezentări șablonate în care doar conținutul se schimbă între rulări.

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ți prezentări de la zero

Cu `createPresentation()`, poți crea un set complet de diapozitive PowerPoint de la zero—fără a necesita un șablon. Funcția returnează un set complet structurat cu un master, temă și layout-uri implicite (`Blank`, `Title Slide`, `Title and Content`). Poți apoi să adaugi diapozitive, să inserezi casete de text, imagini, tabele și grafice utilizând API-uri tipizate. Această abordare oferă control total asupra designului și conținutului, permițând generarea programatică a prezentărilor pentru tablouri de bord, rapoarte sau seturi de diapozitive generate de AI, menținând conformitatea cu ECMA-376.

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

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

Grafice, animații și comentarii

@office-kit/pptx suportă elemente de diapozitiv bogate, inclusiv grafice (bară, linie, plăcintă, zonă), animații (fadeIn, fadeOut, appear) și comentarii. Graficele încorporează date Excel live pentru editare în PowerPoint, în timp ce animațiile utilizează efecte presetate cu durate configurabile. Comentariile îți permit să adaugi note de revizor cu metadate ale autorului și poziționare opțională. Aceste funcționalități fac ca biblioteca să fie potrivită pentru crearea de prezentări interactive și bogate în date, care respectă standardele profesionale și trec de validarea schemei.

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);

Validare și conformitate cu schema

Asigurarea că fișierele PPTX respectă standardul ECMA-376 este esențială pentru compatibilitatea între instrumente. @office-kit/pptx include `validatePresentation()` pentru a detecta probleme precum relații lipsă, ID-uri de diapozitiv nevalide sau referințe de aspect întrerupte. De asemenea, folosește `xmllint` în CI, acolo unde este disponibil, pentru a valida XML-ul generat față de schemele oficiale. Acest strat de validare ajută la capturarea erorilor subtile înainte de distribuție, asigurând deschiderea fiabilă a prezentărilor în PowerPoint, Keynote, Google Slides și LibreOffice—fără a se baza pe comportamentul „deschide și roagă-te”.

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.