|
Wt
3.3.8
|
Theme based on the Twitter Bootstrap CSS framework. More...
#include <Wt/WBootstrapTheme>
Public Types | |
 Public Types inherited from Wt::WObject | |
| typedef void(WObject::* | Method) () |
| Typedef for a WObject method without arguments. | |
Public Member Functions | |
| WBootstrapTheme (WObject *parent=0) | |
| Constructor. | |
| void | setResponsive (bool responsive) |
| bool | responsive () const |
| Returns whether responsive features are enabled. More... | |
| void | setVersion (Version version) |
| Sets the bootstrap version. More... | |
| Version | version () const |
| Returns the bootstrap version. More... | |
| void | setFormControlStyleEnabled (bool enabled) |
| Enables form-control on all applicable form widgets. More... | |
| virtual std::string | name () const |
| Returns a theme name. More... | |
| virtual std::vector< WCssStyleSheet > | styleSheets () const |
| Returns a vector with stylesheets for the theme. More... | |
| virtual void | apply (WWidget *widget, WWidget *child, int widgetRole) const |
| Applies the theme to a child of a composite widget. More... | |
| virtual void | apply (WWidget *widget, DomElement &element, int elementRole) const |
| Applies the theme to a DOM element that renders a widget. More... | |
| virtual std::string | disabledClass () const |
| Returns a generic CSS class name for a disabled element. | |
| virtual std::string | activeClass () const |
| Returns a generic CSS class name for an active element. | |
| virtual std::string | utilityCssClass (int utilityCssClassRole) const |
| Returns a generic CSS class name for the chosen role. More... | |
| virtual bool | canStyleAnchorAsButton () const |
| Returns whether the theme allows for an anchor to be styled as a button. | |
| virtual void | applyValidationStyle (WWidget *widget, const Wt::WValidator::Result &validation, WFlags< ValidationStyleFlag > styles) const |
| Applies a style that indicates the result of validation. | |
| Public Member Functions inherited from Wt::WTheme | |
| WTheme (WObject *parent=0) | |
| Constructor. | |
| virtual | ~WTheme () |
| Destructor. | |
| virtual std::string | resourcesUrl () const |
| Returns the URL where theme-related resources are stored. More... | |
| virtual void | serveCss (WStringStream &out) const |
| Serves the CSS for the theme. More... | |
| Public Member Functions inherited from Wt::WObject | |
| WObject (WObject *parent=0) | |
| Create a WObject with a given parent object. More... | |
| virtual | ~WObject () |
| Destructor. More... | |
| virtual const std::string | id () const |
| Returns the (unique) identifier for this object. More... | |
| virtual void | setObjectName (const std::string &name) |
| Sets an object name. More... | |
| virtual std::string | objectName () const |
| Returns the object name. More... | |
| void | resetLearnedSlots () |
| Resets learned stateless slot implementations. More... | |
| template<class T > | |
| void | resetLearnedSlot (void(T::*method)()) |
| Resets a learned stateless slot implementation. More... | |
| template<class T > | |
| WStatelessSlot * | implementStateless (void(T::*method)()) |
| Declares a slot to be stateless and learn client-side behaviour on first invocation. More... | |
| template<class T > | |
| WStatelessSlot * | implementStateless (void(T::*method)(), void(T::*undoMethod)()) |
| Declares a slot to be stateless and learn client-side behaviour in advance. More... | |
| void | isNotStateless () |
| Marks the current function as not stateless. More... | |
| template<class T > | |
| WStatelessSlot * | implementJavaScript (void(T::*method)(), const std::string &jsCode) |
| Provides a JavaScript implementation for a method. More... | |
| void | addChild (WObject *child) |
| Adds a child object. More... | |
| virtual void | removeChild (WObject *child) |
| Removes a child object. More... | |
| const std::vector< WObject * > & | children () const |
| Returns the children. | |
| WObject * | parent () const |
| Returns the parent object. | |
Additional Inherited Members | |
| Protected Member Functions inherited from Wt::WObject | |
| virtual WStatelessSlot * | getStateless (Method method) |
| On-demand stateless slot implementation. More... | |
| Static Protected Member Functions inherited from Wt::WObject | |
| static WObject * | sender () |
| Returns the sender of the current slot call. More... | |
Theme based on the Twitter Bootstrap CSS framework.
This theme implements support for building a Wt web application that uses Twitter Bootstrap as a theme for its (layout and) styling. The theme comes with CSS from Bootstrap version 2.2.2 or version 3.1. Only the CSS components of twitter bootstrap are used, but not the JavaScript (i.e. the functional parts), since the functionality is already built-in to the widgets from the library.
Using this theme, various widgets provided by the library are rendered using markup that is compatible with Twitter Bootstrap. The bootstrap theme is also extended with a proper (compatible) styling of widgets for which bootstrap does not provide styling (table views, tree views, sliders, etc...).
By default, the theme will use CSS resources that are shipped together with the Wt distribution, but since the Twitter Bootstrap CSS API is a popular API for custom themes, you can easily replace the CSS with custom-built CSS (by reimplementing styleSheets()).
Although this theme facilitates the use of Twitter Bootstrap with Wt, it is still important to understand how Bootstrap expects markup to be, especially related to layout using its grid system, for which we refer to the official bootstrap documentation, see http://getbootstrap.com
Enumeration to select a bootstrap version.
| Enumerator | |
|---|---|
| Version2 |
Bootstrap 2. |
| Version3 |
Bootstrap 3. |
Applies the theme to a child of a composite widget.
The widgetRole indicates the role that child has within the implementation of the widget.
Implements Wt::WTheme.
|
virtual |
Applies the theme to a DOM element that renders a widget.
The element is a rendered representation of the widget, and may be further customized to reflect the theme.
Implements Wt::WTheme.
|
virtual |
Returns a theme name.
Returns a unique name for the theme. This name is used by the default implementation of resourcesUrl() to compute a location for the theme's resources.
Implements Wt::WTheme.
| bool Wt::WBootstrapTheme::responsive | ( | ) | const |
Returns whether responsive features are enabled.
| void Wt::WBootstrapTheme::setFormControlStyleEnabled | ( | bool | enabled | ) |
Enables form-control on all applicable form widgets.
This is relevant only for bootstrap 3.
By applying "form-control" on form widgets, they will become block level elements that take the size of the parent (which is in bootstrap's philosphy a grid layout).
The default value is true.
| void Wt::WBootstrapTheme::setResponsive | ( | bool | responsive | ) |
Enables responsive features.
Responsive features can be enabled only at application startup. For bootstrap 3, you need to use the progressive bootstrap feature of Wt (see see 10.2 General application settings (wt_config.xml)) as it requires setting HTML meta flags.
Responsive features are disabled by default.
| void Wt::WBootstrapTheme::setVersion | ( | Version | version | ) |
Sets the bootstrap version.
The default bootstrap version is 2 (but this may change in the future and thus we recommend setting the version).
Since Twitter Bootstrap breaks its API with a major version change, the version has a big impact on how how the markup is done for various widgets.
Note that the two Bootstrap versions have a different license: Apache 2.0 for Bootstrap version 2.2.2, and MIT for version 3.1. See these licenses for details.
|
virtual |
Returns a vector with stylesheets for the theme.
This should return a vector with stylesheets that implement the theme. This list may be tailored to the current user agent, which is read from the application environment.
Implements Wt::WTheme.
|
virtual |
Returns a generic CSS class name for the chosen role.
Implements Wt::WTheme.
| Version Wt::WBootstrapTheme::version | ( | ) | const |
Returns the bootstrap version.
1.8.11
