Introduzione
Liquid è un linguaggio del modello open source che si può usare per aggiungere contenuti dinamici alle pagine Web. Il codice Liquid può essere usato ovunque in Microsoft Power Pages dove si possa immettere contenuto HTML o di testo, inclusi i contenuti nelle pagine Web, i frammenti di contenuto e i modelli Web.
Liquid offre vari costrutti di linguaggio che possono aiutare a creare contenuti, applicare le trasformazioni e controllare il flusso di implementazione. La possibilità di accedere ai dati Microsoft Dataverse usando il linguaggio di query FetchXML oppure recuperando direttamente le righe della tabella tramite identificatori rende Liquid la scelta migliore per la creazione di pagine Web basate sui dati. Liquid include anche molti tag speciali (o istruzioni di elaborazione) pensati specificamente per la creazione di modelli Web riutilizzabili. Le sezioni seguenti spiegano come si possono usare i modelli nei siti Web Microsoft Power Pages.
Modelli
In Power Pages una riga della pagina Web non definisce l'aspetto della pagina visualizzata sul sito Web. Viene invece collegata a una riga Modello di pagina che definisce il layout e il comportamento.
I due tipi di modelli da usare nei siti Web Power Pages sono i seguenti:
Riscrittura: questi modelli usano l'elaborazione lato server per implementare il comportamento specializzato richiesto da alcuni componenti e pagine speciali, ad esempio pagine di errore, pagine di accesso e altro.
Modello Web: il modello di layout collegato definisce il rendering del contenuto della pagina per l'output.
I modelli di riscrittura offrono personalizzazioni limitate. Il linguaggio del modello Liquid può essere usato come parte del contenuto oppure all'interno di frammenti di contenuto, ma il layout e il comportamento della pagina sono predefiniti.
L'opzione Modello Web, invece, è interamente basata su modello e usa Liquid per definire il rendering del contenuto. I modelli sono flessibili. Un modello può includere altri modelli per specifiche parti del contenuto. Un modello può anche essere basato su un altro modello, estendendone la funzionalità di base. Il vero vantaggio dei modelli Web è dato dalla capacità di contenere codice Liquid, che aggiunge funzionalità di elaborazione al contenuto statico, incluso l'accesso ai dati di Dataverse.
Suggerimento
I modelli Web possono contenere anche HTML, CSS (Cascading Style Sheets) e JavaScript.
È possibile usare i modelli Web per definire un'intera pagina Web, parte di una pagina o elementi comuni come l'intestazione e il piè di pagina del sito. Questo approccio crea un aspetto e un comportamento coerenti in tutto il sito Web e semplifica la modifica dell'aspetto e dei dati di cui viene eseguito il rendering. L'esempio seguente mostra come potrebbe apparire un modello semplice tipico:
<div class="container">
<div class="page-heading">
{% include 'Breadcrumbs' %}
{% include 'Page Header' %}
</div>
<div class="row">
<div class="col-md-12">
{% block main %}
{% include 'Page Copy' %}
{% if page.adx_entitylist %}
{% include 'entity_list' key:page.adx_entitylist.id %}
{% endif %}
{% if page.adx_entityform %}
{% entityform id: page.adx_entityform.id %}
{% endif %}
{% endblock %}
</div>
</div>
</div>
Questo semplice modello include altri modelli per il rendering di varie parti comuni. Definisce un blocco di contenuto che può essere visualizzato in modo diverso da un modello derivato ed esegue il rendering dei dati di Dataverse tramite le righe Elenco e Modulo.
Modelli Web come intestazioni e piè di pagina del sito Web
I modelli Web consentono di sostituire l'intestazione e il piè di pagina globali usati da un sito Web Power Pages. A tale scopo, impostare la colonna Modello intestazione o Modello piè di pagina del sito Web sul modello Web prescelto.
Se si sostituisce la colonna Modello intestazione, il modello selezionato provvederà a eseguire il rendering della navigazione principale, dei collegamenti di accesso/disconnessione, dell'interfaccia di ricerca e così via, per gli elementi dell'interfaccia del sito normalmente gestiti dal modello di intestazione predefinito.
Suggerimento
Se non si specifica alcun modello di intestazione o piè di pagina nella riga Sito Web, viene eseguito il rendering del contenuto predefinito. Per rimuovere completamente un'intestazione o un piè di pagina, specificare un modello vuoto.