Vykreslenie obsahových položiek

Obsahové položky sa vykresľujú pomocou rozložení obsahu. Prijmú dáta obsahovej položky, vykreslia ich do kódu HTML a vložia ho na stránku.

Rozloženia obsahu na vykreslenie obsahových položiek predvolene používajú šablóny Mustache, ale možno ich implementovať v ľubovoľnej technológii JavaScript. Šablóna Mustache na vykreslenie očakáva dáta v určitom formáte. Súbor render.js rozloženia obsahu musí zaistiť, že model, ktorý odovzdá do šablóny, sa zhoduje s príslušným formátom.

Rozloženia obsahu sa vykresľujú vo viacerých prípadoch použitia:

  • Pri použití v používateľskom rozhraní na správu položiek služby Oracle Content Management môžu byť dáta v stave Upravené, aby si používateľ mohol pred uložením zmien pozrieť ich ukážku.

  • Pri použití na lokalite Oracle Content Management v zozname obsahu alebo obsahovej položke sa k dátam pridajú doplňujúce informácie o lokalite, v ktorej sú spustené.

  • Pri použití prostredníctvom volania contentClient.renderLayout() súpravy Content SDK, pričom používateľ súpravy Content SDK odovzdá ľubovoľné dáta priamo do rozloženia obsahu.

Pokiaľ ide o výkon, existuje všeobecný kompromis medzi vytvorením jediného dopytu, ktorý vráti všetky požadované dáta, alebo viacerých dopytov, aby sa prehľad vykreslil čo najrýchlejšie, s rýchlym počiatočným dopytom, pričom oblasti sa následne vyplnia prostredníctvom nasledujúcich dopytov. Výber modelu závisí od vašich dát a prípadov použitia.

Formát dát odovzdaných do rozloženia obsahu sa môže líšiť v závislosti od spôsobu vyvolania dát. Ak napríklad používate Content REST s parametrom expand, môžu sa vrátiť aj referencie poľa na iné obsahové položky, a to individuálne alebo v skupine. Ak odkazované obsahové položky nie sú zahrnuté, bude potrebné vykonať ďalšie volania rozhrania REST.

Vývojár rozloženia obsahu by sa mal snažiť flexibilne použiť formát prijatých dát, aby bolo možné spracovať všetky prípady. V prípade potreby môže vývojár vyvolať ďalšie dáta a zmeniť dáta do formátu, ktorý očakáva šablóna vykreslenia.