@nativescript/core 9.0.0-alpha.24 → 9.0.0-alpha.26

package/ui/list-view/index.ios.js

@@ -1,40 +1,40 @@
-import { ListViewBase, separatorColorProperty, itemTemplatesProperty, iosEstimatedRowHeightProperty } from './list-view-common';
+import { ListViewBase, separatorColorProperty, itemTemplatesProperty, iosEstimatedRowHeightProperty, stickyHeaderProperty, stickyHeaderTemplateProperty, stickyHeaderHeightProperty, sectionedProperty, showSearchProperty, searchAutoHideProperty } from './list-view-common';
 import { View } from '../core/view';
 import { Length } from '../styling/length-shared';
 import { Observable } from '../../data/observable';
 import { Color } from '../../color';
 import { layout } from '../../utils';
+import { SDK_VERSION } from '../../utils/constants';
 import { StackLayout } from '../layouts/stack-layout';
 import { ProxyViewContainer } from '../proxy-view-container';
 import { profile } from '../../profiling';
 import { Trace } from '../../trace';
+import { Builder } from '../builder';
+import { Label } from '../label';
+import { isFunction } from '../../utils/types';
 export * from './list-view-common';
 const ITEMLOADING = ListViewBase.itemLoadingEvent;
 const LOADMOREITEMS = ListViewBase.loadMoreItemsEvent;
 const ITEMTAP = ListViewBase.itemTapEvent;
 const DEFAULT_HEIGHT = 44;
 const infinity = layout.makeMeasureSpec(0, layout.UNSPECIFIED);
