Dabten Usage : Utilities (methods)

UP PREV NEXT

Dabten.Net.Load(url, callback, option)

いわゆるAjaxライブラリ。
戻り値はObject。
Object.clientがXMLHttpRequest/ActiveXObject本体。

---- 引数 ----

url (String)
データ送信先URI
callback (Function | null)
受信完了後に呼び出すコールバック関数
option (String | %CorrespondData)
サーバーに送信するデータ
文字列を渡すと{postData:送信データ}として扱います。
{postData:フォームエレメント}または{postData:[フォームエレメントの配列]}とすることで、そのフォームの値を送信できます。
%CorrespondDataについて
%CorrespondDataからの変更点
namespace: (String , default: null)
XHTML/SMLのノードに適用するnamespace
第一引数 type が'dom'の時に有効。
XHTMLで作成している場合に true、または、<html>タグのxmlns属性を指定してください。
Rangeヘッダの送信

Accespt-Rangesに対応しているブラウザでは、headers:{'Accespt-Ranges': 'ByteRange', Range: 'bytes=***'}を使用することで、だぶ天がmultipart/byterangeデータを自動的に分割します。
（サンプル.3参照）

---- サンプル .1----

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');
}

---- サンプル .2----

var o=new Dabten.Net.Load('sample.cgi', callback,
  {
     postData:document.getElementById('form1')
    ,onFileNotFound:callbackError
    ,onError:callbackError
    ,async:true
    ,method:'GET'
  });

<form id="form1">
<input type="hidden" name="page" value="1">
<select name="category">
<option value="1"sports</option>
<option value="2"arts</option>
<option value="3"books</option>
</select>
</form>

---- サンプル .3----

Rangeを使用し、自動的にmultipart/byterangesのデータを分割します。
コールバック関数の引数から、.rangesプロパティとして取得できます。

.rangesは、以下の構造を持つオブジェクトの配列です

ranges=[
  {
    name: '' /* 通常は空文字列 */
   ,data: '' /* データ本体、responseTextに相当 */
   ,headers: /* プロパティは可変、getResponseHeaderに相当 */
      {
        disposition: 'text'
       ,contentType: 'text/plain'
      }
  }
]
var o=new Dabten.Net.Load('sample.txt', callback,
  {
    headers:{'Accespt-Ranges': 'ByteRange', Range: 'bytes=0-99,300-399'}
  });


function callback(aj){
    for(var i=0;i<;aj.ranges.length;i++){
        alert(aj.ranges[i].data);
    }
    /* raw data はresponseTextから取得できます */
    alert(aj.client.responseText);
}

UP PREV NEXT

Dabten.InsertCSS(url, option)

スタイルシートを挿入します。
可能なかぎり<head>の中に入れますが、入れられないときはdocument.write()で<link>タグを書き出します。

href以外の属性として、
type="text/css"
rel="stylesheet"
が自動的に作成されます。

---- 引数 ----

url (String)
スタイルシートのURI
option (Object)
{id: (String), title: (String), media: (String), charset: (String), rel: (String), alternate: (Boolean)}
 <link>要素の属性
id: (String ; default: null)
ID
title: (String ; default: null)
タイトル
media: (String ; default: null)
メディア
charset: (String ; default: null)
文字コード
ID、クラス名やfontfamilyに日本語などが含まれている場合は指定してください。
rel: (String ; default: null)
'alternate' または 'alternate stylesheet' を指定可能。
スタイルシートをalternate(代替)にします。
alternate: (Boolean ; default: false)
{rel:'alternate'}と同等。

---- サンプル ----

Dabten.InsertCSS('style.css', {title: 'My Style Sheet'});

UP PREV NEXT

%CorrespondData

Dabten.Net.Load()、Dabten.Load()、Dabten.LoadMixed()、Dabten.InsertFromURI()、Dabten.InsertJSONP()で使用するデータ

{method: (String), postData: (String | Object | HTMLFormElement), user: (String), password: (String), enctype: (String), encoded: (Boolean), headers: (Object), onSuccess: (Function), onFileNotFound: (Function), onError: (Function), async: (Boolean), force: (Boolean), callback: (Function)}
method: (String , default: "GET")
送信メソッド。"GET"、"POST"、"HEAD"のいずれか
postData (String | Object | FormElement | Array)
サーバーに送信するデータ
Objectが渡された場合は、そのプロパティと値を組にして送信します。
Formオブジェクト、またはFormオブジェクトの配列が渡された場合は、そのnameとvalueを組にして送信します。
enctype (String , default:"applecation/x-www-form-urlencoded")
送信データ種別
"application/x-www-form-urlencoded"、"multipart/form-data"、"multipart/mixed"をサポート。
ただし、ファイルフィールドのデータ(ファイル)はJavaScriptの制限により送信できません。(postDataの内容のみ送信します。)
multipart/form-data、multipart/mixedについての詳細はmultipartの項目を御覧ください。
encoded (Boolean , default:false)
送信データがURIエンコードされているか
falseが指定されるとencodeURIComponentを使用してエンコードします。
headers: (Object)
RequestHeader
onSuccess (Function)
受信完了後、読み込み等の全ての処理が正常に終了した後に呼び出すコールバック関数
呼び出し時の引数にはDabten.Netが作成したオブジェクト
obj.clientプロパティがXMLHttpRequestオブジェクト本体です。
別途、コールバック関数が指定されている場合でも、このオプションが優先されます。
onFileNotFound (Function)
受信完了後、ファイルが存在しない場合に呼び出すコールバック関数
呼び出し時の引数にはDabten.Netが作成したオブジェクト
obj.clientプロパティがXMLHttpRequestオブジェクト本体です。
onError (Function)
受信完了後、エラーがあった場合に呼び出すコールバック関数
呼び出し時の引数にはDabten.Netが作成したオブジェクト
obj.clientプロパティがXMLHttpRequestオブジェクト本体です。
user (String)
ユーザー名
password (String)
パスワード
async (Boolean , default:true)
非同期指定
force (Boolean , default:false)
強制再読み込み指定
ユニークURIの作成とLast-Modified-Ifヘッダを併用し、ブラウザのキャッシュを使わずに再読み込みを行います。
callback (Function)
受信完了後に呼び出すコールバック関数
onSuccess、onFileNotFound、onErrorの全てをこのオプションで上書きします。

onSuccess、onFileNotFound、onError、callbackオプションは大文字、小文字を区別しません。
それ以外のオプションは大文字、小文字を区別します。