Popup types and visual styles

OpenMenuOS ships five built-in popup types, each with a distinct color scheme, default icon, and interaction behavior. Choosing the right type ensures your UI communicates intent clearly without extra configuration. Every type is accessible through a one-line convenience method on PopupManager or through a PopupConfig struct when you need additional control.

INFO
SUCCESS
WARNING
ERROR
QUESTION

Enum value: PopupType::INFO
Convenience method: PopupManager::showInfo(message, title)
Color scheme: Blue header
Default title: "Information"
Dismissal: Manual — stays open until the user presses OK.Use INFO for neutral messages that give the user context without implying urgency.

PopupManager::showInfo(
  "This is an information message!",
  "Info Demo"
);

// Without a title — defaults to "Information"
PopupManager::showInfo("OpenMenuOS v3.1.0\nProfessional Menu System");

Enum value: PopupType::SUCCESS
Convenience method: PopupManager::showSuccess(message, title)
Color scheme: Green header
Default title: "Success"
Dismissal: Auto-closes after ~3 seconds (configurable via PopupConfig::autoCloseDelay).Use SUCCESS for confirmation that an operation completed as expected.

PopupManager::showSuccess("Settings saved!");

// Override the auto-close delay with PopupConfig
PopupConfig config;
config.message = "Firmware updated successfully.";
config.type = PopupType::SUCCESS;
config.autoClose = true;
config.autoCloseDelay = 5000; // 5 seconds
PopupManager::show(config);

showSuccess() enables auto-close automatically. If you create a SUCCESS popup via PopupManager::show() and want it to stay open, set autoClose = false in your PopupConfig.

Enum value: PopupType::WARNING
Convenience method: PopupManager::showWarning(message, title)
Color scheme: Orange header
Default title: "Warning"
Dismissal: Manual — stays open until the user presses OK.Use WARNING when the user should pay attention before continuing, but no error has occurred yet.

PopupManager::showWarning(
  "This action cannot be undone",
  "Warning!"
);

// Warn about a disabled prerequisite
if (!wifiEnabled) {
  PopupManager::showWarning(
    "WiFi is disabled.\nEnable in Settings first.",
    "WiFi Disabled"
  );
}

Enum value: PopupType::ERROR
Convenience method: PopupManager::showError(message, title)
Color scheme: Red header
Default title: "Error"
Dismissal: Manual — stays open until the user presses OK.Use ERROR when something has gone wrong and the user needs to know.

PopupManager::showError("Failed to save settings", "Error");

// Report a connection failure
PopupManager::showError("Connection failed", "Network Error");

Enum value: PopupType::QUESTION
Convenience method: PopupManager::showQuestion(message, title)
Color scheme: Cyan header
Default title: "Question"
Dismissal: User presses Yes (OK) or No (Cancel).Use QUESTION when the sketch needs explicit confirmation before performing a destructive or irreversible action.

// Trigger from a menu action callback
void resetDevice() {
  PopupManager::showQuestion(
    "This will restart the device.\nContinue?",
    "Reset Device"
  );
}

// Handle the result in loop()
void loop() {
  PopupResult result = PopupManager::update();
  menu.loop();

  if (result == PopupResult::OK) {
    delay(500);
    ESP.restart();
  }
}

PopupResult enum

Every show* call and PopupManager::update() returns a PopupResult value. Use it to branch your sketch logic after the user interacts with a popup.

enum class PopupResult {
  NONE,   // No user interaction yet — popup still visible
  OK,     // User pressed OK or Yes
  CANCEL, // User pressed Cancel or No
  YES,    // Alias for OK (question dialogs)
  NO      // Alias for CANCEL (question dialogs)
};

NONE

PopupResult

Returned by update() on every iteration while the popup is still open and the user has not yet acted. Also returned immediately by all show* methods on the call that opens the popup.

PopupResult

Returned when the user presses the OK or Yes button, or when auto-close fires.

CANCEL

PopupResult

Returned when the user presses the Cancel or No button.

YES

PopupResult

Alias for OK. Both values compare equal. Prefer OK in new code unless you are writing a question dialog and want the intent to be explicit.

PopupResult

Alias for CANCEL. Both values compare equal. Prefer CANCEL in new code unless you are writing a question dialog and want the intent to be explicit.

Handling results in loop()

void loop() {
  PopupResult result = PopupManager::update();
  menu.loop();

  if (result != PopupResult::NONE) {
    switch (result) {
      case PopupResult::OK:
        Serial.println("User clicked OK/Yes");
        break;
      case PopupResult::CANCEL:
        Serial.println("User clicked Cancel/No");
        break;
      default:
        break;
    }
  }
}

When a rotary encoder is configured via menu.setEncoderPin(clk, dt), the popup system supports encoder-driven button selection:

Rotate the encoder to move the highlight between the OK and Cancel/No buttons.
Press the encoder button to confirm the highlighted selection.

This mirrors the button behavior you configure for general menu navigation — no additional setup is needed for popups.

// Enable encoder support (also activates encoder navigation in popups)
menu.setEncoderPin(5, 2);  // CLK, DT pins
menu.setSelectPin(19);     // Encoder push-button

Encoder support in popups is activated automatically as soon as you call menu.setEncoderPin(). No separate popup configuration is required.

Main Classes

Popup System

Data Types

Popup types and visual styles

PopupResult enum

Handling results in loop()

Encoder navigation

Build docs developers (and LLMs) love

Main Classes

Popup System

Data Types

Documentation Index

​Popup types

​PopupResult enum

​Handling results in loop()

​Encoder navigation

Build docs developers (and LLMs) love

Popup types

PopupResult enum

Handling results in loop()

Encoder navigation