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

Wijmo.Observablearray

ObservableArray クラス

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

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

階層

コンストラクタ

プロパティ

メソッド

イベント

コンストラクタ

constructor

プロパティ

isUpdating

isUpdating: boolean

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

length

length: number

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

メソッド

at

  • at(index: number): any | undefined

  • Takes an integer value and returns the item at that index, allowing for positive and negative integers. Negative integers count back from the last item in the array.

    引数

    • index: number

    戻り値 any | undefined

beginUpdate

  • beginUpdate(): void

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

    戻り値 void

clear

  • clear(): void

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

    戻り値 void

concat

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

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

    引数

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

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

    戻り値 any[]

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

    引数

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

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

    戻り値 any[]

deferUpdate

  • deferUpdate(fn: Function): void

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

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

    引数

    • fn: Function

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

    戻り値 void

endUpdate

  • endUpdate(): void

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

    戻り値 void

entries

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

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

    戻り値 IterableIterator<[number, any]>

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): any[]

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

    Type parameters

    • S: any

    引数

    • 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 値として使用されます。

    戻り値 any[]

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

indexOf

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

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

    引数

    • searchElement: any

      配列内で検索する要素。

    • オプション fromIndex: number

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

    戻り値 number

insert

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

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

    引数

    • index: number

      項目を追加する位置。

    • item: any

      配列に追加する項目。

    戻り値 void

join

  • join(separator?: string): string

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

    引数

    • オプション separator: string

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

    戻り値 string

keys

  • keys(): IterableIterator<number>

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

    戻り値 IterableIterator<number>

lastIndexOf

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

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

    引数

    • searchElement: any

      配列内で検索する値。

    • オプション 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(...item: any[]): number

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

    引数

    • Rest ...item: any[]

    戻り値 number

remove

  • remove(item: any): boolean

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

    引数

    • item: any

      削除する項目。

    戻り値 boolean

removeAt

  • removeAt(index: number): void

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

    引数

    • index: number

      削除する項目の位置。

    戻り値 void

reverse

  • reverse(): any[]

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

    戻り値 any[]

setAt

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

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

    引数

    • index: number

      項目を設定する位置。

    • item: any

      配列に設定する項目。

    戻り値 void

shift

  • shift(): any | undefined

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

    戻り値 any | undefined

slice

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

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

    引数

    • オプション begin: number

      コピーを開始する位置。

    • オプション end: number

      コピーを終了する位置。

    戻り値 any[]

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?: any): any[]

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

    引数

    • index: number

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

    • count: number

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

    • オプション item: any

      配列に追加する項目。

    戻り値 any[]

toLocaleString

  • toLocaleString(): string

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

    戻り値 string

toString

  • toString(): string

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

    戻り値 string

unshift

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

  • 配列の先頭に1つ以上の新しい要素を追加します。

    引数

    • Rest ...items: any[]

      配列の先頭に追加する1つ以上の要素。

    戻り値 number

values

  • values(): IterableIterator<any>

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

    戻り値 IterableIterator<any>

イベント

collectionChanged

collectionChanged: Event

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