T9InputView.h

Go to the documentation of this file.

#pragma once
 
#include "cdc_ui/IView.h"
#include <cstdint>
 
namespace cdc::ui {

class T9InputView : public ViewBase {
public:
    static constexpr uint16_t MAX_TEXT_LEN = 320;
    static constexpr uint32_t TIMEOUT_MS = 2000;  // Time before character is committed

    using SaveCallback = void(*)(const char* text);

    using CancelCallback = void(*)();

    void init(const char* title, const char* initialText = nullptr, uint16_t maxLen = MAX_TEXT_LEN);

    void setOnSave(SaveCallback callback) { onSave_ = callback; }

    void setOnCancel(CancelCallback callback) { onCancel_ = callback; }

    const char* getText() const { return text_; }

    uint16_t getLength() const { return len_; }

    void setPlaceholder(const char* placeholder) { placeholder_ = placeholder; }

    void setHint(const char* hint) { hintOverride_ = hint; }

    void forceDigit(char key);

    uint16_t appendRaw(const char* text);
 
    // IView implementation
    void render(bool partial) override;
    InputResult onKey(char key) override;
    InputResult onLongPress(char key) override;
    void onTick(uint32_t nowMs) override;
    const char* getName() const override { return "T9InputView"; }
    const char* getFooterHint() const override;
 
protected:
    static constexpr uint16_t TITLE_MAX_LEN = 48;
    char titleBuf_[TITLE_MAX_LEN + 1] = {0};
    const char* title_ = nullptr;
    const char* placeholder_ = nullptr;
    const char* hintOverride_ = nullptr;
    char text_[MAX_TEXT_LEN + 1] = {0};
    uint16_t len_ = 0;
    uint16_t maxLen_ = MAX_TEXT_LEN;
    SaveCallback onSave_ = nullptr;
    CancelCallback onCancel_ = nullptr;
 
    // T9 state
    char lastKey_ = 0;
    uint8_t charIndex_ = 0;
    uint32_t lastPressMs_ = 0;
    bool cursorActive_ = false;
 
    bool processKey(char key);
    void backspace();
    void commitCharacter();
 
    // T9 helpers
    static char getChar(char key, uint8_t index);
    static uint8_t getCharCount(char key);
};
 
// ============================================================================
// Convenience Functions
// ============================================================================

T9InputView* showT9Input(const char* title, const char* initialText,
                         T9InputView::SaveCallback onSave, uint16_t maxLen = 128);
 
} // namespace cdc::ui