true に設定した場合、次の動作を実行します:
新しい行が追加された後に削除された場合、トランザクションはログに追加されません。
行またはセルが編集された場合、値は元の値に戻され、トランザクションも削除されます。
注: このオプションは、autoCommit が false に設定される場合のみに適用されます。

自動コミットが True の場合、saveChanges() によって値または値の組が更新されると、データは自動的にデータ ソースにコミットされます。

データ バインドの完了時に呼び出すコールバック関数。

コールバック関数を呼び出す対象となるオブジェクト。

これは、データ ソースからフェッチされた後の正規化された (変換された) 結果データです。

クライアント側の dataBinding イベント。関数名を指す文字列または関数を指すオブジェクトが可能です。

クライアント側の dataBound イベント。関数名を指す文字列または関数を指すオブジェクトが可能です。

これはデータのソースです。正規化されていません。配列、JSON オブジェクトへの参照、HTML テーブルの DOM 要素、または関数が可能です。

*** 重要な注意: オプションは非推奨です***
データ ソースのスキーマを指定するフィールド定義のリスト。
フィールド オブジェクトの説明: {fieldName, [fieldDataType], [fieldXPath]}。

組み込みのフィルタリング機能に関連する設定。

• applyToAllData

  タイプ:

  bool

  デフォルト:

  true

  ページング、並べ替え、またはフィルタリングのタイプがローカルの場合、applyToAllData が True であると、ローカルに存在するデータ ソース全体に対してフィルタリングが実行されます。そうでない場合は、現在の dataView に対してのみ実行されます。タイプがリモートの場合、この設定は効果がありません。

  コード サンプル

  jsonDs = new $.ig.RESTDataSource( {     filtering: {         type: "local",         caseSensitive: true,         applyToAllData: true     },     dataSource: jsonData }).dataBind();

• caseSensitive

  タイプ:

  bool

  デフォルト:

  false

  データの大文字と小文字を区別するフィルタリングを有効または無効にします。ローカルのフィルタリングでのみ機能します。

  コード サンプル

  jsonDs = new $.ig.RESTDataSource( {     filtering: {         type: "local",         caseSensitive: true,         applyToAllData: true     },     dataSource: jsonData }).dataBind();

• customConditions

  タイプ:

  object

  デフォルト:

  null

  定義されるカスタム フィルター条件をオブジェクトとして含むオブジェクト。

  コード サンプル

  jsonDs = new $.ig.DataSource( {     filtering: {         type: "local",         caseSensitive: true,         applyToAllData: true,         customConditions: [             BE: {             labelText: "BE",             expressionText: "BE-####",             requireExpr: false,             filterFunc: filterProductNumber             },             CA: {                 labelText: "CA",                 expressionText: "CA-####",                 requireExpr: false,                 filterFunc: filterProductNumber1             }         ]     },     dataSource: jsonData }).dataBind() function filterProductNumber(value, expression, dataType, ignoreCase, preciseDateFormat) {     return value.startsWith("BE"); } function filterProductNumber1(value, expression, dataType, ignoreCase, preciseDateFormat) {     return value.startsWith("CA"); }

• customFunc

  タイプ:

  object

  デフォルト:

  null

  文字列または関数オブジェクトを指すことができます。渡されるパラメーターは、1) フィルタリングされるデータ配列、2) フィルタリングの式定義です。フィルターされたデータの配列を返します。

  コード サンプル

  var ds;   var render = function (success, error) {     if (success) {         var expr = "Cr";         cond = "startsWith";           ds.filter([{             fieldName: "Name",             expr: expr,             cond: cond         }], true);           var template = "<tr><td>${Name}</td><td>${Price}</td><td>${Rating}</td></tr>",         resultHtml = $.ig.tmpl(template, ds.dataView());         $("#table").html(resultHtml);     } else {         alert(error);     } }     var myCustomFunc = function (fieldExpression, data) {     var result = [];     result[0] = data[0];     return result; }   $(window).load(function () {     var url = "http://services.odata.org/OData/OData.svc/Products?$format=json&$callback=?";     ds = new $.ig.RESTDataSource({         callback: render,         dataSource: url,         schema: {             fields: [{                 name: "Name"             }, {                 name: "Price"             }, {                 name: "Rating"             }],             searchField: "d"         },         responseDataKey: "d",         responseDataType: "jsonp",         filtering: {             type: "remote",             customFunc: myCustomFunc         }     });     ds.dataBind();   });

