Control Navigation Bar

The Control Navigation Bar action allows you to programmatically control the navigation bar's selected index. This can be used to switch between tabs or navigation items dynamically based on user interactions or app logic.

This action only works when a navigation bar is present in the current UI. If no navigation bar exists, the action will have no effect.

---

---

📦 Properties

Property	Type	Required	Description
index	Expression (Number)	✅	The zero-based index of the navigation bar item to activate. Can be a static number or an expression that evaluates to an integer.

✅ Common Use Cases

• Programmatically switch the active tab based on user actions

• Synchronize navigation bar state with other components or events

• Control navigation from outside the navigation bar widget

• Implement custom navigation flows or deep linking

---

⚙️ Default Behavior

By default:

Behavior	Description
Index Validation	The index must evaluate to a valid integer (0-based)
Navigation Bar Required	Action only works if a navigation bar is present in the current UI
Bounds Checking	If the index is out of range, the action may have no effect or clamp to valid range
Visual Feedback	Navigation bar updates immediately to show the selected tab
Event Triggering	May trigger navigation bar change events and associated actions

---

🛠️ How to Use

1. Add the action to a widget event (e.g., button tap, form submission)

2. Choose Control Navigation Bar from the action list

3. Set the index property to the desired navigation item (0-based)

Call External Method action configuration in Digia Studio

---

🔗 Related Documentation

• Navigation Bar - Learn about navigation bar widgets

• Navigation Bar Item - Individual navigation items

• Set App State - Update app state that might control navigation

• Control Drawer - Control other navigation elements

---

Asset Placeholder: Tutorial video demonstrating navigation bar control in Digia Studio