php/yii2
1
0
Fork 0
mirror of https://github.com/yiisoft/yii2.git synced 2025-11-04 06:37:55 +08:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #12490 from Mak-Di/patch-4

Browse Source 
Added missing hyphen
This commit is contained in:
Dmitry Naumenko
2016-09-08 10:11:18 +03:00
committed by GitHub
parent 2c3e3f3daa 7d27e203e0
commit a2df4730f4
1 changed files with 6 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

12
docs/guide/input-validation.md
View File

@ -459,7 +459,7 @@ a validator that supports client-side validation *in addition to* server-side va
Many [core validators](tutorial-core-validators.md) support client-side validation out-of-the-box. All you need to do Many [core validators](tutorial-core-validators.md) support client-side validation out-of-the-box. All you need to do
is just use [[yii\widgets\ActiveForm]] to build your HTML forms. For example, `LoginForm` below declares two is just use [[yii\widgets\ActiveForm]] to build your HTML forms. For example, `LoginForm` below declares two
rules: one uses the [required](tutorial-core-validators.md#required) core validator which is supported on both rules: one uses the [required](tutorial-core-validators.md#required) core validator which is supported on both
client and server sides; the other uses the `validatePassword` inline validator which is only supported on the server client and server-sides; the other uses the `validatePassword` inline validator which is only supported on the server
side. side.
```php ```php
@ -522,7 +522,7 @@ the former will take precedence.
To create a validator that supports client-side validation, you should implement the To create a validator that supports client-side validation, you should implement the
[[yii\validators\Validator::clientValidateAttribute()]] method which returns a piece of JavaScript code [[yii\validators\Validator::clientValidateAttribute()]] method which returns a piece of JavaScript code
that performs the validation on the client side. Within the JavaScript code, you may use the following that performs the validation on the client-side. Within the JavaScript code, you may use the following
predefined variables: predefined variables:
- `attribute`: the name of the attribute being validated. - `attribute`: the name of the attribute being validated.
@ -531,7 +531,7 @@ predefined variables:
- `deferred`: an array which deferred objects can be pushed into (explained in the next subsection). - `deferred`: an array which deferred objects can be pushed into (explained in the next subsection).
In the following example, we create a `StatusValidator` which validates if an input is a valid status input In the following example, we create a `StatusValidator` which validates if an input is a valid status input
against the existing status data. The validator supports both server side and client side validation. against the existing status data. The validator supports both server-side and client-side validation.
```php ```php
namespace app\components; namespace app\components;
@ -604,7 +604,7 @@ In the above, the `deferred` variable is provided by Yii, which is an array of D
jQuery method creates a Deferred object which is pushed to the `deferred` array. jQuery method creates a Deferred object which is pushed to the `deferred` array.
You can also explicitly create a Deferred object and call its `resolve()` method when the asynchronous callback You can also explicitly create a Deferred object and call its `resolve()` method when the asynchronous callback
is hit. The following example shows how to validate the dimensions of an uploaded image file on the client side. is hit. The following example shows how to validate the dimensions of an uploaded image file on the client-side.
```php ```php
public function clientValidateAttribute($model, $attribute, $view) public function clientValidateAttribute($model, $attribute, $view)
@ -660,8 +660,8 @@ JS;
### AJAX Validation <span id="ajax-validation"></span> ### AJAX Validation <span id="ajax-validation"></span>
Some validations can only be done on the server side, because only the server has the necessary information. Some validations can only be done on the server-side, because only the server has the necessary information.
For example, to validate if a username is unique or not, it is necessary to check the user table on the server side. For example, to validate if a username is unique or not, it is necessary to check the user table on the server-side.
You can use AJAX-based validation in this case. It will trigger an AJAX request in the background to validate the You can use AJAX-based validation in this case. It will trigger an AJAX request in the background to validate the
input while keeping the same user experience as the regular client-side validation. input while keeping the same user experience as the regular client-side validation.