• defaultFields

  タイプ:

  array

  デフォルト:

  []

  要素タイプ:

  object

  データは dataBind() のすぐ後で予めフィルターされます。

  コード サンプル

  $(window).load(function () {     var url = "http://services.odata.org/OData/OData.svc/Products?$format=json&$callback=?";     ds = new $.ig.RESTDataSource({         callback: render,         dataSource: url,         schema: {             fields: [{                 name: "Name"             }, {                 name: "Price"             }, {                 name: "Rating"             }],             searchField: "d"         },         responseDataKey: "d",         responseDataType: "jsonp",         filtering: {             type: "remote",             defaultFields: [{                 fieldName: "Price",                 cond:"GreaterThan",                 expr: 20             }]         }     });     ds.dataBind(); });

• expressions

  タイプ:

  array

  デフォルト:

  []

  要素タイプ:

  object

  式オブジェクトのリスト。以下のキーと値のペアが含まれます: fieldName、式 (検索文字列)、条件、ロジック (AND/OR)。

  コード サンプル

  var url = "/demos/server/proxy.php?url=http://services.odata.org/OData/OData.svc/Products?$format=json"; ds = new $.ig.RESTDataSource({     callback:render,     dataSource: url,     localSchemaTransform: false,     responseDataKey: "d",     filtering: {         expressions:[             {                 fieldName: "Price",                 cond:"GreaterThan",                 expr: 20             }         ]     },     schema: {         fields: [             {name : "Price"},             {name : "Name"},             {name: "Rating"}         ],         searchField: "d"     } });   ds.dataBind();

• exprString

  タイプ:

  string

  デフォルト:

  ""

  SQL のようなエンコードされた式文字列。「expressions」より優先があります。例: col2 > 100; col2 LIKE %test%。

  コード サンプル

  var render = function (success, error) {     if (success) {         var template = "<tr><td>${Name}</td><td>${Price}</td><td>${Rating}</td></tr>",         resultHtml = $.ig.tmpl(template, ds.dataView());         $("#table").html(resultHtml);     } else {         alert(error);     } }   var ds;   $(window).load(function () {     var url = "http://services.odata.org/OData/OData.svc/Products?$format=json&$callback=?";     ds = new $.ig.RESTDataSource({         callback: render,         dataSource: url,         schema: {             fields: [{                 name: "Name"             }, {                 name: "Price"             }, {                 name: "Rating"             }],             searchField: "d"         },         responseDataKey: "d",         responseDataType: "jsonp",         filtering: {             type: "remote",             exprString: "Name LIKE Cr%"         }     });     ds.dataBind(); });

• filterExprUrlKey

  タイプ:

  string

  デフォルト:

  null

  リモート フィルタリングが実行される場合に、要求の中でエンコードされる URL キー。デフォルト null は OData スタイルの URL エンコードを意味します。詳細は http://www.odata.org/developers/protocols/uri-conventions を参照してください。

  コード サンプル

  var render = function (success, error) {     if (success) {         var template = "<tr><td>${Name}</td><td>${Price}</td><td>${Rating}</td></tr>",         resultHtml = $.ig.tmpl(template, ds.dataView());         $("#table").html(resultHtml);     } else {         alert(error);     } }   var ds;   $(window).load(function () {     var url = "http://services.odata.org/OData/OData.svc/Products?$format=json&$callback=?";     ds = new $.ig.RESTDataSource({         callback: render,         dataSource: url,         schema: {             fields: [{                 name: "Name"             }, {                 name: "Price"             }, {                 name: "Rating"             }],             searchField: "d"         },         responseDataKey: "d",         responseDataType: "jsonp",         filtering: {             type: "remote",             filterExprUrlKey: "filter",             expressions: [{                 fieldName: "Name",                 cond: "Contains",                 expr: "Cr"             }]         }     });     ds.dataBind(); });

