An example showing how to interact custom JavaScript with Wt stuff. More...

#include <JavascriptExample.h>

Inheritance diagram for JavascriptExample:

Public Member Functions
	JavascriptExample (const WEnvironment &env)
	Create the example application. More...

Public Member Functions inherited from Wt::WApplication
	WApplication (const WEnvironment &environment)

	~WApplication ()

const WEnvironment &	environment () const

WContainerWidget *	root () const

WWidget *	findWidget (const std::string &name)

void	setTitle (const WString &title)

const WString &	title () const

const WString &	closeMessage () const

std::shared_ptr< WLocalizedStrings >	localizedStrings ()

void	setLocalizedStrings (const std::shared_ptr< WLocalizedStrings > &stringResolver)

WMessageResourceBundle &	messageResourceBundle ()

void	setLocale (const WLocale &locale)

const WLocale &	locale () const

virtual void	refresh ()

void	bindWidget (std::unique_ptr< WWidget > widget, const std::string &domId)

std::string	docRoot () const

void	setConnectionMonitor (const std::string &jsObject)

std::string	sessionId () const

void	changeSessionId ()

void	processEvents ()

virtual void	waitForEvent ()

virtual void	initialize ()

virtual void	finalize ()

void	setTwoPhaseRenderingThreshold (int size)

void	setCookie (const Http::Cookie &cookie)

void	setCookie (const std::string &name, const std::string &value, int maxAge, const std::string &domain="", const std::string &path="", bool secure=false)

void	removeCookie (const Http::Cookie &cookie)

void	removeCookie (const std::string &name, const std::string &domain="", const std::string &path="")

void	addMetaLink (const std::string &href, const std::string &rel, const std::string &media, const std::string &hreflang, const std::string &type, const std::string &sizes, bool disabled)

void	removeMetaLink (const std::string &href)

void	addMetaHeader (const std::string &name, const WString &content, const std::string &lang="")

void	addMetaHeader (MetaHeaderType type, const std::string &name, const WString &content, const std::string &lang="")

WString	metaHeader (MetaHeaderType type, const std::string &name) const

void	removeMetaHeader (MetaHeaderType type, const std::string &name="")

WLogEntry	log (const std::string &type) const

void	setLoadingIndicator (std::unique_ptr< WLoadingIndicator > indicator)

WLoadingIndicator *	loadingIndicator () const

void	quit ()

void	quit (const WString &restartMessage)

bool	hasQuit () const

::int64_t	maximumRequestSize () const

Signal< ::int64_t > &	requestTooLarge ()

void	setConfirmCloseMessage (const WString &message)

void	deferRendering ()

void	resumeRendering ()

std::string	encodeUntrustedUrl (const std::string &url) const

void	pushExposedConstraint (WWidget *w)

void	suspend (std::chrono::seconds duration)

Signal &	unsuspended ()

WCssStyleSheet &	styleSheet ()

void	useStyleSheet (const WLink &link, const std::string &media="all")

void	useStyleSheet (const WLink &link, const std::string &condition, const std::string &media)

void	useStyleSheet (const WLinkedCssStyleSheet &styleSheet, const std::string &condition="")

void	removeStyleSheet (const WLink &link)

void	setTheme (const std::shared_ptr< WTheme > &theme)

std::shared_ptr< WTheme >	theme () const

void	setCssTheme (const std::string &name)

void	setLayoutDirection (LayoutDirection direction)

LayoutDirection	layoutDirection () const

void	setBodyClass (const std::string &styleClass)

std::string	bodyClass () const

void	setHtmlClass (const std::string &styleClass)

std::string	htmlClass () const

void	setHtmlAttribute (const std::string &name, const std::string &value)

WString	htmlAttribute (const std::string &name) const

void	setBodyAttribute (const std::string &name, const std::string &value)

WString	bodyAttribute (const std::string &name) const

std::string	url (const std::string &internalPath=std::string()) const

virtual std::string	makeAbsoluteUrl (const std::string &url) const

std::string	resolveRelativeUrl (const std::string &url) const

std::string	bookmarkUrl () const

std::string	bookmarkUrl (const std::string &internalPath) const

void	setInternalPath (const std::string &path, bool emitChange=false)

void	setInternalPathDefaultValid (bool valid)

bool	internalPathDefaultValid () const

void	setInternalPathValid (bool valid)

bool	internalPathValid () const

std::string	internalPath () const

std::string	internalPathNextPart (const std::string &path) const

bool	internalPathMatches (const std::string &path) const

Signal< std::string > &	internalPathChanged ()

Signal< std::string > &	internalPathInvalid ()

void	redirect (const std::string &url)

void	enableUpdates (bool enabled=true)

bool	updatesEnabled () const

void	triggerUpdate ()

void	attachThread (bool attach=true)

void	doJavaScript (const std::string &javascript, bool afterLoaded=true)

void	addAutoJavaScript (const std::string &javascript)

void	declareJavaScriptFunction (const std::string &name, const std::string &function)

bool	require (const std::string &url, const std::string &symbol=std::string())

