Komponentin factory-objekti luo komponentin instanssin.
Komponentin factory-objektin merkintä komponentin rekisteröintitiedostossa on initData.componentFactory
. Tämä on viittaus JavaScript-tiedostoon, jonka avulla RequireJS lataa komponentin factory-objektin. Sen on palautettava JavaScript-objekti, joka toteuttaa componentFactory
-liittymän
Komponentin factory-objektin on toteutettava customComponentFactory.createComponent(args)
-API-kutsu, joka luo kunkin komponentin instanssin.
args
sisältää seuraavat asetukset:
SitesSDK
: Oracle Content Management -palvelun sivustojen SDK.
id
: sivulle lisättävän komponentin yksilöivä tunnus (GUID
).
viewMode
: Sivun nykyinen muodostustila. Kun sivua muokataan, tila on Muokkaus. Kun sivua esikatsellaan, tila on Navigointi. Ajon aikana eli sivuston julkaisun aikana arvo on määrittämätön. Voit määrittää erilaisia toteutuksia sen mukaan, mitä toimintoja kussakin tilassa pitäisi olla saatavilla. Linkkien ei esimerkiksi pitäisi olla aktiivisia, kun sivu on käynnissä muokkaustilassa.
Huomautus::
JQueryn tai Knockoutin käyttö komponentissa ei ole pakollista. Sisäkkäisten komponenttien ja muiden Oracle Content Management -toimintojen käyttö kuitenkin edellyttää, että käytössä on Oracle Content Management -palvelun tarjoama Knockout-versio. Tämä Knockout-versio sisältää laajennetut komponentin rekisteröinnin ja käsittelijät, jotka eivät muuten ole käytettävissä.SDK välitetään argumenttina komponentille, kun komponentin instanssi luodaan, jotta komponentti voisi viestiä sivun elinkaaren kanssa Komponentin on toteutettava sivun elinkaaren funktiot. Oracle Content Management kutsuu niitä, kun se muodostaa komponentin sivulle.
Komponentin toteutukseen liittyy pakollisia ja valinnaisia API-liittymiä.
Pakolliset API-liittymät
customComponent.render(container)
: pyytää komponenttia lisäämään itsensä määritettyyn DOM-säiliöelementtiin.
container
: räätälöidyn komponentin DOM-säiliöelementti.
Valinnaiset API-liittymät
customComponent.dispose()
: Kutsutaan, kun komponenttia poistetaan sivulta. Tämän kutsun avulla komponentti voi poistaa resursseja, joita ei enää tarvita.