52 lines
1.4 KiB
C++
52 lines
1.4 KiB
C++
#pragma once
|
|
|
|
#include "esphome/core/component.h"
|
|
#include "esphome/core/entity_base.h"
|
|
#include "esphome/core/helpers.h"
|
|
#include "text_call.h"
|
|
#include "text_traits.h"
|
|
|
|
namespace esphome::text {
|
|
|
|
#define LOG_TEXT(prefix, type, obj) \
|
|
if ((obj) != nullptr) { \
|
|
ESP_LOGCONFIG(TAG, "%s%s '%s'", prefix, LOG_STR_LITERAL(type), (obj)->get_name().c_str()); \
|
|
LOG_ENTITY_ICON(TAG, prefix, *(obj)); \
|
|
}
|
|
|
|
/** Base-class for all text inputs.
|
|
*
|
|
* A text input can use publish_state to send out a new value.
|
|
*/
|
|
class Text : public EntityBase {
|
|
public:
|
|
std::string state;
|
|
TextTraits traits;
|
|
|
|
void publish_state(const std::string &state);
|
|
void publish_state(const char *state);
|
|
void publish_state(const char *state, size_t len);
|
|
|
|
/// Instantiate a TextCall object to modify this text component's state.
|
|
TextCall make_call() { return TextCall(this); }
|
|
|
|
template<typename F> void add_on_state_callback(F &&callback) {
|
|
this->state_callback_.add(std::forward<F>(callback));
|
|
}
|
|
|
|
protected:
|
|
friend class TextCall;
|
|
|
|
/** Set the value of the text input, this is a virtual method that each text input integration must implement.
|
|
*
|
|
* This method is called by the TextCall.
|
|
*
|
|
* @param value The value as validated by the TextCall.
|
|
*/
|
|
virtual void control(const std::string &value) = 0;
|
|
|
|
LazyCallbackManager<void(const std::string &)> state_callback_;
|
|
};
|
|
|
|
} // namespace esphome::text
|