Kreiranje oznake elementa koji se može uređivati

Oznaka elementa koja se može urediti, koristi se za pravljenje elemenata iz stavki sadržaja i područja sjedišta koji se mogu urediti kod prikaza pomoću portleta preglednika Web sadržaja kad je stranica u načinu uređivanja.

O ovom zadatku

Format oznake elementa koji se može urediti:

[EditableElement type=" " context=" " name=" " key=" " format=" " mode=" " 
     callback=" " stateChangeCallback=" " refreshValueOnEdit=" " class=" " htmlencode=" " placeholder=" "]

[/EditableElement]

Bilješka: Nemojte koristiti ovu oznaku ako su omogućene osnovne ili napredne predmemorije za prikaz jer s tim omogućenim predmemorijama, autorsko ažuriranje se ne prikazuju odmah na prikazanoj stranici.

Da biste kreirali oznaku elementa koji se može uređivati:

Postupak

Kliknite Umetni oznaku u prezentacijskom predlošku za dizajniranje komponente ili elementa. Otvara se dijalog Pomoć oznake.
Izaberite EditableElement kao tip oznake.

Izaberite tip stavke gdje je spremljen element i kontekst koji se koristi za određivanje koju stavku referencirati:

Ako nije postavljeno, tip stavke je content i kontekst je current.

Tablica 1. Matrica konteksta i tipa stavke. Ova tablica opisuje kako se mijenja kontekst za različite tipove stavki.
Kontekst i tip stavke	`type="auto"`	`type="content"`	`type="sitearea"`	`type="parent"`	`type="top"`
`context="Selected"` Ako se izabere, kontekst postavlja izabrana stavka. Stavku izaberete klikom na Izbor. Ovaj parametar se dodaje u oznaku kao parametar name=" ":	Ovaj parametar čini da se element iz izabrane stavke sadržaja može uređivati kada je stranica u načinu za uređivanje.	Ovaj parametar čini da se element iz izabrane stavke sadržaja može uređivati kada je stranica u načinu za uređivanje. Ako je izabrano područje sjedišta, onda se ništa ne može uređivati.	Ako je izabrana stavka područje sjedišta, onda ovaj parametar čini da se element iz područja sjedišta može uređivati kada je stranica u načinu uređivanja. Ako je izabrana stavka, stavka sadržaja, onda ovaj parametar čini da se element iz nadređenog područja sjedišta od stavke sadržaja može uređivati kada je stranica u načinu uređivanja.	Ovaj parametar čini da se element iz nadređenog od izabrane stavke može uređivati kada je stranica u načinu za uređivanje.	Ovaj parametar čini da se element iz prve stavke u stazi izabrane stavke može uređivati kada je stranica u načinu za uređivanje.
`context="Current"` Ako se izabere, kontekst postavlja trenutna stavka.	Ovaj parametar čini da se element iz stavke koja se trenutno prikazuje može uređivati kada je stranica u načinu za uređivanje.	Ovaj parametar čini da se element iz trenutne stavke sadržaja može uređivati kada je stranica u načinu za uređivanje. Ako je izabrano područje sjedišta, onda se ništa ne može uređivati.	Ako je stavka koja se trenutno prikazuje područje sjedišta, ovaj parametar čini da se element iz trenutnog područja sjedišta može uređivati kada je stranica u načinu uređivanja. Ako je stavka koja se trenutno prikazuje stavka sadržaja, ovaj parametar čini da se element iz nadređenog područja sjedišta od stavke sadržaja može uređivati kada je stranica u načinu uređivanja.	Ovaj parametar čini da se element iz nadređenog područja sjedišta stavke koja se trenutno prikazuje može uređivati kada je stranica u načinu za uređivanje.	Ovaj parametar čini da se element iz prve stavke u stazi stavke koja se trenutno prikazuje može uređivati kada je stranica u načinu za uređivanje.
`context="Autofill"` Koristite ovu opciju kada su referencirani element odredili parametri pretraživanja izbornika, navigatora ili komponenta sistematizacije. Ako se oznaka ne koristi unutar komponente izbornika, navigatora ili sistematizacije, kontekst će se vratiti na trenutnu stavku.	Ovaj parametar čini da se element stavke koju je vratio izbornik, navigator ili komponenta sistematizacije, može uređivati kada je stranica u načinu uređivanja.	Ovaj parametar čini da se element stavke sadržaja koju je vratio izbornik, navigator ili komponenta sistematizacije, može uređivati kada je stranica u načinu uređivanja. Ako je izabrano područje sjedišta, onda se ništa ne može uređivati.	Ako je trenutna stavka koju vraća komponenta izbornika, navigatora ili sistematizacije područje sjedišta, svojstvo iz područja sjedišta će se moći uređivati kada je stranica u načinu uređivanja. Ako je trenutna stavka koju vraća komponenta izbornika, navigatora ili sistematizacije stavka sadržaja, ovaj parametar čini da se element nadređenog područja sjedišta stavke sadržaja može uređivati kada je stranica u načinu uređivanja.	Ovaj parametar čini da se element nadređene stavke od stavke koju je vratio izbornik, navigator ili komponenta sistematizacije, može uređivati kada je stranica u načinu uređivanja.	Ovaj parametar čini da se element iz prve stavke u stazi stavke koju je vratio izbornik, navigator ili komponenta sistematizacije, može uređivati kada je stranica u načinu uređivanja.

