Browse Source

Fix JA guide page (#18958)

tags/2.0.44
Bizley 3 years ago committed by GitHub
parent
commit
f5973acd08
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
  1. 27
      docs/guide-ja/helper-json.md

27
docs/guide-ja/helper-json.md

@ -1,26 +1,25 @@
Json <EFBFBD>w<EFBFBD><EFBFBD><EFBFBD>p
Json ヘルパ
===========
Json <EFBFBD>w<EFBFBD><EFBFBD><EFBFBD>p<EFBFBD><EFBFBD> JSON <EFBFBD><EFBFBD><EFBFBD>G<EFBFBD><EFBFBD><EFBFBD>R<EFBFBD>[<EFBFBD>h<EFBFBD><EFBFBD><EFBFBD><EFBFBD>уf<EFBFBD>R<EFBFBD>[<EFBFBD>h<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>A<EFBFBD>̐ÓI<EFBFBD><EFBFBD><EFBFBD>\<EFBFBD>b<EFBFBD>h<EFBFBD><EFBFBD>񋟂<EFBFBD><EFBFBD>܂<EFBFBD><EFBFBD>B
`[[yii\helpers\Json::encode()]]` <EFBFBD><EFBFBD><EFBFBD>\<EFBFBD>b<EFBFBD>h<EFBFBD>̓G<EFBFBD><EFBFBD><EFBFBD>R<EFBFBD>[<EFBFBD>h<EFBFBD>E<EFBFBD>G<EFBFBD><EFBFBD><EFBFBD>[<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>܂<EFBFBD><EFBFBD><EFBFBD><EFBFBD>A
`[[yii\web\JsExpression]]` <EFBFBD>I<EFBFBD>u<EFBFBD>W<EFBFBD>F<EFBFBD>N<EFBFBD>g<EFBFBD>̌`<EFBFBD><EFBFBD><EFBFBD>ŕ\<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ꂽ JavaScript <EFBFBD>̎<EFBFBD><EFBFBD>̓G<EFBFBD><EFBFBD><EFBFBD>R<EFBFBD>[<EFBFBD>h<EFBFBD><EFBFBD><EFBFBD>܂<EFBFBD><EFBFBD><EFBFBD>B
<EFBFBD><EFBFBD><EFBFBD><EFBFBD>ł̓G<EFBFBD><EFBFBD><EFBFBD>R<EFBFBD>[<EFBFBD>h<EFBFBD><EFBFBD> `JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE` <EFBFBD>̃I<EFBFBD>v<EFBFBD>V<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ōs<EFBFBD><EFBFBD><EFBFBD>܂<EFBFBD><EFBFBD>B
<EFBFBD>ڍׂɂ‚<EFBFBD><EFBFBD>Ă<EFBFBD> [PHP:json_encode](https://www.php.net/manual/ja/function.json-encode.php) <EFBFBD><EFBFBD><EFBFBD>Q<EFBFBD>Ƃ<EFBFBD><EFBFBD>ĉ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>B
Json ヘルパは JSON をエンコードおよびデコードする一連の静的メソッドを提供します。
`[[yii\helpers\Json::encode()]]` メソッドはエンコード・エラーを処理しますが、
`[[yii\web\JsExpression]]` オブジェクトの形式で表現された JavaScript の式はエンコードしません。
既定ではエンコードは `JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE` のオプションで行われます。
詳細については [PHP:json_encode](https://www.php.net/manual/ja/function.json-encode.php) を参照して下さい。
## <EFBFBD><EFBFBD><EFBFBD>`<EFBFBD>o<EFBFBD><EFBFBD> <span id="pretty-print"></span>
## 整形出力 <span id="pretty-print"></span>
<EFBFBD><EFBFBD><EFBFBD><EFBFBD>ł<EFBFBD> `[[yii\helpers\Json::encode()]]` <EFBFBD><EFBFBD><EFBFBD>\<EFBFBD>b<EFBFBD>h<EFBFBD>͐<EFBFBD><EFBFBD>`<EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ă<EFBFBD><EFBFBD>Ȃ<EFBFBD> JSON (<EFBFBD><EFBFBD><EFBFBD>Ȃ킿<EFBFBD>󔒖<EFBFBD><EFBFBD><EFBFBD><EFBFBD>̂<EFBFBD><EFBFBD><EFBFBD>) <EFBFBD><EFBFBD><EFBFBD>o<EFBFBD>͂<EFBFBD><EFBFBD>܂<EFBFBD><EFBFBD>B
<EFBFBD>l<EFBFBD>ԂɂƂ<EFBFBD><EFBFBD>ēǂ݂<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>̂ɂ<EFBFBD><EFBFBD><EFBFBD>߂ɁA<EFBFBD>u<EFBFBD><EFBFBD><EFBFBD>`<EFBFBD>o<EFBFBD><EFBFBD> pretty printing<EFBFBD>v<EFBFBD><EFBFBD> ON <EFBFBD>ɂ<EFBFBD><EFBFBD><EFBFBD>Ƃ<EFBFBD><EFBFBD>o<EFBFBD><EFBFBD><EFBFBD>܂<EFBFBD><EFBFBD>B
既定では `[[yii\helpers\Json::encode()]]` メソッドは整形されていない JSON (すなわち空白無しのもの) を出力します。
人間にとって読みやすいものにするために、「整形出力 pretty printing」を ON にすることが出来ます。
> Note: <EFBFBD><EFBFBD><EFBFBD>`<EFBFBD>o<EFBFBD>͂͊J<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>̃f<EFBFBD>o<EFBFBD>b<EFBFBD>O<EFBFBD>ɂ͖𗧂‚ł<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>A<EFBFBD><EFBFBD><EFBFBD>i<EFBFBD>‹<EFBFBD><EFBFBD>ł͐<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>܂<EFBFBD><EFBFBD><EFBFBD>B
<EFBFBD>C<EFBFBD><EFBFBD><EFBFBD>X<EFBFBD>^<EFBFBD><EFBFBD><EFBFBD>X<EFBFBD><EFBFBD><EFBFBD>Ƃɐ<EFBFBD><EFBFBD>`<EFBFBD>o<EFBFBD>͂<EFBFBD>L<EFBFBD><EFBFBD><EFBFBD>ɂ<EFBFBD><EFBFBD><EFBFBD>߂ɂ̓I<EFBFBD>v<EFBFBD>V<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>w<EFBFBD><EFBFBD><EFBFBD>Ƃ<EFBFBD><EFBFBD>o<EFBFBD><EFBFBD><EFBFBD>܂<EFBFBD><EFBFBD>B<EFBFBD><EFBFBD><EFBFBD>Ȃ킿 :
> Note: 整形出力は開発中のデバッグには役立つでしょうが、製品環境では推奨されません。
インスタンスごとに整形出力を有効にするためにはオプションを指定することが出来ます。すなわち :
```php
$data = ['a' => 1, 'b' => 2];
$json = yii\helpers\Json::encode($data, JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);
```
JSON <EFBFBD>w<EFBFBD><EFBFBD><EFBFBD>p<EFBFBD>̐<EFBFBD><EFBFBD>`<EFBFBD>o<EFBFBD>͂<EFBFBD><EFBFBD>O<EFBFBD><EFBFBD><EFBFBD>[<EFBFBD>o<EFBFBD><EFBFBD><EFBFBD>ɗL<EFBFBD><EFBFBD><EFBFBD>ɂ<EFBFBD><EFBFBD><EFBFBD>Ƃ<EFBFBD><EFBFBD>o<EFBFBD><EFBFBD><EFBFBD>܂<EFBFBD><EFBFBD>B<EFBFBD><EFBFBD>΁A<EFBFBD>ݒ<EFBFBD>t<EFBFBD>@<EFBFBD>C<EFBFBD><EFBFBD><EFBFBD><EFBFBD> index.php <EFBFBD>̒<EFBFBD><EFBFBD><EFBFBD> :
JSON ヘルパの整形出力をグローバルに有効にすることも出来ます。例えば、設定ファイルや index.php の中で :
```php
yii\helpers\Json::$prettyPrint = YII_DEBUG; // <EFBFBD>f<EFBFBD>o<EFBFBD>b<EFBFBD>O<EFBFBD>E<EFBFBD><EFBFBD><EFBFBD>[<EFBFBD>h<EFBFBD>ł͐<EFBFBD><EFBFBD>`<EFBFBD>o<EFBFBD>͂<EFBFBD><EFBFBD>g<EFBFBD>p
yii\helpers\Json::$prettyPrint = YII_DEBUG; // デバッグ・モードでは整形出力を使用
```

Loading…
Cancel
Save