• filterLogicUrlKey

  タイプ:

  string

  デフォルト:

  "filterLogic"

  フィルタリング ロジックが AND か OR かどうかを示す、要求の中でエンコードされる URL キー。

  コード サンプル

  var render = function (success, error) {     if (success) {         var template = "<tr><td>${Name}</td><td>${Price}</td><td>${Rating}</td></tr>",         resultHtml = $.ig.tmpl(template, ds.dataView());         $("#table").html(resultHtml);     } else {         alert(error);     } }   var ds;   $(window).load(function () {     var url = "http://services.odata.org/OData/OData.svc/Products?$format=json&$callback=?";     ds = new $.ig.RESTDataSource({         callback: render,         dataSource: url,         schema: {             fields: [{                 name: "Name"             }, {                 name: "Price"             }, {                 name: "Rating"             }],             searchField: "d"         },         responseDataKey: "d",         responseDataType: "jsonp",         filtering: {             type: "remote",             filterLogicUrlKey: "testFilterLogicUrlKey",             expressions: [{                 fieldName: "Name",                 cond: "Contains",                 expr: "Cr",                 logic: "OR"             }]         }     });     ds.dataBind(); });

• type

  タイプ:

  enumeration

  デフォルト:

  remote

  フィルタリング タイプ。

  メンバー

  • remote
  • タイプ:string
  • パラメーターはエンコードされ、バックエンド次第で応答から解釈されます。
  • local
  • タイプ:string
  • データは自動的にクライアント側でフィルターされます。

組み込みのグループ化機能に関連する設定。

• defaultCollapseState

  タイプ:

  bool

  デフォルト:

  false

  デフォルトの縮小状態。

  コード サンプル

  ds = new $.ig.RESTDataSource({     dataSource: products,     groupby: {         defaultCollapseState: true     } });

• groupRecordKey

  タイプ:

  string

  デフォルト:

  "__gbRecord"

  グループ データ ビューからのレコードがグループ レコードかどうかを決定するプロパティの名前。

  コード サンプル

  ds = new $.ig.RESTDataSource({     dataSource: products,     groupby: {         groupRecordKey: "__gbRecord"     } });

• groupSummaryRecordKey

  タイプ:

  string

  デフォルト:

  "__gbSummaryRecord"

  グループ データ ビューからのレコードが集計グループ レコードかどうかを決定するプロパティの名前。

  コード サンプル

  ds = new $.ig.RESTDataSource({     dataSource: products,     groupby: {         groupRecordKey: "__gbRecord"     } });

• pagingMode

  タイプ:

  enumeration

  デフォルト:

  allRecords

  グループ化された列が 1 つ以上ある場合、ページングの適用方法を指定します。

  メンバー

  • allRecords
  • タイプ:string
  • ページングは、データおよびグループ化レコードなどのデータ以外のレコードを含むすべてのレコードに適用されます。
  • dataRecordsOnly
  • タイプ:string
  • ページングがデータ レコードのみに適用されます。データ以外のレコードはページング計算で無視されます。

  コード サンプル

  ds = new $.ig.RESTDataSource({     dataSource: products,     groupby: {         pagingMode: "allRecords"     } });

• summaries

  タイプ:

  array

  デフォルト:

  []

  要素タイプ:

  object

  各フィールドの集計を含むオブジェクトの配列。
  各集計オブジェクトに次の形式があります。{ field:"fieldName", summaryFunctions: [] }。summaryFunctions 配列が集計名 (avg、sum、count など) を含む、またはカスタム集計を計算するためのカスタム関数を含みます。

  コード サンプル

  ds = new $.ig.RESTDataSource({     dataSource: data,     groupby: {         summaries: [         {             field:"Age",             summaryFunctions: ["avg","sum"]         },         {             field: "Name",             summaryFunctions: ["count", customFunc]         }]     } });

• summariesPosition

  タイプ:

  enumeration

  デフォルト:

  bottom

  各グループで各フィールドの集計位置を指定します。

  メンバー

  • top
  • タイプ:string
  • 各グループの上部に集計行が 1 行表示されます。
  • bottom
  • タイプ:string
  • 各グループの下部に集計行が 1 行表示されます。
  • both
  • タイプ:string
  • 各グループに集計行が 2 行表示されます。上部および下部にも表示されます。

  コード サンプル

  ds = new $.ig.RESTDataSource({     dataSource: data,     groupby: {         summariesPosition: "top",         summaries: [         {             field:"Age",             summaryFunctions: ["avg","sum"]         },         {             field: "Name",             summaryFunctions: ["count", customFunc]         }]     } });

これを設定する必要があるのは、データ ソースが文字列形式でテーブルに設定される場合だけです。非表示のダミー データ コンテナーを本文中に作成し、テーブル データをそれに追加する必要があります。

False に設定すると、JavaScript コード内でローカルに定義されている場合でもスキーマの変換が無効になります。

これは、実際の結果レコードが配置される dataView 内のプロパティです。(つまり、これが定義される場合、dataView は配列ではなくオブジェクトです)、潜在的なデータ ソース変換の後。

