Module org.jhotdraw8.css
Package org.jhotdraw8.css.converter

Class ListCssConverter<T>

java.lang.Object
org.jhotdraw8.css.converter.ListCssConverter<T>
Type Parameters:
T - the element type
All Implemented Interfaces:
Converter<ImmutableList<T>>, CssConverter<ImmutableList<T>>
public class ListCssConverter<T> extends Object implements CssConverter<ImmutableList<T>>
Parses a list with items separated by configurable optional delimiters.

If the delimiter consists of multiple character tokens, then the parser accepts each of the character tokens and any combination of them.

The delimiters are optional when the list is parsed from a String. When the list is converted into a String, then the specified delimiters are used to separate the items.

Stops parsing at EOF, semicolon and closing bracket.

This parser is intentionally forgiving, so that lists can be output with nice delimiters, but the user does not need to type the delimiter.

In CSS list elements are separated by a comma character.

References:

CSS Syntax Module Level 3, 5.3.11. Parse a comma-separated list of component values
w3.org

  • Constructor Details

    • ListCssConverter

      public ListCssConverter(CssConverter<T> elementConverter)

    • ListCssConverter

      public ListCssConverter(CssConverter<T> elementConverter, @Nullable String delimiter)

    • ListCssConverter

      public ListCssConverter(CssConverter<T> elementConverter, @Nullable String delimiter, @Nullable String prefix, @Nullable String suffix)

    • ListCssConverter

      public ListCssConverter(CssConverter<T> elementConverter, @Nullable String delimiter, @Nullable String prefix, @Nullable String suffix, @Nullable Comparator<T> comparatorForSorting)
      Parameters:
      elementConverter - the convert for a single element
      delimiter - a String which must be parsable into character tokens, each token and any combination of them is accepted as an optional delimiter
      prefix - the prefix of the list, for example a left bracket
      suffix - the suffix of the list, for example a right bracket
      comparatorForSorting - if this value is non-null, then it is used to sort the list

    • ListCssConverter

      public ListCssConverter(CssConverter<T> elementConverter, Iterable<CssToken> delimiter, Iterable<CssToken> prefix, Iterable<CssToken> suffix)
      Creates a new instance that does not sort the elements.
      Parameters:
      elementConverter - converter for elements
      delimiter - optional delimiter for parsing; the delimiter is used for pretty printing
      prefix - white-space tokens for pretty printing that are used when producing tokens or a String
      suffix - white-space tokens for pretty printing that are used when producing tokens or a String

    • ListCssConverter

      public ListCssConverter(CssConverter<T> elementConverter, Iterable<CssToken> delimiter, Iterable<CssToken> prefix, Iterable<CssToken> suffix, @Nullable Comparator<T> comparatorForSorting)
      Creates a new instance.
      Parameters:
      elementConverter - converter for elements
      delimiter - optional delimiter for parsing; the delimiter is used for pretty printing
      prefix - white-space tokens for pretty printing that are used when producing tokens or a String
      suffix - white-space tokens for pretty printing that are used when producing tokens or a String
      comparatorForSorting - optional comparator for sorting; null means no sorting

  • Method Details