PowerPoint üçün Açıq Mənbəli JavaScript Kitabxanası

pptx ilə Başlamaq

@office-kit/pptx paketini npm, pnpm və ya yarn vasitəsilə quraşdırın. Kitabxana ESM paket kimi paylanır və minimal ölçü üçün tree-shaking dəstəkləyir. Quraşdırmadan sonra `loadPresentation`, `savePresentation` və ya `createPresentation` kimi funksiyaları idxal edərək PPTX fayllarını yaratmağa və ya redaktə etməyə başlayın. API Node.js və brauzer mühitlərində ardıcıl işləyir və rəsmi [pptx GitHub](https://github.com/office-kit/pptx) deposu ətraflı istifadə nümunələri, doğrulama alətləri və AI‑yardımlı inkişaf üçün bacarıq bələdçisi təqdim edir.

# npm
npm install @office-kit/pptx

# pnpm
pnpm add @office-kit/pptx

# yarn
yarn add @office-kit/pptx

PowerPoint Şablonlarını Redaktə Et

Şablon redaktəsi @office-kit/pptx‑in əsas güclü tərəflərindən biridir. Mövcud PPTX faylını yükləyə, yer tutucuları (məsələn, başlıq, mətn) tapa və mətnləri proqram vasitəsilə əvəzləyə bilərsiniz — dinamik hesabat yaradılması üçün ideal. Kitabxana bütün slaydlarda token‑əsaslı əvəzləməni dəstəkləyir, toplu yeniləmələri asanlaşdırır. O, dizayn bütövlüyünü qoruyur və çıxışın PowerPoint, Keynote və Google Slides ilə uyğun qalmasını təmin edir. Bu iş axını yalnız məzmunun icra arasında dəyişdiyi şablonlu təqdimatlar üçün xüsusilə faydalıdır.

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

Sıfırdan Dəstlər Yarat

With `createPresentation()`, you can build a complete PowerPoint deck from zero—no template required. The function returns a fully structured deck with a master, theme, and default layouts (`Blank`, `Title Slide`, `Title and Content`). You can then add slides, insert text boxes, images, tables, and charts using typed APIs. This approach gives full control over design and content, enabling programmatic generation of presentations for dashboards, reports, or AI-driven slide decks while maintaining ECMA-376 compliance.

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

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

Cədvəllər, Animasiyalar və Şərhlər

@office-kit/pptx supports rich slide elements including charts (bar, line, pie, area), animations (fadeIn, fadeOut, appear), and comments. Charts embed live Excel data for editing in PowerPoint, while animations use preset effects with configurable durations. Comments let you add reviewer notes with author metadata and optional positioning. These features make the library suitable for creating interactive, data-rich presentations that meet professional standards and pass schema validation.

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

Doğrulama və sxem uyğunluğu

PPTX fayllarının ECMA-376 standartına uyğun olmasını təmin etmək alətlər arasında uyğunluq üçün vacibdir. @office-kit/pptx `validatePresentation()` funksiyasını daxil edir ki, itirilmiş əlaqələr, etibarsız slayd ID-ləri və ya qırılmış layout istinadları kimi problemləri aşkarsın. Həmçinin mövcud olduqda CI-də `xmllint` istifadə edərək yaradılan XML-i rəsmi sxemalara qarşı yoxlayır. Bu doğrulama təbəqəsi paylanmadan əvvəl incə səhvləri tutmağa kömək edir, təqdimatların PowerPoint, Keynote, Google Slides və LibreOffice‑də etibarlı şəkildə açılmasını təmin edir—"open and pray" davranışına etibar etmədən.

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.