組み込みのページング機能に関連する設定。

• appendPage

  タイプ:

  bool

  デフォルト:

  false

  データの新しいページが要求される場合、新しいデータを依存のデータに追加するかどうかを決定します。

  コード サンプル

  var ds = new $.ig.RESTDataSource({     dataSource: products,     paging: {         enabled: true,         appendPage : true     } });

• enabled

  タイプ:

  bool

  デフォルト:

  false

  ページングはデフォルトで有効ではありません。

  コード サンプル

  ds = new $.ig.RESTDataSource({     type: "json",     dataSource: adventureWorks,     responseDataKey: "Records",     paging: {         enabled : true,         pageSize:10,         type: "local"     } });

• pageIndex

  タイプ:

  number

  デフォルト:

  0

  現在のページのインデックスです。

  コード サンプル

  ds = new $.ig.RESTDataSource({     type: "json",     dataSource: adventureWorks,     responseDataKey: "Records",     schema: jsonSchema,     paging:     {         enabled : true,         pageSize:10,         type: "local",         pageIndex: 2     } }); ds.dataBind();

• pageIndexUrlKey

  タイプ:

  string

  デフォルト:

  null

  現在要求されているページ インデックスを説明するエンコードされた URL パラメーターの名前を示します。

  コード サンプル

  var ds = new $.ig.RESTDataSource({     type: "json",     dataSource: adventureWorks,     responseDataKey: "Records",     paging: {         enabled: true,         pageSize: 10,         pageIndex: 2,         pageIndexUrlKey: "myPageIndexUrlKey",         type: "local"     } });

• pageSize

  タイプ:

  number

  デフォルト:

  5

  各ページのレコード数。

  コード サンプル

  ds = new $.ig.RESTDataSource({     type: "json",     dataSource: adventureWorks,     responseDataKey: "Records",     paging: {         enabled : true,         pageSize:10,         type: "local"     } });

• pageSizeUrlKey

  タイプ:

  string

  デフォルト:

  null

  現在要求されているページ サイズを説明するエンコードされた URL パラメーターの名前を示します。

  コード サンプル

  var ds = new $.ig.RESTDataSource({     type: "json",     dataSource: adventureWorks,     responseDataKey: "Records",     paging: {         enabled: true,         pageSize: 10,         pageSizeUrlKey: "myPageSizeUrlKey",         type: "local"     } });

• type

  タイプ:

  enumeration

  デフォルト:

  remote

  ページング操作のタイプ。

  メンバー

  • local
  • タイプ:string
  • データはクライアント側でページングされます。
  • remote
  • タイプ:string
  • リモート要求が完了し、URL パラメーターがエンコードされました。

  コード サンプル

  jsonDs = new $.ig.RESTDataSource( {     filtering: {         type: "local",         caseSensitive: true,         applyToAllData: true     },     dataSource: jsonData }).dataBind();

一意のフィールド識別子。

要求を送信する HTTP 動詞を指定します。

応答のコンテンツ タイプ。http://api.jquery.com/jQuery.ajax/ => contentType を参照してください。

データ レコード配列を保持する場所を指定する応答内のプロパティ (応答がラップされる場合)。

URL がデータ ソースとして設定された場合の応答タイプ。http://api.jquery.com/jQuery.ajax/ => dataType を参照してください。

バックエンド内のレコードの総数を指定する応答内のプロパティ (ページングに必要です)。

REST コンプライアント更新ルーチンに関連する設定。

• contentSerializer

  タイプ:

  function

  デフォルト:

  null

  サーバーに送信したコンテンツをシリアル化するカスタム関数を指定します。単一のオブジェクトまたはオブジェクトの配列を取得して文字列を返します。指定されていない場合、JSON.stringify() は使用されます。

  コード サンプル

  //Initialize var ds = new $.ig.RESTDataSource({     dataSource: products,     primaryKey: "ProductID",     restSettings: {         create: {             url: "/api/customers/",             batch: true         },         contentType: "application/xml; charset=utf-8",         contentSerializer: function (ds) {             // if ds contains JavaScript object literal like this:             //{"ID":9,"Name":"Product","Price":90.0,"Quantity":2 }             //then you can serialize it in XML like this             return "<Product><ID>" + ds.ID + "</ID><Name>" + ds.Name +             "</Name><Price>" + ds.Price + "</Price><Quantity>" +             ds.Quantity + "</Quantity></Product>";            }     } });   //Get var serializer = ds.settings.restSettings.contentSerializer;

