Kontrollerar om ett fält är obligatoriskt på ett formulär eller om det kan lämnas tomt.
Egenskapen nullTest kan användas för validering. En nullTest-validering utvärderas enbart som ett resultat av en validering före händelsen, t.ex. preSubmit, prePrint, preSave, eller preExecute, beroende på värdet för $config.present.validate, eller ett uttryckligt skriptanrop till execValidate.
En behållare blir ogiltig som resultat av utvärdering av det första valideringstestet som misslyckas. En behållare blir giltig om inget valideringstest misslyckas. En behållare är giltig om inget valideringstest utvärderas för behållaren. I valideringskontexten utvärderas inte nullTest och det förekommer inget annat valideringstest.
Ett fält som för tillfället är ogilitigt pga en nullTest-validering kan bli giltigt som följd av att ett värde anges. Om du går tillbaka till fältet och anger ett tomt värde körs inte nullTest-valideringen automatiskt, så fältet kan bli giltigt igen. Senare försök att skicka formuläret skulle göra att fältet blir giltigt igen tack vare nullTest.
Om rawValue för ett fält är null eller tomt misslyckas nullTest-valideringen.
Syntax
Reference_Syntax.nullTest = "disabled | error | warning"
Värden
Typ
|
Värden
|
Sträng
|
inaktiverad (standard)
fel
varning
dismiss: Användaren förstår formulärets rekommendation och vill returnera formuläret och lyda den här begränsningen.
override: Användaren förstår formulärets rekommendation men väljer att gå emot den här begränsningen.
Inget test utförs (standard). Formulärobjektet tillåts att ha värdet null. Fältet kan lämnas utan ett värde och det kommer inte att ha en negativ påverkan på formulärets validitet. Det här värdet inaktiverar valideringstestet.
fel
varning
dismiss: Användaren förstår formulärets rekommendation och vill returnera formuläret och lyda den här begränsningen.
override: Användaren förstår formulärets rekommendation men väljer att gå emot den här begränsningen.
Sänder ett felmeddelande och vägrar acceptera ett tomt fält. Formulärobjektet måste ha ett värde som inte är null.
varning
dismiss: Användaren förstår formulärets rekommendation och vill returnera formuläret och lyda den här begränsningen.
override: Användaren förstår formulärets rekommendation men väljer att gå emot den här begränsningen.
Sänder ett varningsmeddelande om fältet är tomt men användaren tillåts att fortsätta till nästa fält. Meddelandet måste informera användaren om att formulärobjektet bör ha ett värde, vilket ger två möjligheter:
dismiss: Användaren förstår formulärets rekommendation och vill returnera formuläret och lyda den här begränsningen.
override: Användaren förstår formulärets rekommendation men väljer att gå emot den här begränsningen.
|
JavaScript
TextField1.validate.nullTest = "error";
FormCalc
TextField1.validate.nullTest = "error"