-var ListViewCell = /** @class */ (function (_super) {
+var ListViewCell = (function (_super) {
     __extends(ListViewCell, _super);
     function ListViewCell() {
         return _super !== null && _super.apply(this, arguments) || this;
     }
     ListViewCell.initWithEmptyBackground = function () {
         var cell = ListViewCell.new();
-        // Clear background by default - this will make cells transparent
         cell.backgroundColor = UIColor.clearColor;
         return cell;
     };
     ListViewCell.prototype.initWithStyleReuseIdentifier = function (style, reuseIdentifier) {
         var cell = _super.prototype.initWithStyleReuseIdentifier.call(this, style, reuseIdentifier);
-        // Clear background by default - this will make cells transparent
         cell.backgroundColor = UIColor.clearColor;
         return cell;
     };
     ListViewCell.prototype.willMoveToSuperview = function (newSuperview) {
         var parent = (this.view ? this.view.parent : null);
-        // When inside ListView and there is no newSuperview this cell is
-        // removed from native visual tree so we remove it from our tree too.
         if (parent && !newSuperview) {
             parent._removeContainer(this);
         }
@@ -48,11 +48,42 @@ var ListViewCell = /** @class */ (function (_super) {
     });
     return ListViewCell;
 }(UITableViewCell));
+var ListViewHeaderCell = (function (_super) {
+    __extends(ListViewHeaderCell, _super);
+    function ListViewHeaderCell() {
+        return _super !== null && _super.apply(this, arguments) || this;
+    }
+    ListViewHeaderCell.initWithEmptyBackground = function () {
+        var cell = ListViewHeaderCell.new();
+        cell.backgroundColor = UIColor.clearColor;
+        return cell;
+    };
+    ListViewHeaderCell.prototype.initWithReuseIdentifier = function (reuseIdentifier) {
+        var cell = _super.prototype.initWithReuseIdentifier.call(this, reuseIdentifier);
+        cell.backgroundColor = UIColor.clearColor;
+        return cell;
+    };
+    ListViewHeaderCell.prototype.willMoveToSuperview = function (newSuperview) {
+        var parent = (this.view ? this.view.parent : null);
+        if (parent && !newSuperview) {
+            parent._removeHeaderContainer(this);
+        }
+    };
+    Object.defineProperty(ListViewHeaderCell.prototype, "view", {
+        get: function () {
+            return this.owner ? this.owner.deref() : null;
+        },
+        enumerable: true,
+        configurable: true
+    });
+    return ListViewHeaderCell;
+}(UITableViewHeaderFooterView));
 function notifyForItemAtIndex(listView, cell, view, eventName, indexPath) {
     const args = {
         eventName: eventName,
         object: listView,
         index: indexPath.row,
+        section: indexPath.section,
         view: view,
         ios: cell,
         android: undefined,
@@ -60,7 +91,7 @@ function notifyForItemAtIndex(listView, cell, view, eventName, indexPath) {
     listView.notify(args);
     return args;
 }
-var DataSource = /** @class */ (function (_super) {
+var DataSource = (function (_super) {
     __extends(DataSource, _super);
     function DataSource() {
         return _super !== null && _super.apply(this, arguments) || this;
@@ -70,14 +101,33 @@ var DataSource = /** @class */ (function (_super) {
         dataSource._owner = owner;
         return dataSource;
     };
+    DataSource.prototype.numberOfSectionsInTableView = function (tableView) {
+        var _a;
+        var owner = (_a = this._owner) === null || _a === void 0 ? void 0 : _a.deref();
+        if (!owner) {
+            return 1;
+        }
+        var sections = owner._getSectionCount();
+        if (Trace.isEnabled()) {
+            Trace.write("ListView: numberOfSections = ".concat(sections, " (sectioned: ").concat(owner.sectioned, ")"), Trace.categories.Debug);
+        }
+        return sections;
+    };
     DataSource.prototype.tableViewNumberOfRowsInSection = function (tableView, section) {
         var _a;
         var owner = (_a = this._owner) === null || _a === void 0 ? void 0 : _a.deref();
-        return owner && owner.items ? owner.items.length : 0;
+        if (!owner) {
+            return 0;
+        }
+        var sectionItems = owner._getItemsInSection(section);
+        var rowCount = sectionItems ? sectionItems.length : 0;
+        if (Trace.isEnabled()) {
+            Trace.write("ListView: numberOfRows in section ".concat(section, " = ").concat(rowCount), Trace.categories.Debug);
+        }
+        return rowCount;
     };
     DataSource.prototype.tableViewCellForRowAtIndexPath = function (tableView, indexPath) {
         var _a;
-        // We call this method because ...ForIndexPath calls tableViewHeightForRowAtIndexPath immediately (before we can prepare and measure it).
         var owner = (_a = this._owner) === null || _a === void 0 ? void 0 : _a.deref();
         var cell;
         if (owner) {
@@ -86,8 +136,6 @@ var DataSource = /** @class */ (function (_super) {
             owner._prepareCell(cell, indexPath);
             var cellView = cell.view;
             if (cellView && cellView.isLayoutRequired) {
-                // Arrange cell views. We do it here instead of _layoutCell because _layoutCell is called
-                // from 'tableViewHeightForRowAtIndexPath' method too (in iOS 7.1) and we don't want to arrange the fake cell.
                 var width = layout.getMeasureSpecSize(owner.widthMeasureSpec);
                 var rowHeight = owner._effectiveRowHeight;
                 var cellHeight = rowHeight > 0 ? rowHeight : owner.getHeight(indexPath.row);
@@ -103,7 +151,7 @@ var DataSource = /** @class */ (function (_super) {
     DataSource.ObjCProtocols = [UITableViewDataSource];
     return DataSource;
 }(NSObject));
-var UITableViewDelegateImpl = /** @class */ (function (_super) {
+var UITableViewDelegateImpl = (function (_super) {
     __extends(UITableViewDelegateImpl, _super);
     function UITableViewDelegateImpl() {
         return _super !== null && _super.apply(this, arguments) || this;
@@ -145,7 +193,6 @@ var UITableViewDelegateImpl = /** @class */ (function (_super) {
         }
         var height = owner.getHeight(indexPath.row);
         if (height === undefined) {
-            // in iOS8+ after call to scrollToRowAtIndexPath:atScrollPosition:animated: this method is called before tableViewCellForRowAtIndexPath so we need fake cell to measure its content.
             var template = owner._getItemTemplate(indexPath.row);
             var cell = this._measureCellMap.get(template.key);
             if (!cell) {
@@ -156,10 +203,49 @@ var UITableViewDelegateImpl = /** @class */ (function (_super) {
         }
         return layout.toDeviceIndependentPixels(height);
     };
+    UITableViewDelegateImpl.prototype.tableViewViewForHeaderInSection = function (tableView, section) {
+        var _a;
+        var owner = (_a = this._owner) === null || _a === void 0 ? void 0 : _a.deref();
+        if (!owner || !owner.stickyHeader || !owner.stickyHeaderTemplate) {
+            if (Trace.isEnabled()) {
+                Trace.write("ListView: No sticky header (stickyHeader: ".concat(owner === null || owner === void 0 ? void 0 : owner.stickyHeader, ", hasTemplate: ").concat(!!(owner === null || owner === void 0 ? void 0 : owner.stickyHeaderTemplate), ")"), Trace.categories.Debug);
+            }
+            return null;
+        }
+        if (Trace.isEnabled()) {
+            Trace.write("ListView: Creating sticky header", Trace.categories.Debug);
+        }
+        var headerReuseIdentifier = "stickyHeader";
+        var headerCell = tableView.dequeueReusableHeaderFooterViewWithIdentifier(headerReuseIdentifier);
+        if (!headerCell) {
+            headerCell = ListViewHeaderCell.alloc().initWithReuseIdentifier(headerReuseIdentifier);
+            headerCell.backgroundColor = UIColor.clearColor;
+        }
+        owner._prepareHeader(headerCell, section);
+        return headerCell;
+    };
+    UITableViewDelegateImpl.prototype.tableViewHeightForHeaderInSection = function (tableView, section) {
+        var _a;
+        var owner = (_a = this._owner) === null || _a === void 0 ? void 0 : _a.deref();
+        if (!owner || !owner.stickyHeader) {
+            return 0;
+        }
+        var height;
+        if (owner.stickyHeaderHeight === "auto") {
+            height = 44;
+        }
+        else {
+            height = layout.toDeviceIndependentPixels(Length.toDevicePixels(owner.stickyHeaderHeight, 44));
+        }
+        if (Trace.isEnabled()) {
+            Trace.write("ListView: Sticky header height: ".concat(height), Trace.categories.Debug);
+        }
+        return height;
+    };
     UITableViewDelegateImpl.ObjCProtocols = [UITableViewDelegate];
     return UITableViewDelegateImpl;
 }(NSObject));
-var UITableViewRowHeightDelegateImpl = /** @class */ (function (_super) {
+var UITableViewRowHeightDelegateImpl = (function (_super) {
     __extends(UITableViewRowHeightDelegateImpl, _super);
     function UITableViewRowHeightDelegateImpl() {
         return _super !== null && _super.apply(this, arguments) || this;
@@ -200,14 +286,83 @@ var UITableViewRowHeightDelegateImpl = /** @class */ (function (_super) {
         }
         return layout.toDeviceIndependentPixels(owner._effectiveRowHeight);
     };
+    UITableViewRowHeightDelegateImpl.prototype.tableViewViewForHeaderInSection = function (tableView, section) {
+        var _a;
+        var owner = (_a = this._owner) === null || _a === void 0 ? void 0 : _a.deref();
+        if (!owner || !owner.stickyHeader || !owner.stickyHeaderTemplate) {
+            if (Trace.isEnabled()) {
+                Trace.write("ListView: No sticky header (stickyHeader: ".concat(owner === null || owner === void 0 ? void 0 : owner.stickyHeader, ", hasTemplate: ").concat(!!(owner === null || owner === void 0 ? void 0 : owner.stickyHeaderTemplate), ")"), Trace.categories.Debug);
+            }
+            return null;
+        }
+        if (Trace.isEnabled()) {
+            Trace.write("ListView: Creating sticky header", Trace.categories.Debug);
+        }
+        var headerReuseIdentifier = "stickyHeader";
+        var headerCell = tableView.dequeueReusableHeaderFooterViewWithIdentifier(headerReuseIdentifier);
+        if (!headerCell) {
+            headerCell = ListViewHeaderCell.alloc().initWithReuseIdentifier(headerReuseIdentifier);
+            headerCell.backgroundColor = UIColor.clearColor;
+        }
+        owner._prepareHeader(headerCell, section);
+        return headerCell;
+    };
+    UITableViewRowHeightDelegateImpl.prototype.tableViewHeightForHeaderInSection = function (tableView, section) {
+        var _a;
+        var owner = (_a = this._owner) === null || _a === void 0 ? void 0 : _a.deref();
+        if (!owner || !owner.stickyHeader) {
+            return 0;
+        }
+        var height;
+        if (owner.stickyHeaderHeight === "auto") {
+            height = 44;
+        }
+        else {
+            height = layout.toDeviceIndependentPixels(Length.toDevicePixels(owner.stickyHeaderHeight, 44));
+        }
+        if (Trace.isEnabled()) {
+            Trace.write("ListView: Sticky header height: ".concat(height), Trace.categories.Debug);
+        }
+        return height;
+    };
     UITableViewRowHeightDelegateImpl.ObjCProtocols = [UITableViewDelegate];
     return UITableViewRowHeightDelegateImpl;
 }(NSObject));
+var UISearchResultsUpdatingImpl = (function (_super) {
+    __extends(UISearchResultsUpdatingImpl, _super);
+    function UISearchResultsUpdatingImpl() {
+        return _super !== null && _super.apply(this, arguments) || this;
+    }
+    UISearchResultsUpdatingImpl.initWithOwner = function (owner) {
+        var handler = UISearchResultsUpdatingImpl.new();
+        handler._owner = owner;
+        return handler;
+    };
+    UISearchResultsUpdatingImpl.prototype.updateSearchResultsForSearchController = function (searchController) {
+        var owner = this._owner ? this._owner.get() : null;
+        if (!owner) {
+            return;
+        }
+        var searchText = searchController.searchBar.text || "";
+        owner._isSearchActive = searchController.active;
+        var eventData = {
+            eventName: ListViewBase.searchChangeEvent,
+            object: owner,
+            text: searchText,
+            ios: searchController,
+        };
+        owner.notify(eventData);
+    };
+    UISearchResultsUpdatingImpl.ObjCProtocols = [UISearchResultsUpdating];
+    return UISearchResultsUpdatingImpl;
+}(NSObject));
 export class ListView extends ListViewBase {
     constructor() {
         super();
+        this._isSearchActive = false;
         this.widthMeasureSpec = 0;
         this._map = new Map();
+        this._headerMap = new Map();
         this._heights = new Array();
     }
     createNativeView() {
@@ -217,17 +372,125 @@ export class ListView extends ListViewBase {
         super.initNativeView();
         const nativeView = this.nativeViewProtected;
         nativeView.registerClassForCellReuseIdentifier(ListViewCell.class(), this._defaultTemplate.key);
+        nativeView.registerClassForHeaderFooterViewReuseIdentifier(ListViewHeaderCell.class(), 'stickyHeader');
         nativeView.estimatedRowHeight = DEFAULT_HEIGHT;
         nativeView.rowHeight = UITableViewAutomaticDimension;
         nativeView.dataSource = this._dataSource = DataSource.initWithOwner(new WeakRef(this));
         this._delegate = UITableViewDelegateImpl.initWithOwner(new WeakRef(this));
+        // Control section header top padding (iOS 15+)
+        if (nativeView.respondsToSelector('setSectionHeaderTopPadding:')) {
+            if (!this.stickyHeaderTopPadding) {
+                nativeView.sectionHeaderTopPadding = 0;
+            }
+            // When stickyHeaderTopPadding is true, don't set the property to use iOS default
+        }
         this._setNativeClipToBounds();
     }
     disposeNativeView() {
+        this._cleanupSearchController();
         this._delegate = null;
         this._dataSource = null;
         super.disposeNativeView();
     }
+    _setupSearchController() {
+        if (!this.showSearch || this._searchController) {
+            return; // Already setup or not needed
+        }
+        // 1. Create UISearchController with nil (show results in this table)
+        this._searchController = UISearchController.alloc().initWithSearchResultsController(null);
+        this._searchDelegate = UISearchResultsUpdatingImpl.initWithOwner(new WeakRef(this));
+        // 2. Tell it who will update results
+        this._searchController.searchResultsUpdater = this._searchDelegate;
+        // 3. Critical: Don't dim or obscure the table, and prevent extra content
+        this._searchController.obscuresBackgroundDuringPresentation = false;
+        this._searchController.dimsBackgroundDuringPresentation = false;
+        this._searchController.hidesNavigationBarDuringPresentation = false;
+        // 4. Placeholder text and styling
+        this._searchController.searchBar.placeholder = 'Search';
+        this._searchController.searchBar.searchBarStyle = 2 /* UISearchBarStyle.Minimal */;
+        // 5. CRITICAL: Proper presentation context setup
+        const viewController = this._getViewController();
+        if (viewController) {
+            viewController.definesPresentationContext = true;
+            viewController.providesPresentationContextTransitionStyle = true;
+            // 6a. If we're in a UINavigationController (iOS 11+)...
+            if (SDK_VERSION >= 11.0 && viewController.navigationItem) {
+                viewController.navigationItem.searchController = this._searchController;
+                // Set auto-hide behavior based on searchAutoHide property
+                viewController.navigationItem.hidesSearchBarWhenScrolling = this.searchAutoHide;
+                // Optional: Enable large titles for better auto-hide effect when searchAutoHide is true
+                // if (this.searchAutoHide && viewController.navigationController && viewController.navigationController.navigationBar) {
+                // 	// Only set large titles if not already configured
+                // 	if (!viewController.navigationController.navigationBar.prefersLargeTitles) {
+                // 		viewController.navigationController.navigationBar.prefersLargeTitles = true;
+                // 	}
+                // 	// Set large title display mode for this specific view controller
+                // 	if (viewController.navigationItem.largeTitleDisplayMode === UINavigationItemLargeTitleDisplayMode.Automatic) {
+                // 		viewController.navigationItem.largeTitleDisplayMode = UINavigationItemLargeTitleDisplayMode.Always;
+                // 	}
+                // }
+            }
+            else {
+                // 6b. Fallback: put it at the top of our table
+                this.nativeViewProtected.tableHeaderView = this._searchController.searchBar;
+            }
+        }
+        else {
+            // Fallback: no view controller found, use table header
+            this.nativeViewProtected.tableHeaderView = this._searchController.searchBar;
+        }
+        // 7. Ensure search bar is properly sized and prevent content inset issues
+        this._searchController.searchBar.sizeToFit();
+        // 8. Disable automatic content inset adjustment that can cause spacing issues
+        if (this.nativeViewProtected.respondsToSelector('setContentInsetAdjustmentBehavior:')) {
+            // iOS 11+ - prevent automatic content inset adjustments
+            this.nativeViewProtected.contentInsetAdjustmentBehavior = 2 /* UIScrollViewContentInsetAdjustmentBehavior.Never */;
+        }
+        else {
+            // iOS 10 and below - disable automatic content inset
+            this.nativeViewProtected.automaticallyAdjustsScrollIndicatorInsets = false;
+        }
+        if (Trace.isEnabled()) {
+            Trace.write(`ListView: UISearchController setup complete with searchAutoHide: ${this.searchAutoHide}`, Trace.categories.Debug);
+        }
+    }
+    _cleanupSearchController() {
+        if (!this._searchController) {
+            return;
+        }
+        // Remove search controller from navigation item or table header
+        const viewController = this._getViewController();
+        if (viewController && viewController.navigationItem && viewController.navigationItem.searchController === this._searchController) {
+            viewController.navigationItem.searchController = null;
+        }
+        else if (this.nativeViewProtected.tableHeaderView === this._searchController.searchBar) {
+            this.nativeViewProtected.tableHeaderView = null;
+        }
+        // Reset content inset adjustment behavior
+        if (this.nativeViewProtected.respondsToSelector('setContentInsetAdjustmentBehavior:')) {
+            // iOS 11+ - restore automatic content inset adjustments
+            this.nativeViewProtected.contentInsetAdjustmentBehavior = 0 /* UIScrollViewContentInsetAdjustmentBehavior.Automatic */;
+        }
+        else {
+            // iOS 10 and below - restore automatic content inset
+            this.nativeViewProtected.automaticallyAdjustsScrollIndicatorInsets = true;
+        }
+        // Cleanup references
+        this._searchController.searchResultsUpdater = null;
+        this._searchController = null;
+        this._searchDelegate = null;
+    }
+    _getViewController() {
+        // Helper to get the current view controller
+        let parent = this.parent;
+        while (parent) {
+            if (parent.viewController) {
+                return parent.viewController;
+            }
+            parent = parent.parent;
+        }
+        return null;
+    }
     _setNativeClipToBounds() {
         // Always set clipsToBounds for list-view
         const view = this.nativeViewProtected;
@@ -241,18 +504,25 @@ export class ListView extends ListViewBase {
             this.refresh();
         }
         this.nativeViewProtected.delegate = this._delegate;
+        // Setup search controller if enabled
+        if (this.showSearch) {
+            this._setupSearchController();
+        }
     }
     // @ts-ignore
     get ios() {
         return this.nativeViewProtected;
     }
     get _childrenCount() {
-        return this._map.size;
+        return this._map.size + this._headerMap.size;
     }
     eachChildView(callback) {
         this._map.forEach((view, key) => {
             callback(view);
         });
+        this._headerMap.forEach((view, key) => {
+            callback(view);
+        });
     }
     scrollToIndex(index) {
         this._scrollToIndex(index, false);
@@ -286,6 +556,11 @@ export class ListView extends ListViewBase {
                 view.bindingContext = null;
             }
         });
+        this._headerMap.forEach((view, nativeView, map) => {
+            if (!(view.bindingContext instanceof Observable)) {
+                view.bindingContext = null;
+            }
+        });
         if (this.isLoaded) {
             this.nativeViewProtected.reloadData();
             this.requestLayout();
@@ -324,8 +599,8 @@ export class ListView extends ListViewBase {
         super._onRowHeightPropertyChanged(oldValue, newValue);
     }
     requestLayout() {
-        // When preparing cell don't call super - no need to invalidate our measure when cell desiredSize is changed.
-        if (!this._preparingCell) {
+        // When preparing cell or header don't call super - no need to invalidate our measure when cell/header desiredSize is changed.
+        if (!this._preparingCell && !this._preparingHeader) {
             super.requestLayout();
         }
     }
@@ -343,6 +618,9 @@ export class ListView extends ListViewBase {
         this._map.forEach((childView, listViewCell) => {
             View.measureChild(this, childView, childView._currentWidthMeasureSpec, childView._currentHeightMeasureSpec);
         });
+        this._headerMap.forEach((childView, listViewHeaderCell) => {
+            View.measureChild(this, childView, childView._currentWidthMeasureSpec, childView._currentHeightMeasureSpec);
+        });
     }
     onLayout(left, top, right, bottom) {
         super.onLayout(left, top, right, bottom);
@@ -355,6 +633,12 @@ export class ListView extends ListViewBase {
                 View.layoutChild(this, childView, 0, 0, width, cellHeight);
             }
         });
+        this._headerMap.forEach((childView, listViewHeaderCell) => {
+            const headerHeight = this.stickyHeaderHeight === 'auto' ? 44 : Length.toDevicePixels(this.stickyHeaderHeight, 44);
+            const width = layout.getMeasureSpecSize(this.widthMeasureSpec);
+            childView.iosOverflowSafeAreaEnabled = false;
+            View.layoutChild(this, childView, 0, 0, width, headerHeight);
+        });
     }
     _layoutCell(cellView, indexPath) {
         if (cellView) {
@@ -373,10 +657,21 @@ export class ListView extends ListViewBase {
             this._preparingCell = true;
             let view = cell.view;
             if (!view) {
-                view = this._getItemTemplate(indexPath.row).createView();
+                if (this.sectioned) {
+                    // For sectioned data, we need to calculate the absolute index for template selection
+                    let absoluteIndex = 0;
+                    for (let i = 0; i < indexPath.section; i++) {
+                        absoluteIndex += this._getItemsInSection(i).length;
+                    }
+                    absoluteIndex += indexPath.row;
+                    view = this._getItemTemplate(absoluteIndex).createView();
+                }
+                else {
+                    view = this._getItemTemplate(indexPath.row).createView();
+                }
             }
             const args = notifyForItemAtIndex(this, cell, view, ITEMLOADING, indexPath);
-            view = args.view || this._getDefaultItemContent(indexPath.row);
+            view = args.view || this._getDefaultItemContent(this.sectioned ? indexPath.row : indexPath.row);
             // Proxy containers should not get treated as layouts.
             // Wrap them in a real layout as well.
             if (view instanceof ProxyViewContainer) {
@@ -394,8 +689,15 @@ export class ListView extends ListViewBase {
                 this._removeContainer(cell);
                 cell.owner = new WeakRef(view);
             }
-            this._prepareItem(view, indexPath.row);
-            view._listViewItemIndex = indexPath.row;
+            if (this.sectioned) {
+                this._prepareItemInSection(view, indexPath.section, indexPath.row);
+                view._listViewItemIndex = indexPath.row; // Keep row index for compatibility
+                view._listViewSectionIndex = indexPath.section;
+            }
+            else {
+                this._prepareItem(view, indexPath.row);
+                view._listViewItemIndex = indexPath.row;
+            }
             this._map.set(cell, view);
             // We expect that views returned from itemLoading are new (e.g. not reused).
             if (view && !view.parent) {
@@ -423,6 +725,151 @@ export class ListView extends ListViewBase {
         this._preparingCell = preparing;
         this._map.delete(cell);
     }
+    _prepareHeader(headerCell, section) {
+        let headerHeight;
+        try {
+            this._preparingHeader = true;
+            let view = headerCell.view;
+            if (!view) {
+                view = this._getHeaderTemplate();
+                if (!view) {
+                    if (Trace.isEnabled()) {
+                        Trace.write(`ListView: Failed to create header view for section ${section}`, Trace.categories.Debug);
+                    }
+                    // Create a fallback view
+                    const lbl = new Label();
+                    lbl.text = `Section ${section}`;
+                    view = lbl;
+                }
+            }
+            // Handle header cell reuse
+            if (!headerCell.view) {
+                headerCell.owner = new WeakRef(view);
+            }
+            else if (headerCell.view !== view) {
+                // Remove old view and set new one
+                headerCell.view.nativeViewProtected?.removeFromSuperview();
+                this._removeHeaderContainer(headerCell);
+                headerCell.owner = new WeakRef(view);
+            }
+            // Clear existing binding context and set new one
+            if (view.bindingContext) {
+                view.bindingContext = null;
+            }
+            if (this.sectioned) {
+                const sectionData = this._getSectionData(section);
+                if (sectionData) {
+                    view.bindingContext = sectionData;
+                }
+                else {
+                    // Fallback if section data is missing
+                    view.bindingContext = { title: `Section ${section}`, section: section };
+                }
+            }
+            else {
+                view.bindingContext = this.bindingContext;
+            }
+            // Force immediate binding context evaluation
+            if (view && typeof view._onBindingContextChanged === 'function') {
+                view._onBindingContextChanged(null, view.bindingContext);
+                // Also trigger for child views
+                // @ts-ignore
+                if (view._childrenCount) {
+                    view.eachChildView((child) => {
+                        if (typeof child._onBindingContextChanged === 'function') {
+                            child._onBindingContextChanged(null, view.bindingContext);
+                        }
+                        return true;
+                    });
+                }
+            }
+            this._headerMap.set(headerCell, view);
+            // Add new header view to the cell
+            if (view && !view.parent) {
+                this._addView(view);
+                headerCell.contentView.addSubview(view.nativeViewProtected);
+            }
+            // Request layout and measure/layout the header
+            if (view && view.bindingContext) {
+                view.requestLayout();
+            }
+            headerHeight = this._layoutHeader(view);
+        }
+        finally {
+            this._preparingHeader = false;
+        }
+        return headerHeight;
+    }
+    _layoutHeader(headerView) {
+        if (headerView) {
+            const headerHeight = this.stickyHeaderHeight === 'auto' ? 44 : Length.toDevicePixels(this.stickyHeaderHeight, 44);
+            const heightMeasureSpec = layout.makeMeasureSpec(headerHeight, layout.EXACTLY);
+            const measuredSize = View.measureChild(this, headerView, this.widthMeasureSpec, heightMeasureSpec);
+            // Layout the header with the measured size
+            View.layoutChild(this, headerView, 0, 0, measuredSize.measuredWidth, measuredSize.measuredHeight);
+            return measuredSize.measuredHeight;
+        }
+        return 44;
+    }
+    _getHeaderTemplate() {
+        if (this.stickyHeaderTemplate) {
+            if (__UI_USE_EXTERNAL_RENDERER__) {
+                if (isFunction(this.stickyHeaderTemplate)) {
+                    return this.stickyHeaderTemplate();
+                }
+            }
+            else {
+                if (typeof this.stickyHeaderTemplate === 'string') {
+                    try {
+                        const parsed = Builder.parse(this.stickyHeaderTemplate, this);
+                        if (!parsed) {
+                            // Create a simple fallback
+                            const fallbackLabel = new Label();
+                            fallbackLabel.text = 'Parse Failed';
+                            return fallbackLabel;
+                        }
+                        return parsed;
+                    }
+                    catch (error) {
+                        if (Trace.isEnabled()) {
+                            Trace.write(`ListView: Template parsing error: ${error}`, Trace.categories.Debug);
+                        }
+                        // Create a simple fallback
+                        const errorLabel = new Label();
+                        errorLabel.text = 'Template Error';
+                        return errorLabel;
+                    }
+                }
+                else {
+                    const view = this.stickyHeaderTemplate();
+                    if (Trace.isEnabled()) {
+                        Trace.write(`ListView: Created header view from template function: ${!!view} (type: ${view?.constructor?.name})`, Trace.categories.Debug);
+                    }
+                    return view;
+                }
+            }
+        }
+        if (Trace.isEnabled()) {
+            Trace.write(`ListView: No sticky header template, creating default`, Trace.categories.Debug);
+        }
+        // Return a default header if no template is provided
+        const lbl = new Label();
+        lbl.text = 'Default Header';
+        return lbl;
+    }
+    _removeHeaderContainer(headerCell) {
+        const view = headerCell.view;
+        // This is to clear the StackLayout that is used to wrap ProxyViewContainer instances.
+        if (!(view.parent instanceof ListView)) {
+            this._removeView(view.parent);
+        }
+        // No need to request layout when we are removing headers.
+        const preparing = this._preparingHeader;
+        this._preparingHeader = true;
+        view.parent._removeView(view);
+        this._preparingHeader = preparing;
+        this._headerMap.delete(headerCell);
+    }
     [separatorColorProperty.getDefault]() {
         return this.nativeViewProtected.separatorColor;
     }
@@ -450,6 +897,95 @@ export class ListView extends ListViewBase {
         const estimatedHeight = layout.toDeviceIndependentPixels(Length.toDevicePixels(value, 0));
         nativeView.estimatedRowHeight = estimatedHeight < 0 ? DEFAULT_HEIGHT : estimatedHeight;
     }
+    [stickyHeaderProperty.getDefault]() {
+        return false;
+    }
+    [stickyHeaderProperty.setNative](value) {
+        if (Trace.isEnabled()) {
+            Trace.write(`ListView: stickyHeader set to ${value}`, Trace.categories.Debug);
+        }
+        // Immediately refresh to apply changes
+        if (this.isLoaded) {
+            this.refresh();
+        }
+    }
+    [stickyHeaderTemplateProperty.getDefault]() {
+        return null;
+    }
+    [stickyHeaderTemplateProperty.setNative](value) {
+        if (Trace.isEnabled()) {
+            Trace.write(`ListView: stickyHeaderTemplate set: ${typeof value} ${value ? '(has value)' : '(null)'}`, Trace.categories.Debug);
+        }
+        // Clear any cached template
+        this._headerTemplateCache = null;
+        // Immediately refresh to apply changes
+        if (this.isLoaded) {
+            this.refresh();
+        }
+    }
+    [stickyHeaderHeightProperty.getDefault]() {
+        return 'auto';
+    }
+    [stickyHeaderHeightProperty.setNative](value) {
+        if (Trace.isEnabled()) {
+            Trace.write(`ListView: stickyHeaderHeight set to ${value}`, Trace.categories.Debug);
+        }
+        // Immediately refresh to apply changes
+        if (this.isLoaded) {
+            this.refresh();
+        }
+    }
+    [sectionedProperty.getDefault]() {
+        return false;
+    }
+    [sectionedProperty.setNative](value) {
+        if (Trace.isEnabled()) {
+            Trace.write(`ListView: sectioned set to ${value}`, Trace.categories.Debug);
+        }
+        // Immediately refresh to apply changes
+        if (this.isLoaded) {
+            this.refresh();
+        }
+    }
+    [showSearchProperty.getDefault]() {
+        return false;
+    }
+    [showSearchProperty.setNative](value) {
+        if (Trace.isEnabled()) {
+            Trace.write(`ListView: showSearch set to ${value}`, Trace.categories.Debug);
+        }
+        if (value) {
+            this._setupSearchController();
+        }
+        else {
+            this._cleanupSearchController();
+        }
+    }
+    [searchAutoHideProperty.getDefault]() {
+        return false;
+    }
+    [searchAutoHideProperty.setNative](value) {
+        if (Trace.isEnabled()) {
+            Trace.write(`ListView: searchAutoHide set to ${value}`, Trace.categories.Debug);
+        }
+        // If search is already enabled, update the existing search controller
+        if (this.showSearch && this._searchController) {
+            const viewController = this._getViewController();
+            if (viewController && viewController.navigationItem && SDK_VERSION >= 11.0) {
+                viewController.navigationItem.hidesSearchBarWhenScrolling = value;
+                // Enable large titles for better auto-hide effect when searchAutoHide is true
+                // if (value && viewController.navigationController && viewController.navigationController.navigationBar) {
+                // 	if (!viewController.navigationController.navigationBar.prefersLargeTitles) {
+                // 		viewController.navigationController.navigationBar.prefersLargeTitles = true;
+                // 	}
+                // 	if (viewController.navigationItem.largeTitleDisplayMode === UINavigationItemLargeTitleDisplayMode.Automatic) {
+                // 		viewController.navigationItem.largeTitleDisplayMode = UINavigationItemLargeTitleDisplayMode.Always;
+                // 	}
+                // }
+            }
+        }
+        // If search is not enabled yet, the property will be used when _setupSearchController is called
+    }
 }
 __decorate([
     profile,