Class WBootstrapTheme


public class WBootstrapTheme extends WTheme
Deprecated.
WBootstrapTheme is deprecated. Use one of the concrete versioned Bootstrap theme classes instead, like WBootstrap2Theme and WBootstrap3Theme.
Theme based on the Twitter Bootstrap CSS framework.

This theme implements support for building a JWt 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 JWt 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 getStyleSheets()).

Although this theme facilitates the use of Twitter Bootstrap with JWt, 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

See Also:
  • Constructor Details

    • WBootstrapTheme

      public WBootstrapTheme()
      Deprecated.
      Constructor.
  • Method Details

    • setResponsive

      public void setResponsive(boolean enabled)
      Deprecated.
      Enables responsive features.

      Responsive features can be enabled only at application startup. For bootstrap 3, you need to use the progressive bootstrap feature of JWt as it requires setting HTML meta flags.

      Responsive features are disabled by default.

    • isResponsive

      public boolean isResponsive()
      Deprecated.
      Returns whether responsive features are enabled.

      See Also:
    • setVersion

      public void setVersion(BootstrapVersion version)
      Deprecated.
      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.

    • getVersion

      public BootstrapVersion getVersion()
      Deprecated.
      Returns the bootstrap version.

      See Also:
    • setFormControlStyleEnabled

      public void setFormControlStyleEnabled(boolean enabled)
      Deprecated.
      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.

    • getName

      public String getName()
      Deprecated.
      Description copied from class: WTheme
      Returns a theme name.

      Returns a unique name for the theme. This name is used by the default implementation of getResourcesUrl() to compute a location for the theme's resources.

      Specified by:
      getName in class WTheme
    • getResourcesUrl

      public String getResourcesUrl()
      Deprecated.
      Description copied from class: WTheme
      Returns the URL where theme-related resources are stored.

      The default implementation considers a folder within JWt's resource directory, based on the theme getName().

      Overrides:
      getResourcesUrl in class WTheme
    • getStyleSheets

      public List<WLinkedCssStyleSheet> getStyleSheets()
      Deprecated.
      Description copied from class: WTheme
      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.

      Specified by:
      getStyleSheets in class WTheme
    • init

      public void init(WApplication app)
      Deprecated.
      Description copied from class: WTheme
      Called when the theme is assigned to a WApplication.

      This allows the theme to do things like load resource bundles when it is added to an application using WApplication#setTheme().

      The default implementation does nothing.

      Overrides:
      init in class WTheme
    • apply

      public void apply(WWidget widget, WWidget child, int widgetRole)
      Deprecated.
      Description copied from class: WTheme
      Applies the theme to a child of a composite widget.

      The widgetRole indicates the role that child has within the implementation of the widget.

      Specified by:
      apply in class WTheme
    • apply

      public void apply(WWidget widget, DomElement element, int elementRole)
      Deprecated.
      Description copied from class: WTheme
      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.

      Specified by:
      apply in class WTheme
    • getDisabledClass

      public String getDisabledClass()
      Deprecated.
      Description copied from class: WTheme
      Returns a generic CSS class name for a disabled element.
      Specified by:
      getDisabledClass in class WTheme
    • getActiveClass

      public String getActiveClass()
      Deprecated.
      Description copied from class: WTheme
      Returns a generic CSS class name for an active element.
      Specified by:
      getActiveClass in class WTheme
    • utilityCssClass

      public String utilityCssClass(int utilityCssClassRole)
      Deprecated.
      Description copied from class: WTheme
      Returns a generic CSS class name for the chosen role.
      Specified by:
      utilityCssClass in class WTheme
    • isCanStyleAnchorAsButton

      public boolean isCanStyleAnchorAsButton()
      Deprecated.
      Description copied from class: WTheme
      Returns whether the theme allows for an anchor to be styled as a button.
      Specified by:
      isCanStyleAnchorAsButton in class WTheme
    • applyValidationStyle

      public void applyValidationStyle(WWidget widget, WValidator.Result validation, EnumSet<ValidationStyleFlag> styles)
      Deprecated.
      Description copied from class: WTheme
      Applies a style that indicates the result of validation.
      Specified by:
      applyValidationStyle in class WTheme
    • canBorderBoxElement

      public boolean canBorderBoxElement(DomElement element)
      Deprecated.
      Specified by:
      canBorderBoxElement in class WTheme