DefaultNavigationView Directory Reference

Directories
	dart
	java
	kotlin
	objc
	swift

Detailed Description

This directory contains examples demonstrating the usage of DefaultNavigationView across all supported platforms.

Overview

DefaultNavigationView is a ready-to-use navigation view with built-in UI controls:

• Zoom controls — +/- buttons for zoom in/out
• Floor selector — vertical list for switching between floors (sublocations)
• Follow Me button — toggles camera following the user location
• User location layer — displays user position on the map

The view automatically hooks SDK listeners (location, sublocation, camera) and keeps widgets in sync.

Key Components

DefaultNavigationView

• Constructor: Creates a navigation view with callback and optional configs
• onViewCreated: Callback when the view is created (provides LocationWindow access)
• Configs: Widget configs are passed directly to each widget

DefaultNavigationViewConfig (view config)

• visibleWidgets: Bitmask to show/hide zoom controls, follow me button, floor selector

Widget Configs (passed directly to widgets)

• ZoomControlsConfig — zoomInIcon, zoomOutIcon, buttonBackgroundColor, textColor, buttonWidth, zoomControlsHeight, padding
• FollowMeButtonConfig — followMeIcon, followMeIconActive, accentColor, buttonBackgroundColor, textColor, buttonWidth, buttonHeight, padding
• FloorSelectorViewConfig — accentColor, textColor, buttonBackgroundColor, padding

Runtime Customization

• viewConfig / setViewConfig() (iOS/Android): Update visibility at runtime
• setConfig() (Android): Update all configs at runtime (null = keep current)
• setConfigWithViewConfig:zoomConfig:followMeConfig:floorConfig: (iOS): Update all configs at runtime
• DefaultNavigationViewController (Flutter): Controller for runtime config updates via updateConfig()

Platform-Specific Files

Dart/Flutter

• dart/default_navigation_view_example.dart — Flutter widget example with config and controller

Java

• java/DefaultNavigationViewExample.java — Java implementation with config and setConfig

Kotlin

• kotlin/DefaultNavigationViewExample.kt — Kotlin implementation with config builder

Objective-C

• objc/DefaultNavigationViewExample.h — Header file
• objc/DefaultNavigationViewExample.m — Implementation with config properties

Swift

• swift/DefaultNavigationViewExample.swift — Swift implementation with config

Key Documentation Tags

DefaultNavigationView Constructor

• [dart_DefaultNavigationView_constructor] — Dart DefaultNavigationView constructor (default config)
• [dart_DefaultNavigationView_constructor_config] — Dart with custom configs
• [java_DefaultNavigationView_constructor] / [java_DefaultNavigationView_constructor_config] — Java constructor (default / with configs)
• [kotlin_DefaultNavigationView_constructor] / [kotlin_DefaultNavigationView_constructor_config] — Kotlin constructor
• [objc_DefaultNavigationView_constructor] / [objc_DefaultNavigationView_constructor_config] — Objective-C constructor
• [swift_DefaultNavigationView_constructor] / [swift_DefaultNavigationView_constructor_config] — Swift constructor

Config

• [dart_DefaultNavigationView_config] — Dart config usage (configs passed directly)
• [java_DefaultNavigationView_config] — Java config with Builder
• [kotlin_DefaultNavigationView_config] — Kotlin config with builder
• [objc_DefaultNavigationView_config] — Objective-C NCDefaultNavigationViewConfig + widget configs
• [swift_DefaultNavigationView_config] — Swift config

Widget Configs

• [java_ZoomControlsConfig] / [kotlin_ZoomControlsConfig] — ZoomControlsConfig (Java/Kotlin)
• [objc_ZoomControlsConfig] / [swift_ZoomControlsConfig] — NCZoomControlsConfig (ObjC/Swift)
• [dart_ZoomControlsConfig] — ZoomControlsConfig (Dart)
• [java_FollowMeButtonConfig] / [kotlin_FollowMeButtonConfig] — FollowMeButtonConfig (Java/Kotlin)
• [objc_FollowMeButtonConfig] / [swift_FollowMeButtonConfig] — NCFollowMeButtonConfig (ObjC/Swift)
• [dart_FollowMeButtonConfig] — FollowMeButtonConfig (Dart)
• [java_FloorSelectorViewConfig] / [kotlin_FloorSelectorViewConfig] — FloorSelectorViewConfig (Java/Kotlin)
• [objc_FloorSelectorViewConfig] / [swift_FloorSelectorViewConfig] — NCFloorSelectorViewConfig (ObjC/Swift)
• [dart_FloorSelectorViewConfig] — FloorSelectorViewConfig (Dart)

Runtime Update

• [dart_DefaultNavigationView_runtimeConfig] — Dart DefaultNavigationViewController
• [java_DefaultNavigationView_runtimeConfig] — Java setConfig
• [kotlin_DefaultNavigationView_runtimeConfig] — Kotlin setConfig
• [objc_DefaultNavigationView_runtimeConfig] — Objective-C setConfigWithViewConfig:...
• [swift_DefaultNavigationView_runtimeConfig] — Swift setConfig

Widget Access

• [dart_DefaultNavigationView_widgetAccess] — Dart (via config visibility)
• [java_DefaultNavigationView_widgetAccess] — Java getZoomControls, getFollowMeButton, getFloorSelectorView
• [objc_DefaultNavigationView_widgetAccess] — Objective-C zoomControls, followMeButton, floorSelectorView
• [swift_DefaultNavigationView_widgetAccess] — Swift zoomControls, followMeButton, floorSelectorView

Common Usage Patterns

1. Basic Usage (default config)

DefaultNavigationView(
  onViewCreated: (LocationWindow window) {
    locationWindow = window;
  },
)

2. Custom Config (hide floor selector, custom accent — configs passed directly)

DefaultNavigationView(
  viewConfig: DefaultNavigationViewConfig(
    visibleWidgets: NavigationWidgetVisibility.zoomControls | NavigationWidgetVisibility.followMeButton,
  ),
  followMeButtonConfig: FollowMeButtonConfig(
    accentColor: Color(0xFF30AAD9),
  ),
  onViewCreated: (window) { ... },
)

3. Runtime Config Update

final configController = DefaultNavigationViewController();
 
DefaultNavigationView(
  configController: configController,
  onViewCreated: (window) { ... },
)
 
// Later, in runtime:
configController.updateConfig(
  viewConfig: DefaultNavigationViewConfig(visibleWidgets: NavigationWidgetVisibility.followMeButton),
  followMeConfig: FollowMeButtonConfig(accentColor: Color(0xFFFF0000)),
);

4. Direct Widget Access (Android/Java/iOS)

// Get widgets for advanced customization
ZoomControls zoomControls = navigationView.getZoomControls();
FollowMeButton followMeButton = navigationView.getFollowMeButton();
FloorSelectorView floorSelector = navigationView.getFloorSelectorView();

Visibility Flags

• NavigationWidgetVisibility.zoomControls (1 << 0)
• NavigationWidgetVisibility.followMeButton (1 << 1)
• NavigationWidgetVisibility.floorSelector (1 << 2)
• NavigationWidgetVisibility.all (0x7) — all widgets visible

Notes

• All examples demonstrate the same functionality across platforms
• Widget configs are passed directly to each widget; DefaultNavigationViewConfig controls only visibility
• Runtime config updates apply immediately on all platforms
• Floor selector hides automatically when location has only one floor