Converter apresentações para HTML5 em Java
Visão geral
Este artigo explica como converter apresentações do PowerPoint para HTML5 usando Aspose.Slides for Java. Ele abrange exportação básica, controle de animações de formas e transições de slides, e layout de comentários. Também compara a saída HTML5 com a saída baseada em SVG da exportação HTML padrão.
Exportar PowerPoint para HTML5
O exemplo a seguir carrega uma apresentação do diretório de trabalho e a salva no formato HTML5. Ele usa as configurações de exportação padrão; o próximo exemplo mostra como controlar a reprodução de animações explicitamente. Substitua o caminho de entrada pelo caminho da sua apresentação.
import com.aspose.slides.*;
Presentation presentation = new Presentation("pres.pptx");
try {
presentation.save("pres.html", SaveFormat.Html5);
} finally {
presentation.dispose();
}
Note
Além do documento HTML, a exportação grava arquivos CSS e JavaScript de suporte para estilo de slides, animações, efeitos e navegação. Mantenha esses arquivos juntamente com o documento HTML ao mover ou publicar a saída. A página gerada também carrega jQuery e Anime.js de CDNs públicas; sem eles, a navegação e as animações dos slides não funcionam.Para exportar sem reproduzir animações de formas ou transições de slides, passe false para setAnimateShapes e setAnimateTransitions em Html5Options. Essas configurações são independentes, portanto você pode habilitar uma enquanto desabilita a outra. O exemplo exporta a apresentação com ambos os tipos de animação desativados na página gerada.
import com.aspose.slides.*;
Html5Options html5Options = new Html5Options();
html5Options.setAnimateShapes(false);
html5Options.setAnimateTransitions(false);
Presentation presentation = new Presentation("pres.pptx");
try {
presentation.save("pres5.html", SaveFormat.Html5, html5Options);
} finally {
presentation.dispose();
}
Exportar PowerPoint para HTML
A exportação HTML padrão usa uma abordagem de renderização diferente: o conteúdo dos slides é representado por SVG dentro de uma página HTML. O exemplo a seguir converte uma apresentação para um documento HTML usando essa abordagem de renderização.
import com.aspose.slides.*;
Presentation presentation = new Presentation("pres.pptx");
try {
presentation.save("pres.html", SaveFormat.Html);
} finally {
presentation.dispose();
}
A marcação simplificada abaixo ilustra a estrutura da página gerada. O elemento SVG contém o conteúdo renderizado do slide; o texto de espaço reservado representa esse conteúdo e não é a saída literal da exportação.
<body>
<div class="slide" name="slide" id="slideslideIface1">
<svg version="1.1">
<g> THE SLIDE CONTENT GOES HERE </g>
</svg>
</div>
</body>
Warning
A exportação baseada em SVG não expõe as formas do PowerPoint como elementos HTML individuais. Use a exportação HTML5 quando precisar das opções de animação de formas e transição de slides demonstradas neste artigo.Exportar PowerPoint para Visualização de Slides HTML5
A exportação HTML5 produz uma página para visualizar e navegar pelos slides da apresentação em um navegador. Este exemplo habilita tanto setAnimateShapes quanto setAnimateTransitions para que a visualização de slides exportada possa reproduzir os efeitos da apresentação original.
Use uma apresentação que já contenha animações de formas e transições de slides para ver o efeito dessas configurações. Habilitá‑las não adiciona novos efeitos a slides que não possuam nenhum. Após a exportação, abra o documento HTML5 gerado em um navegador com seus arquivos de suporte disponíveis.
import com.aspose.slides.*;
Html5Options html5Options = new Html5Options();
html5Options.setAnimateShapes(true);
html5Options.setAnimateTransitions(true);
Presentation presentation = new Presentation("pres.pptx");
try {
presentation.save("HTML5-slide-view.html", SaveFormat.Html5, html5Options);
} finally {
presentation.dispose();
}
Converter uma Apresentação para um Documento HTML5 com Comentários
Você pode incluir comentários de slide existentes na saída HTML5 para que os leitores vejam o feedback ao lado do conteúdo do slide. O exemplo nesta seção espera que a apresentação de origem contenha comentários, como ilustrado abaixo. Ele exporta esses comentários; não cria novos.
Passe um objeto NotesCommentsLayoutingOptions ao método setSlidesLayoutOptions de Html5Options. Use setCommentsPosition para selecionar Right da enumeração CommentsPositions e posicionar os comentários à direita de cada slide.
O exemplo a seguir exporta a apresentação para HTML5 com este layout de comentários. Uma apresentação sem comentários não terá texto de comentário para exibir.
import com.aspose.slides.*;
NotesCommentsLayoutingOptions layoutOptions = new NotesCommentsLayoutingOptions();
layoutOptions.setCommentsPosition(CommentsPositions.Right);
Html5Options html5Options = new Html5Options();
html5Options.setSlidesLayoutOptions(layoutOptions);
Presentation presentation = new Presentation("sample.pptx");
try {
presentation.save("output.html", SaveFormat.Html5, html5Options);
} finally {
presentation.dispose();
}
A imagem abaixo mostra o documento HTML5 exportado com os comentários exibidos ao lado do slide.
Excluir Hiperlinks JavaScript Durante a Exportação
Suponha que hyperlinks.pptx contenha texto vinculado com um destino javascript:alert('Hello') e um link ordinário https://example.com/. Para excluir o hiperlink JavaScript durante a exportação, passe true para SaveOptions.setSkipJavaScriptLinks. O padrão é false, portanto esses links não são filtrados a menos que você habilite a opção.
O exemplo a seguir carrega a apresentação do diretório de trabalho e a exporta usando Html5Options:
import com.aspose.slides.*;
Html5Options html5Options = new Html5Options();
html5Options.setSkipJavaScriptLinks(true);
Presentation presentation = new Presentation("hyperlinks.pptx");
try {
presentation.save("filtered-html5.html", SaveFormat.Html5, html5Options);
} finally {
presentation.dispose();
}
O arquivo exportado omite o hiperlink JavaScript enquanto mantém seu texto e o link HTTPS ordinário. A apresentação de origem permanece inalterada.
Esta opção filtra hiperlinks JavaScript; não remove todos os scripts ou outro conteúdo ativo, nem garante conformidade com CSP. Por exemplo, a saída HTML5 ainda inclui scripts para navegação de slides e animações.
Perguntas frequentes
Posso controlar se as animações de objetos e as transições de slides serão reproduzidas no HTML5?
Sim, a exportação HTML5 fornece opções separadas para habilitar ou desabilitar shape animations e slide transitions.
Os comentários são suportados e onde podem ser posicionados em relação ao slide?
Sim, os comentários existentes podem ser incluídos na saída HTML5 e posicionados (por exemplo, à direita do slide) por meio das layout settings para notas e comentários.
Posso ignorar links que invocam JavaScript por motivos de segurança ou CSP?
Sim, a configuração setSkipJavaScriptLinks permite ignorar hiperlinks com chamadas JavaScript durante a gravação. O padrão é false. Consulte Excluir Hiperlinks JavaScript Durante a Exportação para um exemplo de exportação HTML5 e o escopo do filtro. Esta configuração não remove o JavaScript usado pelo visualizador HTML5 para navegação e animações.