JavaScript에서 슬라이드 레이아웃 적용 또는 변경

소개

슬라이드 레이아웃은 슬라이드에 있는 콘텐츠의 자리 표시자 박스 배치와 서식을 정의합니다. 사용 가능한 자리 표시자와 그 위치를 제어합니다. 슬라이드 레이아웃을 사용하면 간단한 프레젠테이션이든 복잡한 프레젠테이션이든 빠르고 일관되게 디자인할 수 있습니다. PowerPoint에서 가장 일반적인 슬라이드 레이아웃은 다음과 같습니다:

제목 슬라이드 레이아웃 – 제목과 부제목을 위한 두 개의 텍스트 자리 표시자를 포함합니다.

제목 및 내용 레이아웃 – 상단에 작은 제목 자리 표시자가 있고, 아래에 텍스트, 글머리표, 차트, 이미지 등 다양한 주요 콘텐츠용 큰 자리 표시자가 있습니다.

빈 레이아웃 – 자리 표시자가 전혀 없으며, 처음부터 슬라이드를 설계할 수 있는 완전한 제어를 제공합니다.

슬라이드 레이아웃은 슬라이드 마스터의 일부이며, 슬라이드 마스터는 프레젠테이션의 레이아웃 스타일을 정의하는 최상위 슬라이드입니다. 슬라이드 마스터를 통해 레이아웃 슬라이드에 접근하고 수정할 수 있습니다—유형, 이름 또는 고유 ID로 찾을 수 있습니다. 또는 프레젠테이션 내부에서 특정 레이아웃 슬라이드를 직접 편집할 수도 있습니다.

Aspose.Slides for Node.js에서 슬라이드 레이아웃을 작업하려면 다음을 사용할 수 있습니다:

예를 들어 Presentation 클래스 아래의 getLayoutSlides 및 getMasters 메서드
LayoutSlide, MasterLayoutSlideCollection, LayoutPlaceholderManager, 및 LayoutSlideHeaderFooterManager와 같은 타입

Info

마스터 슬라이드 작업에 대해 자세히 알아보려면 Slide Master 문서를 확인하세요.

프레젠테이션에 슬라이드 레이아웃 추가

슬라이드의 모양과 구조를 사용자 지정하려면 프레젠테이션에 새로운 레이아웃 슬라이드를 추가해야 할 수 있습니다. Aspose.Slides for Node.js를 사용하면 특정 레이아웃이 이미 존재하는지 확인하고, 필요한 경우 새 레이아웃을 추가한 다음 해당 레이아웃을 기반으로 슬라이드를 삽입할 수 있습니다.

Presentation 클래스의 인스턴스를 생성합니다.
MasterLayoutSlideCollection에 접근합니다.
원하는 레이아웃 슬라이드가 컬렉션에 이미 존재하는지 확인합니다. 존재하지 않으면 필요한 레이아웃 슬라이드를 추가합니다.
새 레이아웃 슬라이드를 기반으로 빈 슬라이드를 추가합니다.
프레젠테이션을 저장합니다.

다음 JavaScript 코드는 PowerPoint 프레젠테이션에 슬라이드 레이아웃을 추가하는 방법을 보여줍니다:

// PowerPoint 파일을 나타내는 Presentation 클래스를 인스턴스화합니다.
let presentation = new aspose.slides.Presentation("Sample.pptx");
try {
    // 레이아웃 슬라이드 유형을 순회하여 레이아웃 슬라이드를 선택합니다.
    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) {
        // 프레젠테이션에 모든 레이아웃 유형이 포함되지 않은 상황입니다.
        // 프레젠테이션 파일에는 빈 레이아웃과 사용자 정의 레이아웃 유형만 포함됩니다.
        // 하지만 사용자 정의 유형의 레이아웃 슬라이드에는 인식 가능한 이름이 있을 수 있습니다,
        // "Title", "Title and Content" 등과 같이 레이아웃 슬라이드 선택에 사용할 수 있습니다.
        // 또한 자리 표시자 도형 유형 집합에 의존할 수 있습니다.
        // 예를 들어, 제목 슬라이드에는 제목 자리 표시자 유형만 있어야 합니다.
        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");
                }
            }
        }
    }

    // 추가된 레이아웃 슬라이드를 사용하여 빈 슬라이드를 추가합니다.
    presentation.getSlides().insertEmptySlide(0, layoutSlide);

    // 프레젠테이션을 디스크에 저장합니다.
    presentation.save("output.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

사용되지 않는 레이아웃 슬라이드 제거

Aspose.Slides는 Compress 클래스의 removeUnusedLayoutSlides 메서드를 제공하여 원하지 않거나 사용되지 않는 레이아웃 슬라이드를 삭제할 수 있게 합니다.

다음 JavaScript 코드는 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();
}

슬라이드 레이아웃에 자리 표시자 추가

Aspose.Slides는 LayoutSlide.getPlaceholderManager 메서드를 제공하여 레이아웃 슬라이드에 새로운 자리 표시자를 추가할 수 있게 합니다.

