EmbAJAXMutableSpan Class Reference

An HTML span element with content that can be updated from the server (not the client) More...

#include <EmbAJAX.h>

Inheritance diagram for EmbAJAXMutableSpan:

Collaboration diagram for EmbAJAXMutableSpan:

Public Member Functions
	EmbAJAXMutableSpan (const char *id)
void	print () const override
const char *	value (uint8_t which=EmbAJAXBase::Value) const override
const char *	valueProperty (uint8_t which=EmbAJAXBase::Value) const override
void	setValue (const char *value, bool allowHTML=false)
bool	valueNeedsEscaping (uint8_t which=EmbAJAXBase::Value) const override
Public Member Functions inherited from EmbAJAXElement
	EmbAJAXElement (const char *id)
const char *	id () const
bool	sendUpdates (uint16_t since, bool first) override
virtual void	updateFromDriverArg (const char *argname)
EmbAJAXElement *	toElement () override final
Public Member Functions inherited from EmbAJAXBase
void	setVisible (bool visible)
void	setEnabled (bool enabled)
virtual EmbAJAXElement *	findChild (const char *id) const

Additional Inherited Members
Public Types inherited from EmbAJAXBase
enum	Property {   Visibility , Enabledness , Value , FirstElementSpecificProperty ,   HTMLAllowed }
Static Public Member Functions inherited from EmbAJAXBase
static void	setDriver (EmbAJAXOutputDriverBase *driver)
Protected Member Functions inherited from EmbAJAXElement
void	setBasicProperty (uint8_t num, bool status) override
bool	basicProperty (uint8_t num) const
void	setChanged ()
bool	changed (uint16_t since)
void	printTextInput (size_t size, const char *value) const
Protected Member Functions inherited from EmbAJAXBase
void	printChildren (EmbAJAXBase **children, size_t num) const
bool	sendUpdates (EmbAJAXBase **children, size_t num, uint16_t since, bool first)
EmbAJAXElement *	findChild (EmbAJAXBase **children, size_t num, const char *id) const
void	printPage (EmbAJAXBase **children, size_t num, const char *_title, const char *_header, uint16_t _min_interval) const
void	handleRequest (EmbAJAXBase **children, size_t num, void(*change_callback)())
Protected Attributes inherited from EmbAJAXElement
byte	_flags
const char *	_id
Static Protected Attributes inherited from EmbAJAXBase
static EmbAJAXOutputDriverBase *	_driver
static char	itoa_buf [8]
constexpr static const char	null_string [1]

Detailed Description

An HTML span element with content that can be updated from the server (not the client)

Member Function Documentation

setValue()

void EmbAJAXMutableSpan::setValue	(	const char *	value,
		bool	allowHTML = false
	)

Set the s content to the given value.

Parameters

value	Note: The string is not copied, so don't make this a temporary.
allowHTML	if true, you can set the content to any valid HTML string, which allows for much flexibility, but is not safe when value is untrusted user input. if false (the default), any "<" and "&" in value will be escaped, before rendering on the client, making the string plain but safe.

value()

const char * EmbAJAXMutableSpan::value ( uint8_t  which = EmbAJAXBase::Value ) const

overridevirtual

const char representation of the current server side value. Must be implemented in derived class. This base class handles visibility and enabledness, only. Do call the base implementation for any "which" that is not handled in your derived class.

Reimplemented from EmbAJAXElement.

valueNeedsEscaping()

bool EmbAJAXMutableSpan::valueNeedsEscaping ( uint8_t  which = EmbAJAXBase::Value ) const

overridevirtual

Returns true, if the value may contain HTML, and needs HTML escaping when passed to the client. Base implementation simply returns false.

Reimplemented from EmbAJAXElement.

valueProperty()

const char * EmbAJAXMutableSpan::valueProperty ( uint8_t  which = EmbAJAXBase::Value ) const

overridevirtual

The JS property that will have to be set on the client. Must be implemented in derived class. This base class handles visibility and enabledness, only. Do call the base implementation for any "which" that is not handled in your derived class.

Reimplemented from EmbAJAXElement.

---

The documentation for this class was generated from the following files:

• EmbAJAX.h
• EmbAJAX.cpp