Esempio Online 1 Anteprima (sola lettura)
Sorgente PHP: examples/text/text.php
Sorgente XML: examples/text/text.xml

Esempio Online 2 Anteprima (sola lettura)
Sorgente PHP: examples/text/autocomplete.php
Sorgente XML: examples/text/auticomplete.xml

Sfruttando alcuni dei suoi attributi è possibile ottenere diverse modalità di funzionamento.
La text supporta la formattazione ed il controllo dell'input inserito dall'utente:


POPOLARE LA TEXT

Inserimento manuale dei dati:

<idtag typeobj="text" label="\nText:" value="valoretext"/>

In alternativa la text 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 contenete i dati da visualizzare
<idtag typeobj="text" label="\nText:" dsobj="dsname" dsitem="campotext" />

TEXT COME CAMPO PASSWORD

Nel caso in cui si voglia usare la text per l'inserimento di password basta utilizzare l'attributo password

<idtag typeobj="text" password="true" .......... />

TEXT COME CALENDARIO

Impostando nell'attributo format una stringa per la formattazione della data, l'oggetto visualizzerà il calendario alla pressione del mouse.

<idtag typeobj="text" format="date|IT|dd/mm/yyyy|IT|dd/mm/yyyy" ............ />

TEXT AUTOCOMPLETE

Impostando nell'attributo dsobjlist e dsitemlist si attiva la modalità autocomplete e si comunica all'oggetto la fonte dati utilizzata per completare i valori digitati. Impostando l'attibuto dssearch si imposta la query per il filtraggio dei dati. E' possibile utilizzare nel dssearch il 'TAG $$ID_xxx$$ per includere il valore istantaneo di un altro oggetto della pagina.

<idtag typeobj="text" dsobjlist="ds1" dsitemlist="tabella" dssearch="`campo` LIKE '$$VALUE$$%'" ............ />

TEXT PER L'UPLOAD DI FILE

L'oggetto text può essere anche utilizzato per l'upload di file da parte dell'utente. Gli attributi sono:

  • fileupload: attributo booleano per l'abilitazione dell'upload
  • rewrite: true sovrascrive il file se già presente, false non lo sovrascrive e rename assegna un'altro nome
  • target: attributo opzionale per specificare un eventuale frame di destinazione su cui inviare il post.
  • directory: attributo che specifica la path di destinazione dei file da uplodare (di default è la directory corrente), viceversa bisogna indicare il path relativo a partire dalla "DocumentRoot"(esempio se voglio memorizzare il file /var/www/appl/documents e la mia DocumentRoot = " /var/www" bisognerà mettere directory="/appl/documents/").

Per intercettare l'evento di upload del file bisogna inserire nel file php:

<?php
function html_load()
{
    global $event;
    $code = "
    function upload_posted()
    {
        alert('File Inviato: ' + TEXT.objposted.value);
    }
    SYSTEMEVENT.addAfterCustomFunction('TEXT', 'AfterPost', 'upload_posted');
    ";
    $event->setCodeJs($code);
}
?>

Problemi nell'upload dei files
1. Tutti gli upload verso il server web possono essere disabilitati tramite costante, per maggiori informazioni vedi costanti.
2. La directory di destinazione specificata non esiste/errata o comunque il servizio web non ha i permessi per scrivere al suo interno.
3. Per evitare il caricamento della pagina dopo l'upload il post viene effettuato su un iframe fittizio, in fase di debug per intercettare eventuali errori potrebbe essere utile impostare il target="framenonesistente" cos' da visualizzare l'errore.