Determina se un campo di un modulo è obbligatorio o può essere lasciato vuoto.
La proprietà nullTest può essere utilizzata per le convalide. Una convalida nullTest viene esaminata solo come risultato di una convalida precedente all'evento, ad esempio preSubmit, prePrint, preSave o preExecute, in base al valore di $config.present.validate o ad una chiamata script esplicita a execValidate.
La prima verifica di convalida che restituisce un esito negativo comporta la perdita di validità del contenitore. Se tutte le verifiche di convalida restituiscono un esito positivo, il contenitore risulta valido. Se su un contenitore non viene eseguita alcuna verifica di convalida, tale contenitore risulta valido. In questa situazione di convalida non viene eseguito l'esame di nullTest e non sono previste ulteriori verifiche di convalida.
Ad esempio, un campo contrassegnato come non valido a causa di una convalida nullTest potrebbe diventare valido in seguito all'immissione di un valore. Se si torna a tale campo e si immette un valore, la convalida nullTest non viene eseguita automaticamente, pertanto lo stato del campo non diventa valido. Se si esegue un tentativo successivo di invio del modulo, il campo viene contrassegnato di nuovo come non valido a causa della convalida nullTest.
Se il valore rawValue di un campo è null o se il campo è vuoto, la convalida nullTest restituisce un esito negativo.
Sintassi
Reference_Syntax.nullTest = "disabled | error | warning"
Valori
Tipo
|
Valori
|
|---|
Stringa
|
disabled (predefinito)
errore
avviso
dismiss: l'utente ha compreso l'avvertenza e desidera tornare al modulo per soddisfare la limitazione.
override: l'utente ha capito l'avvertenza, ma non desidera soddisfare la limitazione.
Non eseguire questa verifica (predefinito). All'oggetto modulo è consentito avere un valore null. È possibile lasciare il campo privo di valori senza che questo influisca in modo negativo sulla validità del modulo. Tale valore disattiva il test di convalida.
errore
avviso
dismiss: l'utente ha compreso l'avvertenza e desidera tornare al modulo per soddisfare la limitazione.
override: l'utente ha capito l'avvertenza, ma non desidera soddisfare la limitazione.
Visualizza un errore e rifiuta di accettare un campo vuoto. All'oggetto modulo viene richiesto un valore non nullo.
avviso
dismiss: l'utente ha compreso l'avvertenza e desidera tornare al modulo per soddisfare la limitazione.
override: l'utente ha capito l'avvertenza, ma non desidera soddisfare la limitazione.
Visualizza un messaggio di avviso quando il campo è vuoto, ma consente all'utente di passare al campo successivo. Il messaggio deve informare l'utente che l'oggetto modulo deve avere un valore e fornire due opzioni:
dismiss: l'utente ha compreso l'avvertenza e desidera tornare al modulo per soddisfare la limitazione.
override: l'utente ha capito l'avvertenza, ma non desidera soddisfare la limitazione.
|
JavaScript
TextField1.validate.nullTest = "error";
FormCalc
TextField1.validate.nullTest = "error"