이 관리자는 다음과 같은 자리 표시자 유형에 대한 메서드를 포함합니다:

PowerPoint 자리 표시자	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)

다음 JavaScript 코드는 빈 레이아웃 슬라이드에 새로운 자리 표시자 모양을 추가하는 방법을 보여줍니다:

let presentation = new aspose.slides.Presentation();
try {
    // 빈 레이아웃 슬라이드를 가져옵니다.
    let layout = presentation.getLayoutSlides().getByType(java.newByte(aspose.slides.SlideLayoutType.Blank));

    // 레이아웃 슬라이드의 자리 표시자 관리자를 가져옵니다.
    let placeholderManager = layout.getPlaceholderManager();

    // 빈 레이아웃 슬라이드에 다양한 자리 표시자를 추가합니다.
    placeholderManager.addContentPlaceholder(20, 20, 310, 270);
    placeholderManager.addVerticalTextPlaceholder(350, 20, 350, 270);
    placeholderManager.addChartPlaceholder(20, 310, 310, 180);
    placeholderManager.addTablePlaceholder(350, 310, 350, 180);

    // 빈 레이아웃으로 새 슬라이드를 추가합니다.
    let newSlide = presentation.getSlides().addEmptySlide(layout);

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

결과:

레이아웃 슬라이드의 자리 표시자

레이아웃 슬라이드의 바닥글 표시 여부 설정

PowerPoint 프레젠테이션에서 날짜, 슬라이드 번호, 사용자 지정 텍스트와 같은 바닥글 요소는 슬라이드 레이아웃에 따라 표시하거나 숨길 수 있습니다. Aspose.Slides for Node.js를 사용하면 이러한 바닥글 자리 표시자의 표시 여부를 제어할 수 있습니다. 특정 레이아웃에서는 바닥글 정보를 표시하고, 다른 레이아웃은 깔끔하고 최소한으로 유지하려는 경우에 유용합니다.

Presentation 클래스의 인스턴스를 생성합니다.
인덱스로 레이아웃 슬라이드 참조를 가져옵니다.
슬라이드 바닥글 자리 표시자를 보이도록 설정합니다.
슬라이드 번호 자리 표시자를 보이도록 설정합니다.
날짜‑시간 자리 표시자를 보이도록 설정합니다.
프레젠테이션을 저장합니다.

다음 JavaScript 코드는 슬라이드 바닥글의 표시 여부를 설정하고 관련 작업을 수행하는 방법을 보여줍니다:

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

슬라이드의 하위 바닥글 표시 여부 설정

PowerPoint 프레젠테이션에서 날짜, 슬라이드 번호, 사용자 지정 텍스트와 같은 바닥글 요소는 마스터 슬라이드 수준에서 제어하여 모든 레이아웃 슬라이드에 일관성을 유지할 수 있습니다. Aspose.Slides for Node.js를 사용하면 마스터 슬라이드에서 이러한 바닥글 자리 표시자의 표시 여부와 내용을 설정하고 해당 설정을 모든 하위 레이아웃 슬라이드에 전파할 수 있습니다. 이 방법을 통해 프레젠테이션 전체에 통일된 바닥글 정보를 제공할 수 있습니다.

Presentation 클래스의 인스턴스를 생성합니다.
인덱스로 마스터 슬라이드에 대한 참조를 가져옵니다.
마스터와 모든 하위 바닥글 자리 표시자를 보이도록 설정합니다.
마스터와 모든 하위 슬라이드 번호 자리 표시자를 보이도록 설정합니다.
마스터와 모든 하위 날짜‑시간 자리 표시자를 보이도록 설정합니다.
프레젠테이션을 저장합니다.

다음 JavaScript 코드는 이 작업을 수행하는 방법을 보여줍니다:

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

FAQ

마스터 슬라이드와 레이아웃 슬라이드의 차이점은 무엇인가요?

마스터 슬라이드는 전체 테마와 기본 서식을 정의하고, 레이아웃 슬라이드는 다양한 콘텐츠 종류에 대한 특정 자리 표시자 배치를 정의합니다.

한 프레젠테이션에서 다른 프레젠테이션으로 레이아웃 슬라이드를 복사할 수 있나요?

예, getLayoutSlides 메서드로 접근 가능한 레이아웃 슬라이드 컬렉션에서 레이아웃 슬라이드를 복제한 뒤 addClone 메서드를 사용해 다른 프레젠테이션에 삽입할 수 있습니다.

여전히 슬라이드에서 사용 중인 레이아웃 슬라이드를 삭제하면 어떻게 되나요?

프레젠테이션에 최소 하나의 슬라이드가 해당 레이아웃을 참조하고 있는 상태에서 레이아웃 슬라이드를 삭제하려고 하면 Aspose.Slides는 PptxEditException을 발생시킵니다. 이를 방지하려면 사용되지 않은 레이아웃 슬라이드만 안전하게 제거하는 removeUnusedLayoutSlides를 사용하세요.

JavaScript에서 프레젠테이션 슬라이드 비교 JavaScript에서 프레젠테이션 슬라이드 마스터 관리