Operazioni di presentazione low-code in JavaScript

Panoramica

Lo spazio dei nomi aspose.slides fornisce classi helper statiche per le operazioni comuni sulle presentazioni. Questi helper incapsulano i flussi di lavoro dell’object‑model più usati in metodi mirati, così è possibile convertire o unire file, elaborare gli elementi della presentazione, raccogliere forme e rimuovere contenuti inutilizzati con meno codice.

Gli helper low‑code sono più utili quando l’operazione si applica a un intero file o a una presentazione e il flusso di lavoro predefinito soddisfa i requisiti. Utilizza l’intero Aspose.Slides object model quando hai bisogno di un controllo granulare su singole diapositive, master, layout, forme, impostazioni di esportazione o relazioni tra gli elementi della presentazione.

La tabella seguente riepiloga gli helper disponibili:

Helper Utilizzo
Convert Conversione di una presentazione in un altro formato con una chiamata diretto file‑a‑file.
Merger Combinazione di file di presentazione completi dello stesso formato.
ForEach Esecuzione di un’azione per ogni diapositiva, forma, paragrafo o porzione di testo.
Collect Recupero delle forme dall’intera presentazione per elaborazioni o analisi ripetute.
Compress Rimozione di master e layout inutilizzati e riduzione dei dati dei font incorporati.

Convertire una presentazione

Utilizza Convert.autoByExtension quando l’estensione del file di output è sufficiente a selezionare il formato di esportazione. Il metodo apre la presentazione di origine, determina il formato necessario dal percorso di output e scrive il risultato.

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");

aspose.slides.Convert.autoByExtension("input.pptx", "output.pdf");

La classe Convert fornisce inoltre metodi dedicati per l’output PDF, SVG, JPEG, PNG e TIFF. Utilizza l’intero object model quando è necessario ispezionare o modificare la presentazione prima dell’esportazione o configurare un’opzione di esportazione non esposta dall’helper selezionato. Vedi Convert Presentation per flussi di lavoro e opzioni specifiche per formato.

Unire presentazioni

Utilizza Merger.process per combinare file di presentazione completi con una sola chiamata. Le presentazioni di input devono avere lo stesso formato di file.

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");

const inputFiles = ["first.pptx", "second.pptx"];
aspose.slides.Merger.process(inputFiles, "merged.pptx");

L’helper è appropriato quando tutte le diapositive devono essere aggiunte a un unico risultato senza selezionarle o rimapparle individualmente. Usa l’intero object model quando devi unire diapositive selezionate, applicare un master o layout di destinazione, preservare sezioni in modo esplicito o riconciliare dimensioni di diapositiva diverse. Vedi Merge Presentations per tali scenari.

Iterare attraverso gli elementi della presentazione

La classe ForEach invoca una callback per ogni tipo richiesto di elemento della presentazione. Evita i cicli di raccolta nidificati ed è comoda per ispezioni o modifiche di formattazione a livello di presentazione. In Node.js, crea implementazioni delle interfacce di callback con java.newProxy.

L’esempio seguente utilizza ForEach.slide, ForEach.shape, ForEach.paragraph e ForEach.portion per ispezionare gli elementi corrispondenti:

const java = require("java");
var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");

const presentation = new aspose.slides.Presentation("input.pptx");
try {
    const slideCallback = java.newProxy("com.aspose.slides.ForEach$ForEachSlideCallback", {
        invoke: function (slide, index) {
            console.log(`Slide ${index}: ${slide.getShapes().size()} shapes`);
        }
    });
    aspose.slides.ForEach.slide(presentation, slideCallback);

    const shapeCallback = java.newProxy("com.aspose.slides.ForEach$ForEachShapeCallback", {
        invoke: function (shape, slide, index) {
            console.log(`Shape ${index} on ${slide.getClass().getSimpleName()}: ${shape.getName()}`);
        }
    });
    aspose.slides.ForEach.shape(presentation, shapeCallback);

    const paragraphCallback = java.newProxy("com.aspose.slides.ForEach$ForEachParagraphCallback", {
        invoke: function (paragraph, slide, index) {
            console.log(`Paragraph ${index} on ${slide.getClass().getSimpleName()}: ${paragraph.getText()}`);
        }
    });
    aspose.slides.ForEach.paragraph(presentation, paragraphCallback);

    const portionCallback = java.newProxy("com.aspose.slides.ForEach$ForEachPortionCallback", {
        invoke: function (portion, paragraph, slide, index) {
            console.log(`Portion ${index} on ${slide.getClass().getSimpleName()}: ${portion.getText()}`);
        }
    });
    aspose.slides.ForEach.portion(presentation, portionCallback);
} finally {
    presentation.dispose();
}

