Aplicar o Cambiar un Diseño de Diapositiva en JavaScript

Visión general

Un diseño de diapositiva define la disposición de los cuadros de marcador de posición y el formato del contenido en una diapositiva. Controla qué marcadores de posición están disponibles y dónde aparecen. Los diseños de diapositiva le ayudan a crear presentaciones de forma rápida y coherente, ya sea que esté creando algo simple o más complejo. Algunos de los diseños de diapositiva más comunes en PowerPoint incluyen:

Diseño de diapositiva de título – Incluye dos marcadores de posición de texto: uno para el título y otro para el subtítulo.

Diseño de título y contenido – Presenta un marcador de posición de título más pequeño en la parte superior y uno más grande debajo para el contenido principal (como texto, viñetas, gráficos, imágenes y más).

Diseño en blanco – No contiene marcadores de posición, lo que le brinda control total para diseñar la diapositiva desde cero.

Los diseños de diapositiva forman parte de una diapositiva maestra, que es la diapositiva de nivel superior que define los estilos de diseño para la presentación. Puede acceder y modificar los diseños de diapositiva a través de la diapositiva maestra, ya sea por su tipo, nombre o ID único. Alternativamente, puede editar un diseño de diapositiva específico directamente dentro de la presentación.

Para trabajar con diseños de diapositiva en Aspose.Slides for Node.js, puede usar:

Métodos como getLayoutSlides y getMasters bajo la clase Presentation
Tipos como LayoutSlide, MasterLayoutSlideCollection, LayoutPlaceholderManager y LayoutSlideHeaderFooterManager

Info

Para obtener más información sobre el trabajo con diapositivas maestras, consulte el artículo Slide Master.

Agregar diseños de diapositiva a presentaciones

Para personalizar la apariencia y estructura de sus diapositivas, puede que necesite agregar nuevos diseños de diapositiva a una presentación. Aspose.Slides for Node.js le permite verificar si un diseño específico ya existe, agregar uno nuevo si es necesario y usarlo para insertar diapositivas basadas en ese diseño.

Cree una instancia de la clase Presentation.
Acceda a la MasterLayoutSlideCollection.
Verifique si el diseño de diapositiva deseado ya existe en la colección. Si no, añada el diseño de diapositiva que necesita.
Añada una diapositiva en blanco basada en el nuevo diseño de diapositiva.
Guarde la presentación.

El siguiente código JavaScript muestra cómo agregar un diseño de diapositiva a una presentación de PowerPoint:

// Instanciar la clase Presentation que representa un archivo PowerPoint.
let presentation = new aspose.slides.Presentation("Sample.pptx");
try {
    // Recorrer los tipos de diapositivas de diseño para seleccionar una diapositiva de diseño.
    let layoutSlides = presentation.getMasters().get_Item(0).getLayoutSlides();
    let layoutSlide = null;
    if (layoutSlides.getByType(java.newByte(aspose.slides.SlideLayoutType.TitleAndObject)) != null) {
        layoutSlide = layoutSlides.getByType(java.newByte(aspose.slides.SlideLayoutType.TitleAndObject));
    } else {
        layoutSlide = layoutSlides.getByType(java.newByte(aspose.slides.SlideLayoutType.Title));
    }

    if (layoutSlide == null) {
        // Situación en la que la presentación no contiene todos los tipos de diseño.
        // El archivo de presentación contiene solo los tipos de diseño Blank y Custom.
        // Sin embargo, las diapositivas de diseño con tipos personalizados pueden tener nombres reconocibles,
        // como "Title", "Title and Content", etc., que pueden usarse para la selección de diapositivas de diseño.
        // También puedes basarte en un conjunto de tipos de forma de marcador de posición.
        // Por ejemplo, una diapositiva Title debería tener solo el tipo de marcador de posición Title, y así sucesivamente.
        for (let i = 0; i < layoutSlides.size(); i++) {
            let titleAndObjectLayoutSlide = layoutSlides.get_Item(i);
            if (titleAndObjectLayoutSlide.getName() === "Title and Object") {
                layoutSlide = titleAndObjectLayoutSlide;
                break;
            }
        }

        if (layoutSlide == null) {
            for (let i = 0; i < layoutSlides.size(); i++) {
                let titleLayoutSlide = layoutSlides.get_Item(i);
                if (titleLayoutSlide.getName() === "Title") {
                    layoutSlide = titleLayoutSlide;
                    break;
                }
            }

            if (layoutSlide == null) {
                layoutSlide = layoutSlides.getByType(java.newByte(aspose.slides.SlideLayoutType.Blank));
                if (layoutSlide == null) {
                    layoutSlide = layoutSlides.add(java.newByte(aspose.slides.SlideLayoutType.TitleAndObject), "Title and Object");
                }
            }
        }
    }

    // Añadir una diapositiva vacía usando la diapositiva de diseño añadida.
    presentation.getSlides().insertEmptySlide(0, layoutSlide);

    // Guardar la presentación en disco.
    presentation.save("output.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Eliminar diseños de diapositiva no utilizados

Aspose.Slides proporciona el método removeUnusedLayoutSlides de la clase Compress para permitirle eliminar diseños de diapositiva no deseados y sin usar.

El siguiente código JavaScript muestra cómo eliminar un diseño de diapositiva de una presentación de PowerPoint:

let presentation = new aspose.slides.Presentation("Presentation.pptx");
try {
    aspose.slides.Compress.removeUnusedLayoutSlides(presentation);
    presentation.save("Output.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Agregar marcadores de posición a los diseños de diapositiva

Aspose.Slides proporciona el método LayoutSlide.getPlaceholderManager, que le permite agregar nuevos marcadores de posición a un diseño de diapositiva.

Este gestor contiene métodos para los siguientes tipos de marcadores de posición:

Marcador de posición de PowerPoint	Método LayoutPlaceholderManager
	addContentPlaceholder(float x, float y, float width, float height)
	addVerticalContentPlaceholder(float x, float y, float width, float height)
	addTextPlaceholder(float x, float y, float width, float height)
	addVerticalTextPlaceholder(float x, float y, float width, float height)
	addPicturePlaceholder(float x, float y, float width, float height)
	addChartPlaceholder(float x, float y, float width, float height)
	addTablePlaceholder(float x, float y, float width, float height)
	addSmartArtPlaceholder(float x, float y, float width, float height)
	addMediaPlaceholder(float x, float y, float width, float height)
	addOnlineImagePlaceholder(float x, float y, float width, float height)

El siguiente código JavaScript muestra cómo agregar nuevas formas de marcador de posición al diseño en blanco:

let presentation = new aspose.slides.Presentation();
try {
    // Obtener la diapositiva de diseño en blanco.
    let layout = presentation.getLayoutSlides().getByType(java.newByte(aspose.slides.SlideLayoutType.Blank));

    // Obtener el gestor de marcadores de posición de la diapositiva de diseño.
    let placeholderManager = layout.getPlaceholderManager();

    // Agregar diferentes marcadores de posición a la diapositiva de diseño en blanco.
    placeholderManager.addContentPlaceholder(20, 20, 310, 270);
    placeholderManager.addVerticalTextPlaceholder(350, 20, 350, 270);
    placeholderManager.addChartPlaceholder(20, 310, 310, 180);
    placeholderManager.addTablePlaceholder(350, 310, 350, 180);

    // Agregar una nueva diapositiva con el diseño en blanco.
    let newSlide = presentation.getSlides().addEmptySlide(layout);

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

El resultado:

Los marcadores de posición en el diseño de diapositiva

Establecer visibilidad del pie de página para un diseño de diapositiva

En presentaciones de PowerPoint, los elementos de pie de página como la fecha, el número de diapositiva y el texto personalizado pueden mostrarse u ocultarse según el diseño de la diapositiva. Aspose.Slides for Node.js le permite controlar la visibilidad de estos marcadores de posición de pie de página. Esto es útil cuando desea que ciertos diseños muestren información de pie de página mientras que otros permanezcan limpios y mínimos.

Cree una instancia de la clase Presentation.
Obtenga una referencia a un diseño de diapositiva por su índice.
Establezca el marcador de posición del pie de página de la diapositiva como visible.
Establezca el marcador de posición del número de diapositiva como visible.
Establezca el marcador de posición de fecha y hora como visible.
Guarde la presentación.

El siguiente código JavaScript muestra cómo establecer la visibilidad del pie de página de una diapositiva y realizar tareas relacionadas:

let presentation = new aspose.slides.Presentation("Presentation.ppt");
try {
    let headerFooterManager = presentation.getLayoutSlides().get_Item(0).getHeaderFooterManager();

    if (!headerFooterManager.isFooterVisible()) {
        headerFooterManager.setFooterVisibility(true);
    }

    if (!headerFooterManager.isSlideNumberVisible()) {
        headerFooterManager.setSlideNumberVisibility(true);
    }

    if (!headerFooterManager.isDateTimeVisible()) {
        headerFooterManager.setDateTimeVisibility(true);
    }

    headerFooterManager.setFooterText("Footer text");
    headerFooterManager.setDateTimeText("Date and time text");

    presentation.save("Presentation.ppt", aspose.slides.SaveFormat.Ppt);
} finally {
    presentation.dispose();
}

Establecer visibilidad del pie de página secundario para una diapositiva

En presentaciones de PowerPoint, los elementos de pie de página como la fecha, el número de diapositiva y el texto personalizado pueden controlarse a nivel de la diapositiva maestra para garantizar la consistencia en todos los diseños de diapositiva. Aspose.Slides for Node.js le permite establecer la visibilidad y el contenido de estos marcadores de posición de pie de página en la diapositiva maestra y propagar estos ajustes a todos los diseños de diapositiva secundarios. Este enfoque garantiza información de pie de página uniforme en toda su presentación.

Cree una instancia de la clase Presentation.
Obtenga una referencia a la diapositiva maestra por su índice.
Establezca los marcadores de posición del pie de página de la maestra y de todos los diseños secundarios como visibles.
Establezca los marcadores de posición del número de diapositiva de la maestra y de todos los diseños secundarios como visibles.
Establezca los marcadores de posición de fecha y hora de la maestra y de todos los diseños secundarios como visibles.
Guarde la presentación.

El siguiente código JavaScript demuestra esta operación:

let presentation = new aspose.slides.Presentation("Presentation.ppt");
try {
    let headerFooterManager = presentation.getMasters().get_Item(0).getHeaderFooterManager();

    headerFooterManager.setFooterAndChildFootersVisibility(true);
    headerFooterManager.setSlideNumberAndChildSlideNumbersVisibility(true);
    headerFooterManager.setDateTimeAndChildDateTimesVisibility(true);

    headerFooterManager.setFooterAndChildFootersText("Footer text");
    headerFooterManager.setDateTimeAndChildDateTimesText("Date and time text");

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

Preguntas frecuentes

¿Cuál es la diferencia entre una diapositiva maestra y un diseño de diapositiva?

Una diapositiva maestra define el tema general y el formato predeterminado, mientras que los diseños de diapositiva definen disposiciones específicas de marcadores de posición para diferentes tipos de contenido.

¿Puedo copiar un diseño de diapositiva de una presentación a otra?

Sí, puede clonar un diseño de diapositiva de la colección de diseños de diapositiva de una presentación, accesible mediante el método getLayoutSlides, e insertarlo en otra presentación usando el método addClone.

¿Qué ocurre si elimino un diseño de diapositiva que todavía es utilizado por una diapositiva?

Si intenta eliminar un diseño de diapositiva que aún está referenciado por al menos una diapositiva en la presentación, Aspose.Slides lanzará una PptxEditException. Para evitarlo, use removeUnusedLayoutSlides, que elimina de forma segura solo los diseños de diapositiva que no están en uso.

Visor de presentaciones Propiedades de presentación