[]
【重要】2024年1月公開のアップデート「未適用」のお客様へ デモ ヘルプ APIリファレンス
トライアル版
(Showing Draft Content)

Wijmo.Observablearray

ObservableArray クラス

変更に関する通知を送信する配列。

このクラスは、push、pop、splice、shift、unshift、insert、removeのいずれかの メソッドによって変更が加えられたときにcollectionChanged イベントを発生させます。 警告: 配列メンバに値を直接割り当てることによって配列を変更したとき、 または配列の長さを変更したときには、collectionChanged イベントは発生しません。

Type parameters

  • T

階層

コンストラクタ

プロパティ

メソッド

イベント

コンストラクタ

constructor

プロパティ

isUpdating

isUpdating: boolean

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

length

length: number

配列の長さを取得または設定します。 これは、配列で定義された最も高い要素より1つ大きい値です。

メソッド

at

  • at(index: number): T | undefined

  • 整数値を取り、そのインデックスにある項目を返します。正と負の整数が許可されます。 負の整数は、配列の最後の項目からカウントされます。

    引数

    • index: number

    戻り値 T | undefined

beginUpdate

  • beginUpdate(): void

  • 次にendUpdate が呼び出されるまで通知を中断します。

    戻り値 void

clear

  • clear(): void

  • 配列からすべての項目を削除します。

    戻り値 void

concat

  • concat(...items: ConcatArray<T>[]): T[]
  • concat(...items: (T | ConcatArray<T>)[]): T[]

  • 2つ以上の配列を結合します。

    引数

    • Rest ...items: ConcatArray<T>[]

      array1の末尾に追加する追加項目。

    戻り値 T[]

  • 2つ以上の配列を結合します。

    引数

    • Rest ...items: (T | ConcatArray<T>)[]

      array1の末尾に追加する追加項目。

    戻り値 T[]

deferUpdate

  • deferUpdate(fn: Function): void

  • beginUpdate/endUpdate ブロック内で関数を実行します。

    この関数が終了するまでコレクションはリフレッシュされません。 このメソッドは、関数が例外を生成した場合でもendUpdate が呼び出されるようにします。

    引数

    • fn: Function

      更新なしで実行する関数。

    戻り値 void

endUpdate

  • endUpdate(isSilent?: boolean): void

  • beginUpdate の呼び出しによって中断された通知を再開します。

    引数

    • オプション isSilent: boolean

      更新をサイレントに終了するかどうか、つまり collectionChanged イベントを発生させずに終了するかどうか

    戻り値 void

entries

  • entries(): IterableIterator<[number, T]>

  • 配列の各要素のキーと値のペアを持つ反復可能オブジェクトを返します。

    戻り値 IterableIterator<[number, T]>

every

  • every(callbackfn: Object, thisArg?: any): boolean

  • 配列内のすべての要素が指定されたテストに合格するかどうかテストを実行します。

    引数

    • callbackfn: Object

      引数を 3 つまで受け取る関数。 every メソッドは、array1 の各要素に対して、callbackfn が false を返すか、または配列の末尾に到達するまで callbackfn 関数を呼び出します。

    • オプション thisArg: any

      this のキーワードが callbackfn 関数内で参照できるオブジェクト。 thisArg を省略すると、undefined が this 値として使用されます。

    戻り値 boolean

filter

  • filter<S>(callbackfn: Object, thisArg?: any): S[]
  • filter(callbackfn: Object, thisArg?: any): T[]

  • コールバック関数で指定された条件を満たす配列の要素を返します。

    Type parameters

    • S: T

    引数

    • callbackfn: Object

      引数を 3 つまで受け取る関数。 filter メソッドは、配列内の各要素に対して callbackfn 関数を 1 回呼び出します。

    • オプション thisArg: any

      this のキーワードが callbackfn 関数内で参照できるオブジェクト。 thisArg を省略すると、undefined が this 値として使用されます。

    戻り値 S[]

  • コールバック関数で指定された条件を満たす配列の要素を返します。

    引数

    • callbackfn: Object

      引数を 3 つまで受け取る関数。 filter メソッドは、配列内の各要素に対して callbackfn 関数を 1 回呼び出します。

    • オプション thisArg: any

      this のキーワードが callbackfn 関数内で参照できるオブジェクト。 thisArg を省略すると、undefined が this 値として使用されます。

    戻り値 T[]

forEach

  • forEach(callbackfn: Object, thisArg?: any): void

  • 配列内の各要素に対して指定されたアクションを実行します。

    引数

    • callbackfn: Object

      引数を 3 つまで受け取る関数。 forEach メソッドは、配列内の各要素に対して callbackfn 関数を 1 回呼び出します。

    • オプション thisArg: any

      this のキーワードが callbackfn 関数内で参照できるオブジェクト。 thisArg を省略すると、undefined が this 値として使用されます。

    戻り値 void

implementsInterface

  • implementsInterface(interfaceName: string): boolean

  • 指定したインタフェースがサポートされている場合、trueを返します。

    引数

    • interfaceName: string

      調べるインタフェースの名前。

    戻り値 boolean

    指定したインタフェースがサポートされている場合はtrue。

indexOf

  • indexOf(searchElement: T, fromIndex?: number): number

  • 配列内で項目を検索します。

    引数

    • searchElement: T

      配列内で検索する要素。

    • オプション fromIndex: number

      検索を開始するインデックス。

    戻り値 number

    配列内の項目のインデックス。項目が見つからない場合は-1。

