Gestire le transizioni delle diapositive nelle presentazioni con JavaScript
Panoramica
Le transizioni delle diapositive controllano come le diapositive appaiono durante una presentazione. Con Aspose.Slides per Node.js via Java, è possibile scegliere un effetto di transizione per ciascuna diapositiva, configurare l’avanzamento tramite clic del mouse oppure timer e regolare le opzioni specifiche di un effetto. Questo articolo utilizza esempi JavaScript per applicare transizioni, impostare durate esatte delle transizioni, gestire il timing delle diapositive e creare una transizione Morph tra due diapositive. Gli esempi mostrano anche come salvare le impostazioni in un file PPTX.
Aggiungere una transizione alla diapositiva
Per applicare una transizione, carica una presentazione con la classe Presentation e accedi alle impostazioni di transizione della diapositiva tramite getSlideShowTransition. Usa setType con un valore dell’enumerazione TransitionType, quindi salva la presentazione.
L’esempio seguente applica una transizione Circle alla prima diapositiva e una transizione Comb alla seconda. Usa un file input.pptx con almeno due diapositive.
const slides = require("aspose.slides.via.java");
const presentation = new slides.Presentation("input.pptx");
try {
if (presentation.getSlides().size() >= 2) {
presentation.getSlides().get_Item(0).getSlideShowTransition().setType(slides.TransitionType.Circle);
presentation.getSlides().get_Item(1).getSlideShowTransition().setType(slides.TransitionType.Comb);
presentation.save("slide-transitions.pptx", slides.SaveFormat.Pptx);
} else {
console.log("The input presentation must contain at least two slides.");
}
} finally {
presentation.dispose();
}
Transizione Wheel
Il metodo setSpokes di WheelTransition controlla il numero di settori radiali che rivelano la diapositiva di destinazione. Imposta il tipo di transizione della diapositiva su Wheel tramite TransitionType usando setType prima di accedere a getValue come WheelTransition.
Questo esempio crea due coppie identiche di diapositive: una diapositiva nera seguita da una diapositiva con un rettangolo dorato. Le diapositive di destinazione usano conteggi di raggi di 1 e 8, con la stessa velocità impostata tramite setSpeed e una durata esplicita di 8 000 millisecondi impostata tramite setDuration per rendere la differenza facile da osservare.
const java = require("java");
const slides = require("aspose.slides.via.java");
const presentation = new slides.Presentation();
try {
const slideWidth = presentation.getSlideSize().getSize().getWidth();
const slideHeight = presentation.getSlideSize().getSize().getHeight();
const blackSlide = presentation.getSlides().get_Item(0);
blackSlide.getShapes().clear();
blackSlide.getBackground().setType(java.newByte(slides.BackgroundType.OwnBackground));
blackSlide.getBackground().getFillFormat().setFillType(java.newByte(slides.FillType.Solid));
const black = java.newInstanceSync("java.awt.Color", 0, 0, 0);
blackSlide.getBackground().getFillFormat().getSolidFillColor().setColor(black);
const destinationSlide = presentation.getSlides().addClone(blackSlide);
const rectangle = destinationSlide.getShapes().addAutoShape(slides.ShapeType.Rectangle, 0, 0, slideWidth, slideHeight);
rectangle.getFillFormat().setFillType(java.newByte(slides.FillType.Solid));
const gold = java.newInstanceSync("java.awt.Color", 255, 215, 0);
rectangle.getFillFormat().getSolidFillColor().setColor(gold);
rectangle.getTextFrame().setText("Wheel transition");
presentation.getSlides().addClone(blackSlide);
presentation.getSlides().addClone(destinationSlide);
const spokeCounts = [1, 8];
for (let i = 0; i < spokeCounts.length; i++) {
const transition = presentation.getSlides().get_Item(i * 2 + 1).getSlideShowTransition();
transition.setType(slides.TransitionType.Wheel);
const wheelTransition = transition.getValue();
wheelTransition.setSpokes(java.newLong(spokeCounts[i]));
transition.setSpeed(slides.TransitionSpeed.Slow);
transition.setDuration(8000);
}
presentation.save("wheel-transitions.pptx", slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Apri la presentazione di output in PowerPoint ed esegui la presentazione. Avanza dalla diapositiva 1 alla diapositiva 2, poi dalla diapositiva 3 alla diapositiva 4. Nella riproduzione di PowerPoint, il conteggio dei raggi verificato di 1 rivela la diapositiva con una scansionata oraria; il conteggio verificato di 8 la rivela attraverso otto settori radiali simultaneamente. Il contenuto di destinazione e il timing della transizione sono identici, quindi la differenza è il numero di settori di rivelazione.
Aggiungere una transizione avanzata alla diapositiva
Puoi configurare per quanto tempo una diapositiva rimane sullo schermo e se un clic del mouse avanza la presentazione. I seguenti metodi controllano questo comportamento:
- setAdvanceOnClick consente allo spettatore di avanzare facendo clic col mouse.
- setAdvanceAfter abilita l’avanzamento automatico.
- setAdvanceAfterTime specifica il ritardo prima dell’avanzamento automatico, in millisecondi.
Abilita sia l’avanzamento tramite clic sia quello temporizzato per consentire allo spettatore di passare con un clic o di attendere il timer. Per usare solo il timer, passa false a setAdvanceOnClick. Il ritardo controlla quando la presentazione avanza; non imposta la durata dell’effetto di transizione visivo.
Questo esempio assegna effetti diversi alle prime tre diapositive e abilita l’avanzamento automatico dopo 3, 5 e 7 secondi, rispettivamente. Anche i clic del mouse possono avanzare queste diapositive. Usa un file input.pptx con almeno tre diapositive.
const slides = require("aspose.slides.via.java");
const presentation = new slides.Presentation("input.pptx");
try {
if (presentation.getSlides().size() >= 3) {
const firstTransition = presentation.getSlides().get_Item(0).getSlideShowTransition();
firstTransition.setType(slides.TransitionType.Circle);
firstTransition.setAdvanceOnClick(true);
firstTransition.setAdvanceAfter(true);
firstTransition.setAdvanceAfterTime(3000);
const secondTransition = presentation.getSlides().get_Item(1).getSlideShowTransition();
secondTransition.setType(slides.TransitionType.Comb);
secondTransition.setAdvanceOnClick(true);
secondTransition.setAdvanceAfter(true);
secondTransition.setAdvanceAfterTime(5000);
const thirdTransition = presentation.getSlides().get_Item(2).getSlideShowTransition();
thirdTransition.setType(slides.TransitionType.Zoom);
thirdTransition.setAdvanceOnClick(true);
thirdTransition.setAdvanceAfter(true);
thirdTransition.setAdvanceAfterTime(7000);
presentation.save("advanced-transitions.pptx", slides.SaveFormat.Pptx);
} else {
console.log("The input presentation must contain at least three slides.");
}
} finally {
presentation.dispose();
}
Per verificare se l’avanzamento temporizzato è abilitato, chiama getAdvanceAfter. Un ritardo memorizzato da solo non indica che il timer sia attivo.
Il prossimo esempio apre il file salvato sopra, segnala ogni timer abilitato e disabilita l’avanzamento automatico per le diapositive con un ritardo superiore a due secondi. Abilita i clic del mouse per quelle diapositive e salva le impostazioni aggiornate.
const slides = require("aspose.slides.via.java");
const presentation = new slides.Presentation("advanced-transitions.pptx");
try {
for (let i = 0; i < presentation.getSlides().size(); i++) {
const slide = presentation.getSlides().get_Item(i);
const transition = slide.getSlideShowTransition();
if (transition.getAdvanceAfter()) {
console.log("Slide " + slide.getSlideNumber() + ": advance after " + transition.getAdvanceAfterTime() + " ms.");
if (transition.getAdvanceAfterTime() > 2000) {
transition.setAdvanceAfter(false);
transition.setAdvanceOnClick(true);
}
}
}
presentation.save("adjusted-transitions.pptx", slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Controllare con precisione il timing della transizione
Usa setDuration per specificare la lunghezza esatta di un effetto di transizione in millisecondi. Il metodo getSlideShowTransition della diapositiva espone queste impostazioni tramite SlideShowTransition:
| Metodo | Scopo |
|---|---|
| setDuration | Imposta la durata dell’effetto di transizione stesso, in millisecondi. |
| setAdvanceAfterTime | Imposta il ritardo prima che la diapositiva avanzi automaticamente, in millisecondi. Passa true a setAdvanceAfter per attivare questo timer. |
| setSpeed | Seleziona una categoria di velocità predefinita da TransitionSpeed: Slow, Medium o Fast. Viene usata quando non è specificata una durata esplicita. |
setDuration controlla solo l’effetto di transizione; non determina per quanto tempo la diapositiva rimane visibile. Configura separatamente il ritardo di avanzamento automatico. Quando non è impostata una durata esplicita, Aspose.Slides determina la durata dell’effetto dal tipo di transizione e dal valore di getSpeed.
L’esempio condiviso assegna a ogni diapositiva una transizione Fade di 750 ms e abilita separatamente l’avanzamento automatico a 5 000 ms. La durata della transizione controlla l’effetto; l’avanzamento controlla quando lasciare la diapositiva. Queste barre sono impostazioni schematiche, non una timeline combinata misurata.
Applicare la stessa durata a ogni diapositiva
Per mantenere un ritmo costante, applica lo stesso effetto e la stessa durata esatta a tutte le diapositive. Questo esempio carica input.pptx, seleziona Fade da TransitionType, e assegna a ciascuna transizione una durata di 750 millisecondi. Abilita separatamente l’avanzamento automatico dopo 5 000 millisecondi e disabilita l’avanzamento tramite clic del mouse, quindi salva il risultato come PPTX.
const slides = require("aspose.slides.via.java");
const presentation = new slides.Presentation("input.pptx");
try {
for (let i = 0; i < presentation.getSlides().size(); i++) {
const slide = presentation.getSlides().get_Item(i);
const transition = slide.getSlideShowTransition();
transition.setType(slides.TransitionType.Fade);
transition.setDuration(750);
// Configura l'avanzamento automatico indipendentemente dalla durata dell'effetto.
transition.setAdvanceAfter(true);
transition.setAdvanceAfterTime(5000);
transition.setAdvanceOnClick(false);
}
presentation.save("precise-transitions.pptx", slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Impostare durate diverse per diapositive individuali
Diapositive diverse possono utilizzare durate di effetto differenti. Ad esempio, usa una transizione breve per una diapositiva titolo e una più lunga per l’introduzione di una sezione. Questo esempio imposta 500 ms per la prima diapositiva e 1 200 ms per la seconda. Usa un file input.pptx con almeno due diapositive.
const slides = require("aspose.slides.via.java");
const presentation = new slides.Presentation("input.pptx");
try {
if (presentation.getSlides().size() >= 2) {
const firstTransition = presentation.getSlides().get_Item(0).getSlideShowTransition();
firstTransition.setType(slides.TransitionType.Fade);
firstTransition.setDuration(500);
const secondTransition = presentation.getSlides().get_Item(1).getSlideShowTransition();
secondTransition.setType(slides.TransitionType.Push);
secondTransition.setDuration(1200);
presentation.save("individual-transition-durations.pptx", slides.SaveFormat.Pptx);
} else {
console.log("The input presentation must contain at least two slides.");
}
} finally {
presentation.dispose();
}
Coordinare le transizioni con l’output animato
Quando prepari un GIF animato, una presentazione HTML5 o un video, imposta le durate di transizione esatte prima dell’esportazione per corrispondere al ritmo desiderato. Ad esempio, usa una dissolvenza di 600 ms tra le scene e regola separatamente il ritardo di avanzamento di ciascuna diapositiva per consentire il tempo della narrazione o del contenuto.
Per GIF e video, coordina il frame rate di output con la durata dell’effetto: 600 ms corrispondono a 18 fotogrammi a 30 fps. In HTML5, abilita le transizioni animate nelle impostazioni di esportazione. Verifica gli effetti e le opzioni di timing supportati dal formato di esportazione scelto e visualizza un’anteprima per confermare la sincronizzazione.
Leggere la durata della transizione esistente
Chiama getDuration prima di modificare la transizione per determinare se è memorizzato un valore esplicito. Un valore di -1 indica che non è impostata alcuna durata esplicita; un valore non negativo specifica la durata memorizzata in millisecondi. Il valore non impostato non è la durata di riproduzione calcolata: Aspose.Slides usa il tipo di transizione e il valore di getSpeed per determinare tale durata. L’impostazione di un tipo di transizione può inizializzare una durata, quindi ispeziona prima le impostazioni originali.
const slides = require("aspose.slides.via.java");
const presentation = new slides.Presentation("input.pptx");
try {
for (let i = 0; i < presentation.getSlides().size(); i++) {
const slide = presentation.getSlides().get_Item(i);
const transition = slide.getSlideShowTransition();
const duration = transition.getDuration();
if (duration >= 0) {
console.log("Slide " + slide.getSlideNumber() + ": stored transition duration is " + duration + " ms.");
} else {
console.log("Slide " + slide.getSlideNumber() + ": no explicit duration; timing depends on transition type " + transition.getType() + " and speed " + transition.getSpeed() + ".");
}
}
} finally {
presentation.dispose();
}
Transizione Morph
La transizione Morph anima le modifiche tra oggetti su diapositive consecutive. Per creare un semplice effetto Morph, clona una diapositiva, sposta o ridimensiona un oggetto sulla copia e applica la transizione Morph alla seconda diapositiva. Questo fornisce alla transizione gli oggetti corrispondenti da animare tra lo stato originale e quello modificato.
L’esempio seguente crea una diapositiva con un rettangolo di testo, ne clona la diapositiva e cambia la posizione e la dimensione del rettangolo sulla copia. Quindi seleziona Morph dall’enumerazione TransitionType per la seconda diapositiva. Apri il file salvato in un visualizzatore di presentazioni che supporta Morph per vedere l’effetto durante la presentazione.
const slides = require("aspose.slides.via.java");
const presentation = new slides.Presentation();
try {
const firstSlide = presentation.getSlides().get_Item(0);
const rectangle = firstSlide.getShapes().addAutoShape(slides.ShapeType.Rectangle, 100, 100, 400, 100);
rectangle.getTextFrame().setText("Morph transition");
const secondSlide = presentation.getSlides().addClone(firstSlide);
const movedRectangle = secondSlide.getShapes().get_Item(0);
movedRectangle.setX(movedRectangle.getX() + 100);
movedRectangle.setY(movedRectangle.getY() + 50);
movedRectangle.setWidth(movedRectangle.getWidth() - 200);
movedRectangle.setHeight(movedRectangle.getHeight() - 10);
secondSlide.getSlideShowTransition().setType(slides.TransitionType.Morph);
presentation.save("morph-transition.pptx", slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Tipi di transizione Morph
L’enumerazione TransitionMorphType controlla come Morph associa e anima il contenuto:
- ByObject tratta ogni forma come un intero oggetto.
- ByWord anima il testo associando le parole dove possibile.
- ByChar anima il testo associando i caratteri dove possibile.
Usa setType per selezionare Morph prima di accedere a getValue. Il valore restituisce quindi un oggetto MorphTransition, il cui metodo setMorphType seleziona la modalità di associazione.
Questo esempio apre la presentazione creata nella sezione precedente e configura la seconda diapositiva per utilizzare l’animazione Morph basata sulle parole.
const java = require("java");
const slides = require("aspose.slides.via.java");
const presentation = new slides.Presentation("morph-transition.pptx");
try {
if (presentation.getSlides().size() >= 2) {
const transition = presentation.getSlides().get_Item(1).getSlideShowTransition();
transition.setType(slides.TransitionType.Morph);
const transitionValue = transition.getValue();
if (java.instanceOf(transitionValue, "com.aspose.slides.IMorphTransition")) {
transitionValue.setMorphType(slides.TransitionMorphType.ByWord);
presentation.save("morph-by-word.pptx", slides.SaveFormat.Pptx);
} else {
console.log("Morph transition options are unavailable.");
}
} else {
console.log("The input presentation must contain at least two slides.");
}
} finally {
presentation.dispose();
}
Impostare gli effetti di transizione
Alcune transizioni espongono opzioni aggiuntive, come la direzione o se l’effetto inizia da uno schermo nero. Le opzioni disponibili dipendono dalla transizione selezionata con setType. Imposta prima il tipo, poi usa l’oggetto di transizione appropriato ottenuto da getValue.
L’esempio seguente applica una transizione Cut alla prima diapositiva di input.pptx. Chiama setFromBlack tramite OptionalBlackTransition in modo che la transizione inizi da uno schermo nero.
const java = require("java");
const slides = require("aspose.slides.via.java");
const presentation = new slides.Presentation("input.pptx");
try {
const transition = presentation.getSlides().get_Item(0).getSlideShowTransition();
transition.setType(slides.TransitionType.Cut);
const transitionValue = transition.getValue();
if (java.instanceOf(transitionValue, "com.aspose.slides.IOptionalBlackTransition")) {
transitionValue.setFromBlack(true);
presentation.save("cut-from-black.pptx", slides.SaveFormat.Pptx);
} else {
console.log("Cut transition options are unavailable.");
}
} finally {
presentation.dispose();
}
FAQ
Posso controllare la velocità di riproduzione di una transizione della diapositiva?
Sì. Preferisci setDuration quando hai bisogno di una durata esatta dell’effetto in millisecondi. Usa setSpeed quando è sufficiente una categoria predefinita di TransitionSpeed: Slow, Medium o Fast, e non è impostata alcuna durata esplicita. Queste impostazioni controllano l’effetto di transizione indipendentemente dal ritardo di avanzamento automatico.
Posso associare audio a una transizione e farlo ripetere in loop?
Sì. Assegna l’audio incorporato con setSound, passa StartSound dall’enumerazione TransitionSoundMode a setSoundMode e abilita setSoundLoop con true. L’audio si ripete finché non si verifica il successivo evento sonoro nella presentazione.
Qual è il modo più veloce per applicare la stessa transizione a tutte le diapositive?
Scorri la collezione getSlides della presentazione e chiama setType con lo stesso valore per la transizione di ciascuna diapositiva. Imposta tempi e opzioni di effetto nello stesso ciclo per mantenere il comportamento coerente su tutte le diapositive.
Come posso verificare quale transizione è attualmente impostata su una diapositiva?
Chiama getType sul risultato di getSlideShowTransition della diapositiva. Restituisce un valore dell’enumerazione TransitionType; None indica che non è applicato alcun effetto di transizione.