Histórico do HTL history-of-htl

Para usuários antigos do AEM, esse documento fornece informações sobre o HTL, sua mudança de nome (ele era anteriormente conhecido como Sightly) e como ele substitui o JSP.

Anteriormente conhecido como Sightly sightly

O HTL (Linguagem de modelo HTML) é o sistema de modelo do lado do servidor preferencial e recomendado para HTML no Adobe Experience Manager. Substitui as páginas JSP (JavaServer Pages), conforme usadas em versões anteriores do AEM.

HTL em vez de JSP htl-over-jsp

A Adobe recomenda que, para novos projetos do AEM, você use a Linguagem de modelo HTML. O motivo é porque ele oferece vários benefícios em comparação ao JSP. No entanto, para projetos já existentes, a migração só faz sentido se for estimado que o esforço será menor do que manter os JSPs atuais pelos próximos anos.

Mudar para HTL não é, necessariamente, uma escolha do tipo tudo ou nada, pois os componentes gravados em HTL são compatíveis com componentes gravados em JSP ou ESP. Essa abordagem significa que os projetos existentes podem usar HTL para novos componentes sem problemas, mantendo o JSP para os componentes existentes.

Inclusive no mesmo componente, os arquivos HTL podem ser usados junto a JSPs e ESPs. O exemplo a seguir mostra, na linha 1, como incluir um arquivo HTL a partir de um arquivo JSP; e na linha 2, como um arquivo JSP pode ser incluído a partir de um arquivo HTL:

<cq:include script="template.html"/>
<sly data-sly-include="template.jsp"/>

Perguntas frequentes frequently-asked-questions

Os desenvolvedores experientes do AEM que são iniciantes em HTL geralmente fazem as seguintes perguntas:

A HTL tem alguma limitação que o JSP não tem? limitations

A HTL não tem limitações em comparação com o JSP: o que pode ser feito com JSP também pode ser alcançado com HTL. No entanto, por design, a HTL é mais rigorosa que o JSP em vários aspectos. O que pode ser obtido com um único arquivo JSP pode precisar ser separado em uma classe Java ou em um arquivo JavaScript para ser obtido em HTL. Mas, em geral, essa abordagem é desejável para garantir uma boa separação de interesses entre a lógica e a marcação.

A HTL é compatível com Bibliotecas de tags JSP? tag-libraries

Não. No entanto, conforme mostrado na seção Carregamento de bibliotecas de clientes do documento de introdução, as declarações de modelo e chamada oferecem um padrão semelhante.

Os recursos da HTL podem ser estendidos em um projeto do AEM? extended

Não. O HTL tem mecanismos de extensão poderosos para reutilização de lógica (a API de uso) e de marcação (as declarações de modelo e chamada), que podem ser usados para modular o código dos projetos.

Quais são os principais benefícios do HTL em relação ao JSP? benefits

A segurança e a eficiência dos projetos são os principais benefícios, detalhados na Visão geral.

O JavaServer Pages (JSP) vai desaparecer? go-away

Não. Não há planos para descontinuar o JSP.

Por que o nome foi alterado? what-is-in-a-name

No AEM 6.0 e 6.1, a HTL era chamada de Sightly. A Adobe a renomeou para Linguagem de modelo HTML ou HTL para esclarecer a sua especificação e alinhar-se às diretrizes gerais de nomenclatura da Adobe. Essa alteração de nome entrou em vigor em agosto de 2016 e se aplica à versão AEM 6.0 e posteriores.

Para saber mais sobre HTL, consulte o Guia de introdução à Linguagem de Modelo HTML (HTL).