insert

  • insert(index: number, item: T): void

  • 配列内の指定した位置に項目を挿入します。

    引数

    • index: number

      項目を追加する位置。

    • item: T

      配列に追加する項目。

    戻り値 void

join

  • join(separator?: string): string

  • 指定されたセパレータによって分離された配列のすべての要素を追加します。

    引数

    • オプション separator: string

      返された文字列内で配列の要素を次の要素から分離するために使用される文字列。 引数を省略すると、配列要素はコンマで区切られます。

    戻り値 string

keys

  • keys(): IterableIterator<number>

  • 配列内のキーを持つ反復可能オブジェクトを返します。

    戻り値 IterableIterator<number>

lastIndexOf

  • lastIndexOf(searchElement: T, fromIndex?: number): number

  • 配列内で指定された値が最後に見つかった位置のインデックスを返します。

    引数

    • searchElement: T

      配列内で検索する値。

    • オプション fromIndex: number

      検索を開始する配列インデックス。 fromIndexを省略すると、検索は配列の最後のインデックスから開始されます。

    戻り値 number

map

  • map<U>(callbackfn: Object, thisArg?: any): U[]

  • 定義されたコールバック関数を配列の各要素に対して呼び出し、結果を含む配列を返します。

    Type parameters

    • U

    引数

    • callbackfn: Object

      引数を 3 つまで受け取る関数。 map メソッドは、配列内の各要素に対して callbackfn 関数を 1 回呼び出します。

    • オプション thisArg: any

      this のキーワードが callbackfn 関数内で参照できるオブジェクト。 thisArg を省略すると、undefined が this 値として使用されます。

    戻り値 U[]

onCollectionChanged

push

  • push(...items: T[]): number

  • 配列の末尾に1つ以上の項目を追加します。

    引数

    • Rest ...items: T[]

    戻り値 number

    配列の新しい長さ。

remove

  • remove(item: T): boolean

  • 配列から項目を削除します。

    引数

    • item: T

      削除する項目。

    戻り値 boolean

    項目が削除された場合はtrue、配列に見つからない場合はfalse。

removeAt

  • removeAt(index: number): void

  • 配列内の指定した位置にある項目を削除します。

    引数

    • index: number

      削除する項目の位置。

    戻り値 void

reverse

  • reverse(): T[]

  • 配列の要素の順番を反転させます。

    戻り値 T[]

setAt

  • setAt(index: number, item: T): void

  • 配列内の指定した位置にある項目を設定します。

    引数

    • index: number

      項目を設定する位置。

    • item: T

      配列に設定する項目。

    戻り値 void

shift

  • shift(): T

  • 配列から最初の要素を取り除き、その要素を返します。

    このメソッドは配列の長さを変更します。

    戻り値 T

slice

  • slice(begin?: number, end?: number): T[]

  • 配列の一部のシャローコピーを作成します。

    引数

    • オプション begin: number

      コピーを開始する位置。

    • オプション end: number

      コピーを終了する位置。

    戻り値 T[]

    配列の一部のシャローコピー。

some

  • some(callbackfn: Object, thisArg?: any): boolean

  • 指定されたコールバック関数が配列ののいずれかの要素に対して true を返すかどうかを決定します。

    引数

    • callbackfn: Object

      引数を 3 つまで受け取る関数。 some メソッドは、array1 の各要素に対して、callbackfn が trueを返すか、または配列の末尾に到達するまで callbackfn 関数を呼び出します。

    • オプション thisArg: any

      this のキーワードが callbackfn 関数内で参照できるオブジェクト。 thisArg を省略すると、undefined が this 値として使用されます。

    戻り値 boolean

sort

  • sort(compareFn?: Function): this

  • 配列の要素を適切な位置にソートします。

    引数

    • オプション compareFn: Function

      ソート順序を定義する関数を指定します。 この関数は2つの引数を受け取り、 -1（最初の引数の方が2番目の引数より小さい場合）、+1（大きい場合）、0（等しい場合）のいずれかの値を返す必要があります。 これを省略した場合は、各要素の文字列変換に従って辞書順にソートされます。

    戻り値 this

    ソートされた配列のコピー。

splice

  • splice(index: number, count: number, ...item: T[]): T[]

  • 配列からの項目の削除と配列への項目の追加の一方または両方を行います。

    引数

    • index: number

      項目を追加または削除する位置。

    • count: number

      配列から削除する項目の数。

    • Rest ...item: T[]

    戻り値 T[]

    削除された要素を含む配列。

toLocaleString

  • toLocaleString(): string

  • 配列の文字列表現を返します。 要素は、toLocalStringメソッドを使用して文字列に変換されます。

    戻り値 string

toString

  • toString(): string

  • 配列の文字列表現を返します。

    戻り値 string

unshift

  • unshift(...items: T[]): number

  • 配列の最初に1つ以上の要素を追加し、配列の新しい長さを返します。

    引数

    • Rest ...items: T[]

    戻り値 number

    配列の新しい長さ。

values

  • values(): IterableIterator<T>

  • 配列内の値を持つ反復可能オブジェクトを返します。

    戻り値 IterableIterator<T>

イベント

collectionChanged

collectionChanged: Event<ObservableArray<T>, NotifyCollectionChangedEventArgs<T>>

コレクションが変更されたときに発生します。