com.databasesandlife.util.wicket

Class MultilineLabelWithClickableLinks

java.lang.Object

org.apache.wicket.Component

org.apache.wicket.markup.html.WebComponent

org.apache.wicket.markup.html.basic.Label

com.databasesandlife.util.wicket.MultilineLabelWithClickableLinks

All Implemented Interfaces:

Serializable, org.apache.wicket.event.IEventSink, org.apache.wicket.event.IEventSource, org.apache.wicket.IConverterLocator, org.apache.wicket.markup.html.IHeaderContributor, org.apache.wicket.request.component.IRequestableComponent, org.apache.wicket.util.IHierarchical<org.apache.wicket.Component>, org.apache.wicket.util.io.IClusterable

public class MultilineLabelWithClickableLinks
extends org.apache.wicket.markup.html.basic.Label

Displays the text in the model over multiple HTML lines, and makes links clickable.

Author:

This source is copyright Adrian Smith and licensed under the LGPL 3.

See Also:

Project on GitHub, Serialized Form

Field Summary

Fields inherited from class org.apache.wicket.Component

ENABLE, PARENT_PATH, PATH_SEPARATOR, RENDER

Constructor Summary

Constructors

Constructor and Description
MultilineLabelWithClickableLinks(String id, org.apache.wicket.model.IModel<?> model)
MultilineLabelWithClickableLinks(String id, Serializable label)

Method Summary

Modifier and Type	Method and Description
static CharSequence	encodeLinksToHtml(CharSequence plainText) Takes some plain text and returns HTML with URLs marked up as clickable links.
void	onComponentTagBody(org.apache.wicket.markup.MarkupStream markupStream, org.apache.wicket.markup.ComponentTag openTag)

Methods inherited from class org.apache.wicket.Component

add, afterRender, beforeRender, canCallListenerInterface, configure, continueToOriginalDestination, debug, detach, detachModels, determineVisibility, error, fatal, findParent, findParentWithAssociatedMarkup, get, getAjaxRegionMarkupId, getApplication, getBehaviorById, getBehaviorId, getBehaviors, getBehaviors, getClassRelativePath, getConverter, getDefaultModel, getDefaultModelObject, getDefaultModelObjectAsString, getDefaultModelObjectAsString, getEscapeModelStrings, getFeedbackMessages, getId, getInnermostModel, getLocale, getLocalizer, getMarkup, getMarkupAttributes, getMarkupId, getMarkupId, getMarkupIdFromMarkup, getMarkupIdImpl, getMetaData, getModelComparator, getOutputMarkupId, getOutputMarkupPlaceholderTag, getPage, getPageRelativePath, getParent, getPath, getRenderBodyOnly, getRequest, getRequestCycle, getResponse, getSession, getSizeInBytes, getString, getString, getString, getStyle, getVariation, hasBeenRendered, hasErrorMessage, hasFeedbackMessage, info, internalInitialize, internalPrepareForRender, internalRenderComponent, isActionAuthorized, isAuto, isEnableAllowed, isEnabled, isEnabledInHierarchy, isRenderAllowed, isStateless, isVersioned, isVisibilityAllowed, isVisible, isVisibleInHierarchy, markRendering, modelChanged, modelChanging, onEvent, prepareForRender, redirectToInterceptPage, remove, remove, render, rendered, renderHead, renderHead, renderHead, replaceWith, sameInnermostModel, sameInnermostModel, send, setDefaultModel, setDefaultModelObject, setEnabled, setEscapeModelStrings, setMarkup, setMarkupId, setMarkupIdImpl, setMetaData, setOutputMarkupId, setOutputMarkupPlaceholderTag, setParent, setRenderBodyOnly, setResponsePage, setResponsePage, setResponsePage, setVersioned, setVisibilityAllowed, setVisible, success, toString, toString, urlFor, urlFor, urlFor, urlFor, urlFor, visitParents, visitParents, warn

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

MultilineLabelWithClickableLinks

public MultilineLabelWithClickableLinks(String id,
                                        Serializable label)

MultilineLabelWithClickableLinks

public MultilineLabelWithClickableLinks(String id,
                                        org.apache.wicket.model.IModel<?> model)

Method Detail

encodeLinksToHtml

public static CharSequence encodeLinksToHtml(CharSequence plainText)

Takes some plain text and returns HTML with URLs marked up as clickable links.

Making links clickable is not as easy as it seems.

• Conversion from plain text to HTML requires that entities such as "&" get replaced by "&amp;".
• Links such as "foo.com/a&b" need to get replaced by "<a href='foo.com/a&b'>foo.com/a&amp;b</a>".

Therefore,

• One cannot firstly replace entities and then markup links, as the links should contain unescaped "&" as opposed to "&amp;".
• One cannot firstly encode links and then replace entities as the angle brackets in the link's "<a href.." would get replaced by "&lt;a href..." which the browser would not understand.

Therefore, the replacement of HTML entities, and the replacement of links, must be done in a single pass, not one after another.

Parameters:

plainText - Plain text, no HTML.

Returns:

Safe HTML with entities encoded and links marked up.

onComponentTagBody

public void onComponentTagBody(org.apache.wicket.markup.MarkupStream markupStream,
                               org.apache.wicket.markup.ComponentTag openTag)

Overrides:

onComponentTagBody in class org.apache.wicket.markup.html.basic.Label