com.atlassian.confluence.content.render.xhtml
Class HtmlElementIdCreator

java.lang.Object
  com.atlassian.confluence.content.render.xhtml.HtmlElementIdCreator

All Implemented Interfaces:

ElementIdCreator

public class HtmlElementIdCreator
extends Object
implements ElementIdCreator

A non-thread safe class used to create HTML ids within a render 'context'.

Constructor Summary

HtmlElementIdCreator()

Method Summary

static String	convertToId(String str) The draft HTML5 spec states that the id attribute value must be unique amongst all the IDs in the element's home subtree and must contain at least one character.
String	generateId() The current implementation is very simplistic and will simply create id's of the pattern "id-<n>".
String	generateId(String basis) The draft HTML5 spec states that the id attribute value must be unique amongst all the IDs in the element's home subtree and must contain at least one character.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

HtmlElementIdCreator

public HtmlElementIdCreator()

Method Detail

generateId

public String generateId()

The current implementation is very simplistic and will simply create id's of the pattern "id-<n>".

Specified by:

generateId in interface ElementIdCreator

Returns:

an auto-generate id unique within the context of a particular ConversionContext.

generateId

public String generateId(String basis)

The draft HTML5 spec states that the id attribute value

must be unique amongst all the IDs in the element's home subtree and must contain at least one character. The value must not contain any space characters.

(As specified at http://dev.w3.org/html5/spec/elements.html#the-id-attribute).

This method will take an arbitrary String and ensure that the above encoding is followed as well as ensuring that the id returned is unique (within the scope of this HtmlElementIdCreator instance).

Specified by:

generateId in interface ElementIdCreator

Parameters:

str - the string to be converted to an id

Returns:

a valid id String unique to the scope of the HtmlElementIdCreator instance.

convertToId

public static String convertToId(String str)

The draft HTML5 spec states that the id attribute value

must be unique amongst all the IDs in the element's home subtree and must contain at least one character. The value must not contain any space characters.

(As specified at http://dev.w3.org/html5/spec/elements.html#the-id-attribute).

This method will take an arbitrary String and ensure that all white space and punctuation are removed, except for hyphens. This method does not necessarily create unique ids. You should use #convertToUniqueId(String) if you have this requirement.

Parameters:

str - the string to be converted to an id

Returns:

a valid id