bool	requireJQuery (const std::string &url)

bool	customJQuery () const

void	setJavaScriptClass (const std::string &className)

std::string	javaScriptClass ()

EventSignal< WKeyEvent > &	globalKeyWentDown ()

EventSignal< WKeyEvent > &	globalKeyPressed ()

EventSignal< WKeyEvent > &	globalKeyWentUp ()

EventSignal &	globalEnterPressed ()

EventSignal &	globalEscapePressed ()

WCssStyleSheet &	styleSheet ()

void	useStyleSheet (const WLink &link, const std::string &media="all")

void	useStyleSheet (const WLink &link, const std::string &condition, const std::string &media)

void	useStyleSheet (const WLinkedCssStyleSheet &styleSheet, const std::string &condition="")

void	removeStyleSheet (const WLink &link)

void	setTheme (const std::shared_ptr< WTheme > &theme)

std::shared_ptr< WTheme >	theme () const

void	setCssTheme (const std::string &name)

void	setLayoutDirection (LayoutDirection direction)

LayoutDirection	layoutDirection () const

void	setBodyClass (const std::string &styleClass)

std::string	bodyClass () const

void	setHtmlClass (const std::string &styleClass)

std::string	htmlClass () const

void	setHtmlAttribute (const std::string &name, const std::string &value)

WString	htmlAttribute (const std::string &name) const

void	setBodyAttribute (const std::string &name, const std::string &value)

WString	bodyAttribute (const std::string &name) const

std::string	url (const std::string &internalPath=std::string()) const

virtual std::string	makeAbsoluteUrl (const std::string &url) const

std::string	resolveRelativeUrl (const std::string &url) const

std::string	bookmarkUrl () const

std::string	bookmarkUrl (const std::string &internalPath) const

void	setInternalPath (const std::string &path, bool emitChange=false)

void	setInternalPathDefaultValid (bool valid)

bool	internalPathDefaultValid () const

void	setInternalPathValid (bool valid)

bool	internalPathValid () const

std::string	internalPath () const

std::string	internalPathNextPart (const std::string &path) const

bool	internalPathMatches (const std::string &path) const

Signal< std::string > &	internalPathChanged ()

Signal< std::string > &	internalPathInvalid ()

void	redirect (const std::string &url)

void	enableUpdates (bool enabled=true)

bool	updatesEnabled () const

void	triggerUpdate ()

void	attachThread (bool attach=true)

void	doJavaScript (const std::string &javascript, bool afterLoaded=true)

void	addAutoJavaScript (const std::string &javascript)

void	declareJavaScriptFunction (const std::string &name, const std::string &function)

bool	require (const std::string &url, const std::string &symbol=std::string())

bool	requireJQuery (const std::string &url)

bool	customJQuery () const

void	setJavaScriptClass (const std::string &className)

std::string	javaScriptClass ()

EventSignal< WKeyEvent > &	globalKeyWentDown ()

EventSignal< WKeyEvent > &	globalKeyPressed ()

EventSignal< WKeyEvent > &	globalKeyWentUp ()

EventSignal &	globalEnterPressed ()

EventSignal &	globalEscapePressed ()

Public Member Functions inherited from Wt::WObject
void	addChild (std::unique_ptr< WObject > child)

Child *	addChild (std::unique_ptr< Child > child)

std::unique_ptr< WObject >	removeChild (WObject *child)

std::unique_ptr< Child >	removeChild (Child *child)

virtual const std::string	id () const

virtual void	setObjectName (const std::string &name)

virtual std::string	objectName () const

void	resetLearnedSlots ()

void	resetLearnedSlot (void(T::*method)())

WStatelessSlot *	implementStateless (void(T::*method)())

WStatelessSlot *	implementStateless (void(T::method)(), void(T::undoMethod)())

void	isNotStateless ()

WStatelessSlot *	implementJavaScript (void(T::*method)(), const std::string &jsCode)

Public Member Functions inherited from Wt::Core::observable
	observable () noexcept

virtual	~observable ()

auto	bindSafe (void(C::*method)(Args...)) noexcept

auto	bindSafe (void(C::*method)(Args...) const) const noexcept

auto	bindSafe (const Function &function) noexcept

Private Member Functions
void	confirmed ()
	The user has confirmed the payment. More...

void	setAmount (std::string amount)
	Set the amount to be payed. More...

Private Attributes
std::unique_ptr< Popup >	promptAmount_
	Popup for changing the amount. More...

std::unique_ptr< Popup >	confirmPay_
	Popup for paying. More...

WText *	currentAmount_
	WText for showing the current amount. More...

Additional Inherited Members
Public Types inherited from Wt::WApplication
typedef Wt::ApplicationCreator	ApplicationCreator

typedef std::function< std::unique_ptr< WApplication >const WEnvironment &)>	ApplicationCreator

Public Types inherited from Wt::WObject
typedef void(WObject::*	Method) ()

Static Public Member Functions inherited from Wt::WApplication
static WApplication *	instance ()

static std::string	resourcesUrl ()

static std::string	relativeResourcesUrl ()

static std::string	appRoot ()

static bool	readConfigurationProperty (const std::string &name, std::string &value)

Protected Member Functions inherited from Wt::WApplication
virtual void	notify (const WEvent &e)

virtual bool	isExposed (WWidget *w) const

virtual void	enableAjax ()

virtual void	unload ()

virtual void	idleTimeout ()

virtual void	handleJavaScriptError (const std::string &errorText)

Protected Member Functions inherited from Wt::WObject
virtual WStatelessSlot *	getStateless (Method method)

Detailed Description

An example showing how to interact custom JavaScript with Wt stuff.

Definition at line 24 of file JavascriptExample.h.

Constructor & Destructor Documentation

◆ JavascriptExample()

JavascriptExample::JavascriptExample ( const WEnvironment & env )

Create the example application.

Definition at line 17 of file JavascriptExample.C.

   : WApplication(env)
 {
   setTitle("Javascript example");
  
   // Create a popup for prompting the amount of money, and connect the
   // okPressed button to the slot for setting the amount of money.
   //
   // Note that the input provided by the user in the prompt box is passed as
   // an argument to the slot.
   promptAmount_ = Popup::createPrompt("How much do you want to pay?","");
   promptAmount_->okPressed().connect(std::bind(&JavascriptExample::setAmount,
                                                this, std::placeholders::_1));
  
   // Create a popup for confirming the payment.
   //
   // Since a confirm popup does not allow input, we ignore the
   // argument carrying the input (which will be empty anyway).
   confirmPay_ = Popup::createConfirm("");
   confirmPay_->okPressed().connect(this, &JavascriptExample::confirmed);
  
   root()->addWidget(std::make_unique<WText>("<h2>Wt Javascript example</h2>"
             "<p>Wt makes abstraction of Javascript, and therefore allows you"
             " to develop web applications without any knowledge of Javascript,"
             " and which are not dependent on Javascript."
             " However, Wt does allow you to add custom Javascript code:</p>"
             " <ul>"
             "   <li>To call custom JavaScript code from an event handler, "
             "connect the Wt::EventSignal to a Wt::JSlot.</li>"
             "   <li>To call C++ code from custom JavaScript, use "
             "Wt.emit() to emit a Wt::JSignal.</li>"
             "   <li>To call custom JavaScript code from C++, use "
             "WApplication::doJavascript() or Wt::JSlot::exec().</li>"
             " </ul>"
             "<p>This simple application shows how to interact between C++ and"
             " JavaScript using the JSlot and JSignal classes.</p>"));
  
   currentAmount_
     = root()->addWidget(std::make_unique<WText>("Current amount: $" +
                                                   promptAmount_->defaultValue()));
  
   auto amountButton =
       root()->addWidget(std::make_unique<WPushButton>("Change ..."));
   amountButton->setMargin(10, Side::Left | Side::Right);
  
   root()->addWidget(std::make_unique<WBreak>());
  
   auto confirmButton =
       root()->addWidget(std::make_unique<WPushButton>("Pay now."));
   confirmButton->setMargin(10, Side::Top | Side::Bottom);
  
   // Connect the event handlers to a JSlot: this will execute the JavaScript
   // immediately, without a server round trip.
   amountButton->clicked().connect(promptAmount_->show);
   confirmButton->clicked().connect(confirmPay_->show);
  
   // Set the initial amount
   setAmount("1000");
 }

Member Function Documentation

◆ confirmed()

void JavascriptExample::confirmed ( )

private

The user has confirmed the payment.

Definition at line 89 of file JavascriptExample.C.

 {
   root()->addWidget(std::make_unique<WText>("<br/>Just payed $" +
                                               promptAmount_->defaultValue() + "."));
 }

◆ setAmount()

void JavascriptExample::setAmount ( std::string amount )

private

Set the amount to be payed.

Definition at line 77 of file JavascriptExample.C.

 {
   // Change the confirmation message to include the amount.
   confirmPay_->setMessage("Are you sure you want to pay $" + amount + " ?");
  
   // Change the default value for the prompt.
   promptAmount_->setDefaultValue(amount);
  
   // Change the text that shows the current amount.
   currentAmount_->setText("Current amount: $" + promptAmount_->defaultValue());
 }

Member Data Documentation

◆ confirmPay_

std::unique_ptr<Popup> JavascriptExample::confirmPay_

private

Popup for paying.

Definition at line 46 of file JavascriptExample.h.

◆ currentAmount_

WText* JavascriptExample::currentAmount_

private

WText for showing the current amount.

Definition at line 50 of file JavascriptExample.h.

◆ promptAmount_

std::unique_ptr<Popup> JavascriptExample::promptAmount_

private

Popup for changing the amount.

Definition at line 42 of file JavascriptExample.h.

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

javascript/JavascriptExample.h
javascript/JavascriptExample.C

Public Member Functions

Private Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ JavascriptExample()

Member Function Documentation

◆ confirmed()

◆ setAmount()

Member Data Documentation

◆ confirmPay_

◆ currentAmount_

◆ promptAmount_