Operace prezentace s nízkým kódem v JavaScriptu

Přehled

Namespace aspose.slides poskytuje statické pomocné třídy pro běžné operace s prezentacemi. Tyto pomocníky zapouzdřují často používané pracovní postupy objektového modelu do cílených metod, takže můžete převádět nebo slučovat soubory, zpracovávat prvky prezentace, sbírat tvary a odstraňovat nepoužitý obsah s méně kódem.

Pomocníky s nízkým kódem jsou nejužitečnější, když se operace vztahuje na celý soubor nebo prezentaci a výchozí pracovní postup vyhovuje vašim požadavkům. Použijte úplný Aspose.Slides object model, pokud potřebujete detailní kontrolu nad jednotlivými snímky, mastery, rozvrženími, tvary, nastaveními exportu nebo vztahy mezi prvky prezentace.

Následující tabulka shrnuje dostupné pomocníky:

Pomocník K čemu
Convert Převádění prezentace do jiného formátu pomocí přímého volání soubor na soubor.
Merger Kombinování kompletních souborů prezentací ve stejném formátu.
ForEach Spouštění akce pro každý snímek, tvar, odstavec nebo část textu.
Collect Načtení tvarů z celé prezentace pro opakované zpracování nebo analýzu.
Compress Odstranění nepoužitých masterů a rozvržení a snížení vložených dat fontů.

Převod prezentace

Použijte Convert.autoByExtension, když je přípona výstupního souboru dostačující pro výběr formátu exportu. Metoda otevře zdrojovou prezentaci, určí požadovaný formát z výstupní cesty a zapíše výsledek.

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

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

Třída Convert také poskytuje dedikované metody pro výstup do PDF, SVG, JPEG, PNG a TIFF. Použijte úplný objektový model, pokud potřebujete před exportem prozkoumat nebo upravit prezentaci nebo nakonfigurovat volbu exportu, která není vybraným pomocníkem zpřístupněna. Viz Convert Presentation pro pracovní postupy a možnosti specifické pro formát.

Sloučení prezentací

Použijte Merger.process pro kombinaci kompletních souborů prezentací jedním voláním. Vstupní prezentace musí mít stejný formát souboru.

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

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

Tento pomocník je vhodný, když mají být všechny snímky připojeny do jednoho výsledku bez individuálního výběru nebo přemapování. Použijte úplný objektový model, pokud potřebujete sloučit vybrané snímky, použít cílový master nebo rozvržení, explicitně zachovat sekce nebo sladit různé velikosti snímků. Viz Merge Presentations pro tyto scénáře.

Iterace přes prvky prezentace

Třída ForEach volá zpětnou funkci pro každý požadovaný typ prvku prezentace. Vyhýbá se vnořeným smyčkám kolekcí a je vhodná pro prohlížení nebo změny formátování v celé prezentaci. V Node.js vytvořte implementace rozhraní zpětné funkce pomocí java.newProxy.

Následující příklad používá ForEach.slide, ForEach.shape, ForEach.paragraph a ForEach.portion k prozkoumání odpovídajících prvků:

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

Ve výchozím nastavení procházení tvarů a textu v celé prezentaci zahrnuje normální, master a layout snímky. Přetížení s parametrem includeNotes mohou také zpracovávat snímky s poznámkami. Použijte přímé smyčky kolekcí, když je důležitý pořadí procházení, předčasný výstup, filtrování před voláním zpětné funkce nebo podrobná kontrola nad rodičovským a potomkovým vztahem.

Sbírání tvarů

Použijte Collect.shapes, pokud potřebujete kolekci všech tvarů v prezentaci místo zpětné funkce pro každý tvar. To je užitečné, když bude stejná množina filtrována, počítána nebo zpracovávána vícekrát.

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

Použijte místo toho ForEach.shape, když může být každý tvar zpracován okamžitě a není potřeba uchovávat získaný výsledek.

Komprese obsahu prezentace

Třída Compress může odstranit nepoužité strukturační prvky a snížit vložená data fontů:

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

Odstraňte nepoužité rozvržení před nepoužitými mastery, aby master, který se po úklidu rozvržení stane nepoužívaným, mohl být také odstraněn. Uložte optimalizovanou prezentaci do nového souboru, pokud později budete potřebovat původní mastery, rozvržení nebo kompletní vložená data fontů. Pro podrobnější informace viz Slide Master a Embedded Font.

FAQ

Kdy bych měl použít API s nízkým kódem místo úplného objektového modelu?

Používejte pomocníky s nízkým kódem, když se standardní operace vztahuje na celý soubor nebo prezentaci a nevyžaduje detailní kontrolu nad jednotlivými prvky. Použijte úplný objektový model, pokud potřebujete vybrat konkrétní snímky, řídit vztahy mezi mastery a rozvržením, prozkoumat mezistav nebo nakonfigurovat chování, které pomocník neumožňuje.

Může Merger kombinovat prezentace v různých formátech souborů?

Ne. Merger.process vyžaduje vstupní prezentace ve stejném formátu. Nejprve převěďte vstupní soubory do společného formátu, například pomocí Convert.autoByExtension, a poté sloučte převedené soubory.

Zpracovává ForEach master, layout a poznámkové snímky?

ForEach.slide prochází normální snímky prezentace. Operace ForEach.shape, ForEach.paragraph a ForEach.portion na úrovni celé prezentace zahrnují normální, master a layout snímky ve výchozím nastavení. Použijte jejich přetížení s includeNotes nastaveným na true, abyste zahrnuli poznámkové snímky.

Jaký je rozdíl mezi ForEach.shape a Collect.shapes?

Použijte ForEach.shape k okamžitému zpracování každého tvaru pomocí zpětné funkce. Použijte Collect.shapes, když potřebujete iterovatelný výsledek, který lze uchovat, filtrovat, počítat nebo procházet vícekrát.

Zmenšuje Compress vždy soubor prezentace?

Ne nutně. Výsledek závisí na tom, zda prezentace obsahuje nepoužité rozvržení, nepoužité mastery nebo vložené fonty s nepoužitými znaky. Pokud žádné z nich nejsou přítomny, odpovídající operace Compress nemusí zmenšit velikost souboru.

Ukládají se změny provedené pomocí ForEach nebo Compress automaticky?

Ne. Tito pomocníci pracují s načteným objektem Presentation v paměti. Po změně prvků v zpětné funkci ForEach nebo po spuštění Compress zavolejte Presentation.save, aby se výsledek zapsal.

Související články

Efektivně sloučit prezentace v JavaScriptu Import prezentací z PDF nebo HTML v JavaScriptu