CRequiredValidator
鍖 | system.validators |
---|---|
缁ф壙 | class CRequiredValidator » CValidator » CComponent |
婧愯嚜 | 1.0 |
鐗堟湰 | $Id: CRequiredValidator.php 3515 2011-12-28 12:29:24Z mdomba $ |
婧愮爜 | framework/validators/CRequiredValidator.php |
CRequiredValidator楠岃瘉鎸囧畾鐨勫睘鎬х殑鍊间笉涓簄ull鎴杄mpty銆
褰撲娇鐢message灞炴ц嚜瀹氫箟閿欒鎻愮ず淇℃伅鏃讹紝璇ヤ俊鎭彲浠 鍗犱綅绗︼紝鍗犱綅绗﹀彲浠ヨ瀹為檯鍐呭鏇挎崲銆傞櫎浜嗘墍鏈夐獙璇佸櫒鍧囧彲璇嗗埆鐨 "{attribute}" 鍗犱綅绗(鍙傝CValidator)澶栵紝 CRequiredValidator杩樺厑璁告寚瀹氫笅鍒楀崰浣嶇锛
褰撲娇鐢message灞炴ц嚜瀹氫箟閿欒鎻愮ず淇℃伅鏃讹紝璇ヤ俊鎭彲浠 鍗犱綅绗︼紝鍗犱綅绗﹀彲浠ヨ瀹為檯鍐呭鏇挎崲銆傞櫎浜嗘墍鏈夐獙璇佸櫒鍧囧彲璇嗗埆鐨 "{attribute}" 鍗犱綅绗(鍙傝CValidator)澶栵紝 CRequiredValidator杩樺厑璁告寚瀹氫笅鍒楀崰浣嶇锛
- {value}: 浣跨敤鏈熸湜鐨勫兼浛鎹requiredValue銆
鍏叡灞炴
灞炴 | 绫诲瀷 | 鎻忚堪 | 瀹氫箟鍦 |
---|---|---|---|
attributes | array | 闇瑕佽楠岃瘉鐨勫睘鎬х殑鍒楄〃銆 | CValidator |
builtInValidators | array | 鍐呯疆楠岃瘉鍣ㄥ垪琛 (name=>class) | CValidator |
enableClientValidation | boolean | 鏄惁鎵ц瀹㈡埛绔獙璇併傞粯璁ゅ间负true銆 鍙傝CActiveForm::enableClientValidation浠ヤ簡瑙f洿澶氬叧浜庡鎴风楠岃瘉鐨勭粏鑺傘 | CValidator |
message | string | 鐢ㄦ埛鑷畾涔夌殑閿欒鎻愮ず淇℃伅銆備笉鍚岀殑楠岃瘉鍣ㄥ彲浠ュ湪璇ヤ俊鎭腑 瀹氫箟鍚勭鍗犱綅绗︼紙灏嗚瀹為檯鍊兼浛鎹級銆傚崰浣嶇鈥渰attribute}鈥濆彲浠ヨ鎵鏈 楠岃瘉鍣ㄨ瘑鍒紝瀹冧細琚娇鐢ㄥ睘鎬х殑鏍囩鏉ユ浛鎹€ | CValidator |
on | array | 楠岃瘉鍣ㄥ皢琚簲鐢ㄥ埌鐨勬儏鏅ā寮忕殑鍒楄〃銆 鏁扮粍鐨勯敭-鍊奸兘鏄儏鏅ā寮忕殑鍚嶇О銆 | CValidator |
requiredValue | mixed | 姝ゅ睘鎬у繀椤昏緭鍏ョ殑鏈熸湜鐨勫笺 濡傛灉璁剧疆涓簄ull锛岄獙璇佸櫒灏嗛獙璇佹寚瀹氱殑灞炴у间笉涓簄ull鎴杄mpty銆 濡傛灉璁剧疆涓轰笉鏄痭ull鐨勫硷紝楠岃瘉鍣ㄥ皢楠岃瘉 姝ゅ睘鎬х殑鍊间笌璁剧疆鐨勫肩浉鍚屻 榛樿鍊兼槸null銆 | CRequiredValidator |
safe | boolean | 杩涜鏁村潡璧嬪兼槸鏄惁鑰冭檻姝ら獙璇佸櫒涓垪鍑虹殑灞炴х殑瀹夊叏鎬с 榛樿鍊间负true銆 | CValidator |
skipOnError | boolean | 濡傛灉褰撳墠灞炴у凡缁忓瓨鍦ㄩ獙璇侀敊璇紝杩欎釜楠岃瘉瑙勫垯 鏄惁璺宠繃銆傞粯璁ゅ兼槸false銆 | CValidator |
strict | boolean | 鏄惁涓requiredValue杩涜涓ユ牸姣旇緝銆 濡傛灉璁剧疆涓簍rue锛屾灞炴х殑鍊间笌绫诲瀷閮藉繀椤讳笌requiredValue鐩稿悓銆 榛樿鍊兼槸false锛岃〃绀哄彧闇瑕佸肩浉鍚屽嵆鍙 姝ゅ弬鏁颁粎鍦requiredValue涓嶄负null鏃惰浣跨敤銆 | CRequiredValidator |
鍏叡鏂规硶
鍙椾繚鎶ゆ柟娉
鏂规硶 | 鎻忚堪 | 瀹氫箟鍦 |
---|---|---|
addError() | 娣诲姞鍏充簬鎸囧畾灞炴х殑涓涓敊璇彁绀轰俊鎭埌娲诲姩璁板綍涓 | CValidator |
isEmpty() | 妫娴嬬粰瀹氬兼槸鍚︿负绌恒 | CValidator |
validateAttribute() | 楠岃瘉浼犲叆瀵硅薄鐨勫睘鎬с | CRequiredValidator |
灞炴ц缁
requiredValue
灞炴
public mixed $requiredValue;
姝ゅ睘鎬у繀椤昏緭鍏ョ殑鏈熸湜鐨勫笺 濡傛灉璁剧疆涓簄ull锛岄獙璇佸櫒灏嗛獙璇佹寚瀹氱殑灞炴у间笉涓簄ull鎴杄mpty銆 濡傛灉璁剧疆涓轰笉鏄痭ull鐨勫硷紝楠岃瘉鍣ㄥ皢楠岃瘉 姝ゅ睘鎬х殑鍊间笌璁剧疆鐨勫肩浉鍚屻 榛樿鍊兼槸null銆
strict
灞炴
public boolean $strict;
鏄惁涓requiredValue杩涜涓ユ牸姣旇緝銆 濡傛灉璁剧疆涓簍rue锛屾灞炴х殑鍊间笌绫诲瀷閮藉繀椤讳笌requiredValue鐩稿悓銆 榛樿鍊兼槸false锛岃〃绀哄彧闇瑕佸肩浉鍚屽嵆鍙 姝ゅ弬鏁颁粎鍦requiredValue涓嶄负null鏃惰浣跨敤銆
鏂规硶璇︾粏
clientValidateAttribute()
鏂规硶
锛堝彲鐢ㄨ嚜 v1.1.7锛
public string clientValidateAttribute(CModel $object, string $attribute)
| ||
$object | CModel | 闇瑕侀獙璇佺殑瀵硅薄 |
$attribute | string | 闇瑕侀獙璇佺殑灞炴 |
{return} | string | 瀹㈡埛绔獙璇佽剼鏈 |
婧愮爜锛 framework/validators/CRequiredValidator.php#77 (鏄剧ず)
public function clientValidateAttribute($object,$attribute)
{
$message=$this->message;
if($this->requiredValue!==null)
{
if($message===null)
$message=Yii::t('yii','{attribute} must be {value}.');
$message=strtr($message, array(
'{value}'=>$this->requiredValue,
'{attribute}'=>$object->getAttributeLabel($attribute),
));
return "
if(value!=" . CJSON::encode($this->requiredValue) . ") {
messages.push(".CJSON::encode($message).");
}
";
}
else
{
if($message===null)
$message=Yii::t('yii','{attribute} cannot be blank.');
$message=strtr($message, array(
'{attribute}'=>$object->getAttributeLabel($attribute),
));
return "
if($.trim(value)=='') {
messages.push(".CJSON::encode($message).");
}
";
}
}
杩斿洖鎵ц瀹㈡埛绔獙璇佹墍闇鐨凧avaScript銆
validateAttribute()
鏂规硶
protected void validateAttribute(CModel $object, string $attribute)
| ||
$object | CModel | 闇瑕侀獙璇佺殑瀵硅薄 |
$attribute | string | 闇瑕侀獙璇佺殑灞炴 |
婧愮爜锛 framework/validators/CRequiredValidator.php#50 (鏄剧ず)
protected function validateAttribute($object,$attribute)
{
$value=$object->$attribute;
if($this->requiredValue!==null)
{
if(!$this->strict && $value!=$this->requiredValue || $this->strict && $value!==$this->requiredValue)
{
$message=$this->message!==null?$this->message:Yii::t('yii','{attribute} must be {value}.',
array('{value}'=>$this->requiredValue));
$this->addError($object,$attribute,$message);
}
}
else if($this->isEmpty($value,true))
{
$message=$this->message!==null?$this->message:Yii::t('yii','{attribute} cannot be blank.');
$this->addError($object,$attribute,$message);
}
}
楠岃瘉浼犲叆瀵硅薄鐨勫睘鎬с 濡傛灉瀛樺湪浠讳綍楠岃瘉閿欒锛岄敊璇彁绀轰俊鎭皢琚坊鍔犲埌姝ゅ璞′腑銆