diff --git a/docs/guide-ja/input-validation.md b/docs/guide-ja/input-validation.md index 546f8f05bf..469df3083f 100644 --- a/docs/guide-ja/input-validation.md +++ b/docs/guide-ja/input-validation.md @@ -9,10 +9,12 @@ 例えば、 ```php -$model = new \app\models\ContactForm; +$model = new \app\models\ContactForm(); // モデルの属性にユーザ入力を投入する -$model->attributes = \Yii::$app->request->post('ContactForm'); +$model->load(\Yii::$app->request->post()); +// これは次と等価 +// $model->attributes = \Yii::$app->request->post('ContactForm'); if ($model->validate()) { // 全ての入力が有効 @@ -440,6 +442,7 @@ class LoginForm extends Model クライアント側の検証を完全に無効にしたい場合は、[[yii\widgets\ActiveForm::enableClientValidation]] プロパティを false に設定することが出来ます。 また、個々の入力フィールドごとにクライアント側の検証を無効にしたい場合には、入力フィールドの [[yii\widgets\ActiveField::enableClientValidation]] プロパティを false に設定することが出来ます。 +`eanbleClientValidation` が入力フィールドのレベルとフォームのレベルの両方で構成されている場合は前者が優先されます。 ### クライアント側の検証を実装する @@ -583,16 +586,32 @@ JS; このような場合には、AJAX ベースの検証を使うことが出来ます。 AJAX 検証は、通常のクライアント側での検証と同じユーザ体験を保ちながら、入力値を検証するためにバックグラウンドで AJAX リクエストを発行します。 -AJAX 検証をフォーム全体に対して有効にするためには、[[yii\widgets\ActiveForm::enableAjaxValidation]] プロパティを `true` に設定して、`id` にフォームを特定するユニークな ID を設定しなければなりません。 +単一のインプットフィールドに対して AJAX 検証を有効にするためには、そのフィールドの [[yii\widgets\ActiveField::enableAjaxValidation|enableAjaxValidation]] プロパティを true に設定し、フォームに一意の `id` を指定します。 ```php - 'contact-form', - 'enableAjaxValidation' => true, -]); ?> +use yii\widgets\ActiveForm; + +$form = ActiveForm::begin([ + 'id' => 'registration-form', +]); + +echo $form->field($model, 'username', ['enableAjaxValidation' => true]); + +// ... + +ActiveForm::end(); ``` -個別の入力フィールドについても、[[yii\widgets\ActiveField::enableAjaxValidation]] プロパティを設定して、AJAX 検証を有効にしたり無効にしたりすることが出来ます。 +フォーム全体に対して AJAX 検証を有効にするためには、フォームのレベルで [[yii\widgets\ActiveForm::enableAjaxValidation|enableAjaxValidation]] を true に設定します。 + +```php +$form = ActiveForm::begin([ + 'id' => 'contact-form', + 'enableAjaxValidation' => true, +]); +``` + +> Note|注意: `enableAjaxValidation` プロパティがインプットフィールドのレベルとフォームのレベルの両方で構成された場合は、前者が優先されます。 また、サーバ側では、AJAX 検証のリクエストを処理できるように準備しておく必要があります。 これは、コントローラのアクションにおいて、次のようなコード断片を使用することで達成できます。 diff --git a/docs/guide-ja/intro-upgrade-from-v1.md b/docs/guide-ja/intro-upgrade-from-v1.md index 79e24f8c08..083483eaf1 100644 --- a/docs/guide-ja/intro-upgrade-from-v1.md +++ b/docs/guide-ja/intro-upgrade-from-v1.md @@ -102,7 +102,7 @@ $object = Yii::createObject([ ], [$param1, $param2]); ``` -構成情報に関する詳細は、[オブジェクトの構成情報](concept-configurations.md) の節で見ることが出来ます。 +構成情報に関する詳細は、[構成情報](concept-configurations.md) の節で見ることが出来ます。 イベント diff --git a/docs/guide-ja/runtime-sessions-cookies.md b/docs/guide-ja/runtime-sessions-cookies.md index 51b5fef11b..3a65f0f21e 100644 --- a/docs/guide-ja/runtime-sessions-cookies.md +++ b/docs/guide-ja/runtime-sessions-cookies.md @@ -218,6 +218,15 @@ $alerts = $session->getFlash('alerts'); これは、後者のメソッドが、同じ名前のフラッシュデータを追加できるように、フラッシュデータを自動的に配列に変換するからです。 その結果、[[yii\web\Session::getFlash()]] を呼び出したとき、この二つのメソッドの呼び出し順によって、あるときは配列を受け取り、あるときは文字列を受け取るということになってしまいます。 +> Tip|ヒント: フラッシュメッセージを表示するためには、[[yii\bootstrap\Alert|bootstrap Alert]] ウィジェットを次のように使用することが出来ます。 +> +> ```php +> echo Alert::widget([ +> 'options' => ['class' => 'alert-info'], +> 'body' => Yii::$app->session->getFlash('postDeleted'), +> ]); +> ``` + ## クッキー diff --git a/docs/guide-ja/security-passwords.md b/docs/guide-ja/security-passwords.md index d51dddc447..cfd6b2b8d5 100644 --- a/docs/guide-ja/security-passwords.md +++ b/docs/guide-ja/security-passwords.md @@ -1,5 +1,5 @@ -セキュリティ -============ +パスワードを扱う +================ > Note|注意: この節はまだ執筆中です。 diff --git a/docs/guide-ja/start-gii.md b/docs/guide-ja/start-gii.md index 45257cf53e..db46b20a95 100644 --- a/docs/guide-ja/start-gii.md +++ b/docs/guide-ja/start-gii.md @@ -15,7 +15,7 @@ Gii を使ってコードを自動生成することは、Gii のウェブペー Gii を開始する -------------- -[Gii](tool-gii.md) は Yii の [モジュール](structure-modules.md) として提供されています。 +[Gii](https://github.com/yiisoft/yii2-gii/blob/master/docs/guide-ja/README.md) は Yii の [モジュール](structure-modules.md) として提供されています。 Gii は、アプリケーションの [[yii\base\Application::modules|modules]] プロパティの中で構成することで有効にすることが出来ます。 アプリケーションを生成した仕方にもよりますが、`config/web.php` の構成情報ファイルの中に、多分、下記のコードが既に提供されているでしょう。