キーが計算フィールドを表し、値が式（関数または文字列）であるオブジェクトを取得または設定します。

計算フィールドにはプロキシが必要になります。 Ie11で使用する場合は、 https://www.npmjs.com/package/proxy-polyfill のようなポリフィルを使用します。

計算フィールドは、外部データを扱う場合に役立ちます。 たとえば、1人当たりの収入フィールド（gnp/pop）または利益フィールド（収益-経費）を追加できます。

計算フィールドは動的です。 計算で使用されるフィールドを変更すると、それらの値は自動的に更新されます。 また、読み取り専用です。 それらの計算に使用されるプロパティの値を変更することはできますが、結果を直接編集することはできません。

FlexGrid cellTemplatesとは異なり、計算フィールドは並べ替え、フィルタリング、およびグループ化に使用できます。 また、チャートやその他のWijmoコントロールで使用することもできます。

計算フィールドは、データ項目を引数または文字列として受け取る関数として定義できます。

以下に例を示します。

```typescript // 通常のデータ項目 interface IDataItem { product: string, brand: string, unitPrice: number, qty: number, shipped: boolean } function getData(): IDataItem[] { return [ { product: 'Banana', brand: 'Chiquita', unitPrice: 45.95, qty: 12, discount: .08, shipped: true }, ... ] } ```

次のように関数ベースの計算フィールドを追加できます。

```typescript // 計算プロパティをIDataItemに追加します interface ICalcDataItem extends IDataItem { fullName: string; allCaps: string; totalPrice: number, tax: number; }

let cv = new CollectionView(getData(), { calculatedFields: { fullName: ($: ICalcDataItem) => [$.brand, $.product].join(' '), allCaps: ($: ICalcDataItem) => $.fullName.toUpperCase(), totalPrice: ($: ICalcDataItem) => ($.unitPrice * $.qty) * (1 - $.discount), tax: ($: ICalcDataItem) => $.totalPrice * 0.12 } }); ``` **関数ベースの計算フィールド** は、次の理由により、通常、文字列ベースの計算フィールドよりも優れています。

1) 設計時のエラーチェックとコマンド補完を提供します。 2) 実行速度が速い 3) コンテンツセキュリティポリシー（CSP）に関する問題はありません。

あるいは、文字列ベースの計算フィールドを追加することもできます。

```typescript let cv = new CollectionView(getData(), { calculatedFields: { fullName: '[$.brand, $.product].join(" ")', allCaps: '$.fullNameStr.toUpperCase()', totalPrice: '($.unitPrice * $.qty) * (1 - $.discount)', tax: '$.totalPrice * 0.12' }); ``` 文字列式は、 項目の元の値と計算された値を含むコンテキスト変数「$」により、現在の項目を参照できます。

**文字列ベースの計算フィールド**には、関数ベースの計算フィールドよりも利点があり、場合によっては重要になることがあります。 いくつかの利点は次のとおりです。

1) 少し簡潔です 2) データとして保存でき、実行時に簡単に変更できます。

コレクションに新しい項目を追加できるかどうかを示す値を取得します。

適用前の変更を破棄して編集されたオブジェクトの元の値を復元できるかどうかを示す値を取得します。

pageIndex 値を変更できるかどうかを示す値を取得します。

このビューがfilter プロパティによってフィルタリングをサポートしているかどうかを示す値を取得します。

このプロパティは、常に適用されるfiltersプロパティには影響しません。

このビューがgroupDescriptions プロパティによってグループ化をサポートしているかどうかを示す値を取得します。

コレクションから項目を削除できるかどうかを示す値を取得します。

このビューがsortDescriptions プロパティによってソートをサポートしているかどうかを示す値を取得します。

現在の追加トランザクションの間に追加される項目を取得します。

現在の編集トランザクションの間に編集される項目を取得します。

ビューの現在の項目を取得します。

ビューの現在の項目の順序位置を取得します。

項目がビューに含める対象として適しているかどうかを判断するために使用されるコールバックを取得または設定します。

このコールバックがtrueを返した場合、パラメーターとして渡された項目はビューに含まれます。

このプロパティのデフォルト値は**null**,です。これは、データがフィルタリングされないことを意味します。

このCollectionView でフィルターとして使用されるIPredicate 関数の配列を取得します。