• contentType

  タイプ:

  string

  デフォルト:

  "application/json; charset=utf-8"

  要求のコンテンツ タイプを指定します。

  コード サンプル

  //Initialize var ds = new $.ig.RESTDataSource({     dataSource: products,     primaryKey: "ProductID",     restSettings: {         create: {             url: "/api/customers/",             batch: true         },         contentType: "application/xml; charset=utf-8",         contentSerializer: function (ds) {             // if ds contains JavaScript object literal like this:             //{"ID":9,"Name":"Product","Price":90.0,"Quantity":2 }             //then you can serialize it in XML like this             return "<Product><ID>" + ds.ID + "</ID><Name>" + ds.Name +             "</Name><Price>" + ds.Price + "</Price><Quantity>" +             ds.Quantity + "</Quantity></Product>";            }     } });   //Get var contentType = ds.settings.restSettings.contentType;

• create

  タイプ:

  object

  デフォルト:

  {}

  作成要求の設定。

  コード サンプル

  //Initialize var ds = new $.ig.RESTDataSource({     restSettings: {         create: {             url: "/api/customers/",             batch: true         }     } });   //Get var createRs = ds.settings.restSettings.create;

  • batch

    タイプ:

    bool

    デフォルト:

    false

    作成要求がバッチで送信するかどうかを指定します。

    コード サンプル

    //Initialize var ds = new $.ig.RESTDataSource({     restSettings: {         create: {             url: "/api/customers/",             batch: true         }     } });   //Get var batch = ds.settings.restSettings.create.batch;

  • template

    タイプ:

    string

    デフォルト:

    null

    リモート URL テンプレートを指定します。リソース ID の代わりに ${id} を使用します。

    コード サンプル

    //Initialize var ds = new $.ig.RESTDataSource({     restSettings: {         create: {             template: "/api/customers/"         }     } });   //Get var template = ds.settings.restSettings.create.template;

  • url

    タイプ:

    string

    デフォルト:

    null

    作成要求に送信するリモート URL を指定します。バッチおよび非バッチのために使用されます。ただし、テンプレートも設定される場合、この URL はバッチ要求のみに使用されます。

    コード サンプル

    //Initialize var ds = new $.ig.RESTDataSource({     restSettings: {         create: {             url: "/api/customers/",             batch: true         }     } });   //Get var url = ds.settings.restSettings.create.url;

• encodeRemoveInRequestUri

  タイプ:

  bool

  デフォルト:

  true

  削除されたリソースの id が要求 URI を介して送信されるかどうかを指定します。

  コード サンプル

  //Initialize var ds = new $.ig.RESTDataSource({     restSettings: {         create: {             url: "/api/customers/",             batch: true         },         encodeRemoveInRequestUri: false     } });   //Get var encodeRemoveInRequestUri = ds.settings.restSettings.encodeRemoveInRequestUri;

• remove

  タイプ:

  object

  デフォルト:

  {}

  削除要求の設定。

  コード サンプル

  //Initialize var ds = new $.ig.RESTDataSource({     restSettings: {         remove: {             url: "/api/customers/",             batch: true         }     } });   //Get var removeRs = ds.settings.restSettings.remove;

  • batch

    タイプ:

    bool

    デフォルト:

    false

    更新要求がバッチで送信するかどうかを指定します。

    コード サンプル

    //Initialize var ds = new $.ig.RESTDataSource({     restSettings: {         remove: {             url: "/api/customers/",             batch: true         }     } });   //Get var batch = ds.settings.restSettings.remove.batch;

  • template

    タイプ:

    string

    デフォルト:

    null

    リモート URL テンプレートを指定します。リソース ID の代わりに ${id} を使用します。

    コード サンプル

    //Initialize var ds = new $.ig.RESTDataSource({     restSettings: {         remove: {             template: "/api/customers/${id}"         }     } });   //Get var template = ds.settings.restSettings.remove.template;

  • url

    タイプ:

    string

    デフォルト:

    null

    削除要求に送信するリモート URL を指定します。バッチおよび非バッチのために使用されます。ただし、テンプレートも設定される場合、この URL はバッチ要求のみに使用されます。

    コード サンプル

    //Initialize var ds = new $.ig.RESTDataSource({     restSettings: {         remove: {             url: "/api/customers/",             batch: true         }     } });   //Get var url = ds.settings.restSettings.remove.url;

