Sfruttando alcuni dei suoi attributi è possibile ottenere diverse modalità di funzionamento. .
La textarea supporta la formattazione ed il controllo dell'input inserito dall'utente:
POPOLARE LA TEXTAREA
Inserimento manuale dei dati:
<idtag typeobj="textarea" label="nText:" value="Testo dentro la textarea" />
In alternatica la textarea può essere popolata da un ds, gli attributi in gioco sono:
- dsobj: attributo contenete il nome del ds da cui prelevare i dati
- dsitem: attributo contenete il nome del campo da cui prelevare i dati da visualizzare
<idtag typeobj="textarea" label="nText:" dsobj="dsname" dsitem="campotext" />
TEXTAREA COME EDITOR HIGHLIGHT
Nel caso in cui si voglia usare la textarea come editor highlight basta utilizzare l'attributo editor-lang
<idtag typeobj="textarea" editor-lang="language" .......... />
TEXTAREA COME EDITOR HTML
Impostando a true l'attributo editor-web, l'oggetto visualizzerà un editor HTML.
<idtag typeobj="textarea" editor-web="true" .......... />
›› REFERENCE XML - TEXTAREA
Oggetto: TEXTAREA
<nome typeobj="textarea" attribute="valore".../>
Attributi:
debug
Attiva il debug dell'oggetto.
Valori consentiti: true,false
Valori di default: false
onclick
Codice associato all'evento onclick.
ondblclick
Codice associato all'evento ondblclick.
onmousedown
Codice associato all'evento onmousedown.
onmouseup
Codice associato all'evento onmouseup.
onmouseover
Codice associato all'evento onmouseover.
onmousemove
Codice associato all'evento onmousemove.
onmouseout
Codice associato all'evento onmouseout.
onkeypress
Codice associato all'evento onkeypress.
onkeydown
Codice associato all'evento onkeydown.
onkeyup
Codice associato all'evento onkeyup.
class
Nome della classe di stile utilizzata dall'oggetto.
style
Proprietà di stile.
lang
Specifica il codice della lingua utilizzata.
dir
Direzione del testo:
- LTR da sinistra a destra(default).
- RTL da destra a sinistra.
template
Nome del template utilizzato dall'oggetto, se non specificato viene utilizzato quello di sistema.
title
Informazioni aggiuntive visualizzate al passaggio del mouse sull'oggetto istanziato.
id
Nome univoco dell'oggetto.
Valori di default: textarea
name
Nome dell'oggetto.
cols
Larghezza espressa il colonne.
Valori di default: 30
rows
Altezza espressa in righe.
Valori di default: 5
alt
Testo alternativo.
src
URL immagine.
accesskey
Assegna un tasto per accedere all'oggetto.
onfocus
Codice associato all'evento onfocus.
onselect
Codice associato all'evento onselect.
onblur
Codice associato all'evento onblur.
onchange
Codice associato all'evento onchange.
tabindex
Indice di tabulazione.
value
Vedi TAG VALUE
Valore dell'oggetto.
width
Larghezza dell'oggetto (con unità di misura es: 600px).
height
Altezza dell'oggetto (con unità di misura es: 600px).
label
Etichetta dell'oggetto.
labelalign
Allineamento etichetta rispetto all'oggetto
Valori consentiti: left,right
Valori di default: left
labelwidth
Larghezza dell'etichetta.
labelstyle
Stile associato all'etichetta.
java
Nome del/dei file javascript usati dall'oggetto.
Valori di default: textarea.js, regexp.js, format.js
dsobj
ID dell'oggetto datasource associato.
dsitem
Nome del campo datasource associato.
display
ID dell'oggetto che visualizza/nasconde la textarea.
Es. "display"="tabs1"
L'init della textarea (solo nella modalità codepress) avverà solamente alla chiamata della funzione tabs1Display().
Per un corretto funzionamento della textarea l'inizializzazione deve avvenire quando la textarea non è nascosta dal css. Non è necessario impostare questo valore poichè viene ereditato automaticamente in base all'oggetto in cui si trova la textarea.
keypress
Consente di filtrare i caratteri digitati.
blur
Consente di validare il testo digitato durante l'evento onblur.
format
Vedi Formattazione
Style di formattazione.
minlength
Cosente di specificare la lunghezza minima del testo.
maxlength
Numero massimo di caratteri accettati.
disabled
Disabilita l'oggetto
Valori consentiti: true,false
readonly
Oggetto in sola lettura.
Valori consentiti: true,false
editor-web
Attiva l'editor HTML.
Valori consentiti: true,false
editor-file
Percorso del file da caricare nell'editor highlight
editor-lang
Sintassi riconosciuta dall'editor highlight.
Valori consentiti: csharp,css,generic,html,java,javascript,perl,ruby,php,text,sql,vbscript,jamp
›› Elenco dei metodi Javascript intercettabili dall'utente:
Sintassi JS: SYSTEMEVENT.addBeforeCustomFunction("TEXTAREA","setDsValue", "User function"); Function parameters: function(obj,value)
Sintassi JS: SYSTEMEVENT.addBeforeCustomFunction("TEXTAREA","getDsValue", "User function"); Function parameters: function(id)
Sintassi JS: SYSTEMEVENT.addBeforeCustomFunction("TEXTAREA","checkDsValue", "User function"); Function parameters: function(obj)
Sintassi JS: SYSTEMEVENT.addBeforeCustomFunction("TEXTAREA","refreshObj", "User function"); Function parameters: function(id)
Sintassi JS: SYSTEMEVENT.addAfterCustomFunction("TEXTAREA","setDsValue", "User function"); Function parameters: function(obj,value)
Sintassi JS: SYSTEMEVENT.addAfterCustomFunction("TEXTAREA","getDsValue", "User function"); Function parameters: function(id)
Sintassi JS: SYSTEMEVENT.addAfterCustomFunction("TEXTAREA","checkDsValue", "User function"); Function parameters: function(obj)
Sintassi JS: SYSTEMEVENT.addAfterCustomFunction("TEXTAREA","refreshObj", "User function"); Function parameters: function(id)
›› Note fornite dagli utenti
Toolbar per Codepress
Scritto da: ruben
E' possibile utilizzare il dsnav come toolbar per la textarea in modalità codepress.
La textarea ha come id "code".
I metodi del codepress richiamabili diventono:
- code_cp.edit('other_textarea_id','language') Carica o edita il codice della textarea
- code_cp.getCode() Preleva il codice dall'editor
- code_cp.setCode("codice") Scrive in codice nell'editor
- code_cp.editor.syntaxHighlight(); Colora la sintassi
- code_cp.toggleEditor() Attiva o disattiva l'editor
- code_cp.toggleLineNumbers() Visualizza o nasconde il numero delle righe
- code_cp.toggleReadOnly() Attiva o disattiva la modalità solo lettura
- code_cp.toggleAutoComplete() Attiva o disattiva l'autocompletamento
Esempio:
<jamp>
<page typeobj="page" title="JDevelop" loaddata="true">
<dsnav typeobj="dsnav">
<button>
<bt onclick="Save();" image="img/save.png" title="Salva"/>
<bt onclick="code_cp.toggleLineNumbers();" image="./img/line.png" title="Visualizza/Nascondi Righe"/>
<bt onclick="code_cp.toggleAutoComplete();" image="./img/auto.png" title="Attiva/Disattiva Autocompletamento"/>
<bt onclick="Reload();" image="img/reload.png" title="Ricarica"/>
</button>
</dsnav>
<code typeobj="textarea" width="autosize" height="autosize" editor-lang="php" editor-file="./file.php"/>
</page>
</jamp>