Leabharlann JavaScript Foinse Oscailte do PowerPoint

Ag tosú le pptx

Suiteáil @office-kit/pptx trí npm, pnpm, nó yarn. Dáiltear an leabharlann mar bhunáireamh ESM agus tacaíonn sé le tree-shaking le haghaidh rúraíocht íseal. Tar éis an tsuiteála, iompórtáil feidhmeanna mar `loadPresentation`, `savePresentation`, nó `createPresentation` chun tosú ag scríobh nó ag cur in eagar comhaid PPTX. Tá an API comhsheasmhach ar fud timpeallachtaí Node.js agus brabhsálaí, agus tá an stór [GitHub pptx](https://github.com/office-kit/pptx) oifigiúil ina bhfuil samplaí úsáide mionsonraithe, uirlisí bailíochtaithe, agus treoir scileanna le haghaidh forbartha AI-chabhrach.

# npm
npm install @office-kit/pptx

# pnpm
pnpm add @office-kit/pptx

# yarn
yarn add @office-kit/pptx

Cuir Teimpléid PowerPoint in Eagar

Is é eagarthóireacht teimplí an láidreacht bhunúsach de @office-kit/pptx. Is féidir leat comhad PPTX atá ann cheana a luchtú, ionadanna sealadóra (m.sh., teideal, corp) a aimsiú, agus téacs a chur in ionad go cláir—ideálach le haghaidh giniúint tuarascálacha dinimiciúla. Tacaíonn an leabharlann le hathsholáthar bunaithe ar chomharthaí ar fud gach sleamhnán, rud a fhágann nuashonruithe i mbaisc gan stró. Caomhnúann sé sláine an leagain agus cinntíonn sé go bhfanann an t-aschur comhoiriúnach le PowerPoint, Keynote, agus Google Slides. Tá an sreabhadh oibre seo thar a bheith úsáideach do chur i láthair teimplithe áit a n-athraíonn an t-ábhar amháin idir rith.

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

Cruthaigh Deic ó Bhunús

Le `createPresentation()`, is féidir leat deic PowerPoint iomlán a thógáil ó nialas—gan teimpléad de dhíth. Tuairisceann an fheidhm deic struchtúrtha go hiomlán le máistir, téama, agus leaganacha réamhshocraithe (`Blank`, `Title Slide`, `Title and Content`). Is féidir leat ansin sleamhnáin a chur leis, boscaí téacs, íomhánna, táblaí, agus cairteacha a ionsáint ag baint úsáide as APIanna clóite. Tugann an cur chuige seo smacht iomlán ar dhearadh agus ar ábhar, ag cumasú giniúint clárúcháin de chur i láthair do dheashbháirdí, tuarascálacha, nó deic sleamhnáin spreagtha ag AI agus ag coinneáil comhlíontachta ECMA-376.

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

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

Cairteacha, Beochan & Tráchtanna

Tacraíonn @office-kit/pptx ar eilimintí sleamhnáin saibhre lena n-áirítear cairteacha (bar, line, pie, area), beochana (fadeIn, fadeOut, appear), agus nótaí. Cuirtear sonraí beo Excel isteach i gcartaí le haghaidh eagarthóireachta i PowerPoint, agus úsáideann beochana éifeachtaí réamhshocraithe le fadanna inathshainithe. Ligeann nótaí duit nótaí athbhreithnithe a chur leis le meiteashonraí údar agus suíomh roghnach. Déanann na gnéithe seo an leabharlann oiriúnach chun cur i láthair idirghníomhach, saibhir ar shonraí a chruthú a chomhlíonann caighdeáin ghairmiúla agus a threoraíonn bailíochtú scéime.

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

Bailíochtú & Comhlíontú Scéime

Tá sé ríthábhachtach go mbeadh comhaid PPTX comhoiriúnach le ECMA-376 chun comhoiriúnacht a chinntiú idir uirlisí. @office-kit/pptx cuimsíonn `validatePresentation()` chun fadhbanna a bhrath cosúil le caidreamh ar iarraidh, IDanna sleamhnán neamhbhailí, nó tagairtí leagan amach briste. Úsáideann sé freisin `xmllint` i CI nuair atá sé ar fáil chun XML a ghintear a bhailíochtú i gcoinne scéimeanna oifigiúla. Cabhraíonn an sraith bailíochtaithe seo le hearráidí mionaithe a ghabháil roimh dháileadh, ag cinntiú go ndéantar cur i láthair a oscailt go iontaofa i PowerPoint, Keynote, Google Slides, agus LibreOffice—gan brath ar iompar "oscail agus guí".

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.