• update

  タイプ:

  object

  デフォルト:

  {}

  更新要求の設定。

  コード サンプル

  //Initialize var ds = new $.ig.RESTDataSource({     restSettings: {         update: {             url: "/api/customers/",             batch: true         }     } });   //Get var updateRs = ds.settings.restSettings.update;

  • batch

    タイプ:

    bool

    デフォルト:

    false

    更新要求がバッチで送信するかどうかを指定します。

    コード サンプル

    //Initialize var ds = new $.ig.RESTDataSource({     restSettings: {         update: {             url: "/api/customers/",             batch: true         }     } });   //Get var batch = ds.settings.restSettings.update.batch;

  • template

    タイプ:

    string

    デフォルト:

    null

    リモート URL テンプレートを指定します。リソース ID の代わりに ${id} を使用します。

    コード サンプル

    //Initialize var ds = new $.ig.RESTDataSource({     restSettings: {         update: {             template: "/api/customers/${id}"         }     } });   //Get var template = ds.settings.restSettings.update.template;

  • url

    タイプ:

    string

    デフォルト:

    null

    更新要求に送信するリモート URL を指定します。バッチおよび非バッチのために使用されます。ただし、テンプレートも設定される場合、この URL はバッチ要求のみに使用されます。

    コード サンプル

    //Initialize var ds = new $.ig.RESTDataSource({     restSettings: {         update: {             url: "/api/customers/",             batch: true         }     } });   //Get var url = ds.settings.restSettings.update.url;

行が追加されたときに呼び出される関数。
関数は最初の引数に項目を、2 番目の引数に dataSource を取ります。
item.row を使用して、追加された行への参照を取得します。
item.rowId を使用して、行 ID を取得します。
dataSource を使用して、$.ig.DataSource への参照を取得します。

行が削除されたときに呼び出される関数。
item.row を使用して、削除された行への参照を取得します。
item.rowId を使用して、行 ID を取得します。
item.rowIndex を使用して、行インデックスを取得します。
dataSource を使用して、$.ig.DataSource への参照を取得します。

行が挿入されたときに呼び出される関数。
関数は最初の引数に項目を、2 番目の引数に dataSource を取ります。
item.row を使用して、挿入された行への参照を取得します。
item.rowId を使用して、行 ID を取得します。
item.rowIndex を使用して、行インデックスを取得します。
dataSource を使用して、$.ig.DataSource への参照を取得します。

行が更新 (編集) されたときに呼び出される関数。
関数は最初の引数に項目を、2 番目の引数に dataSource を取ります。
item.rowIndex を使用して、行インデックスを取得します。
item.newRow を使用して、更新された行への参照を取得します。
item.oldRow を使用して、更新された行への参照を取得します。
dataSource を使用して、$.ig.DataSource への参照を取得します。

データのどのフィールドにバインドするかを定義するスキーマ オブジェクト。

True の場合、リモート要求によってコミットが実行されると、更新された値のトランザクション ログ (もしあれば) を必ずシリアル化します。

組み込みの並べ替え機能に関連する設定。

• applyToAllData

  タイプ:

  bool

  デフォルト:

  true

  並べ替えタイプがローカルの場合、applyToAllData が True であると、並べ替えは、ローカルに存在するデータ ソース全体に対して実行されます。そうでない場合は、現在の dataView に対して実行されます。並べ替えのタイプがリモートの場合、この設定は効果がありません。

  コード サンプル

  jsonDs = new $.ig.RESTDataSource({     sorting: {         type: "local",         applyToAllData: true     },     dataSource: jsonData }).dataBind();

• caseSensitive

  タイプ:

  bool

  デフォルト:

  false

  並べ替えが大文字と小文字を区別するかどうかを指定します。ローカルの並べ替えでのみ操作します。

  コード サンプル

  $(window).load(function () {     ds = new $.ig.RESTDataSource({         type: "json",         dataSource: adventureWorks,         sorting: {             type: "local",             caseSensitive: true         }     });       ds.dataBind(); });