ビューに含めるには、アイテムはfilterプロパティとfiltersコレクション内のすべての述語を渡す必要があります。

項目の特定のプロパティに検証エラーが含まれているかどうかを判定するコールバックを取得または設定します。

メソッドは、データ項目をパラメータとして、検証されるプロパティ、およびタが既に解析されてデータ項目に適用されているかどうか（parsing == false）またはザーが値を編集しようとして予期されたデータ型に解析できない値を入力したかどうかを記述する解析パラメータ（parsing == true）を受け取ります。

このメソッドは、エラーメッセージを含む文字列を返します。エラーが検出されなかった場合はnullを返します。

次に例を示します。

```typescript view = new CollectionView(data, { getError: (item: any, prop: string, parsing: boolean) => {

// 解析に失敗しました」メッセージを表示します。 if (parsing) { if (prop == 'date') { return 'Please enter a valid date in the format "MM/dd/yyyy"'; } else if (prop == 'id') { return 'Please enter a positive number'; } }

// 保存（解析）されたデータが有効であることを確認します。 if (prop == 'date' && item.date < minDate) { return 'Please enter a date after ' + Globalize.formatDate(minDate, 'd'); } else if (prop == 'id' && item.id < 0) { return 'Please enter a positive number'; } } }); ```</>>

コレクションの項目をビューでどのようにグループ化するかを記述するGroupDescription オブジェクトのコレクションを取得します。

最上位レベルのグループを表すCollectionViewGroup オブジェクトの配列を取得します。

追加トランザクションが進行中であるかどうかを示す値を取得します。

編集トランザクションが進行中であるかどうかを示す値を取得します。

このビューに項目が1つも含まれていないかどうかを示す値を取得します。

ページインデックスが変更されているかどうかを示す値を取得します。

通知が現在中断されているかどうかを示す値を取得します（beginUpdate およびendUpdate を参照）。

ページングを適用する前のビューの既知の項目の数を取得します。

ビューの項目を取得します。

trackChanges が有効化されてから、コレクションに追加されたレコードを含むObservableArray を取得します。

trackChanges が有効化されてから、コレクションで編集されたレコードを含むObservableArray を取得します。

trackChanges が有効化されてから、コレクションから削除されたレコードを含むObservableArray を取得します。

コレクションの新しい項目を作成する関数を取得または設定します。

作成関数が提供されない場合、CollectionView は、適切な型の項目を初期化せずに作成しようとします。

作成関数が提供される場合、その関数は、パラメータを受け取らず、コレクションに対して適切な型のオブジェクトを初期化して返す 必要があります。

総ページ数を取得します。

現在のページの0から始まるインデックスを取得します。

各ページに表示する項目数を取得または設定します。

このプロパティのデフォルト値は **zero** です。この場合、ページングが無効になります。

CollectionView が、アイテムの編集後に結果（ソート、フィルター、およびグループ化を適用する）を自動的に更新するかどうかを決定する値を取得または設定します。

このプロパティはデフォルトで **true** に設定されます。これにより、 編集が完了した後にコレクションが常に正しくソート、フィルタリング、およびグループ化されるようにします。

false に設定する場合、アイテムの編集時に更新を遅延されます。 この場合、ソート、フィルタリング、およびグループ化の基準が変更されるか、 またはExcelと同様にrefresh メソッドが呼び出されるまで、コレクションは更新されません。

ソート時に値の比較に使用する関数を取得または設定します。

指定された場合、ソート比較関数は、パラメータとして任意の型の値を 2つ取り、最初の値が2番目の値と比べて小さい、等しい、または大きいのいずれであるかを示す値-1、0、または+1を返します。ソート比較関数がnullを返す場合は、標準の組み込み比較子が使用されます。

この sortComparer プロパティを使用すると、カスタム比較アルゴリズムを提供でき、単純な文字列比較より、ユーザーが期待する結果によく一致するソートシーケンスが得られる場合があります。

たとえば、 Dave Koele's Alphanum algorithm 参照してください。 このアルゴリズムは、文字列を文字列や数値から成る部分に分割した後、 数値部分は値順に、文字列部分はASCII順にソートします。 Daveは、この結果を「自然なソート順」と呼んでいます。

