La proprieta type dichiara che cosa e stato risolto e la proprieta content ne trasporta i dati. Insieme a publishedAt e al sommario gia calcolato, sono le informazioni che distinguono una pagina da un articolo, da una scheda prodotto o da una pagina della guida.
Il tipo di pagina
La proprieta type e la prima informazione da leggere dopo la route: dichiara la natura del contenuto risolto e permette al software di rendering di scegliere il proprio modello di presentazione.
Gruppo
Valori
Contenuti editoriali
HomePage, Page, Post, Event, Product, Review, PageDoc
Le pagine di servizio, di ricerca, di accesso e dell'area riservata hanno una funzione fissa nel sito: il tipo indica al client quale schermata montare, mentre le regioni e le aree di contenuto continuano a fornire la parte redazionale.
L'oggetto content
L'oggetto content espone otto proprieta alternative fra loro. Al massimo una descrive l'entita risolta, coerente con type; la galleria di dettaglio puo accompagnarla.
Proprieta
Valorizzata quando type vale
page
HomePage, Page, PageDoc e i tipi di servizio basati su una pagina
post
Post
event
Event
product
Product
postCategory
PostCategory
eventCategory
EventCategory
productCategory
ProductCategory
detailGallery
qualunque tipo, quando il layout prevede una galleria di dettaglio
Il software di rendering non deve dedurre il tipo dalla presenza di una proprieta: legge type e accede alla proprieta corrispondente. Le altre sono assenti dal JSON.
La pagina generica
La proprieta content.page e volutamente essenziale, perche per una pagina generica tutti i dati redazionali si trovano gia nella route e nelle aree di contenuto.
Proprieta
Descrizione
id
Identificativo della pagina, uguale all'id di primo livello della risposta.
absoluteUrl
URL assoluto della pagina, quando valorizzato.
title
Titolo della pagina come entita, distinto dal titolo della route.
description
Descrizione della pagina come entita.
Gli altri contenuti risolti, come articolo, evento, prodotto e le relative categorie, hanno un contratto piu ampio, con categoria, autore, date, prezzi, valutazioni e contenuti correlati. Ciascuno e descritto nella pagina dedicata al proprio tipo.
La galleria di dettaglio
La proprieta content.detailGallery contiene la galleria che il layout associa alla pagina di dettaglio, tipicamente le immagini di una scheda prodotto o di un articolo. Espone un solo elenco, items, con la stessa forma degli elementi del componente galleria.
A differenza delle gallerie inserite nel contenuto, questa galleria non e mai a caricamento differito: se il layout la prevede, gli elementi arrivano nella risposta della pagina. Un elenco vuoto significa che la galleria e prevista ma priva di immagini.
Il sommario della pagina
L'elenco tableOfContents e gia calcolato dai titoli dei componenti della pagina e arriva nell'ordine di lettura. Ogni voce ha tre proprieta.
Proprieta
Descrizione
id
Ancora del titolo. Coincide con anchorId del titolo del componente e va usata come identificativo dell'elemento nel documento.
label
Testo della voce, gia privo di formattazione.
level
Profondita numerica del titolo, da usare per l'annidamento visivo del sommario.
Il collegamento di ciascuna voce si costruisce anteponendo il carattere # all'ancora. La corrispondenza con i titoli dei componenti e garantita: ogni voce del sommario ha un titolo corrispondente nel contenuto della pagina.
La proprieta publishedAt riporta la data e l'ora UTC di pubblicazione del contenuto. E il valore da usare per i dati strutturati e per le intestazioni di validita della cache del client.