• compareFunc

  タイプ:

  object

  デフォルト:

  null

  カスタムの比較並べ替え関数。次の引数を受けとります: フィールド、スキーマ、並べ替えが昇順かどうかを示すブール値、変換関数 (customConvertFunc オプションを確認する必要があります)。値が等しい場合、値 0 を返します。val1 > val2 の場合、値 0 を返します。val1 < val2 の場合、値 -1 を返します。

  コード サンプル

  var render = function (success, error) {     if (success) {         var template = "<tr><td>${Name}</td><td>${Price}</td><td>${Rating}</td></tr>",         resultHtml = $.ig.tmpl(template, ds.dataView());         $("#table").html(resultHtml);     } else {         alert(error);     } }   var myCompareFunc = function (fields, schema, reverse, convertf) {     return function (val1, val2) {         if (val1.Price > val2.Price) {             return 1;         }           if (val1.Price < val2.Price) {             return -1;         }           return 0;     } }   var ds; $(window).load(function () {     var url = "http://services.odata.org/OData/OData.svc/Products?$format=json&$callback=?";     ds = new $.ig.RESTDataSource({         callback: render,         dataSource: url,         schema: {             fields: [{                 name: "Name"             }, {                 name: "Price"             }, {                 name: "Rating"             }],             searchField: "d"         },         responseDataKey: "d",         responseDataType: "jsonp",         sorting: {             type: "local",             compareFunc: myCompareFunc,             defaultFields: [{                 fieldName: "Price"             }]         }     });     ds.dataBind(); });

• customConvertFunc

  タイプ:

  object

  デフォルト:

  null

  カスタム データ値の変換関数 (並べ替え関数から呼び出されます)。データ セルの値および列キーを受け取り、変換された値を返します。

  コード サンプル

  var render = function (success, error) {         if (success) {             var template = "<tr><td>${Name}</td><td>${Price}</td><td>${Rating}</td></tr>",             resultHtml = $.ig.tmpl(template, ds.dataView());             $("#table").html(resultHtml);         } else {             alert(error);         }     }       var myCompareFunc = function (fields, schema, reverse, convertf) {         return function (obj1, obj2) {             a = convertf(obj1);             b = convertf(obj2);               if (a > b) {                 return 1;             }               if (a < b) {                 return -1;             }               return 0;         }     }   var myCustomConvertFunc = function (obj) {         return obj.Price;     }       var ds;     $(window).load(function () {         var url = "http://services.odata.org/OData/OData.svc/Products?$format=json&$callback=?";         ds = new $.ig.RESTDataSource({             callback: render,             dataSource: url,             schema: {                 fields: [{                     name: "Name"                 }, {                     name: "Price"                 }, {                     name: "Rating"                 }],                 searchField: "d"             },             responseDataKey: "d",             responseDataType: "jsonp",             sorting: {                 type: "local",                 compareFunc: myCompareFunc,                 customConvertFunc: myCustomConvertFunc,                 defaultFields: [{                     fieldName: "Price"                 }]             }         });         ds.dataBind();     });

• customFunc

  タイプ:

  object

  デフォルト:

  null

  文字列または関数オブジェクトを指すことができるカスタムの並べ替え関数。関数が呼び出されると、次の引数が渡されます: データ配列、フィールド (フィールド定義の配列)、方向 ("asc" または "desc")。関数は並べ替えられたデータ配列を返す必要があります。

  コード サンプル

  var render = function (success, error) {     if (success) {         var template = "<tr><td>${Name}</td><td>${Price}</td><td>${Rating}</td></tr>",         resultHtml = $.ig.tmpl(template, ds.dataView());         $("#table").html(resultHtml);     } else {         alert(error);     } }   var myCustomFunc = function (data, fields, direction) {     function myCompareFunc(obj1, obj2) {         if (direction == "desc") {             return obj2[fields[0].fieldName] - obj1[fields[0].fieldName];         }           return obj1[fields[0].fieldName] - obj2[fields[0].fieldName];     }     var result = data.sort(myCompareFunc);     return result; }   var ds; $(window).load(function () {     var url = "http://services.odata.org/OData/OData.svc/Products?$format=json&$callback=?";     ds = new $.ig.RESTDataSource({         callback: render,         dataSource: url,         schema: {             fields: [{                 name: "Name"             }, {                 name: "Price"             }, {                 name: "Rating"             }],             searchField: "d"         },         responseDataKey: "d",         responseDataType: "jsonp",         sorting: {             type: "local",             customFunc: myCustomFunc,             defaultFields: [{                 fieldName: "Price"             }],             defaultDirection: "desc"         }     });     ds.dataBind(); });

