Class MarkupSettings

java.lang.Object
org.apache.wicket.settings.MarkupSettings

public class MarkupSettings extends Object
Class for markup related settings.

compressWhitespace (defaults to false) - Causes pages to render with redundant whitespace removed. Whitespace stripping is not HTML or JavaScript savvy and can conceivably break pages, but should provide significant performance improvements.

stripComments (defaults to false) - Set to true to strip HTML comments during markup loading

Author:
Jonathan Locke, Chris Turner, Eelco Hillenius, Juergen Donnerstag, Johan Compagner, Igor Vaynberg (ivaynberg), Martijn Dashorst, James Carman
  • Constructor Details

  • Method Details

    • getAutomaticLinking

      public boolean getAutomaticLinking()
      If true, automatic link resolution is enabled. Disabled by default.
      Returns:
      Returns the automaticLinking.
      See Also:
    • getCompressWhitespace

      public boolean getCompressWhitespace()
      Returns:
      Returns the compressWhitespace.
    • getDefaultMarkupEncoding

      Returns:
      Returns default encoding of markup files. If null, the operating system provided encoding will be used.
      Since:
      1.1
    • getMarkupFactory

      Get the markup factory
      Returns:
      A new instance of MarkupFactory.
    • getStripComments

      public boolean getStripComments()
      Returns:
      Returns the stripComments.
    • getStripWicketTags

      public boolean getStripWicketTags()
      Gets whether to remove wicket tags from the output.
      Returns:
      whether to remove wicket tags from the output
    • getThrowExceptionOnMissingXmlDeclaration

      Returns:
      if true, an exception is thrown if the markup file does not contain a xml declaration
      Since:
      1.3
    • setAutomaticLinking

      public MarkupSettings setAutomaticLinking(boolean automaticLinking)
      Application default for automatic link resolution.
      Parameters:
      automaticLinking - The automaticLinking to set.
      Returns:
      this object for chaining
      See Also:
    • setCompressWhitespace

      public MarkupSettings setCompressWhitespace(boolean compressWhitespace)
      Turns on whitespace compression. Multiple occurrences of space/tab characters will be compressed to a single space. Multiple line breaks newline/carriage-return will also be compressed to a single newline.

      Compression is currently not HTML aware and so it may be possible for whitespace compression to break pages. For this reason, whitespace compression is off by default and you should test your application thoroughly after turning whitespace compression on.

      Spaces are removed from markup at markup load time and there should be no effect on page rendering speed. In fact, your pages should render faster with whitespace compression enabled.

      Parameters:
      compressWhitespace - The compressWhitespace to set.
      Returns:
      this object for chaining
    • setDefaultMarkupEncoding

      Set default encoding for markup files. If null, the encoding provided by the operating system will be used.
      Parameters:
      encoding -
      Returns:
      this object for chaining
      Since:
      1.1
    • setMarkupFactory

      Set a new markup factory
      Parameters:
      factory -
      Returns:
      this object for chaining
    • setStripComments

      public MarkupSettings setStripComments(boolean stripComments)
      Enables stripping of markup comments denoted in markup by HTML comment tagging.
      Parameters:
      stripComments - True to strip markup comments from rendered pages
      Returns:
      this object for chaining
    • setStripWicketTags

      public MarkupSettings setStripWicketTags(boolean stripWicketTags)
      Sets whether to remove wicket tags from the output.
      Parameters:
      stripWicketTags - whether to remove wicket tags from the output
      Returns:
      this object for chaining
    • setThrowExceptionOnMissingXmlDeclaration

      If true, an exception is thrown if the markup file does not contain a xml declaration
      Parameters:
      throwException -
      Returns:
      this object for chaining
      Since:
      1.3
    • getMarkupIdGenerator

      Returns:
      The configured generator for component markup ids
    • setMarkupIdGenerator

      Sets a new IMarkupIdGenerator
      Parameters:
      markupIdGenerator - The generator of markup ids for the components
      Returns:
      this object for chaining
    • isUpdateAutoLabelsTogetherWithFormComponent

      Returns:
      If true, wicket auto-labels will always be updated (via AJAX) whenever the associated form component is. The default is false (for backward compatibility).
    • setUpdateAutoLabelsTogetherWithFormComponent

      public MarkupSettings setUpdateAutoLabelsTogetherWithFormComponent(boolean updateAutoLabelsTogetherWithFormComponent)
      Parameters:
      updateAutoLabelsTogetherWithFormComponent - If true, wicket auto-labels will always be updated (via AJAX) whenever the associated form component is.
      Returns:
      this object for chaining