Per impostazione predefinita, la traversata di forme e testo a livello di presentazione include diapositive normali, master e layout. Le overload con un parametro includeNotes possono inoltre elaborare le diapositive delle note. Usa cicli di raccolta diretti quando l’ordine di traversata, l’uscita anticipata, il filtraggio prima della chiamata della callback o il controllo dettagliato genitore‑figlio sono importanti.

Raccogliere forme

Usa Collect.shapes quando ti serve una collezione di tutte le forme in una presentazione anziché una callback per ogni forma. È utile quando lo stesso insieme sarà filtrato, contato o elaborato più volte.

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");

const presentation = new aspose.slides.Presentation("input.pptx");
try {
    const shapes = aspose.slides.Collect.shapes(presentation);
    const iterator = shapes.iterator();

    while (iterator.hasNext()) {
        const shape = iterator.next();
        console.log(`${shape.getName()}: ${shape.getClass().getSimpleName()}`);
    }
} finally {
    presentation.dispose();
}

Utilizza ForEach.shape invece quando ogni forma può essere gestita immediatamente e non è necessario conservare il risultato raccolto.

Comprimere il contenuto della presentazione

La classe Compress può rimuovere elementi strutturali inutilizzati e ridurre i dati dei font incorporati:

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");

const presentation = new aspose.slides.Presentation("input.pptx");
try {
    aspose.slides.Compress.removeUnusedLayoutSlides(presentation);
    aspose.slides.Compress.removeUnusedMasterSlides(presentation);
    aspose.slides.Compress.compressEmbeddedFonts(presentation);

    presentation.save("compressed.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Rimuovi prima i layout inutilizzati e poi i master inutilizzati, così un master che diventa non referenziato dopo la pulizia dei layout può essere rimosso anch’esso. Salva la presentazione ottimizzata in un nuovo file se potresti aver bisogno in seguito dei master, dei layout o dei dati completi dei font incorporati originali. Per maggiori dettagli, vedi Slide Master e Embedded Font.

FAQ

Quando dovrei usare l’API low‑code invece dell’intero object model?

Usa gli helper low‑code quando un’operazione standard si applica a un file o a una presentazione completa e non richiede un controllo dettagliato sui singoli elementi. Usa l’intero object model quando devi selezionare diapositive specifiche, controllare le relazioni tra master e layout, ispezionare lo stato intermedio o configurare comportamenti che l’helper non espone.

Il Merger può combinare presentazioni in formati di file diversi?

No. Merger.process richiede che le presentazioni di input siano nello stesso formato. Converte prima i file di input in un formato comune, ad esempio con Convert.autoByExtension, e poi unisci i file convertiti.

ForEach elabora master, layout e diapositive delle note?

ForEach.slide itera le diapositive di presentazione normali. Le operazioni a livello di presentazione di ForEach.shape, ForEach.paragraph e ForEach.portion includono diapositive normali, master e layout per impostazione predefinita. Usa le loro overload con includeNotes impostato a true per includere le diapositive delle note.

Qual è la differenza tra ForEach.shape e Collect.shapes?

Usa ForEach.shape per elaborare ogni forma immediatamente tramite una callback. Usa Collect.shapes quando ti serve un risultato iterabile che può essere conservato, filtrato, contato o attraversato più volte.

Compress rende sempre il file della presentazione più piccolo?

Non necessariamente. Il risultato dipende dal fatto che la presentazione contenga layout inutilizzati, master inutilizzati o font incorporati con caratteri inutilizzati. Se nessuno di questi elementi è presente, le relative operazioni di Compress potrebbero non ridurre la dimensione del file.

Le modifiche apportate da ForEach o Compress vengono salvate automaticamente?

No. Questi helper operano sull’oggetto Presentation caricato in memoria. Dopo aver modificato gli elementi in una callback di ForEach o aver eseguito Compress, chiama Presentation.save per scrivere il risultato.

Articoli correlati

Unire presentazioni in modo efficiente con JavaScript Importa presentazioni da PDF o HTML in JavaScript