CNumberValidator
鍖 | system.validators |
---|---|
缁ф壙 | class CNumberValidator » CValidator » CComponent |
婧愯嚜 | 1.0 |
鐗堟湰 | $Id: CNumberValidator.php 3491 2011-12-17 05:17:57Z jefftulsa $ |
婧愮爜 | framework/validators/CNumberValidator.php |
CNumberValidator楠岃瘉姝ゅ睘鎬х殑鍊兼槸涓涓暟瀛椼
闄や簡浣跨敤message灞炴ц缃竴涓嚜瀹氫箟閿欒鎻愮ず淇℃伅涔嬪锛 CNumberValidator杩樻湁涓瀵硅嚜瀹氫箟閿欒鎻愮ず淇℃伅锛屼綘鍙互閽堝涓嶅悓 鐨勯獙璇佹儏鏅ā寮忓垎鍒娇鐢ㄣ傝涓轰竴涓お澶х殑鏁板兼寚瀹氳嚜瀹氫箟閿欒鎻 绀轰俊鎭紝浣犲彲浠ヤ娇鐢tooBig灞炴с傜被浼煎湴鏈tooSmall銆 鎻愮ず淇℃伅鍙互鍖呭惈鍗犱綅绗︼紝鍗犱綅绗﹀彲浠ヨ瀹為檯鍐呭鏇挎崲銆 闄や簡鎵鏈夐獙璇佸櫒鍧囧彲璇嗗埆鐨 "{attribute}" 鍗犱綅绗﹀锛 CNumberValidator杩樺厑璁告寚瀹氫笅鍒 鍗犱綅绗︼細
闄や簡浣跨敤message灞炴ц缃竴涓嚜瀹氫箟閿欒鎻愮ず淇℃伅涔嬪锛 CNumberValidator杩樻湁涓瀵硅嚜瀹氫箟閿欒鎻愮ず淇℃伅锛屼綘鍙互閽堝涓嶅悓 鐨勯獙璇佹儏鏅ā寮忓垎鍒娇鐢ㄣ傝涓轰竴涓お澶х殑鏁板兼寚瀹氳嚜瀹氫箟閿欒鎻 绀轰俊鎭紝浣犲彲浠ヤ娇鐢tooBig灞炴с傜被浼煎湴鏈tooSmall銆 鎻愮ず淇℃伅鍙互鍖呭惈鍗犱綅绗︼紝鍗犱綅绗﹀彲浠ヨ瀹為檯鍐呭鏇挎崲銆 闄や簡鎵鏈夐獙璇佸櫒鍧囧彲璇嗗埆鐨 "{attribute}" 鍗犱綅绗﹀锛 CNumberValidator杩樺厑璁告寚瀹氫笅鍒 鍗犱綅绗︼細
鍏叡灞炴
灞炴 | 绫诲瀷 | 鎻忚堪 | 瀹氫箟鍦 |
---|---|---|---|
allowEmpty | boolean | 鏄惁姝ゅ睘鎬у煎厑璁镐负null鎴杄mpty銆傞粯璁ゅ兼槸true锛 琛ㄧず濡傛灉姝ゅ睘鎬у间负绌烘椂瀹冨皢閫氳繃楠岃瘉銆 | CNumberValidator |
attributes | array | 闇瑕佽楠岃瘉鐨勫睘鎬х殑鍒楄〃銆 | CValidator |
builtInValidators | array | 鍐呯疆楠岃瘉鍣ㄥ垪琛 (name=>class) | CValidator |
enableClientValidation | boolean | 鏄惁鎵ц瀹㈡埛绔獙璇併傞粯璁ゅ间负true銆 鍙傝CActiveForm::enableClientValidation浠ヤ簡瑙f洿澶氬叧浜庡鎴风楠岃瘉鐨勭粏鑺傘 | CValidator |
integerOnly | boolean | 鏄惁姝ゅ睘鎬у间粎鍏佽鏁存暟銆傞粯璁ゅ兼槸false銆 | CNumberValidator |
integerPattern | string | 鍖归厤鏁存暟鐨勬鍒欒〃杈惧紡銆 | CNumberValidator |
max | integer|float | 鏁板肩殑涓婇檺銆傞粯璁ゅ兼槸null锛岃〃绀烘病鏈変笂闄愩 | CNumberValidator |
message | string | 鐢ㄦ埛鑷畾涔夌殑閿欒鎻愮ず淇℃伅銆備笉鍚岀殑楠岃瘉鍣ㄥ彲浠ュ湪璇ヤ俊鎭腑 瀹氫箟鍚勭鍗犱綅绗︼紙灏嗚瀹為檯鍊兼浛鎹級銆傚崰浣嶇鈥渰attribute}鈥濆彲浠ヨ鎵鏈 楠岃瘉鍣ㄨ瘑鍒紝瀹冧細琚娇鐢ㄥ睘鎬х殑鏍囩鏉ユ浛鎹€ | CValidator |
min | integer|float | 鏁板肩殑涓婇檺銆傞粯璁ゅ兼槸null锛岃〃绀烘病鏈変笅闄愩 | CNumberValidator |
numberPattern | string | the 鍖归厤鏁板肩殑姝e垯琛ㄨ揪寮忋 | CNumberValidator |
on | array | 楠岃瘉鍣ㄥ皢琚簲鐢ㄥ埌鐨勬儏鏅ā寮忕殑鍒楄〃銆 鏁扮粍鐨勯敭-鍊奸兘鏄儏鏅ā寮忕殑鍚嶇О銆 | CValidator |
safe | boolean | 杩涜鏁村潡璧嬪兼槸鏄惁鑰冭檻姝ら獙璇佸櫒涓垪鍑虹殑灞炴х殑瀹夊叏鎬с 榛樿鍊间负true銆 | CValidator |
skipOnError | boolean | 濡傛灉褰撳墠灞炴у凡缁忓瓨鍦ㄩ獙璇侀敊璇紝杩欎釜楠岃瘉瑙勫垯 鏄惁璺宠繃銆傞粯璁ゅ兼槸false銆 | CValidator |
tooBig | string | 褰撴暟鍊煎お澶ф椂浣跨敤鐨勭敤鎴疯嚜瀹氫箟閿欒鎻愮ず淇℃伅銆 | CNumberValidator |
tooSmall | string | 褰撴暟鍊煎お灏忔椂浣跨敤鐨勭敤鎴疯嚜瀹氫箟閿欒鎻愮ず淇℃伅銆 | CNumberValidator |
鍏叡鏂规硶
鍙椾繚鎶ゆ柟娉
鏂规硶 | 鎻忚堪 | 瀹氫箟鍦 |
---|---|---|
addError() | 娣诲姞鍏充簬鎸囧畾灞炴х殑涓涓敊璇彁绀轰俊鎭埌娲诲姩璁板綍涓 | CValidator |
isEmpty() | 妫娴嬬粰瀹氬兼槸鍚︿负绌恒 | CValidator |
validateAttribute() | 楠岃瘉浼犲叆瀵硅薄鐨勫睘鎬с | CNumberValidator |
灞炴ц缁
allowEmpty
灞炴
public boolean $allowEmpty;
鏄惁姝ゅ睘鎬у煎厑璁镐负null鎴杄mpty銆傞粯璁ゅ兼槸true锛 琛ㄧず濡傛灉姝ゅ睘鎬у间负绌烘椂瀹冨皢閫氳繃楠岃瘉銆
integerOnly
灞炴
public boolean $integerOnly;
鏄惁姝ゅ睘鎬у间粎鍏佽鏁存暟銆傞粯璁ゅ兼槸false銆
integerPattern
灞炴
锛堝彲鐢ㄨ嚜 v1.1.7锛
public string $integerPattern;
鍖归厤鏁存暟鐨勬鍒欒〃杈惧紡銆
max
灞炴
public integer|float $max;
鏁板肩殑涓婇檺銆傞粯璁ゅ兼槸null锛岃〃绀烘病鏈変笂闄愩
min
灞炴
public integer|float $min;
鏁板肩殑涓婇檺銆傞粯璁ゅ兼槸null锛岃〃绀烘病鏈変笅闄愩
numberPattern
灞炴
锛堝彲鐢ㄨ嚜 v1.1.7锛
public string $numberPattern;
the 鍖归厤鏁板肩殑姝e垯琛ㄨ揪寮忋
tooBig
灞炴
public string $tooBig;
褰撴暟鍊煎お澶ф椂浣跨敤鐨勭敤鎴疯嚜瀹氫箟閿欒鎻愮ず淇℃伅銆
tooSmall
灞炴
public string $tooSmall;
褰撴暟鍊煎お灏忔椂浣跨敤鐨勭敤鎴疯嚜瀹氫箟閿欒鎻愮ず淇℃伅銆
鏂规硶璇︾粏
clientValidateAttribute()
鏂规硶
锛堝彲鐢ㄨ嚜 v1.1.7锛
public string clientValidateAttribute(CModel $object, string $attribute)
| ||
$object | CModel | 闇瑕侀獙璇佺殑瀵硅薄 |
$attribute | string | 闇瑕侀獙璇佺殑灞炴 |
{return} | string | 瀹㈡埛绔獙璇佽剼鏈 |
婧愮爜锛 framework/validators/CNumberValidator.php#118 (鏄剧ず)
public function clientValidateAttribute($object,$attribute)
{
$label=$object->getAttributeLabel($attribute);
if(($message=$this->message)===null)
$message=$this->integerOnly ? Yii::t('yii','{attribute} must be an integer.') : Yii::t('yii','{attribute} must be a number.');
$message=strtr($message, array(
'{attribute}'=>$label,
));
if(($tooBig=$this->tooBig)===null)
$tooBig=Yii::t('yii','{attribute} is too big (maximum is {max}).');
$tooBig=strtr($tooBig, array(
'{attribute}'=>$label,
'{max}'=>$this->max,
));
if(($tooSmall=$this->tooSmall)===null)
$tooSmall=Yii::t('yii','{attribute} is too small (minimum is {min}).');
$tooSmall=strtr($tooSmall, array(
'{attribute}'=>$label,
'{min}'=>$this->min,
));
$pattern=$this->integerOnly ? $this->integerPattern : $this->numberPattern;
$js="
if(!value.match($pattern)) {
messages.push(".CJSON::encode($message).");
}
";
if($this->min!==null)
{
$js.="
if(value<{$this->min}) {
messages.push(".CJSON::encode($tooSmall).");
}
";
}
if($this->max!==null)
{
$js.="
if(value>{$this->max}) {
messages.push(".CJSON::encode($tooBig).");
}
";
}
if($this->allowEmpty)
{
$js="
if($.trim(value)!='') {
$js
}
";
}
return $js;
}
杩斿洖鎵ц瀹㈡埛绔獙璇佹墍闇鐨凧avaScript銆
validateAttribute()
鏂规硶
protected void validateAttribute(CModel $object, string $attribute)
| ||
$object | CModel | 闇瑕侀獙璇佺殑瀵硅薄 |
$attribute | string | 闇瑕侀獙璇佺殑灞炴 |
婧愮爜锛 framework/validators/CNumberValidator.php#77 (鏄剧ず)
protected function validateAttribute($object,$attribute)
{
$value=$object->$attribute;
if($this->allowEmpty && $this->isEmpty($value))
return;
if($this->integerOnly)
{
if(!preg_match($this->integerPattern,"$value"))
{
$message=$this->message!==null?$this->message:Yii::t('yii','{attribute} must be an integer.');
$this->addError($object,$attribute,$message);
}
}
else
{
if(!preg_match($this->numberPattern,"$value"))
{
$message=$this->message!==null?$this->message:Yii::t('yii','{attribute} must be a number.');
$this->addError($object,$attribute,$message);
}
}
if($this->min!==null && $value<$this->min)
{
$message=$this->tooSmall!==null?$this->tooSmall:Yii::t('yii','{attribute} is too small (minimum is {min}).');
$this->addError($object,$attribute,$message,array('{min}'=>$this->min));
}
if($this->max!==null && $value>$this->max)
{
$message=$this->tooBig!==null?$this->tooBig:Yii::t('yii','{attribute} is too big (maximum is {max}).');
$this->addError($object,$attribute,$message,array('{max}'=>$this->max));
}
}
楠岃瘉浼犲叆瀵硅薄鐨勫睘鎬с 濡傛灉瀛樺湪浠讳綍楠岃瘉閿欒锛岄敊璇彁绀轰俊鎭皢琚坊鍔犲埌姝ゅ璞′腑銆