Personalizzazione delle funzioni

Per maggiore flessibilità, è possibile creare funzioni JavaScript personalizzate per manipolare i dati in pagine e viste.
  • In una pagina, definisci la funzione JavaScript personalizzata in un HTML personalizzato, all'interno di tag <script> .
  • In una vista, definisci le funzioni JavaScript personalizzate nell'editor JavaScript Inline, in Behavior.

Utilizzo di parole chiave this e page

In JavaScript inline di una vista, la parola chiave this utilizza l'ambito del contesto di esecuzione globale iniziale, che significa che this fa riferimento alla vista stessa e può anche fare riferimento a qualsiasi vista nidificata al suo interno.

Nel seguente esempio, il modulo di collegamento ha una vista di testo e password definita nella pagina, con gli ID di controllo e. Nota come questo viene utilizzato in JavaScriptin linea. La funzionalità è definita nel contesto della vista this . Lo stesso vale per le variabili definite nella funzione.

La parola chiave page può essere utilizzata in un HTML personalizzato o nel JavaScript in linea di una vista. Pagina fa riferimento alla vista più in alto della pagina, il che significa che è possibile accedere alle viste nella pagina e anche alle viste nidificate al loro interno. Per le viste nidificate, è necessario definire i percorsi. Ad esempio, se si è tentato di accedere all'ID di controllo nella vista a livello di pagina, specificare il percorso come mostrato:

Si noti come questo metodo di definizione di una funzione non utilizzi una parola chiave che precede il nome della funzione poiché la funzione non è ambigua a livello di pagina. Inoltre, notare come viene utilizzata la parola chiave page invece di thise il percorso da definire nella funzione. Nell'esempio, è l'ID di controllo della vista ed è l'ID di controllo del testo.

Richiamo di funzioni personalizzate

Dopo aver definito una funzione utilizzando uno dei metodi descritti in precedenza, è possibile accedere alla funzione tramite i gestori eventi di qualsiasi vista. Per richiamare una funzione, utilizzare o nelle opzioni di configurazione del gestore eventi. Nel seguente esempio, la funzione personalizzata viene aggiunta al gestore eventi di un pulsante.

Quando una funzione viene definita a più livelli, ad esempio, sia nella pagina che nella vista, la versione richiamata è quella più vicina alla vista. In questo esempio, poiché è definito sia a livello di pagina che di vista, la versione che viene richiamata è quella definita nella vista stessa. Vengono ricercate prima le funzioni definite allo stesso livello della chiamata, quindi la ricerca si sposta in alto in modo sequenziale attraverso i livelli fino a trovare la funzione definita.

In una vista composita, le funzioni definite per la vista composita sono preferite rispetto alle funzioni con lo stesso nome definite in un HTML personalizzato o in una casella di contenuto nella pagina. Inoltre, se è presente una vista intermedia con una casella di contenuto che ha la stessa funzione denominata, la funzione nella vista intermedia viene richiamata invece della funzione nell'elemento principale effettivo. La vista foglia non sa se la casella del contenuto ha tale funzione. Se si chiama la funzione sbagliata, non funziona. Questo comportamento può causare problemi quando, ad esempio, uno sviluppatore utilizza un toolkit pronto che include, per caso, la vista con la casella del contenuto che ha la stessa funzione denominata.
Importante: per evitare conflitti o conflitti di nomi, utilizzare nomi funzione univoci aggiungendo prefissi o suffissi alle funzioni definite in una vista composita.

Creazione di funzioni personalizzate con parametri

Una funzione personalizzata può anche essere passata in argomenti, il che la rende riutilizzabile in altri tipi di viste. Un metodo comunemente utilizzato in molte viste è setLabel. È possibile creare una singola funzione con un parametro.

Alla funzione changeLabel è stato fornito il parametro. È quindi possibile richiamare un metodo su tale controllo. In questo caso, è stato chiamato il metodo setLabel per modificare l'etichetta. Per richiamare la funzione changeLabel , è possibile richiamarla da uno degli eventi di una vista.

È stata aggiunta una vista di testo, che richiama la funzione changeLabel dall'evento. La funzione non necessita di un argomento inoltrato poiché la visualizzazione del controllo viene sempre inoltrata come primo argomento. Finché la vista ha il metodo richiamato nella funzione personalizzata, la funzione personalizzata funzionerà con vari tipi di viste.

Per ulteriori informazioni sui metodi disponibili, vedi UI toolkit JavaScript API.