Платформа A2v10 довідкова система
EN


Властивості і методи масиву

Кожен масив розширюється наступними додатковими службовими властивостями та методами:

Кожен елемент в масиві реалізує інтерфейс IArrayElement і містить деякі додаткові властивості і методи.


Властивості

readonly $root: IRoot

Посилання на кореневий об`єкт моделі (IRoot).

readonly $parent: IElement

Посилання на батьківський об`єкт масива (IElement).

readonly $ctrl: IController

Посилання на об`єкт контролера (IController).

readonly $hasSelected: boolean

Чи є в масиві виділений елемент (той, в якого властивість $selected встановлено в true).

readonly $hasChecked: boolean

Чи є в масиві щонайменьше один відмічений елемент (той, в якого властивість $checked встановлено в true).

readonly $selectedIndex: number

Індекс виділеного елементу або -1, якщо нема виділеного елементу.

readonly $checked: IElementArray<T>

Масив позначених ($checked = true) елементів поточного масиву.

readonly $cross: { [prop: string]: string[] }

Об'єкт ключів для перехресних моделей даних. Повертає об`єкт з іменами властивостей, що відповідають перехресним полям. Значеннями є масив рядків - перехресних ключів.

Методи

			
		

Опис

Очищує масив. Видаляє всі елементи.

Повертає:

  • Посилання на сам масив.
			
		

Опис

Перезавантажує масив з бази даних. Має сенс тільки для дочірніх та "лінивих" масивів.

Повертає:

  • Проміс з посиланням на сам масив.
			
		

Опис

Видаляє заданий елемент з масива.

Аргументи:

  • elem - елемент, що видаляється.

Повертає:

  • Посилання на сам масив.
			
		

Опис

Скидає ознаку виділення з усіх елементів масиву.

Повертає:

  • Посилання на сам масив.
			
		

Опис

Вставляє елемент в кінець масиву. Якщо джерело вказане і є об'єктом, то його властивості копіюються во вставлений елемент.

Аргументи:

  • src - джерело для вставки. Може бути звичайним (не реактивним) об'єктом javascript.

Повертає:

  • Вставлений елемент.
			
		

Опис

Вставляє елемент на початок масива. Якщо джерело вказане і є об'єктом, то його властивості копіюються у вставлений елемент.

Аргументи:

  • src - джерело для вставки. Може бути звичайним (не реактивним) об'єктом javascript.

Повертає:

  • Вставлений елемент.
			
		

Опис

Вставляє в масив новий елемент.

Аргументи:

  • src - джерело. Може бути звичайним (не реактивним) об'єктом javascript.
  • to - місце вставки. Можливі значення:
    • 'start' - на початок масива (еквівалент $prepend).
    • 'end' - в кінець масива (еквівалент $append).
    • 'above' - перед вказаним (ref) елементом.
    • 'below' - після вказаного (ref) елементу.
  • ref - Елемент, відносно якого буде виконуватися вставка для to = 'above' | 'below'.

Повертає:

  • Вставлений елемент.
			
		

Опис

Копіює джерело в поточний масив.

Аргументи:

  • src - джерело для копіювання. Може бути масивом звичайних (не реактивних) об'єктів javascript. Властивості джерела, яких нема в елементі, ігноруються.

Повертає:

  • Сам масив.
			
		

Опис

Обчислює суму для елементів масиву.

Аргументи:

  • fn - функція зворотнього виклику, яка повинна повернути властивість елементу масиву для підсумовування.

Повертає:

  • Обчислену суму.
			
		

Опис

Шукає в масиві перший підходящий елемент. Функція відрізняється від звичайного пошуку в масиві тим, що для ієрархічних масивів вона виконує рекурсивний пошук по дереву.

Аргументи:

  • fn - функція зворотнього виклику, яка повинна повернути true, якщо елемент підходить по критеріях вибірки. Аргументи функції:
    • this? - значення аргументу thisArg.
    • item - елемент масиву.
    • index? - індекс елементу.
    • array? - масив, в якому виконується пошук.
  • thisArg - значення аргументу this для функції зворотнього виклику

Повертає:

  • Знайдений елемент.
			
		

Опис

Чи є масив "лінивим".

Повертає:

  • true, якщо масив "лінивий" (з відкладеним завантаженням).
			
		

Опис

Скидає ознаку завантаження "лінивого" масиву. При наступному звернені масив заново буде завантажений з сервера.