Operaciones de presentación de bajo código en JavaScript

Descripción general

El espacio de nombres aspose.slides proporciona clases auxiliares estáticas para operaciones comunes de presentaciones. Estas ayudas envuelven flujos de trabajo del modelo de objetos que se usan con frecuencia en métodos concretos, de modo que puedes convertir o fusionar archivos, procesar elementos de la presentación, recopilar formas y eliminar contenido no utilizado con menos código.

Los ayudantes de bajo código son más útiles cuando la operación se aplica a todo el archivo o presentación y el flujo de trabajo predeterminado coincide con tus requisitos. Utiliza el modelo de objetos completo de Aspose.Slides object model cuando necesites un control granular sobre diapositivas individuales, maestros, diseños, formas, configuraciones de exportación o relaciones entre los elementos de la presentación.

La siguiente tabla resume los ayudantes disponibles:

Asistente Para qué se usa
Convert Convertir una presentación a otro formato con una llamada directa de archivo a archivo.
Merger Combinar archivos de presentación completos del mismo formato.
ForEach Ejecutar una acción para cada diapositiva, forma, párrafo o porción de texto.
Collect Obtener formas de toda la presentación para procesamiento o análisis repetidos.
Compress Eliminar maestros y diseños no utilizados y reducir los datos de fuentes incrustadas.

Convertir una presentación

Utiliza Convert.autoByExtension cuando la extensión del archivo de salida es suficiente para seleccionar el formato de exportación. El método abre la presentación origen, determina el formato requerido a partir de la ruta de salida y escribe el resultado.

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

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

La clase Convert también proporciona métodos dedicados para salida en PDF, SVG, JPEG, PNG y TIFF. Utiliza el modelo de objetos completo cuando necesites inspeccionar o modificar la presentación antes de la exportación o configurar una opción de exportación que no está expuesta por el asistente seleccionado. Consulta Convertir presentación para flujos de trabajo y opciones específicas de formato.

Fusionar presentaciones

Utiliza Merger.process para combinar archivos de presentación completos con una sola llamada. Las presentaciones de entrada deben tener el mismo formato de archivo.

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

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

El asistente es apropiado cuando todas las diapositivas deben añadirse a un único resultado sin seleccionarlas o remapearlas individualmente. Utiliza el modelo de objetos completo cuando necesites fusionar diapositivas seleccionadas, aplicar un maestro o diseño de destino, conservar secciones explícitamente o conciliar tamaños de diapositiva diferentes. Consulta Fusionar presentaciones para esos escenarios.

Iterar a través de los elementos de la presentación

La clase ForEach invoca una devolución de llamada para cada tipo solicitado de elemento de la presentación. Evita bucles de colección anidados y es conveniente para inspecciones o cambios de formato a nivel de toda la presentación. En Node.js, crea implementaciones de las interfaces de devolución de llamada con java.newProxy.

El siguiente ejemplo usa ForEach.slide, ForEach.shape, ForEach.paragraph y ForEach.portion para inspeccionar los elementos correspondientes:

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

Por defecto, el recorrido de formas y texto a nivel de presentación incluye diapositivas normales, maestras y de diseño. Las sobrecargas con un parámetro includeNotes también pueden procesar diapositivas de notas. Usa bucles de colección directos cuando el orden de recorrido, la salida anticipada, el filtrado antes de la invocación de la devolución de llamada o el control detallado padre‑hijo sean importantes.

Recopilar formas

Utiliza Collect.shapes cuando necesites una colección de todas las formas en una presentación en lugar de una devolución de llamada para cada forma. Esto es útil cuando el mismo conjunto será filtrado, contado o procesado más de una vez.

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

Usa ForEach.shape en su lugar cuando cada forma pueda manejarse inmediatamente y no necesites retener el resultado recopilado.

Comprimir contenido de la presentación

La clase Compress puede eliminar elementos estructurales no utilizados y reducir los datos de fuentes incrustadas:

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

Elimina los diseños no utilizados antes que los maestros no utilizados, de modo que un maestro que quede sin referencias tras la limpieza de diseños también pueda eliminarse. Guarda la presentación optimizada en un nuevo archivo si puedes necesitar más adelante los maestros, diseños o los datos completos de fuentes incrustadas originales. Para más detalle, consulta Slide Master y Embedded Font.

Preguntas frecuentes

¿Cuándo debo usar la API de bajo código en lugar del modelo de objetos completo?

Utiliza los ayudantes de bajo código cuando una operación estándar se aplica a un archivo o presentación completa y no requiere un control detallado sobre elementos individuales. Usa el modelo de objetos completo cuando necesites seleccionar diapositivas específicas, controlar relaciones de maestros y diseños, inspeccionar el estado intermedio o configurar un comportamiento que el asistente no expone.

¿Puede Merger combinar presentaciones en diferentes formatos de archivo?

No. Merger.process requiere que las presentaciones de entrada tengan el mismo formato. Convierte primero los archivos de entrada a un formato común, por ejemplo con Convert.autoByExtension, y luego fusiona los archivos convertidos.

¿Procesa ForEach diapositivas maestras, de diseño y de notas?

ForEach.slide recorre las diapositivas normales de la presentación. Las operaciones a nivel de presentación de ForEach.shape, ForEach.paragraph y ForEach.portion incluyen por defecto diapositivas normales, maestras y de diseño. Usa sus sobrecargas con includeNotes establecido en true para incluir diapositivas de notas.

¿Cuál es la diferencia entre ForEach.shape y Collect.shapes?

Usa ForEach.shape para procesar cada forma inmediatamente mediante una devolución de llamada. Usa Collect.shapes cuando necesites un resultado iterable que pueda conservarse, filtrarse, contarse o recorrerse varias veces.

¿Compress siempre reduce el tamaño del archivo de la presentación?

No necesariamente. El resultado depende de si la presentación contiene diseños no utilizados, maestros no utilizados o fuentes incrustadas con caracteres no usados. Si ninguno de esos elementos está presente, las operaciones correspondientes de Compress pueden no reducir el tamaño del archivo.

¿Los cambios realizados por ForEach o Compress se guardan automáticamente?

No. Estos ayudantes operan sobre el objeto Presentation cargado en memoria. Después de modificar elementos en una devolución de llamada de ForEach o ejecutar Compress, llama a Presentation.save para escribir el resultado.

Artículos relacionados

Propiedades de presentación