Ανοιχτού Κώδικα Βιβλιοθήκη JavaScript για PowerPoint

Ξεκινώντας με το pptx

Εγκαταστήστε το @office-kit/pptx μέσω npm, pnpm ή yarn. Η βιβλιοθήκη διανέμεται ως πακέτο ESM και υποστηρίζει tree-shaking για ελάχιστο αποτύπωμα. Μετά την εγκατάσταση, εισάγετε συναρτήσεις όπως `loadPresentation`, `savePresentation` ή `createPresentation` για να ξεκινήσετε τη δημιουργία ή την επεξεργασία αρχείων PPTX. Το API είναι συνεπές σε περιβάλλοντα Node.js και προγράμματα περιήγησης, και το επίσημο αποθετήριο [pptx GitHub](https://github.com/office-kit/pptx) περιλαμβάνει λεπτομερή παραδείγματα χρήσης, εργαλεία επικύρωσης και έναν οδηγό δεξιοτήτων για ανάπτυξη με υποβοήθηση AI.

# npm
npm install @office-kit/pptx

# pnpm
pnpm add @office-kit/pptx

# yarn
yarn add @office-kit/pptx

Επεξεργασία προτύπων PowerPoint

Η επεξεργασία προτύπων είναι βασικό πλεονέκτημα του @office-kit/pptx. Μπορείτε να φορτώσετε ένα υπάρχον αρχείο PPTX, να εντοπίσετε τα placeholders (π.χ., τίτλο, σώμα) και να αντικαταστήσετε το κείμενο προγραμματιστικά—ιδανικό για δυναμική δημιουργία αναφορών. Η βιβλιοθήκη υποστηρίζει αντικατάσταση βάσει token σε όλες τις διαφάνειες, καθιστώντας τις μαζικές ενημερώσεις απρόσκοπτες. Διατηρεί την ακεραιότητα της διάταξης και εξασφαλίζει ότι το αποτέλεσμα παραμένει συμβατό με PowerPoint, Keynote και Google Slides. Αυτή η ροή εργασίας είναι ιδιαίτερα χρήσιμη για παρουσιάσεις με πρότυπα όπου μόνο το περιεχόμενο αλλάζει μεταξύ εκτελέσεων.

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

Δημιουργία παρουσιάσεων από το μηδέν

Με τη `createPresentation()`, μπορείτε να δημιουργήσετε ένα πλήρες σετ διαφανειών PowerPoint από το μηδέν—χωρίς να απαιτείται πρότυπο. Η λειτουργία επιστρέφει ένα πλήρως δομημένο σετ με master, θέμα και προεπιλεγμένες διατάξεις (`Blank`, `Title Slide`, `Title and Content`). Στη συνέχεια, μπορείτε να προσθέσετε διαφάνειες, να εισάγετε πλαίσια κειμένου, εικόνες, πίνακες και γραφήματα χρησιμοποιώντας τυποποιημένα API. Αυτή η προσέγγιση παρέχει πλήρη έλεγχο του σχεδιασμού και του περιεχομένου, επιτρέποντας τη προγραμματιστική δημιουργία παρουσιάσεων για πίνακες ελέγχου, αναφορές ή παρουσιάσεις που δημιουργούνται από AI, διατηρώντας τη συμμόρφωση με το ECMA-376.

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

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

Διαγράμματα, Κινούμενα Σχέδια & Σχόλια

Το @office-kit/pptx υποστηρίζει πλούσια στοιχεία διαφάνειας, συμπεριλαμβανομένων γραφημάτων (bar, line, pie, area), κινούμενων σχεδίων (fadeIn, fadeOut, appear) και σχολίων. Τα γραφήματα ενσωματώνουν ζωντανά δεδομένα Excel για επεξεργασία στο PowerPoint, ενώ τα κινούμενα σχέδια χρησιμοποιούν προεπιλεγμένα εφέ με ρυθμιζόμενες διάρκειες. Τα σχόλια σας επιτρέπουν να προσθέσετε σημειώσεις αξιολογητών με μεταδεδομένα συγγραφέα και προαιρετική τοποθέτηση. Αυτά τα χαρακτηριστικά καθιστούν τη βιβλιοθήκη κατάλληλη για τη δημιουργία διαδραστικών, δεδομένων‑πλούσιων παρουσιάσεων που πληρούν τα επαγγελματικά πρότυπα και περνούν την επικύρωση του σχήματος.

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

Επικύρωση & Συμμόρφωση Σχήματος

Η διασφάλιση ότι τα αρχεία PPTX είναι συμβατά με το ECMA-376 είναι κρίσιμη για τη συμβατότητα μεταξύ εργαλείων. Το @office-kit/pptx περιλαμβάνει `validatePresentation()` για την ανίχνευση προβλημάτων όπως ελλιπείς σχέσεις, μη έγκυρα IDs διαφανειών ή σπασμένες αναφορές διάταξης. Χρησιμοποιεί επίσης `xmllint` στο CI όπου είναι διαθέσιμο για την επικύρωση του παραγόμενου XML έναντι των επίσημων σχημάτων. Αυτό το επίπεδο επικύρωσης βοηθά στο να εντοπίζονται λεπτές σφάλματα πριν τη διανομή, διασφαλίζοντας ότι οι παρουσιάσεις ανοίγουν αξιόπιστα στο PowerPoint, Keynote, Google Slides και LibreOffice—χωρίς να βασίζονται στη συμπεριφορά «άνοιξε και προσευχήσου».

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.