* @version $Id: CRangeValidator.php 3120 2011-03-25 01:50:48Z qiang.xue $ * @package system.validators * @since 1.0 */ class CRangeValidator extends Validator { /** * @var array list of valid values that the attribute value should be among */ public $range; /** * @var boolean whether the comparison is strict (both type and value must be the same) */ public $strict = false; /** * @var boolean whether the attribute value can be null or empty. Defaults to true, * meaning that if the attribute is empty, it is considered valid. */ public $allowEmpty = true; /** * @var boolean whether to invert the validation logic. Defaults to false. If set to true, * the attribute value should NOT be among the list of values defined via {@link range}. * @since 1.1.5 **/ public $not = false; /** * Validates the attribute of the object. * If there is any error, the error message is added to the object. * @param \yii\base\Model $object the object being validated * @param string $attribute the attribute being validated */ public function validateAttribute($object, $attribute) { $value = $object->$attribute; if ($this->allowEmpty && $this->isEmpty($value)) return; if (!is_array($this->range)) throw new CException(Yii::t('yii', 'The "range" property must be specified with a list of values.')); if (!$this->not && !in_array($value, $this->range, $this->strict)) { $message = $this->message !== null ? $this->message : Yii::t('yii', '{attribute} is not in the list.'); $this->addError($object, $attribute, $message); } elseif ($this->not && in_array($value, $this->range, $this->strict)) { $message = $this->message !== null ? $this->message : Yii::t('yii', '{attribute} is in the list.'); $this->addError($object, $attribute, $message); } } /** * Returns the JavaScript needed for performing client-side validation. * @param \yii\base\Model $object the data object being validated * @param string $attribute the name of the attribute to be validated. * @return string the client-side validation script. * @see CActiveForm::enableClientValidation * @since 1.1.7 */ public function clientValidateAttribute($object, $attribute) { if (!is_array($this->range)) throw new CException(Yii::t('yii', 'The "range" property must be specified with a list of values.')); if (($message = $this->message) === null) $message = $this->not ? Yii::t('yii', '{attribute} is in the list.') : Yii::t('yii', '{attribute} is not in the list.'); $message = strtr($message, array( '{attribute}' => $object->getAttributeLabel($attribute), )); $range = array(); foreach ($this->range as $value) $range[] = (string)$value; $range = json_encode($range); return " if(" . ($this->allowEmpty ? "$.trim(value)!='' && " : '') . ($this->not ? "$.inArray(value, $range)>=0" : "$.inArray(value, $range)<0") . ") { messages.push(" . json_encode($message) . "); } "; } }