Overview | Package | Class | Use | Tree | Deprecated | Index | Help
| JDOM 1.1.1
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

## org.jdom.output
Class Format.TextMode

    java.lang.Object
      org.jdom.output.Format.TextMode

Enclosing class:
  Format

    public static class Format.TextMode

extends java.lang.Object

Class to signify how text should be handled on output. The following table provides details.

Text Mode | Resulting behavior.
--- | ---
PRESERVE (Default) | All content is printed in the format it was created, no whitespace or line separators are are added or removed.
TRIM_FULL_WHITE | Content between tags consisting of all whitespace is not printed. If the content contains even one non-whitespace character, it is printed verbatim, whitespace and all.
TRIM | Same as TrimAllWhite, plus leading/trailing whitespace are trimmed.
NORMALIZE | Same as TextTrim, plus addition interior whitespace is compressed to a single space.

In most cases textual content is aligned with the surrounding tags (after the appropriate text mode is applied). In the case where the only content between the start and end tags is textual, the start tag, text, and end tag are all printed on the same line. If the document being output already has whitespace, it's wise to turn on TRIM mode so the pre-existing whitespace can be trimmed before adding new whitespace.

When a element has a xml:space attribute with the value of "preserve", all formating is turned off and reverts back to the default until the element and its contents have been printed. If a nested element contains another xml:space with the value "default" formatting is turned back on for the child element and then off for the remainder of the parent element.

Field Summary
`static Format.TextMode` | `NORMALIZE` Mode for text normalization (left and right trim plus internal whitespace is normalized to a single space.
`static Format.TextMode` | `PRESERVE` Mode for literal text preservation.
`static Format.TextMode` | `TRIM` Mode for text trimming (left and right trim).
`static Format.TextMode` | `TRIM_FULL_WHITE` Mode for text trimming of content consisting of nothing but whitespace but otherwise not changing output.

Method Summary
`java.lang.String` | `toString()`

Methods inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait`

Field Detail

### PRESERVE

    public static final Format.TextMode PRESERVE

  Mode for literal text preservation.

### TRIM

    public static final Format.TextMode TRIM

  Mode for text trimming (left and right trim).

### NORMALIZE

    public static final Format.TextMode NORMALIZE

  Mode for text normalization (left and right trim plus internal whitespace is normalized to a single space.

  See Also:
    `Element.getTextNormalize()`

### TRIM_FULL_WHITE

    public static final Format.TextMode TRIM_FULL_WHITE

  Mode for text trimming of content consisting of nothing but whitespace but otherwise not changing output.

Method Detail

### toString

    public java.lang.String toString()

  Overrides:
    `toString` in class `java.lang.Object`

Overview | Package | Class | Use | Tree | Deprecated | Index | Help
| JDOM 1.1.1
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

Copyright © 2007 Jason Hunter, Brett McLaughlin. All Rights Reserved.