次の例は、 sortComparer プロパティの一般的な使用方法を示します。

```typescript import { CollectionView, isString } from '@grapecity/wijmo';

// カスタムソート比較子を使用してCollectionViewを作成します const view = new CollectionView(data, { sortComparer: (a: any, b: any) => { return isString(a) && isString(b) ? alphanum(a, b) // use custom comparer for strings : null; // use default comparer for everything else } }); ```

次の例は、 Intl.Collator を使用してソート順を制御する方法を示しています。

```typescript import { CollectionView, isString } from '@grapecity/wijmo';

// Intl.Collatorを使用してソートするCollectionViewを作成します const collator = window.Intl ? new Intl.Collator() : null; let view = new CollectionView(data, { sortComparer: (a, b) => { return isString(a) && isString(b) && collator ? collator.compare(a, b) // 文字列に使用するカスタム比較子 : null; // 文字列以外にはデフォルトの比較子を使用します } }); ```

ソート時の値の変換に使用される関数を取得または設定します。

この関数は、SortDescription、データ項目、および変換する値をパラメーターとして受け取り、変換後の値を返す必要があります。

たとえば、FlexGrid コントロールはこのプロパティを使用して、マップされた列を生の値ではなく表示値を基準にソートします。

以下のサンプルコードでは、CollectionViewが国コードの整数を含む'country'プロパティをソートするときに、 対応する国名を使用してソートされるようにします。

```typescript const countries = 'US,Germany,UK,Japan,Italy,Greece'.split(','); view.sortConverter = (sd: SortDescription, item: any, value: any) => { return sd.property === 'countryMapped' ? countries[value]; // 国IDを名前に変換します。 : value; } ```

次の例では、2つの値を組み合わせています。 この場合、国でソートすると、ビューが都市ごとに分割されます。

```typescript view.sortConverter: (sd: SortDescription, item: any, value: any) => { if (sd.property == 'country') { value = item.country + '\t' + item.city; } return value; } ```

コレクションの項目をビューでどのようにソートするかを記述するSortDescription オブジェクトの配列を取得します。

null値のソート方法を決定する値を取得または設定します。

このプロパティはデフォルトで**SortNulls.Last**に設定されます。これにより、コレクションをソートするとNULL値が最後に表示されます。 この動作はExcelと同じです。

基になる（フィルタリングもソートもされていない）コレクションを取得または設定します。

ページングを適用する前のビュー内の項目の合計数を取得します。

コントロールがデータの変更を追跡するかどうかを決定する値を取得または設定します。

このプロパティのデフォルト値は**false**に設定されているため、CollectionViewはどのデータ項目が変更されたかを追跡しません。

このプロパティが**true**に設定されている場合、CollectionView は、データの変更を追跡し、itemsAdded、itemsRemoved、 itemsEdited の 各コレクションを介して変更を公開します。

変更の追跡は、変更が有効であることをユーザーが確認した後にサーバーを更新する必要がある場合に役立ちます。

変更をコミットまたはキャンセルしたら、clearChanges メソッドを使用して、 itemsAdded、itemsRemoved、itemsEdited の各コレクションをクリアします。

CollectionView は、適切なCollectionView メソッド（editItem /commitEdit、 addNew /commitNew、remove）を使用して行われた変更だけを追跡します。データに直接行われた変更は追跡されません。

安定したソートアルゴリズムを使用するかどうかを取得または設定します。

安定したソートアルゴリズムは、同じキーを持つレコード間の相対的な順序を維持します。 たとえば、「Amount」フィールドを持つオブジェクトのコレクションを考えてみます。 このコレクションを「Amount」でソートする場合、安定したソートでは、 Amount値が同じレコード間で元の順序が保たれます。

このプロパティのデフォルトは false です。この場合は、 高速だが安定ではないJavaScriptの組み込みソートメソッドが CollectionView で使用されます。

Chromeはバージョン70以降、Firefoxバージョン3以降は安定したソートを提供します。 ES2019の場合 、ソートは安定している**必要があります**。 ES2018までのECMAScript第1版では、不安定になることが許可されていました。

useStableSortプロパティをtrueに設定すると、すべてのブラウザー（IE11も含む）で安定したソートが保証されますが、ソートにかかる時間が30％〜50％増加します。