• defaultDirection

  タイプ:

  enumeration

  デフォルト:

  none

  並べ替えの方向。

  メンバー

  • none
  • タイプ:string
  • asc
  • タイプ:string
  • desc
  • タイプ:string

  コード サンプル

  jsonDs = new $.ig.RESTDataSource({     sorting: {         type: "local",         defaultDirection: "asc"     },     dataSource: jsonData }).dataBind();

• defaultFields

  タイプ:

  array

  デフォルト:

  []

  要素タイプ:

  object

  defaultDirection が "none" でなく、defaultFields が指定されている場合、dataBind() のすぐ後に、データは最初に適宜並べ替えられます。

  コード サンプル

  var url = "http://services.odata.org/OData/OData.svc/Products?$format=json&$callback=?"; var ds = new $.ig.RESTDataSource({     callback: render,     dataSource: url,     schema: {         fields: [{             name: "Name"         }, {             name: "Price"         }, {             name: "Rating"         }],         searchField: "d"     },     responseDataKey: "d",     responseDataType: "jsonp",     sorting: {         type: "local",         defaultFields: [{         fieldName: "Price"         }]     } });

• expressions

  タイプ:

  array

  デフォルト:

  []

  要素タイプ:

  object

  並べ替えの式のリスト。次のキー (およびそれぞれの値) で構成されます: fieldName、direction、および compareFunc (オプション)。

  コード サンプル

  ds = new $.ig.RESTDataSource({     callback: render,     dataSource: url,     localSchemaTransform: false,     responseDataKey: "d",     sorting: {         expressions:[             {                 fieldName:"Rating",                 dir:"asc"             },             {                 fieldName:"Price", dir:"asc"             }         ]     } });

• exprString

  タイプ:

  string

  デフォルト:

  ""

  式よりも優先される「SQL ライクな」エンコードされた式の文字列です。sort() を参照してください。例: col2 > 100 ORDER BY asc。

  コード サンプル

  function sortRemote() {     ds.settings.sorting.type = "remote";       // remote sort     ds.settings.sorting.exprString = "GNP " + dir;     ds.dataBind(); }

• sortUrlAscValueKey

  タイプ:

  string

  デフォルト:

  null

  昇順の並べ替えの URL パラメーター値。デフォルトは null で、OData 規則を使用します。

  コード サンプル

  var url = "http://services.odata.org/OData/OData.svc/Products?$format=json&$callback=?"; var ds = new $.ig.RESTDataSource({     callback: render,     dataSource: url,     schema: {         fields: [{             name: "Name"         }, {             name: "Price"         }, {             name: "Rating"         }],         searchField: "d"     },     responseDataKey: "d",     responseDataType: "jsonp",     sorting: {         type: "local",         sortUrlAscValueKey: "mySortUrlAscValueKey"     } });

• sortUrlDescValueKey

  タイプ:

  string

  デフォルト:

  null

  降順の並べ替えの URL パラメーター値。デフォルトは null で、OData 規則を使用します。

  コード サンプル

  var url = "http://services.odata.org/OData/OData.svc/Products?$format=json&$callback=?"; var ds = new $.ig.RESTDataSource({     callback: render,     dataSource: url,     schema: {         fields: [             {name: "Name"},             {name: "Price"},             {name: "Rating"}         ],         searchField: "d"     },     responseDataKey: "d",     responseDataType: "jsonp",     sorting: {         type: "local",         sortUrlDescValueKey: "mySortUrlDescValueKey"     } });

• sortUrlKey

  タイプ:

  string

  デフォルト:

  null

  並べ替えの式を URL 内でエンコードする方法を指定する URL パラメーター名。デフォルトは null で、OData 規則を使用します。

  コード サンプル

  var url = "http://services.odata.org/OData/OData.svc/Products?$format=json&$callback=?"; var ds = new $.ig.RESTDataSource({     callback: render,     dataSource: url,     schema: {         fields: [             {name: "Name"},             {name: "Price"},             {name: "Rating"}         ],         searchField: "d"     },     responseDataKey: "d",     responseDataType: "jsonp",     sorting: {         type: "local",         sortUrlKey: "mySortUrlKey"     } });

• type

  タイプ:

  enumeration

  デフォルト:

  remote

  並べ替えをローカルで適用するかリモートで (リモート要求によって) 適用するかを指定します。

  メンバー

  • remote
  • タイプ:string
  • local
  • タイプ:string

  コード サンプル

  $(window).load(function () {     ds = new $.ig.RESTDataSource({         type: "json",         dataSource: adventureWorks,         sorting: {             type: "local",             caseSensitive: true         }     });     ds.dataBind(); });