- uu.url - parse and build URL - URL の分解と構築
uu.url(url = ".") は絶対 URL または 相対 URL を分解し、
URL の構成要素を格納した Hash を返します。
url に Hash を指定すると、Hash を元に構築した URL を返します。
@param String [url] - 絶対 URL または相対 URL を指定します。デフォルトは "." です。
/Hash Hash も指定できます。
@return Hash/false - URL 文字列の分解に成功した場合は URL の構成要素を格納した Hash を返します。
/String URL の分解に失敗した場合は false を返します。
url に Hash が指定された場合は、URL 文字列を返します。
uu.url("http://wwww.example.com:8080/dir/file.ext?key1=value1&key2=value2#menu1"); の戻り値
| Hash property | Value | Type | Example |
|---|
| scheme | スキーム | String | "http" |
| domain | ドメイン | String | "www.example.com" |
| port | ポート番号 | String | "8080"
ポート番号が省略されている場合は "" |
| path | パス | String | "/dir/file.ext"
パスが省略されている場合は "/" |
| query | QueryString | String | "key1=value1&key2=value2"
QueryStringが省略されている場合は "" |
| fragment | フラグメント | String | "menu1"
フラグメントが省略されている場合は "" |
| url | 絶対 URL | String | "http://wwww.example.com:8080/dir/file.ext?key1=value1&key2=value2#menu1" |
| base | スキーム
+ ドメイン
+ ポート番号
+ ディレクトリ | String | "http://wwww.example.com:8080/dir/" |
| dir | ディレクトリ | String | "/dir"
ディレクトリが省略されている場合は "/" |
| file | ファイル名[.拡張子] | String | "file.ext"
ファイル名が省略されている場合は "" |
| hash | uu.url.query(QueryString)の
実行結果 | Hash | { key1: "value1", key2: "value2" }
QueryStringが省略されている場合は {} |
uu.url(url) で有効なプロパティの一覧
| Hash property | Value | Type | Example |
|---|
| scheme | スキーム | String | "http"
このプロパティは省略できません。 |
| domain | ドメイン | String | "www.example.com"
このプロパティは省略できません。 |
| port | ポート番号 | String | "8080"
ポート番号が不要なら省略するか "" を指定します |
| path | パス | String | "/dir/file.ext"
パスが不要なら省略するか "" を指定します |
| query | QueryString | String | "key1=value1&key2=value2"
QueryStringが不要なら省略するか "" を指定します |
| fragment | フラグメント | String | "menu1"
フラグメントが不要なら省略するか "" を指定します |
| 以下のプロパティは使用されません(無視されます) |
|---|
| url | | | |
| base | | | |
| dir | | | |
| file | | | |
| hash | | | |
Run
alert(uu.url({
scheme: 'http',
domain: 'www.example.com',
port: 8080,
path: '/dir/file.ext',
query: 'key1=value1&key2=value2',
fragment: 'menu1'
}));
Run uu.url は可逆です
alert(uu.url(uu.url('.')));
- uu.url.toAbsURL - to absolute URL - 絶対 URL 化
uu.url.toAbsURL(url = ".") は 相対URL(path)を絶対 URL に変換します。
url が絶対 URL ならそのまま返します。
@param String url - 相対 URL を指定します。絶対 URL も指定可能です。デフォルトは "." です。
"." を指定するとカレント URL を絶対 URL に変換します。
@return String - 絶対 URL を返します。
Run
alert(uu.url.toAbsURL());
- uu.url.query - parse and build QueryString - QueryString の分解と構築
uu.url.parseQuery(qstr) は
query を分解し Hash( { key: value, ... } )を返します。
query に Hash を指定すると、Hash を元に構築した QueryString を返します。
@param String query - QueryString を指定します。
/Hash Hash も指定できます。
@return Hash - 分解した結果を返します。
/String query に Hash を指定した場合は、構築した QueryString を返します。
Run
var query = uu.url.query('key1=value1&key2=value2'); // query = { key1: "value1", key2: "value2" }
alert(uu.url.query(query)); // "key1=value1&key2=value2"
Run
適切にURIエンコードを行います
var query = uu.url.query('#KEY#=日本語'); // query = { "#KEY#": "日本語" }
alert(uu.url.query(query)); // "%23KEY%23=%E6%97%A5%E6%9C%AC%E8%AA%9E" URIエンコード済み
Run uu.url.query は可逆です
alert(uu.url.query(uu.url.query('key=value')));
- uuClass - create "Keep It Simple, Stupid" class - シンプルなクラスの雛形を生成
-
uuClass(args, ...) は、シンプルなクラスの雛形を生成します。
@param Mix [...] - constructに渡す引数をいくつでも指定できます。
@return Function - シンプルなクラスの雛形を生成するクロージャを返します。
uuClass は、2つの機能を持ちます。
- カプセル化し、役割を明確にします。
- construct メソッドが定義されている場合は、インスタンス生成時に construct メソッドを自動的に呼び出します。
Run new MyClass(arg1, arg2); は、
construct(arg1, arg2) を呼び出します。
function boot() {
var MyClass = uuClass();
MyClass.prototype = {
construct: function(var1, var2 /*, ... */) {
// 初期化
this._var1 = var1;
this._var2 = var2;
},
method: function() {
return this._var1 * this._var2;
}
};
var my = new MyClass(10, 20); // 自動的に construct() を実行する。
document.getElementById("log").innerHTML += my.method(); // "200"
}
window.onload = boot;
- uuClass.Generic - create generic class - 汎用クラスの雛形を生成
-
uuClass.Generic(args, ...) は、汎用的なクラスの雛形を生成します。
@param Mix [...] - construct に渡す引数をいくつでも指定できます。
@return Function - 汎用クラスの雛形を生成するクロージャを返します。
uuClass.Generic() は uuClass() に機能を追加したものです。より幅広い用途に利用可能です。
- カプセル化し、役割を明確にします。
- construct メソッドが定義されている場合は、インスタンス生成時に construct メソッドを自動的に呼び出します。
- destruct メソッドが定義されている場合は、ページ遷移時に destruct メソッドを自動的に呼び出します。
- 個々のインスタンスを識別するために システム全体を通じてユニーク(唯一)な値を持つ uuid プロパティを自動で追加します(既に存在する場合は追加しません)。
- msgbox メソッドが定義されている場合は メッセージポンプに登録し(uuClass.MsgPump.regist)使えるようにします。
- uuClass.Singleton - create singleton class - シングルトンクラスの雛形を生成
-
uuClass.Singleton(args, ...) は、シングルトンクラスの雛形を生成します。
シングルトンパターンを JavaScript で実装したものです。
一つ存在すれば十分なものや、new する度に新しく生成できてしまうとまずいものはシングルトンクラスにします。
@param Mix [...] - construct に渡す引数をいくつでも指定できます。
@return Function - Singleton クラスの雛形を生成するクロージャを返します。
uuClass.Singleton は uuClass.Generic に、機能を追加したものです。
- カプセル化し、役割を明確にします。
- new 済みのインスタンスがある場合は、新しくインスタンスを生成せずに、既存のインスタンスへの参照を返します。
- construct メソッドが定義されている場合は、1度目の new で construct メソッドを呼び出します。
- stabled メソッドが定義されている場合は、2度目以降の new で stabled メソッドを呼び出します。
- destruct メソッドが定義されている場合は、インスタンス破棄 や ページ遷移時に destruct メソッドを自動的に呼び出します。
- 個々のインスタンスを識別するために システム全体を通じてユニーク(唯一)な値を持つ uuid プロパティを自動で追加します(既に存在する場合は追加しません)。
- msgbox メソッドが定義されている場合は メッセージポンプに登録し(uuClass.MsgPump.regist)使えるようにします。
Run
何度 new してもシングルトンクラスの実体は一つしか生成されません
var MyClass = uuClass.Singleton();
MyClass.prototype = {
construct: function() { log("call construct"); },
stabled: function() { log("call stabled"); },
destruct: function() { log("call destruct"); },
method: function() { log("call method"); }
};
var my = new MyClass();
my.method();
var my2 = new MyClass(); // 二度目のnew
my.method();
log(my === my2); // "true" myとmy2は同じもの(シングルトン)
window.setTimeout(function() {
if (window.confirm("jump to http://www.example.com/")) {
// ページ遷移が発生するため、自動的に destruct() を1度だけ実行する。
window.location.href = "http://www.example.com/";
}
}, 1000);
IE base browser is true
Gecko base browser(Firefox, Camino) is true
WebKit base browser(Safari, Chrome, Konqueror) is true
Opera base browser(Opera, Wii) is true