ユーティリティについて

ExtではJavaScriptおよびJSONを便利に利用するためのユーティリティを提供しています。

apply and applyIf

apply
Ext.applyメソッドはあるオブジェクトリテラルの全てのプロパティを別のオブジェクトにコピーする際に利用します。第1引数はコピー先のオブジェクト、第2引数はコピー元のオブジェクトです。コピー元とコピー先に同じ名前のプロパティがある場合コピー元のプロパティの値で上書きされることに注意してください。この呼び出しの結果、コピー先のオブジェクトの中身は書き換えられます。
```
var person = {
    name: 'John Smith',
    age: 30
};

Ext.apply(person, {
    hobby: 'Coding',
    city: 'London'
}); // オブジェクトリテラルpersonに"hobby"と"city"を追加
```
applyIf
Ext.applyIfはExt.applyとほぼ同じ動作をしますが、唯一の違いは、Ext.applyIfはコピー元とコピー先に同じプロパティが存在する場合、上書きをしないということです。コピー先のプロパティはそのままで、存在しないプロパティのみが新しく追加されます。
```
var person = {
    name: 'John Smith',
    age: 30,
    hobby: 'Rock Band'
};

Ext.applyIf(person, {
    hobby: 'Coding',
    city: 'London'
}); // "hobby"はコピーされない
```

URLのエンコード/デコード

これらのメソッドはJSONデータをGETメソッドに渡す文字列に変換（あるいは文字列からJSONに戻す）ときに便利なメソッドです。

urlEncode
オブジェクトリテラルを渡すとGETメソッドで送信できる文字列に変換します。文字列の書式はkey1=value1&key2=value2...のようになります。
```
var params = {
    foo: 'value1',
    bar: 100
};

var s = Ext.encode(params); // 文字列sはfoo=value1&bar=100
```
urlDecode
このメソッドはurlEncodeと逆の変換をします。key1=value1&key2=valueのような文字列をJavaScriptのオブジェクトリテラルに変換します。
```
var s = 'foo=value1&bar=100';
var o = Ext.decode(s); // オブジェクトoは"foo"と"bar"の2つのプロパティを持つ
alert(o.bar);
```

配列の扱い

Ext Coreでは配列やその他のデータ集合を扱うためのメソッドを提供しています。

each
Ext.eachは配列やその他のデータ集合（NodelistやCompositeElementを含む）をイテレーションする場合に利用します。Ext.eachは第1引数に配列あるいはデータ集合、2引数に関数を取ります。この関数は第1引数のそれぞれのデータに対して呼び出されます。また、この関数からfalseが戻されるとその時点でイテレーションが終了します。
```
Ext.each([1, 2, 3, 4, 5], function(num){
    alert(num);
});
```

toArray

Ext.toArrayはExt.eachでイテレーショ可能なデータ集合（あるいは単独のデータでも）をJavaScriptの配列に変換します。

var arr1 = Ext.toArray(1); // arr1 = [1];
// arr2 はExt.CompositeElementからExt.Elementの配列に変換される。
var arr2 = Ext.toArray(Ext.select('div));

JSON

JSONは"JavaScript Object Notation"を略したものです。JSONはJavaScriptのオブジェクトリテラルのような姿をしていて、主にデータの送受信のためのフォーマットとして利用されています。サーバーとデータをやり取りする際には、JavaScript側で処理可能な形に変換（あるいはその逆）をする必要があります。以下のヘルパーメソッドはこれらの変換処理を行ってくれます。JSONに関する詳しい情報についてはjson.orgをご参照ください。

encode
Ext.util.JSON.encode（省略形はExt.encode）はJavaScriptオブジェクトあるいは配列を引数として取り、外部に送信可能なJSON形式の文字列に変換します。
```
var s = Ext.encode({
    foo: 1,
    bar: 2
}); //変数sには文字列'{foo=1,bar=2}'が格納される
```
decode
Ext.util.JSON.decode（省略形はExt.decode）はExt.encodeと逆にJSON形式の文字列を引数として取り、JavaScriptオブジェクトに変換します。このメソッドはAjaxリクエストへのコールバック関数内でよく利用されます。
```
var s = '{foo=1,bar=2}';
var o = Ext.decode(s); 変数o"foo"と"bar"の2つのプロパティを持つオブジェクト
```

ブラウザとOSの判定

JavaScript

Extはクロスブラウザー対応ですが、それでも時には開発者自身がクロスブラウザー対応のためのコードを書く必要が発生します。Extではそういった用途に必要なブラウザーの種類を検知する機能を提供しています。この検知機能はJavaScriptだけではなくCSSでも提供されていて、クロスブラウザー対応にとって大変便利な機能となっています。

以下のJavaScriptによるブラウザー検知機能が利用可能です：

Internet Explorer - Ext.isIE, Ext.isIE6, Ext.isIE7, Ext.isIE8
Firefox - Ext.isGecko, Ext.isGecko2, Ext.isGecko3
Opera - Ext.isOpera
Chrome - Ext.isChrome
Safari - Ext.isSafari, Ext.isSafari2, Ext.isSafari3
WebKit - Ext.isWebKit
Operating Systems - Ext.isLinux, Ext.isWindows, Ext.isMac

if(Ext.isIE){
    // IE特有の処理をここに書く
}

CSS

CSSにおいても同じような仕組みで、実行環境に合わせたCSSのクラスがルート要素やbodyタグに付加されます。この機能によりブラウザ毎のスタイリング方法の違いを比較的簡単に吸収することが可能となります。例えば、"stric mode"の場合には、"ext-strict"というクラスがルート要素に付加され、その他の下記のクラスはbodyタグ以下の要素に必要に応じて付加されることになります：

.ext-ie, .ext-ie6, .ext-ie7, .ext-ie8
.ext-gecko, .ext-gecko2, .ext-gecko3
.ext-opera
.ext-safari
.ext-chrome
.ext-mac, .ext-linux

/* Safariで"strict mode"の場合に、"font-size"を変更 */
.ext-strict .ext-safari .sample-item{
    font-size: 20px; 
}

データタイプの検知

JavaScriptは弱い型付けの言語であるため、変数のデータタイプについて調べる必要が頻繁に発生します。Extではデータタイプを検知するためのメソッドを提供しています：

isEmpty
Ext.isEmptyは引数が空（undefined、null、空の文字列を含む）かどうかを調べます。
```
alert(Ext.isEmpty(''));
```
isArray
Ext.isArrayは引数が配列かどうかを調べます。
```
alert(Ext.isArray([1, 2, 3]));
```
isObject
Ext.isObjectは引数がオブジェクトかどうかを調べます。
```
alert(Ext.isObject({}));
```
isFunction
Ext.isFunctionは引数が関数かどうかを調べます。
```
alert(Ext.isFunction(function(){
}));
```

その他

id
Ext.idメソッドはユニークなID（文字列）を返します。Ext.idはまだ使用されていないIDを返すことを保証します。第1引数（オプション）にExt.Elementのインスタンスを渡すと、このインスタンスにIDが付与されます。第2引数（オプション）でIDにプレフィックスを指定することができます。
```
var s = Ext.id(null, 'prefix'); // Ext.Elementは指定しない
var s = Ext.id(Ext.get(document.body)); // bodyタグにIDを付与
```

Utilities