だぶ天 [メソッド]

<body class="subpages"> <div id="header" class="floatend"> <div id="top"> <h2>JavaScript Template Engine</h2> <h1>だぶ天 <sup>Dabten</sup> </h1> <h2 align="right"><sub>Wings-Winds</sub></h2> </div> <hr noshade> </div> <div id="toc"> <ul class="fileinfo flask"> <li class="flask fluidlist" title="latest item">発売日 <ul> <li>2008. 8.15 （初版2007.10.1）</li> </ul> </li> <li class="flask fluidlist" title="download and takeout">持ち帰り <ul> <li><a href="/download/source/dabten.1.0.sit">dabten.1.0.sit</a></li> <li><a href="/download/source/dabten.1.0.lzh">dabten.1.0.lzh</a></li> <li><a href="/download/source/dabten.1.0.zip">dabten.1.0.zip </a></li> </ul> </li> <li class="flask fluidlist" title="source">たれ <ul> <li><a href="/download/source/dabten.js" title="javascript source code">dabten.js</a></li> <li><a href="/download/source/readme.txt" title="READ ME">readme.txt</a></li> <li><a href="/download/source/method.txt" title="Methods">method.txt</a></li> <li><a href="/download/source/template.txt" title="Template">template.txt</a></li> </ul> </li> <li class="flask fluidlist" title="menu">御品書 <ul> <li><a href="/index.html" title="index">入口</a></li> <li><a href="/method/index.html" title="method">めし</a></li> <li><a href="/template/index.html" title="template">てんぷら</a></li> <li><a href="/support/index.html" title="support">つけ合わせ</a></li> <li><a href="/samples/index.html" title="sample">試食</a></li> <li><a href="/download/index.html" title="download">勘定</a></li> </ul> </li> </ul> </div> <div id="atp" style="padding-left: 2em;"> <ul class="topicpath flask"> <li><a href="/index.html" title="入り口">HOME</a></li> <li>Coding</li> <li><a href="method.html" title="めし">Methods</a></li> </ul> <h2 class="cl">Dabten Usage : めし（Method）</h2> </div> <div id="maincontents"> <div class="menu"> <ul> <li class="outcat"><a href="/method/index.html">入り口</a></li> <li class="incat"><a href="/method/index.html">めし</a> <ul> <li class="first"><a href="#writeInHtml">HTML記述</a></li> <li><a href="#Load">Dabten.Load()</a></li> <li><a href="#LoadMixed">Dabten.LoadMixed()</a></li> <li><a href="#GetHTML">Dabten.GetHTML()</a></li> <li><a href="#GetDOM">Dabten.GetDOM()</a></li> <li><a href="#GetXML">Dabten.GetXML()</a></li> <li><a href="#InsertHTML">Dabten.InsertHTML()</a></li> <li><a href="#InsertDOM">Dabten.InsertDOM()</a></li> <li><a href="#Test">Dabten.Test()</a></li> <li><a href="#TestGroup">Dabten.TestGroup()</a></li> <li><a href="#GetFromURI">Dabten.GetFromURI()</a></li> <li><a href="#InsertFromURI">Dabten.InsertFromURI()</a></li> <li><a href="#InsertJSONP">Dabten.InsertJSONP()</a></li> <li><a href="#NetLoad">Dabten.Net.Load()</a></li> </ul> </li> <li class="outcat"><a href="/template/index.html">てんぷら</a></li> <li class="outcat"><a href="/support/index.html">付け合わせ</a></li> <li class="outcat"><a href="/samples/index.html">試食</a></li> <li class="outcat"><a href="/download/index.html">勘定</a></li> </ul> </div> <div class="description"> <div id="writeInHtml" class="function first"> <p class="control"><a href="#top" title="Page TOP"><img src="images/up.gif" alt="UP"></a> <a href="#top" title="Page TOP"><img src="images/prev.gif" alt="PREV"></a> <a href="#Load" title="Dabten.Load()"><img src="images/next.gif" alt="NEXT"></a></p> <h3>HTML記述</h3> <p> <code><tt><script type="text/javascript" src="dabten.js"></script></tt></code><br> を記述し、dabten.jsを読み込んでください。<br> Dabtenというオブジェクトを生成しますので、以降、このオブジェクトのメソッドを使用してテンプレートファイルにアクセスしてください。 </p> </div> <div id="Load" class="function"> <p class="control"><a href="#top" title="Page TOP"><img src="images/up.gif" alt="UP"></a> <a href="#writeInHtml" title="HTML記述"><img src="images/prev.gif" alt="PREV"></a> <a href="#LoadMixed" title="Dabten.GetHTML()"><img src="images/next.gif" alt="NEXT" border="0"></a></p> <h3>Dabten.Load(files, option)</h3> <p><a href="/template/index.html">テンプレートファイル</a>をロードします。</p> <h4>---- 引数 ----</h4> <dl> <dt>files (Object)</dt> <dd> <code><tt>{ID1: ファイル1, ID2: ファイル2 [, ...] }</tt><br></code> このIDはテンプレートからHTMLやDOMノードツリーを作成するときに参照します。<br> Load()関数は何度でも呼び出せますが、IDは共有されます。<br> 同じIDが指定された場合は上書きされます。</dd> <dt>option (Object)</dt> <dd> <code><tt>{method: (String), postData: (String||Object), user: (String), password: (String), enctype: (String), encoded: (Boolean), headers: (Object), onsuccess: (Function)}</tt><br> </code> サーバーに送信するデータ、および受信後の動作指示 <dl> <dd> </dd> <dt>method: (String)</dt> <dd>送信メソッド。"GET"または"POST"</dd> <dt>postData (String, Object)</dt> <dd>サーバーに送信するデータ<br> Objectが渡された場合は、そのプロパティと値を組にして送信します。</dd> <dt>encoded (Boolean , default:false)</dt> <dd>送信データがURIエンコードされているか<br> falseが指定されるとencodeURIComponentを使用してエンコードします。</dd> <dt>enctype (String , default:"applecation/x-www-form-urlencoded")</dt> <dd>送信データ種別<br> "application/x-www-form-urlencoded"をサポート</dd> <dt>user: (String)</dt> <dd>Authroizationが必要なページで使用するユーザー名</dd> <dt>password: (String)</dt> <dd>Authroizationが必要なページで使用するパスワード</dd> <dt>headers: (Object)</dt> <dd>RequestHeader</dd> <dt>onsuccess: (Function)</dt> <dd><code><tt>{id1: (Function), id2: (Function) [, ...]}</tt><br></code> <dd>指定したIDのファイルが読み終わると実行されるコールバック関数です。</dd> </dl> </dd> </dl> <h4>---- サンプル ----</h4> <pre><tt>Dabten.Load( { id1:'tpldetail.txt' ,id2:'tpldetail2.tpl' ,id3:'tpldetail3.html' } , { onsuccess:callback } );</tt></pre> </div> <div id="LoadMixed" class="function"> <p class="control"><a href="#top" title="Page TOP"><img src="images/up.gif" alt="UP"></a> <a href="#Load" title="Dabten.Load()"><img src="images/prev.gif" alt="PREV" border="0"></a> <a href="#GetHTML" title="Dabten.GetHTML()"><img src="images/next.gif" alt="NEXT" border="0"></a></p> <h3>Dabten.LoadMixed(uri, files, option)</h3> <p>multipart/mixed形式の<a href="/template/index.html">テンプレートファイル</a>をロードします。<br> 送信はmethod="POST"、encode-type: "multipart/form-data"になります。<br> ＊今後のバージョンで大幅な仕様変更を予定しています</p> <h4>---- 引数 ----</h4> <dl> <dt>files (Object)</dt> <dd> <code><tt>{ID1: ファイル1, ID2: ファイル2 [, ...] }</tt><br></code> このIDはテンプレートからHTMLやDOMノードツリーを作成するときに参照します。<br> Load()関数は何度でも呼び出せますが、IDは共有されます。<br> 同じIDが指定された場合は上書きされます。</dd> <dt>option (Object)</dt> <dd> <code><tt>{method: (String), postData: (String||Object), user: (String), password: (String), enctype: (String), encoded: (Boolean), headers: (Object), onsuccess: (Function)}</tt><br> </code> サーバーに送信するデータ、および受信後の動作指示 <dl> <dd> </dd> <dt>method: (String)</dt> <dd>送信メソッド。"POST"のみ</dd> <dt>postData (String, Object)</dt> <dd>サーバーに送信するデータ<br> Objectが渡された場合は、そのプロパティと値を組にして送信します。</dd> <dt>encoded (Boolean , default:false)</dt> <dd>送信データがURIエンコードされているか<br> falseが指定されるとencodeURIComponentを使用してエンコードします。</dd> <dt>enctype (String , default:"multipart/form-data")</dt> <dd>送信データ種別<br> "multipart/form-data"、"multipart/mixed"をサポート</dd> <dt>user: (String)</dt> <dd>Authroizationが必要なページで使用するユーザー名</dd> <dt>password: (String)</dt> <dd>Authroizationが必要なページで使用するパスワード</dd> <dt>headers: (Object)</dt> <dd>RequestHeader</dd> <dt>onsuccess: (Function)</dt> <dd><code><tt>{id1: (Function), id2: (Function) [, ...]}</tt><br></code> <dd>指定したIDのファイルが読み終わると実行されるコールバック関数です。</dd> </dl> </dd> </dl> <h4>---- サンプル ----</h4> <pre><tt>Dabten.Load( sample.cgi ,{ id1:'tpldetail.txt' ,id2:'tpldetail2.tpl' ,id3:'tpldetail3.html' } , { onsuccess:callback } );</tt></pre> </div> <div id="GetHTML" class="function"> <p class="control"><a href="#top" title="Page TOP"><img src="images/up.gif" alt="UP"></a> <a href="#LoadMixed" title="Dabten.LoadMixed()"><img src="images/prev.gif" alt="PREV" border="0"></a> <a href="#GetDOM" title="Dabten.GetDOM()"><img src="images/next.gif" alt="NEXT"></a></p> <h3>Dabten.GetHTML(ID, data)</h3> <p>戻り値は通常の文字列です。<br> <a href="#Load">Dabten.Load()</a>で指定されていないIDが指定された場合、<br> または<a href="#Load">Dabten.Load()</a>に失敗したファイルのIDが指定された場合は空文字列が返されます。</p> <h4>---- 引数 ----</h4> <dl> <dt>ID (String)</dt> <dd><a href="#Load">Dabten.Load()</a>の第一引数のIDに対応。</dd> <dt>data (Object)</dt> <dd><code><tt>{var: value [, ...] } | {wrapper: [{var: value [, ...] } ]}</tt><br></code> テンプレートの{tpl:var}に適用するデータ</dd> </dl> <h4>---- サンプル ----</h4> <pre><tt>document.getElementById('docid').innerHTML = Dabten.GetHTML('id', {name:'Joe',age:33});</tt></pre> </div> <div id="GetDOM" class="function"> <p class="control"><a href="#top" title="Page TOP"><img src="images/up.gif" alt="UP"></a> <a href="#GetHTML" title="Dabten.GetHTML()"><img src="images/prev.gif" alt="PREV"></a> <a href="#GetXML" title="Dabten.GetXML()"><img src="images/next.gif" alt="NEXT"></a></p> <h3>Dabten.GetDOM(ID, data, namespace)</h3> <p>DOMエレメント<br> 戻り値はリスト(配列)となります。</p> <h4>---- 引数 ----</h4> <dl> <dt>ID (String)</dt> <dd>Load()の第一引数のIDに対応。</dd> <dt>data (Object)</dt> <dd><code><tt>{var: value [, ...] } | {wrapper: [{var: value [, ...] } ]}</tt><br></code> テンプレートの{tpl:var}に適用するデータ</dd> <dt>namespace (Boolean||String , Default: true)</dt> <dd>trueが指定されるとXHTMLで作成している場合にhtmlタグのxmlns属性を取得し、DOMエレメント生成時のnamespaceとして使用します。<br> falseが指定されるとXHTMLの時でもnamespaceは使用しません。<br> 独自のnamespaceを指定するときは、文字列で指定してください。<br> XHTML1.0、XHTML1.1では xmlns属性は "https://www.w3.org/1999/xhtml" と決まっています。</dd> </dl> <h4>---- サンプル .1 ----</h4> <p>template.tpl</p> <pre><tt><h1>{tpl:title}</h1> <p>{tpl:summary}</p></tt></pre> <p>script</p> <pre><tt>domarray=<samp>Dabten.GetDOM</samp>(tplId, {title:'学生簿', summary:'２年１組男子生徒一覧'}); docobj=document.getElementById('doc'); for(var id=0;i<domarray.length;i++){ docobj.appendChild(domarray[i]); }</tt></pre> <h4>---- サンプル .2----</h4> <p>template.tpl</p> <pre><tt>{tpl::repeat=students} <tr> <td>{tpl:sid}</td> <td>{tpl:name}</th> </tr> {tpl::endrepeat}</tt></pre> <p>script</p> <pre><tt>data={students:[ {sid:1, name:'Joe'} ,{age:2, name:'Peat'} ]}; domarray=<samp>Dabten.GetDOM</samp>(tplId, data); table=document.getElementsByTagName('table')[0]; tbody=table.getElementsByTagName('tbody')[0]; for(var i=0;i<domarray.length;i++){<br> tbody.appendChild(domobj[i]); }</tt></pre> </div> <div id="GetXML" class="function"> <p class="control"><a href="#top" title="Page TOP"><img src="images/up.gif" alt="UP"></a> <a href="#GetDOM" title="Dabten.GetDOM()"><img src="images/prev.gif" alt="PREV"></a> <a href="#Set" title="Dabten.Set()"><img src="images/next.gif" alt="NEXT"></a></p> <h3>Dabten.GetXML(ID, data, slt);</h3> <p><strong class="caution">この機能は現在サポートしていません。</strong><br> テンプレートファイルはrootとなるノード(タグ)が必須。<br> XSLの適用はブラウザのXSLTを使用します。</p> <p>戻り値はXMLエレメントとなります。</p> <h4>---- 引数 ----</h4> </div> <div id="Set" class="function"> <p class="control"><a href="#top" title="Page TOP"><img src="images/up.gif" alt="UP"></a> <a href="#GetXML" title=".GetXML()"><img src="images/prev.gif" alt="PREV"></a> <a href="#Document" title="Dabten.Document()"><img src="images/next.gif" alt="NEXT"></a></p> <h3>Dabten.Set(ID, str)</h3> <p><a href="#Load">Dabten.Load()</a>の代わりにIDと文字列を指定し、登録します。<br> </p> </div> <div id="Document" class="function"> <p class="control"><a href="#top" title="Page TOP"><img src="images/up.gif" alt="UP"></a> <a href="#Set" title="Dabten.Set()"><img src="images/prev.gif" alt="PREV"></a> <a href="#InsertHTML" title="Dabten.InsertHTML()"><img src="images/next.gif" alt="NEXT"></a></p> <h3>Dabten.Document(ID, elementID)</h3> <p><a href="#Load">Dabten.Load()</a>の代わりにドキュメント内のHTML/XHTMLを読み込み、登録します。<br> 現在はinnerHTMLを使用するだけなので、そのエレメント自身は含まれません。 </p> </div> <div id="InsertHTML" class="function"> <p class="control"><a href="#top" title="Page TOP"><img src="images/up.gif" alt="UP"></a> <a href="#Document" title="Dabten.Document()"><img src="images/prev.gif" alt="PREV"></a> <a href="#InsertDOM" title="Dabten.InsertDOM()"><img src="images/next.gif" alt="NEXT"></a></p> <h3>Dabten.InsertHTML(elementID, ID, Object)</h3> <p><a href="#GetHTML">Dabten.GetHTML()</a>で作成したHTMLを、第一引数で指定したエレメントに入れ換えます。</p> <p>戻り値は成功時 true、失敗時 false</p> <h4>---- 引数 ----</h4> <dl> <dt>element (String || HTML-DOM-Element) </dt> <dd>HTML/XHTMLドキュメント内の要素、またはそのID</dd> <dt>ID (String)</dt> <dd><a href="#Load" title="Dabten.Load()">Dabten.Load()</a>の第一引数のIDに対応。</dd> <dt>data (Object)</dt> <dd><code><tt>{var: value [, ...] } | {wrapper: [{var: value [, ...] } ]}</tt><br></code> テンプレートの{tpl:var}に適用するデータ</dd> </dl> <h4>---- サンプル .1 ----</h4> <pre><tt>Dabten.InsertHTML('docid', 'tplid', {name:'Joe',age:33});</tt></pre> <h4>---- サンプル .2 ----</h4> <pre><tt>var elm=document.getElementById('docid'); Dabten.InsertHTML(elm, 'tplid', {name:'Joe',age:33});</tt></pre> </div> <div id="InsertDOM" class="function"> <p class="control"><a href="#top" title="Page TOP"><img src="images/up.gif" alt="UP"></a> <a href="#InsertHTML" title="Dabten.InsertHTML()"><img src="images/prev.gif" alt="PREV"></a> <a href="#Test" title="Dabten.Test()"><img src="images/next.gif" alt="NEXT"></a></p> <h3>Dabten.InsertDOM(element, ID, Object, add, namespace)</h3> <p><a href="#GetDOM">Dabten.GetDOM()</a>で作成したDOMエレメントを、第一引数で指定したエレメントに追加、または入れ換えます。</p> <p>戻り値は成功時 true、失敗時 false</p> <h4>---- 引数 ----</h4> <dl> <dt>element (String || HTML-DOM-Element) </dt> <dd>HTML/XHTMLドキュメント内の要素、またはそのID</dd> <dt>ID (String)</dt> <dd><a href="#Load" title="Dabten.Load()">Dabten.Load()</a>の第一引数のIDに対応。</dd> <dt>data (Object)</dt> <dd><code><tt>{var: value [, ...] } | {wrapper: [{var: value [, ...] } ]}</tt><br></code> テンプレートの{tpl:var}に適用するデータ</dd> <dt>add (Boolean , Default: false)</dt> <dd>HTMLを追加(true)するか更新(false)するかの指定。</dd> <dt>namespace (Boolean||String , Default: true)</dt> <dd>trueが指定されるとXHTMLで作成している場合にhtmlタグのxmlns属性を取得し、DOMエレメント生成時のnamespaceとして使用します。<br> falseが指定されるとXHTMLの時でもnamespaceは使用しません。<br> 独自のnamespaceを指定するときは、文字列で指定してください。<br> DOMエレメント作成時にnamespace付きで作成するようになります。<br> XHTML1.0、XHTML1.1では xmlns属性は "https://www.w3.org/1999/xhtml" と決まっています。</dd> </dl> <h4>---- サンプル .1 ----</h4> <pre><tt>Dabten.InsertDOM('docid', 'tplid', {name:'Joe',age:33});</tt></pre> </div> <div id="Test" class="function"> <p class="control"><a href="#top" title="Page TOP"><img src="images/up.gif" alt="UP"></a> <a href="#InsertDOM" title="Dabten.InsertDOM()"><img src="images/prev.gif" alt="PREV"></a> <a href="#TestGroup" title="Dabten.TestGroup()"><img src="images/next.gif" alt="NEXT"></a></p> <h3>Dabten.Test(id);</h3> <p><strong class="caution">この機能は現在サポートしていません。</strong><br> <a href="#Load">Dabten.Load()</a>で指定されたIDに対応したファイルが正常に読み込めたかどうかをテストします。</p> </div> <div id="TestGroup" class="function"> <p class="control"><a href="#top" title="Page TOP"><img src="images/up.gif" alt="UP"></a> <a href="#Test" title="Dabten.Test()"><img src="images/prev.gif" alt="PREV"></a> <a href="#GetFromURI" title="Dabten.GetFromURI()"><img src="images/next.gif" alt="NEXT"></a></p> <h3>Dabten.TestGroup(groupID);</h3> <p><strong class="caution">この機能は現在サポートしていません。</strong><br> <a href="#Load">Dabten.Load()</a>で指定された全てのファイルが正常に読み込めたかどうかをテストします。<br> groupIDは<a href="#Load">Dabten.Load()</a>が呼び出された順番に、0からの連番になります。</p> </div> <div id="GetFromURI" class="function"> <p class="control"><a href="#top" title="Page TOP"><img src="images/up.gif" alt="UP"></a> <a href="#TestGroup" title="Dabten.TestGroup()"><img src="images/prev.gif" alt="PREV"></a> <a href="#InsertFromURI" title="Dabten.InsertFromURI()"><img src="images/next.gif" alt="NEXT"></a></p> <h3>Dabten.GetFromURI(type, id, uri, option)</h3> <p><a href="#GetHTML">Dabten.GetHTML()</a>、<a href="#GetDOM">Dabten.GetDOM()</a>、<a href="#GetXML">Dabten.GetXML()</a>の代わりに<br> CGIスクリプトなどのデータを受信し、テンプレートに適用します。<br> CGIスクリプトから取得するデータは、プレーンテキスト(JSON)です。</p> <h4>---- 引数 ----</h4> <dl> <dt>type (String)</dt> <dd>'html', 'dom'のいずれか<br> 戻り値のタイプをHTML、HTML-DOMエレメントのいずれかにします。</dd> <dt>id (String)</dt> <dd><a href="#Load">Dabten.Load()</a>の第一引数のIDに対応。</dd> <dt>uri (String)</dt> <dd>データ受信のためのCGIスクリプトのURI</dd> <dt>option (Object)</dt> <dd><code><tt>{method: (String), postData: (String), user: (String), password: (String), enctype: (String), encoded: (Boolean), headers: (Object), onFileNotFound: (Function), onError: (Function), async: (boolean), namespace: (String), slt: (Object)}</tt><br></code> サーバーに送信するデータ、および受信後の動作指示 <dl> <dt>method: (String)</dt> <dd>送信メソッド。"GET"または"POST"</dd> <dt>postData (String, Object)</dt> <dd>サーバーに送信するデータ<br> Objectが渡された場合は、そのプロパティと値を組にして送信します。</dd> <dt>user: (String)</dt> <dd>Authroizationが必要なページで使用するユーザー名</dd> <dt>password: (String)</dt> <dd>Authroizationが必要なページで使用するパスワード</dd> <dt>enctype (String , default:"applecation/x-www-form-urlencoded")</dt> <dd>送信データ種別<br> "application/x-www-form-urlencoded"、"multipart/form-data"、"multipart/mixed"をサポート</dd> <dt>encoded (Boolean , default:true)</dt> <dd>送信データがURIエンコードされているか<br> falseが指定されるとencodeURIComponentを使用してエンコードします。</dd> <dt>headers: (Object)</dt> <dd>RequestHeader</dd> <dt>onSuccess (Function)</dt> <dd>受信、および挿入完了後に呼び出すコールバック関数<br> 呼び出し時の引数にはHTML、HTML/XHTML-DOMエレメントの配列、XML-DOMエレメントのいずれかになります。</dd> <dt>onFileNotFound (Function)</dt> <dd>受信完了後、ファイルが存在しない場合に呼び出すコールバック関数<br> 呼び出し時の引数にはDabten.Netが作成したオブジェクト<br> obj.clientプロパティがXMLHttpRequestオブジェクト本体です。</dd> <dt>onError (Function)</dt> <dd>受信完了後、エラーがあった場合に呼び出すコールバック関数<br> 呼び出し時の引数にはDabten.Netが作成したオブジェクト<br> obj.clientプロパティがXMLHttpRequestオブジェクト本体です。</dd> <dt>async (Boolean , default:true)</dt> <dd>非同期指定</dd> <dt>namespace: (String)</dt> <dd>XHTML/SMLのノードに適用するnamespace<br> typeが'xml'または'dom'の時に有効。<br> XHTMLで作成している場合に true、または、htmlタグのxmlns属性を指定してください。</dd> </dl> </dd> </dl> <h4>---- サンプル ----</h4> <p>template.tpl</p> <pre><tt><h1>{tpl:title}</h1> <p>{tpl:summary}</p></tt></pre> <p>script</p> <pre><tt>domarray=Dabten.GetFromURI('dom', tplId, 'data.cgi'); docobj=document.getElementById('doc'); for(var id=0;i<domarray.length;i++){ docobj.appendChild(domarray[i]); }</tt></pre> <p>受け取り時のデータは通常のeval(responseText)を使用してJavaScriptのObject（JSON）に変換できる形式のみ対応しています。<br> <strong>varが付いているとエラーになります</strong>。</p> <pre><tt>var data={ key : value};　//受け取れない</tt></pre> <pre><tt>data={ key: value };  // 受け取れる</tt></pre> </div> <div id="InsertFromURI" class="function"> <p class="control"><a href="#top" title="Page TOP"><img src="images/up.gif" alt="UP"></a> <a href="#GetFromURI" title="Dabten.GetFromURI()"><img src="images/prev.gif" alt="PREV"></a> <a href="#InsertJSONP" title="Dabten.InsertJSONP()"><img src="images/next.gif" alt="NEXT"></a></p> <h3>Dabten.InsertFromURI(element, type, id, uri, option)</h3> <p><a href="#GetHTML">Dabten.GetHTML()</a>、<a href="#GetDOM">Dabten.GetDOM()</a>、<a href="#GetXML">Dabten.GetXML()</a>の代わりに<br> CGIスクリプトなどのデータを受信し、テンプレートに適用します。<br> CGIスクリプトから取得するデータは、プレーンテキスト(JSON)、XMLのいずれかです。<br> 戻り値は、正常に完了すればtrue、失敗すればfalse<br> asyncがtrueの場合は、データの送信までで戻り値を返します。</p> <h4>---- 引数 ----</h4> <dl> <dt>element (String || HTML-DOM-Element) </dt> <dd>HTML/XHTMLドキュメント内の要素、またはそのID</dd> <dt>type (String)</dt> <dd>'html', 'dom', 'xml'のいずれか<br> 戻り値のタイプをHTML、HTML-DOMエレメント、XML-DOMエレメントのいずれかにします。</dd> <dt>id (String)</dt> <dd><a href="#Load">Dabten.Load()</a>の第一引数のIDに対応。</dd> <dt>uri (String)</dt> <dd>データ受信のためのCGIスクリプトのURI</dd> <dt>option (Object)</dt> <dd><code><tt>{method: (String), postData: (String), user: (String), password: (String), enctype: (String), encoded: (Boolean), headers: (Object), onFileNotFound: (Function), onError: (Function), async: (boolean), add: (Boolean), namespace: (String), slt: (Object)}</tt><br></code> サーバーに送信するデータ、および受信後の動作指示 <dl> <dt>method: (String)</dt> <dd>送信メソッド。"GET"または"POST"</dd> <dt>postData (String, Object)</dt> <dd>サーバーに送信するデータ<br> Objectが渡された場合は、そのプロパティと値を組にして送信します。</dd> <dt>user: (String)</dt> <dd>Authroizationが必要なページで使用するユーザー名</dd> <dt>password: (String)</dt> <dd>Authroizationが必要なページで使用するパスワード</dd> <dt>enctype (String , default:"applecation/x-www-form-urlencoded")</dt> <dd>送信データ種別<br> "application/x-www-form-urlencoded"、"multipart/form-data"、"multipart/mixed"をサポート</dd> <dt>encoded (boolean , default:true)</dt> <dd>送信データがURIエンコードされているか<br> falseが指定されるとencodeURIComponentを使用してエンコードします。</dd> <dt>headers: (Object)</dt> <dd>RequestHeader</dd> <dt>onSuccess (Function)</dt> <dd>受信、および挿入完了後に呼び出すコールバック関数<br> 呼び出し時の引数にはHTML、HTML/XHTML-DOMエレメントの配列のいずれかになります。</dd> <dt>onFileNotFound (Function)</dt> <dd>受信完了後、ファイルが存在しない場合に呼び出すコールバック関数<br> 呼び出し時の引数にはDabten.Netが作成したオブジェクト<br> obj.clientプロパティがXMLHttpRequestオブジェクト本体です。</dd> <dt>onError (Function)</dt> <dd>受信完了後、エラーがあった場合に呼び出すコールバック関数<br> 呼び出し時の引数にはDabten.Netが作成したオブジェクト<br> obj.clientプロパティがXMLHttpRequestオブジェクト本体です。</dd> <dt>async (boolean , default:true)</dt> <dd>非同期指定</dd> <dt>add (Boolean , Default: false)</dt> <dd>HTMLを追加(true)するか更新(false)するかの指定。</dd> <dt>namespace: (Boolean || String , Default: true)</dt> <dd>XHTML/SMLのノードに適用するnamespace<br> typeが'xml'または'dom'の時、かつ、ドキュメントがXHTMLまたはXMLの時に有効。<br> XHTMLドキュメントではtrueを指定することで、ドキュメントのhtmlタグに書かれたxmlns属性を取得し、デフォルトのnamespaceとします。</dd> </dl> </dd> </dl> <h4>---- サンプル ----</h4> <p>template.tpl</p> <pre><tt><h1>{tpl:title}</h1> <p>{tpl:summary}</p></tt></pre> <p>script</p> <pre><tt>Dabten.InsertFromURI('elementID', 'dom', 'tplId', 'data.cgi');</tt></pre> <p>受け取り時のデータは通常のeval(responseText)を使用してJavaScriptのObject（JSON）に変換できる形式のみ対応しています。<br> <strong>varが付いているとエラーになります</strong>。</p> <pre><tt>var data={ key : value};　//受け取れない</tt></pre> <pre><tt>data={ key: value };  // 受け取れる</tt></pre> </div> <div id="InsertJSONP" class="function"> <p class="control"><a href="#top" title="Page TOP"><img src="images/up.gif" alt="UP"></a> <a href="#InsertFromURI" title="Dabten.InsertFromURI()"><img src="images/prev.gif" alt="PREV"></a> <a href="#NetLoad" title="Dabten.Net.Load()"><img src="images/next.gif" alt="NEXT"></a></p> <h3>Dabten.InsertJSONP(elm, id, uri, cbkey, post, callback)</h3> <p>JSONPによるテンプレートへのデータ反映を行います。<br> 現在のバージョンでは受け取るデータをテンプレートに反映させるためのコールバック関数が別途必要です。</p> <h4>---- 引数 ----</h4> <dl> <dt>elem (String || HTML-DOM-Element)</dt> <dd>データを挿入するHTMLエレメントのID、またはエレメント自身。</dd> <dt>id (String)</dt> <dd><a href="#Load">Dabten.Load()</a>の第一引数のIDに対応。</dd> <dt>uri (String)</dt> <dd>テンプレートID。<br> データ受信のためのCGIスクリプトのURI</dd> <dt>cbkey (String)</dt> <dd>JSONPを提供しているサーバーが指定する、コールバック関数の名前。<br> 一般的には "callback" </dd> <dt>post (Object)</dt> <dd> サーバーに送信するデータ</dd> <dt>callback (Function)</dt> <dd>JSONPデータを受け取ってから呼び出す関数 </dd> </dl> <h4>---- サンプル ----</h4> </div> <div id="NetLoad" class="function"> <p class="control"><a href="#top" title="Page TOP"><img src="images/up.gif" alt="UP"></a> <a href="#InsertJSONP" title="Dabten.InsertJSONP()"><img src="images/prev.gif" alt="PREV"></a> <a><img src="images/next.gif" alt="NEXT"></a></p> <h3>Dabten.Net.Load(url, callback, option)</h3> <p>いわゆるAjaxライブラリ。<br> 戻り値はObject。<br> Object.clientがXMLHttpRequest/ActiveXObject本体。</p> <h4>---- 引数 ----</h4> <dl> <dt>url (String)</dt> <dd>データ送信先URI</dd> <dt>callback (Function)</dt> <dd>受信完了後に呼び出すコールバック関数</dd> <dt>option (Object)</dt> <dd><code><tt>{method: (String), postData: (String), user: (String), password: (String), enctype: (String), encoded: (Boolean), headers: (Object), onFileNotFound: (Function), onError: (Function), async: (Boolean)}</tt><br></code> サーバーに送信するデータ <dl> <dt>method: (String , default: "GET")</dt> <dd>送信メソッド。"GET"、"POST"、"HEAD"のいずれか</dd> <dt>postData (String, Object)</dt> <dd>サーバーに送信するデータ<br> Objectが渡された場合は、そのプロパティと値を組にして送信します。</dd> <dt>enctype (String , default:"applecation/x-www-form-urlencoded")</dt> <dd>送信データ種別<br> "application/x-www-form-urlencoded"、<a href="#multipart" title="multipart/formdata, multipart/mixed">"multipart/form-data"</a>、<a href="#multipart" title="multipart/formdata, multipart/mixed">"multipart/mixed"</a>をサポート。<br> ただし、ファイルフィールドのデータ(ファイル)はJavaScriptの制限により送信できません。(postDataの内容のみ送信します。)<br> <a href="#multipart" title="multipart/formdata, multipart/mixed">multipart/form-data</a>、<a href="#multipart" title="multipart/formdata, multipart/mixed">multipart/mixed</a>についての詳細は<a href="#multipart" title="multipart/formdata, multipart/mixed">multipart</a>の項目を御覧ください。</dd> <dt>encoded (Boolean , default:false)</dt> <dd>送信データがURIエンコードされているか<br> falseが指定されるとencodeURIComponentを使用してエンコードします。</dd> <dt>headers: (Object)</dt> <dd>RequestHeader</dd> <dt>onFileNotFound (Function)</dt> <dd>受信完了後、ファイルが存在しない場合に呼び出すコールバック関数<br> 呼び出し時の引数にはDabten.Netが作成したオブジェクト<br> obj.clientプロパティがXMLHttpRequestオブジェクト本体です。</dd> <dt>onError (Function)</dt> <dd>受信完了後、エラーがあった場合に呼び出すコールバック関数<br> 呼び出し時の引数にはDabten.Netが作成したオブジェクト<br> obj.clientプロパティがXMLHttpRequestオブジェクト本体です。</dd> <dt>user (String)</dt> <dd>ユーザー名</dd> <dt>password (String)</dt> <dd>パスワード</dd> <dt>async (Boolean , default:true)</dt> <dd>非同期指定</dd> </dl> </dd> </dl> <h4>---- サンプル ----</h4> <pre><tt>var o=new Dabten.Net.Load('sample.cgi', callback, { postData:'postData' ,onFileNotFound:callbackError ,onError:callbackError ,async:true ,method:'GET' }); function callback(obj){ alert(obj.client.responseText); } function callbackError(obj){ alert('something error occured'); }</tt></pre> </div> </div> </div> <div id="footer"> <hr> <div id="copyright" class="copyright"> <h3>COPYRIGHT</h3> <p class="copyright">Copyright(c) Wataru Kanzaki, https://www.wi-wi.jp/, 2007-2012</p> <p>ソースコードに上記著作権表記を記載することを条件に、商用、非商用にかかわらず、自由に改変、利用、配布頂けます<br> 改変の有無にかかわらず、だぶ天単体での販売を禁止します。<br> このプログラムを使用したことより不具合等が生じた場合でも、作者は一切の責任を負いません</p> </div> <div class="sitemap"> <h3>Sitemap</h3> <ul><li><a href="/index.html">HOME</a></li><li><a href="/method/index.html">methods</a></li><li><a href="/template/index.html">template</a></li></ul> <ul><li><a href="/support/index.html">support</a></li><li><a href="/samples/index.html">sample</a></li><li><a href="/download/index.html">download</a></li></ul> <p class="cr">©<a href="https://www.wi-wi.jp/">Wicker-Wings</a></p> </div> </div> </body>