autoHideOnModal property

bool autoHideOnModal
final

When true (default), destroys the native button's PlatformView while a modal sheet is presented above this widget's host route. Fixes the iOS hybrid-composition z-order bleed (Issue #53) where a host-page CNButton's pixels leak through a sheet that also contains a CN-widget. Requires CNTabBarRouteObserver() to be registered in the app's navigatorObservers. No effect on iOS < 26 / non-iOS (Flutter fallback).

When false, the native view stays while a modal (a dialog, popup or sheet) is up, and its Liquid Glass glow is clipped to the view's bounds from the modal's push until its exit animation ends, so no box shows around it through the modal's barrier (Issue #124).

Implementation

final bool autoHideOnModal;