HTML personalizzato

Utilizzando un elemento HTML personalizzato, è possibile aggiungere codice HTML a una pagina o a una vista.
L'elemento HTML personalizzato può contenere una o più serie di elementi HTML come tag <div> e <label> . È possibile aggiungere il codice HTML direttamente come testo utilizzando un file gestito o utilizzando una variabile. L'elemento HTML personalizzato inserisce gli elementi all'interno della tag <div> della pagina o della vista. Se si utilizza un elemento HTML personalizzato in un contenitore come la tabella, la scheda, la sezione orizzontale e le viste di sezione verticale, racchiudere il codice HTML in un tag <div> . Eseguendo il wrapping del codice HTML, il contenitore considera tutto il codice HTML come un'unica entità.
Nota: quando si creano pagine utilizzando blocchi HTML personalizzati, assicurarsi che i segmenti HTML all'interno di questi blocchi non siano troppo grandi. I blocchi HTML personalizzati sono progettati per l'utilizzo con segmenti HTML di dimensioni da piccole a moderate. Se si fornisce un segmento HTML troppo grande, potrebbe essere visualizzata un'eccezione di overflow dello stack. In questo caso, è necessario ridurre la dimensione del segmento HTML che si sta utilizzando all'interno della pagina. Consultare Configurazione della JVM in WebSphere Application Server .
Limitazione: se l'elemento HTML personalizzato si trova all'interno di una vista ripetuta come una tabella o una sezione, non associarlo a una variabile che è una proprietà all'interno di una voce di elenco. Normalmente, il generatore di codice inserisce il contenuto HTML personalizzato come codice HTML quando crea la pagina. Tuttavia, le viste ripetute sono collegate a un elenco. Poiché il contenuto dell'elenco non viene impostato fino al runtime, il generatore di codice non può determinare l'indice della variabile nell'elenco quando crea la pagina. Se si desidera che il testo venga modificato dinamicamente, considerare l'utilizzo di una vista come ad esempio Testo di output collegato alla variabile.
Importante: non utilizzare i seguenti nomi come nomi di classe CSS nel codice sorgente HTML perché sono nomi riservati:
  • CoachView
  • ContentBox

L'elemento HTML personalizzato supporta l'utilizzo di variabili JavaScript per tipi semplici. Quando il server genera la pagina HTML per il client, sostituisce il nome della variabile con il relativo valore. Tuttavia, dopo che il server ha generato la pagina, non aggiorna l'HTML se c'è una modifica nel valore. Il server aggiorna la variabile solo quando rigenera l'intera pagina HTML. Se il server non è in grado di risolvere la variabile, gli utenti visualizzano il nome della variabile invece del suo valore.

Nel codice, inserisci la variabile tra doppie parentesi graffe. Per le pagine, la variabile può fare riferimento solo ai dati nello spazio dei nomi tw.local . Vale a dire, la variabile può fare riferimento ai dati definiti nella pagina Variabili del servizio umano nel nodo locale. Ad esempio, una pagina ha una variabile oggetto di business user con un parametro name contenente il nome dell'utente. È possibile visualizzare la pagina con il seguente codice in un elemento HTML:
<div>Hello, {{tw.local.user.name}}.</div>
Per le viste, la variabile può fare riferimento ai dati negli spazi dei nomi tw.businessData o tw.options . In altre parole, la variabile può fare riferimento ai dati definiti nella pagina Variabili della vista nei nodi Dati di business o Opzioni di configurazione. Ad esempio, se si desidera che una vista visualizzi il nome di una strada, collegare la vista a un oggetto di business address con un parametro denominato street. In un elemento HTML, si aggiunge il codice seguente:
{{tw.businessData.address.street}}
Se si posiziona un'istanza di tale vista in una pagina, l'utente visualizza il valore del parametro street nella vista. Tuttavia, se l'utente aggiorna il parametro street , il contenuto nell'elemento HTML non viene aggiornato fino a quando il server non rigenera l'intera pagina.
Suggerimento: per inserire uno script, aggiungerlo utilizzando gli script in linea nella pagina Comportamento della vista. Non aggiungere lo script utilizzando un elemento HTML personalizzato.