Kliknite Izbor autorskog predloška za izbor odgovarajućeg autorskog predloška. Izaberite element koji će se moći uređivati iz liste dostupnih elemenata. Ovaj parametar se dodaje u oznaku kao key=" " parametar.
Bilješka: Ako ste izabrali tip izvora bilo nadređenog elementa, vršnog elementa ili područja sjedišta, tada trebate ručno navesti parametar key=" " u oznaci elementa koji se može urediti umjesto da kliknete na Izbor autorskog predloška.
Izaberite treba li uključiti početne i krajnje dijelove. Možete unijeti dodatni tekst između početka i kraja odjeljaka oznake i ostalih oznaka Web sadržaja kao što su oznaka komponente ili elementa.
Kliknite OK da biste dodali oznaku u vaš dizajn navigatora.

Što napraviti sljedeće

Nakon što dodate oznaku u vaš dizajn, možete također dodati i sljedeće parametre u oznaku:

Tablica 2. Parametri dodatne oznake. Ova tablica prikazuje dodatne parametre koji se mogu dodati ručno u ovu oznaku.
Parametri oznake	Detalji
`name=" "`	Morate specificirati ime stavke koja je referencirana ako je `context="selected"`. Ako navedete `name="./itemName"`, stvarna staza se ne rješava dok se stavka ne počne prikazivati. Ovaj način traje malo duže od specificiranja staze za stavku.
`format=" "`	Ako specificirate `format="div"`, prikazuje se regija koja se može uređivati, unutar oznake div. Ako format nije naveden, oznaka div se koristi po defaultu. Ako specificirate `format="span"`, prikazuje se regija koja se može uređivati, unutar oznake span.
`mode=" "`	Ovaj parametar određuje način umetnutog uređivanja. Navedite `mode="inplace"` da omogućite uređivanje na mjestu elementa. Taj način ne podržavaju sva polja. Ako element ne podržava način uređivanja na licu mjesta, koristi se način dijaloga. Navedite `mode="embed"` da omogućite umetnuto uređivanje elementa. Taj način ne podržavaju sva polja. Ako element ne podržava način umetnutog uređivanja, koristi se način dijaloga. Navedite `mode="dialog"` da omogućite uređivanje u dijalogu. Ovaj parametar je koristan za veće elemente kao što su elementi obogaćenog teksta koji možda neće biti prikladni za uređivanje u mjestu. Sva polja podržavaju način dijaloga. Ako način nije specificiran, onda se koristi default postavka koja je specificirana u inplaceEdit.defaultModeForText ili inplaceEdit.defaultModeForRichText svojstvu od WCM WCMConfigService servisa. Bilješka: Za način 'inplace' ili 'embed' uvijek se koristi default editor obogaćenog teksta. Kada se koristi način 'dialog', koristi se editor obogaćenog teksta koji je izabran u postavkama portleta autorstva ili u predlošku sadržaja za stavke sadržaja.
`callback=" "`	Ovaj parametar se koristi za referenciranje i$ obećanja. Obećanje je ispunjeno ako je umetnuto uređivanje dovršeno, a odbijeno ako je umetnuto uređivanje opozvano. Pogledajte Javadoc za više informacija o i$ izgledima. Na primjer: Standardni povratni poziv može izgledati ovako: `var myCallBack=new i$.Promise(); myCallBack.then(function(){window.alert('resolved')}, function(){window.alert('rejected')});return myCallBack;` Ako je `myCallBack` `i$` obećanje, povratni poziv može izgledati ovako: `myCallBack`. Funkcija koja sama vraća novo obećanje kod svakog izvođenja može izgledati ovako: `return (function() {var myCallBack = new i$.Promise(); myCallBack.then(function() {window.alert('resolved');}, function() {window.alert('rejected');}); return myCallBack;})();`
`stateChangeCallback=" "`	Ovaj parametar se koristi za referenciranje povratnih poziva JavaScripta za sve promjene stanja. Pogledajte Javadoc za više informacija. Na primjer, da biste naveli `stateChangeCallback="myStateChangeCallback"`, možete kreirati sljedeću funkciju povratnog poziva promjene stanja. /** * element: id regije elementa koji se trenutno uređuje * state : novo stanje * additionalData: neki dodatni podaci, na primjer tip oznake, naziv elementa, poruke */ function myStateChangeCallback(element, state, additionalData) State Constants: // učitavanje vrijednosti StateChangeEvent.STATE_LOADING = 0; // uređivanje StateChangeEvent.STATE_EDITING = 1; // spremanje StateChangeEvent.STATE_SAVING = 2; // spremljeno StateChangeEvent.STATE_SAVED = 3; // opozvano StateChangeEvent.STATE_CANCELLED = 4; // greška StateChangeEvent.STATE_ERROR = 5; Registrirana JavaScript funkcija izvodi se svaki puta kada se promijeni stanje. Bilješka: Učitavanje stanja se izvodi samo prvi puta kada korisnik uređuje element.
`refreshValueOnEdit=" "`	Ova postavka forsira osvježavanje vrijednosti oznake kada korisnik uređuje element. Ova postavka je uključena po defaultu. Ako želite onemogućiti ovu funkciju, postavite ovu postavku na false. Ograničenje: Ovaj atribut vrijedi samo za elemente teksta, elemente kratkog teksta, elemente brojeva ili elemente bogatog teksta. Kada koristite ovaj parametar s elementom bogatog teksta, ne možete koristiti referencu na oznaku web sadržaja u sadržaju elementa jer se ne može sintaktički analizirati. Ako je polje u načinu dijaloga ili je nekog drugog tipa elementa, poput podataka ili reference datoteke, ova vrijednost nema utjecaja. Ako se postavi na false, tada nema stanja učitavanja za ovaj element.
`class=" "`	Ovaj parametar se koristi za specificiranje CSS klase za div ili span oznaku koja je specificirana pomoću parametra formata. Bilješka: Prilagođena klasa koju ovdje specificirate, mora uključiti stilove s imenima "spremanje", "uređivanje" i "greška." Ova imena su potrebna za prikaz polja koje se može uređivati, u načinu uređivanja, kod spremanja i za prikaz poruke greške. Default css klasa koja se koristi za polja koja se mogu uređivati u mjestu, je wcm-default-inplace-editable. Ova klasa može biti nadjačana dodavanjem sljedećih postavki u WCM WCMConfigService servis pomoću WebSphere Integrated Solutions Console: `inplaceEdit.defaultClasses=class1 class2` U ovu postavku se dodaju sve potrebne klase, odvojene razmacima. Bazirajte prilagođene klase na default listu stila koji se nalazi na `AppServer_root\installedApps\nodename\wcm.ear\wcm-inplaceEdit.war\css\default-style.css`. Bilješka: Klase koje su navedene na EditableElement ili EditableProperty oznaci imaju prednost nad ovom vrijednošću. Ako trebate koristiti i default css klasu, dodajte je na listu klasa. Na primjer: `inplaceEdit.defaultClasses=wcm-default-inplace-editable class1 class2`
`htmlencode=" "`	Ako je `htmlencode="true"`, onda se rezervirani HTML znakovi u elementima koji prikazuju tekst, konvertiraju u entitete znakova. Na primjer, `<`' se konvertira u `<`'. Ova metoda je korisna ako želite spriječiti korisnike da dodaju zlonamjeran kod ili ako želite spriječiti korisnike da promijene dizajn teksta pomoću HTML-a. Ako nije specificirano, default postavka specificirana od `cmpnt.htmlEncodeDefault` svojstva u WCM WCMConfigService servisu, koristi se za prikaz teksta. Default postavka specificirana od `cmpnt.htmlEncodeUrls` svojstva u WCM WCMConfigService servisu koristi se za prikaz URL-ova. Po defaultu, ova svojstva se postavljaju na true.
`placeholder=" "`	Ovdje uneseni tekst se prikazuje kada nema početne vrijednosti za tijelo polja elementa, koje se može uređivati. Na primjer: `placeholder="Enter title"` Također se može koristiti u kombinaciji s pružateljem teksta za prikaz prevedenog teksta. Na primjer: `placeholder="[Plugin:TextProvider provider="com.mycompany.mybundle" key="enter_title"]"` Ova specijalne vrijednosti se koriste za prikaz teksta iz postojećih izvora: `placeholder="useName"` Ovaj parametar prikazuje ime elementa. `placeholder="useTitle"` Ovaj parametar prikazuje naslov elementa. `placeholder="useHelpText"` Ovaj parametar prikazuje tekst pomoći elementa. `placeholder="useNone"` Ovaj parametar pokazuje da nema znaka rezerviranog mjesta.

Dodatni tekst, HTML ili oznake moraju biti dodani između [EditableElement] i [/EditableElement] oznake. Tekst i oznake koje dodate ovdje predstavljaju sadržaj koji se prikazuje na stranici. Kada je stranica u načinu uređivanja, ova regija se može uređivati. Kada se prvi puta doda u dizajn, odgovarajuća oznaka elementa se doda po defaultu.

Na primjer, za prikaz elementa koji se može uređivati, a zove se body koristite sljedeće oznake:

[EditableElement type="content" context="current" key="body"]
[Element type="content" context="current" key="body"]
[/EditableElement]

Bilješka: Postavke konteksta portalContext i portalMapping se ne mogu koristiti s oznakom elementa koji se može uređivati. Ovo ograničenje se primjenjuje na samu oznaku elementa koji se može uređivati i bilo koju drugu oznaku koja je referencirana između [EditableElement] i [/EditableElement] oznaka.