mavimo

Nella creazione di form può essere necessario procede con passi successivi in una serie di scelte, questo comporta una perdita di tempo per gli utenti e quindi è molto comodo sfruttare le potenzialità offerte da ajax per effettuare questi passaggi in cascata senza dover andare a ricaricare la pagina.

Andiamo a vedere come effettuare questo usando gli AHAH form di Drupal, che consentono di mantenere sufficientemente sicure le informazioni che transitano ma comunque alleggerendo il carico di lavoro per il server; per capire il risultato che vogliamo ottenere andiamo a vedere questa pagina.

Innanzitutto dovremmo creare un nuovo modulo, di conseguenza andiamo a creare i tre file richiesti (*.info, *.install e *.module) e proseguiamo con la creazione del modulo. Ora ci soffermeremo solo sugli elementi necessari alla creazione di form ahah, quindi tralasceremo tutte le parti "inutili".

Iniziamo creando, usando l'hook_menu, i path necessari; nel nostro caso ne abbiamo due, il rpimo in cui verrà presentato il primo form e il secondo che serve invece a far transitare i dati asincroni. Per fare questo andiamo ad inserire:

come vedete le due voci di menu richiamano due differenti pagine; la prima voce genera un form usando al funzione drupal_get_form, e come argomento usa il form che deve essere generato, mentre la seconda è la funzione che restituirà i dati tramite JSON; da notare che in questo caso si tratta ti una cove di menu di tipo MENU_CALLBACK.

Il secondo passaggio riguarda la generazione del form iniziale, non ci soffermiamo su questo, usando le FAPI ho inserito un paio di select, la prima con tre valori fissi, mentre la seconda con un unico valore di default, mentre gli altri devono essere caricati al volo. Per genrare il nostro form usiamo:

Focalizziamo la nostra attenzione sul primo eleemnto del form, se facciamo attenzione notiamo che è presente una voce particolare, la voce #ahah che rappresenta un array di dati. Il primo elemento dell'array (path) contiene l'indirizzo da cui verranno caricati i dati, mentre la voce wrapper indica quale sarà l'oggetto su cui verranno inserite le modifiche. Nel nostro caso il secondo elemento è racchiuso, usando prefix e suffix, in un div con un ID specifico, quindi quando verrà sostituito il contenuto del div in realtà verrà sostituito il select vero e proprio.

La funzione che si occupa di caricare i dati, invece, è quella che ci interessa maggiormente; questa funzione è stata divisa per comodità in due parti, vediamo la prima:

In questo caso usando i dati di $_POST viene recuperato il valore dell'elemento che genera la chiamata (all'evento onchange), e usando questa informazione viene creato il nuovo elemento da inserire nel form. In questo caso ci siamom limitati a cambiare i nomi delle voci, ma potrebbe essere possibile andare a caricare dati dal database e fare una serie di operazioni prima di mostrare il risultato.

Una volta creato l'elemento viene richiamata la funzione ahah_field_render, la seconda parte del nostro script che analizzeremo dopo, e dopo questa chiamata viene renderizzato l'elemento del form che verrà inviato tramite AJAX prima di terminarne l'esecuzione.

Prima di proseguire, però, vediamo come funziona un form in Drupal:

1. Il form generato viene messo in cache prima di inviarlo all'utente.
2. L'utente reinvia il form e il sistema lo confronta con quello in cache.
3. Se il form in cache è diverso da quello restituito il sistema se ne accorge e lo rifiuta presupponendo che si tratta di un tentativo di inectjon

La funzione ahah_field_render permette di afre proprio questo, modiicare il form in cache, andando a sostituire il field con nome $name con l'elemento da noi generato:

Se per caso il nostro sistema si limitasse a modificare il form lato client quando viene fatto il submit il form in cache non corrisponderà e verrà rifiutato, per questo ad ogni invio il form deve essere modificato anche nella cache. La funzione è (spero) ben commentata e quindi non richiede specifiche informazioni e credo possa essere ben compresa, in caso di richieste di chiarimenti scrivete pure nei commenti.

In alegato trovate il modulo di test. Sono state volutamente escluse tute le funzioni inutili (salvataggio dati, ....) in modo da concentrarsi sull'obbiettivo principale.