1. Táirgí
  2.   Próiseáil Focal
  3.   JavaScript
  4.   Docx-templates
 
  

API JavaScript chun Doiciméid Word Dinimiciúla a Ghiniúint

Leabharlann JavaScript Foinse Oscailte le haghaidh Cruthú Doiciméad Word Dinimiciúil le Node.js agus Feidhmchláir Bhrabhsálaí.

Cad é Docx-templates?

Is leabharlann JavaScript foinse oscailte é Docx-Templates a chuireann ar chumas forbróirí bogearraí doiciméid Microsoft Word (.docx) dinimiciúla a ghiniúint ag baint úsáide as teimpléid réamhshainithe. Seachas doiciméid Word a thógáil de láimh go clárúcháin, is féidir le forbróirí teimpléid a dhearadh i Microsoft Word agus sonraí dinimiciúla a ionchur trí orduithe leabaithe. Oibríonn an leabharlann seo i ngnáthshaoibrithe Node.js agus brabhsálaí, rud a fhágann go bhfuil sé an-ildáileach do fheidhmchláir ghréasáin agus freastalaí nua-aimseartha. Próiseálann sé comhaid DOCX trí a struchtúr XML inmheánach a pharsáil agus orduithe teimpléid a chur in ionad sonraí fíorúla ag am rite.

Is leabharlann chumhachtach, foinse oscailte í Docx-Templates atá deartha do chomhshaoibheanna Node.js agus brabhsálaí. Is é an buntarraí den leabharlann ná scaradh an dearaidh agus an loighic. Is féidir le húsáideoirí neamh-theicniúla an leagan amach agus an stíleáil a dhearadh i Word, agus díríonn forbróirí ar ionchur na sonraí. Tacaíonn sé le loighic chasta cosúil le lúba, formáidiú coinníollach, agus fiú le cur i bhfeidhm píosaí JavaScript go díreach laistigh den cháipéis. Déanann sé seo sé mar réiteach idéalach do fhorbróirí a theastaíonn tuarascálacha ard-dhílis a tháirgeadh gan troid le XML nó le huirlisí deartha dílse.

Previous Next

Ag tosú le Docx-templates

Is é an bealach molta chun leabharlann Docx-templates a shuiteáil ná trí npm. Úsáid an t-ordú seo a leanas le haghaidh suiteáil réidh le do thoil.

Suiteáil Docx-Templates trí NPM

$ npm install docx-templates

Suiteáil Docx-Templates trí Yarn/strong>

$ yarn add docx-templates

Giniúint Doiciméad Bunaithe ar Theimpléad trí API JS

Ceadaíonn leabharlann oscailte Docx-Templates do fhorbróirí bogearraí cáipéisí a dhearadh i Word agus sonraí a ionchur go dinimiciúil ag baint úsáide as orduithe simplí. Scarann an cur chuige seo an láithreoireacht ón loighic, rud a fhágann go bhfuil teimpléid éasca le bainistiú agus le nuashonrú gan cód a athrú. Is féidir leat rochtain dhíreach a fháil ar airíonna ó d'objec sonraí nó fiú slonn simplí a rith. Mar shampla, chun ainm iomlán a chur isteach, d'fhéachfadh do theimpléad mar seo: {firstName} {surname}. Déanann an leabharlann an cód a mheas agus é a chur in ionad go réidh.

Conas doiciméid Word a chruthú go dinimiciúil laistigh de Apps JavaScript?

import createReport from 'docx-templates';
import fs from 'fs';

const template = fs.readFileSync('template.docx');

const report = await createReport({
  template,
  data: { name: 'John', surname: 'Doe' },
});

fs.writeFileSync('output.docx', report);

Ionsá Íomhánna Dinimiciúla trí JavaScript

Seachas téacs, is féidir le leabharlann oscailte Docx-Templates íomhánna a ionchur go láithreach. Áirítear leis seo comhaid áitiúla, íomhánna ó URL, nó fiú cóid QR a ghintear go cláraitheach. Is féidir leat méid na híomhá agus a suíomh a rialú. Is gné thábhachtach é seo chun suaitheantais, catalóga táirgí, nó tuarascálacha a chruthú a éilíonn cairteacha dinimiciúla agus cruthúnas amhairc. Seo sampla simplí a thaispeánann conas íomhá a chur isteach i gcáipéisí Word trí API JavaScript.

Conas íomhá a chur isteach go huathoibríoch laistigh de doiciméid Word trí API JavaScript?

const buffer = await createReport({
  template,
  data: {
    userAvatar: async () => {
      const resp = await fetch('https://example.com/photo.png');
      return { width: 3, height: 3, data: await resp.arrayBuffer(), extension: '.png' };
    }
  },
});
// In Word: {IMAGE userAvatar()}

Lúbaí Cumhachtacha (FOR/END-FOR)

Is gan uaimh an láimhseáil liostaí sonraí leis an ordú FOR. Ligeann an ghné seo duit dul trí eagar chun rótaí tábla, liostaí, nó fiú rannóga iomlána de cháipéis a ghiniúint. Tá tacaíocht do lúbaí neadaithe curtha san áireamh sa leabharlann Docx-Templates, rud a ligeann duit struchtúir sonraí casta iordhú, mar shampla liosta roinnte le d'fhoireann a bhfoireann, agus an stíle Word bunaidh a chothabháil. Taispeánann an sampla cód thíos conas é seo a bhaint amach.

Conas lúb chun cinn a chur i bhfeidhm laistigh de Apps JavaScript?

const buffer = await createReport({
  template,
  data: {
    projects: [
      { name: 'SEO Optimization', status: 'Completed' },
      { name: 'API Integration', status: 'In Progress' }
    ]
  },
});
/* In Word:
{FOR project IN projects}
Project: {project.name} - Status: {project.status}
{END-FOR}
*/

Comhthéacs JavaScript Saincheaptha (EXEC)

Ceann de na gnéithe is forbartha den leabharlann Docx-Templates ná an cumas píosaí JavaScript de réir rogha a rith ag baint úsáide as an ordú EXEC (nó !). Trí additionalJsContext a sholáthar, is féidir leat feidhmeanna cúnta saincheaptha a nochtadh don teimpléad. Ligeann sé seo don teimpléad ríomhanna a dhéanamh, dátaí a fhormáidiú, nó teaghráin a láimhseáil go hintríneach gan gá a bheith ag réamhphróiseáil gach píosa sonraí i do loighic phríomhchláir.

 Gaeilge