Gerenciar Transições de Slide em Apresentações Usando JavaScript
Visão geral
As transições de slides controlam como os slides aparecem durante uma apresentação. Com Aspose.Slides para Node.js via Java, você pode escolher um efeito de transição para cada slide, configurar o avanço por clique do mouse ou temporizador e ajustar opções específicas de um efeito. Este artigo usa exemplos em JavaScript para aplicar transições, definir durações exatas de transição, gerenciar o tempo dos slides e criar uma transição Morph entre dois slides. Os exemplos também mostram como salvar as configurações em um arquivo PPTX.
Adicionar transição de slide
Para aplicar uma transição, carregue uma apresentação com a classe Presentation e acesse as configurações de transição do slide através de getSlideShowTransition. Use setType com um valor da enumeração TransitionType, depois salve a apresentação.
O exemplo a seguir aplica uma transição Circle ao primeiro slide e uma transição Comb ao segundo. Use um arquivo input.pptx com pelo menos dois slides.
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();
}
Transição Wheel
O método setSpokes da classe WheelTransition controla o número de setores radiais que revelam o slide de destino. Defina o tipo de transição do slide para Wheel a partir de TransitionType usando setType antes de acessar getValue como WheelTransition.
Este exemplo cria dois pares idênticos de slides: um slide preto seguido de um slide com um retângulo dourado. Os slides de destino usam contagens de raios de 1 e 8, com a mesma velocidade definida por setSpeed e uma duração explícita de 8 000 milissegundos definida por setDuration para facilitar a observação da diferença.
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();
}
Abra a apresentação de saída no PowerPoint e execute a apresentação. Avance do slide 1 para o slide 2, depois do slide 3 para o slide 4. Na reprodução no PowerPoint, a contagem verificada de 1 revela o slide com uma varredura no sentido horário; a contagem verificada de 8 o revela através de oito setores radiais simultaneamente. O conteúdo de destino e o tempo da transição são idênticos, portanto a diferença está no número de setores de revelação.
Adicionar transição avançada de slide
Você pode configurar quanto tempo um slide permanece na tela e se um clique do mouse avança a apresentação. Os métodos a seguir controlam esse comportamento:
- setAdvanceOnClick permite que o visualizador avance ao clicar o mouse.
- setAdvanceAfter habilita o avanço automático.
- setAdvanceAfterTime especifica o atraso antes do avanço automático, em milissegundos.
Habilite tanto o avanço por clique quanto o cronometrado para que o visualizador avance com um clique ou espere o temporizador. Para usar apenas o temporizador, passe false para setAdvanceOnClick. O atraso controla quando a apresentação avança; ele não define a duração do efeito visual da transição.
Este exemplo atribui efeitos diferentes aos três primeiros slides e habilita o avanço automático após 3, 5 e 7 segundos, respectivamente. Cliques do mouse também podem avançar esses slides. Use um arquivo input.pptx com pelo menos três slides.
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();
}
Para verificar se o avanço cronometrado está habilitado, chame getAdvanceAfter. Um atraso armazenado sozinho não indica que o temporizador está ativo.
O próximo exemplo abre o arquivo salvo acima, relata cada temporizador habilitado e desabilita o avanço automático para slides com atraso maior que dois segundos. Ele habilita cliques do mouse para esses slides e salva as configurações atualizadas.
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();
}
Controlar o tempo da transição com precisão
Use setDuration para especificar o comprimento exato de um efeito de transição em milissegundos. O método getSlideShowTransition do slide expõe essas configurações através de SlideShowTransition:
| Método | Propósito |
|---|---|
| setDuration | Define a duração do próprio efeito de transição, em milissegundos. |
| setAdvanceAfterTime | Define o atraso antes que o slide avance automaticamente, em milissegundos. Passe true para setAdvanceAfter para ativar esse temporizador. |
| setSpeed | Seleciona uma categoria de velocidade predefinida da enumeração TransitionSpeed: Slow, Medium ou Fast. É usada quando uma duração exata não é especificada. |
setDuration controla apenas o efeito da transição; não determina quanto tempo o slide permanece visível. Configure o atraso de avanço automático separadamente. Quando nenhuma duração explícita é definida, Aspose.Slides determina a duração do efeito a partir do tipo de transição e do valor de getSpeed.
O exemplo compartilhado atribui a cada slide uma transição Fade de 750 ms e habilita separadamente o avanço automático em 5 000 ms. A duração da transição controla o efeito; o avanço controla quando deixar o slide. Essas barras são configurações esquemáticas, não uma linha do tempo combinada medida.
Aplicar a mesma duração a todos os slides
Para um ritmo consistente, aplique o mesmo efeito e a mesma duração exata a cada slide. Este exemplo carrega input.pptx, seleciona Fade a partir de TransitionType e define 750 milissegundos como duração de cada transição. Ele habilita separadamente o avanço automático após 5 000 milissegundos e desabilita o avanço por clique do mouse, então salva o resultado como 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);
// Configurar avanço automático independentemente da duração do efeito.
transition.setAdvanceAfter(true);
transition.setAdvanceAfterTime(5000);
transition.setAdvanceOnClick(false);
}
presentation.save("precise-transitions.pptx", slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Definir durações diferentes para slides individuais
Slides diferentes podem usar durações de efeito distintas. Por exemplo, use uma transição breve para um slide de título e uma transição mais longa para a introdução de uma seção. Este exemplo define 500 milissegundos para o primeiro slide e 1 200 milissegundos para o segundo. Use um arquivo input.pptx com pelo menos dois slides.
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();
}
** Coordenar transições com saída animada**
Ao preparar um animated GIF, uma HTML5 presentation ou um video, defina durações exatas de transição antes da exportação para corresponder ao ritmo desejado. Por exemplo, use um fade de 600 milissegundos entre cenas e ajuste separadamente o atraso de avanço de cada slide para permitir tempo para sua narração ou conteúdo.
Para GIF e vídeo, coordene a taxa de quadros de saída com a duração do efeito: 600 milissegundos correspondem a 18 quadros a 30 quadros por segundo. No HTML5, habilite transições animadas nas opções de exportação. Verifique os efeitos e opções de tempo suportados pelo formato de exportação escolhido e visualize a saída para confirmar a sincronização.
Ler a duração de uma transição existente
Chame getDuration antes de modificar a transição para determinar se um valor explícito está armazenado. Um valor -1 significa que nenhuma duração explícita foi definida; um valor não negativo especifica a duração armazenada em milissegundos. O valor não definido não é a duração de reprodução calculada: Aspose.Slides usa o tipo de transição e o valor de getSpeed para determinar essa duração. Definir um tipo de transição pode inicializar uma duração, portanto inspecione as configurações originais primeiro.
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();
}
Transição Morph
A transição Morph anima mudanças entre objetos em slides consecutivos. Para criar um efeito Morph simples, clone um slide, mova ou redimensione um objeto no clone e aplique a transição Morph ao segundo slide. Isso fornece aos objetos correspondentes a animação entre seus estados original e modificado.
O exemplo a seguir cria um slide com um retângulo de texto, clona o slide e altera a posição e o tamanho do retângulo no clone. Em seguida, seleciona Morph a partir da enumeração TransitionType para o segundo slide. Abra o arquivo salvo em um visualizador de apresentações que suporte Morph para ver o efeito durante a apresentação.
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();
}
Tipos de Transição Morph
A enumeração TransitionMorphType controla como o Morph combina e anima o conteúdo:
- ByObject trata cada forma como um objeto completo.
- ByWord anima texto combinando palavras quando possível.
- ByChar anima texto combinando caracteres quando possível.
Use setType para selecionar Morph antes de acessar getValue. O valor então fornece um objeto MorphTransition, cujo método setMorphType seleciona o modo de correspondência.
Este exemplo abre a apresentação criada na seção anterior e configura o segundo slide para usar animação Morph baseada em palavras.
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();
}
Definir efeitos de transição
Algumas transições expõem opções adicionais, como direção ou se o efeito começa a partir de uma tela preta. As opções disponíveis dependem da transição selecionada com setType. Defina o tipo primeiro, depois use o objeto de transição apropriado obtido via getValue.
O exemplo a seguir aplica uma transição Cut ao primeiro slide de input.pptx. Ele chama setFromBlack através de OptionalBlackTransition para que a transição comece a partir de uma tela preta.
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 controlar a velocidade de reprodução de uma transição de slide?
Sim. Prefira setDuration quando precisar de uma duração exata do efeito em milissegundos. Use setSpeed quando uma categoria predefinida de TransitionSpeed – Slow, Medium ou Fast – for suficiente e nenhuma duração explícita for definida. Essas configurações controlam o efeito da transição independentemente do atraso de avanço automático.
Posso anexar áudio a uma transição e fazer loop?
Sim. Atribua áudio incorporado com setSound, passe StartSound da enumeração TransitionSoundMode para setSoundMode e habilite setSoundLoop com true. O áudio gera loop até o próximo evento sonoro na apresentação.
Qual a maneira mais rápida de aplicar a mesma transição a todos os slides?
Percorra a coleção getSlides da apresentação e chame setType com o mesmo valor para a transição de cada slide. Defina quaisquer opções de tempo e efeito no mesmo laço para manter o comportamento consistente em todos os slides.
Como posso verificar qual transição está atualmente definida em um slide?
Chame getType no resultado de getSlideShowTransition do slide. Ele retorna um valor da enumeração TransitionType; None significa que nenhum efeito de transição foi aplicado.