Кожен масив розширюється наступними додатковими службовими властивостями та методами:
Кожен елемент в масиві реалізує інтерфейс 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
- місце вставки. Можливі значення:
$prepend
).$append
).ref
) елементом.ref
) елементу.ref
- Елемент, відносно якого буде виконуватися вставка для to = 'above' | 'below'
.Копіює джерело в поточний масив.
src
- джерело для копіювання. Може бути масивом звичайних (не реактивних) об'єктів javascript.
Властивості джерела, яких нема в елементі, ігноруються.
Обчислює суму для елементів масиву.
fn
- функція зворотнього виклику, яка повинна повернути властивість елементу масиву для підсумовування.
Шукає в масиві перший підходящий елемент. Функція відрізняється від звичайного пошуку в масиві тим, що для ієрархічних масивів вона виконує рекурсивний пошук по дереву.
fn
- функція зворотнього виклику, яка повинна повернути true
,
якщо елемент підходить по критеріях вибірки.
Аргументи функції:
this?
- значення аргументу thisArg
.
item
- елемент масиву.index?
- індекс елементу.array?
- масив, в якому виконується пошук.thisArg
- значення аргументу this
для функції зворотнього виклику
Скидає ознаку завантаження "лінивого" масиву. При наступному звернені масив заново буде завантажений з сервера.