Hiermee wordt bepaald of een veld verplicht is in een formulier of leeg kan worden gelaten.
De eigenschap nullTest kan voor validaties worden gebruikt. De validatie nullTest wordt alleen geëvalueerd als resultaat van validatie voor de gebeurtenis, zoals preSubmit, prePrint, preSave of preExecute, afhankelijk van de waarde van $config.present.validate, of een expliciete scriptaanroep van execValidate.
Een container wordt ongeldig na evaluatie van de eerste validatietest die is mislukt. Een container wordt geldig als geen validatietest mislukt. Een container is geldig als er geen validatietests worden geëvalueerd voor de container. In die validatiecontext wordt nullTest niet geëvalueerd en is er geen andere validatietest.
Een veld dat nu ongeldig is vanwege een nullTest-validatie, kan bijvoorbeeld weer geldig worden als er een waarde wordt ingevoerd. Als u teruggaat naar het veld en een lege waarde invoert, wordt de nullTest-validatie niet automatisch uitgevoerd, dus het veld zou weer geldig kunnen worden. Als u vervolgens probeert het formulier te verzenden, kan het veld weer ongeldig worden vanwege de nullTest.
Als de rawValue voor een veld null of leeg is, is denullTest-validatie mislukt.
Syntaxis
Reference_Syntax.nullTest = "disabled | error | warning"
Waarden
Type
|
Waarden
|
|---|
Tekenreeks
|
disabled (standaardwaarde)
error
warning
dismiss: de gebruiker begrijpt de aanbeveling voor het formulier en wil het formulier retourneren en rekening houden met deze beperking.
override: de gebruiker begrijpt de aanbeveling voor het formulier maar kiest ervoor geen rekening te houden met deze beperking.
Deze test niet uitvoeren (standaardwaarde). Het formulierobject mag de waarde null hebben. Als het veld geen waarde heeft, heeft dat geen negatieve gevolgen voor de geldigheid van het formulier. Met deze waarde wordt de validatietest uitgeschakeld.
error
warning
dismiss: de gebruiker begrijpt de aanbeveling voor het formulier en wil het formulier retourneren en rekening houden met deze beperking.
override: de gebruiker begrijpt de aanbeveling voor het formulier maar kiest ervoor geen rekening te houden met deze beperking.
Een foutbericht genereren en een leeg veld weigeren te accepteren. Het formulierobject mag niet de waarde null hebben.
warning
dismiss: de gebruiker begrijpt de aanbeveling voor het formulier en wil het formulier retourneren en rekening houden met deze beperking.
override: de gebruiker begrijpt de aanbeveling voor het formulier maar kiest ervoor geen rekening te houden met deze beperking.
Een waarschuwingsbericht genereren als het veld leeg is, maar de gebruiker toestaan naar het volgende veld te gaan. Het bericht moet de gebruiker informeren dat het wordt aanbevolen dat het formulierobject een waarde heeft en moet twee mogelijkheden bieden:
dismiss: de gebruiker begrijpt de aanbeveling voor het formulier en wil het formulier retourneren en rekening houden met deze beperking.
override: de gebruiker begrijpt de aanbeveling voor het formulier maar kiest ervoor geen rekening te houden met deze beperking.
|
JavaScript
TextField1.validate.nullTest = "error";
FormCalc
TextField1.validate.nullTest = "error"
