|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object com.atlassian.confluence.content.render.xhtml.HtmlElementIdCreator
public class HtmlElementIdCreator
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 |
---|
public HtmlElementIdCreator()
Method Detail |
---|
public String generateId()
generateId
in interface ElementIdCreator
ConversionContext
.public String generateId(String basis)
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).
generateId
in interface ElementIdCreator
str
- the string to be converted to an id
HtmlElementIdCreator
instance.public static String convertToId(String str)
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.
str
- the string to be converted to an id
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |