Browse Source

Merge pull request #7494 from softark/docs-guide-ja-helper-rev

docs/guide-ja/helper reviewed [ci skip]
tags/2.0.3
Qiang Xue 10 years ago
parent
commit
f7290bce8c
  1. 10
      docs/guide-ja/helper-array.md
  2. 2
      docs/guide-ja/helper-html.md
  3. 6
      docs/guide-ja/helper-url.md

10
docs/guide-ja/helper-array.md

@ -6,7 +6,7 @@ ArrayHelper
## 値を取得する <span id="getting-values"></span>
配列、オブジェクト、またはその両方から成る複雑な構造から値を取得することは、標準的な PHP を使う場合、何度も繰り返さねばならない面倒くさい仕事です。
配列、オブジェクト、またはその両方から成る複雑な構造から標準的な PHP を使って値を取得することは、何度も繰り返さねばならない面倒くさい仕事です。
最初に `isset` でキーの存在をチェックしなければならず、次に、キーが存在していれば値を取得し、存在していなければ、デフォルト値を提供しなければなりません。
```php
@ -24,7 +24,7 @@ $array = [
$value = isset($array['foo']['bar']->name) ? $array['foo']['bar']->name : null;
```
Yii はこれをするための非常に便利なメソッドを提供しています。
Yii はこための非常に便利なメソッドを提供しています。
```php
$value = ArrayHelper::getValue($array, 'foo.bar.name');
@ -34,7 +34,7 @@ $value = ArrayHelper::getValue($array, 'foo.bar.name');
二番目の引数は、データの取得の仕方を指定します。これは、以下の一つとすることが出来ます。
- 値を読み出すべき配列のキーまたはオブジェクトのプロパティの名前。
- ドットで分された配列のキーまたはオブジェクトのプロパティ名のセット。上の例で使用した形式。
- ドットで分された配列のキーまたはオブジェクトのプロパティ名のセット。上の例で使用した形式です
- 値を返すコールバック。
コールバックは次の形式でなければなりません。
@ -227,7 +227,7 @@ echo ArrayHelper::isAssociative($associative);
## 値を HTML エンコード / デコードする <span id="html-encoding-values"></span>
文字列の配列の中にある特殊文字を HTML エンティティ にエンコード、または、HTML エンティティからデコードするために、下記の関数を使うことが出来ます。
文字列の配列の中にある特殊文字を HTML エンティティにエンコード、または、HTML エンティティからデコードするために、下記の関数を使うことが出来ます。
```php
$encoded = ArrayHelper::htmlEncode($data);
@ -300,4 +300,4 @@ $data = ArrayHelper::toArray($post, [
]
```
特定のクラスについて、配列に変換するデフォルトの方法を提供するために、そのクラスの [[yii\base\Arrayable|Arrayable]] インタフェイスを実装することが出来ます。
特定のクラスについて、配列に変換するデフォルトの方法を提供するために、そのクラスの [[yii\base\Arrayable|Arrayable]] インタフェイスを実装することが出来ます。

2
docs/guide-ja/helper-html.md

@ -6,7 +6,7 @@ Html ヘルパ
Yii はそのような手助けを Html ヘルパの形式で提供します。
これは、よく使われる HTML タグとそのオプションやコンテントを処理するための一連のスタティックメソッドを提供するものです。
> Note|注意: あなたのマークアップがおおむね静的なものである場合は、HTML を直接に使用する方が良いです。
> Note|注意: あなたのマークアップがおおむね静的なものである場合は、HTML を直接に使用する方が適切です。
> 何でもかんでも Html ヘルパの呼び出しでラップする必要はありません。

6
docs/guide-ja/helper-url.md

@ -18,7 +18,7 @@ $httpsAbsoluteHomeUrl = Url::home('https');
パラメータが渡されない場合は、相対 URL が生成されます。
`true` を渡すと、現在のスキーマの絶対 URL を取得することが出来ます。
または、スキーを明示的に指定して (`http`, `https`) 絶対 URL を取得することも出来ます。
または、スキーを明示的に指定して (`http`, `https`) 絶対 URL を取得することも出来ます。
現在のリクエストのベース URL を取得するためには、次のようにします。
@ -94,7 +94,6 @@ echo Url::toRoute('site/index', 'https');
- 配列: URL を生成するために [[toRoute()]] が呼び出されます。例えば、`['site/index']`、`['post/index', 'page' => 2]`。
ルートの指定方法の詳細については [[toRoute()]] を参照してください。
on how to specify a route.
- `@` で始まる文字列: これはエイリアスとして扱われ、エイリアスに対応する文字列が返されます。
- 空文字列: 現在リクエストされている URL が返されます。
- 通常の文字列: その通りのものとして扱われます。
@ -133,9 +132,6 @@ echo Url::to('@web/images/logo.gif', 'https');
バージョン 2.0.3 以降では、[[yii\helpers\Url::current()]] を使って、現在リクエストされているルートと GET パラメータに基づいて URL を生成することが出来ます。
`$params` パラメータを渡して、GET パラメータの中のいくつかを修正したり削除したり、または新しい GET パラメータを追加したりすることが出来ます。
例えば、
Starting from version 2.0.3, you may use [[yii\helpers\Url::current()]] to create a URL based on the currently
requested route and GET parameters. You may modify or remove some of the GET parameters or add new ones by
passing a `$params` parameter to the method. For example,
```php
// $_GET が ['id' => 123, 'src' => 'google'] であり、現在のルートが "post/view" であると仮定

Loading…
Cancel
Save