Class UILink
- All Implemented Interfaces:
EventListener, SupportFieldId, SupportsAccessKey, SupportsAutoSpacing, Visual
Renders a link element, i. e. an anchor <a> tag.
For a <link> tag, please use <tc:metaLink> tag.
UIComponent class, generated from template
component.stg with class
LinkTagDeclaration.-
Field Summary
Fields -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionvoidaddActionListener(jakarta.faces.event.ActionListener arg0) voidaddClientBehavior(String arg0, jakarta.faces.component.behavior.ClientBehavior arg1) voidaddClientBehavior(String arg0, jakarta.faces.component.behavior.ClientBehavior arg1) protected voidaddFacesListener(jakarta.faces.event.FacesListener arg0) voidbroadcast(jakarta.faces.event.FacesEvent arg0) voidvoiddecode(jakarta.faces.context.FacesContext arg0) voidencodeAll(jakarta.faces.context.FacesContext arg0) voidencodeBegin(jakarta.faces.context.FacesContext arg0) voidencodeChildren(jakarta.faces.context.FacesContext arg0) voidencodeEnd(jakarta.faces.context.FacesContext arg0) jakarta.faces.component.UIComponentfindComponent(String arg0) The access key of this control.jakarta.el.MethodExpressionjakarta.faces.event.ActionListener[]Automatically add spacing (margins/paddings) to the component for better positioning.intList<jakarta.faces.component.UIComponent> getClientId(jakarta.faces.context.FacesContext arg0) static jakarta.faces.component.UIComponentgetCompositeComponentParent(jakarta.faces.component.UIComponent arg0) Text to use as confirmation message.getContainerClientId(jakarta.faces.context.FacesContext arg0) static jakarta.faces.component.UIComponentgetCurrentComponent(jakarta.faces.context.FacesContext arg0) static jakarta.faces.component.UIComponentgetCurrentCompositeComponent(jakarta.faces.context.FacesContext arg0) Sets a CSS class in its parent, if the parent supports it.protected jakarta.faces.context.FacesContextprotected jakarta.faces.event.FacesListener[]getFacesListeners(Class arg0) jakarta.faces.component.UIComponentintIterator<jakarta.faces.component.UIComponent> The identifier of the page fragment which should be brought into focus when the target page is rendered.getId()getImage()Url to an image to display.getLabel()A localized user presentable label for this component.getLink()Link to an arbitrary URL, either an internal link or an external link.List<jakarta.faces.event.SystemEventListener> getListenersForEventClass(Class<? extends jakarta.faces.event.SystemEvent> arg0) jakarta.faces.component.UIComponentLink to an internal facelet page, like the outcome of an action.jakarta.faces.component.UIComponentgetPassThroughAttributes(boolean arg0) protected jakarta.faces.render.RenderergetRenderer(jakarta.faces.context.FacesContext arg0) booleanprotected jakarta.faces.component.StateHelperprotected jakarta.faces.component.StateHelpergetStateHelper(boolean arg0) Controls the navigation of the focus through the input controls on a page with the Tab-Key.Name of a frame where the resource retrieved via this hyperlink is to be displayed.getTip()Text value to display as tooltip.jakarta.faces.component.TransientStateHelperjakarta.faces.component.TransientStateHelpergetTransientStateHelper(boolean arg0) getValue()jakarta.el.ValueExpressiongetValueExpression(String arg0) booleanbooleaninvokeOnComponent(jakarta.faces.context.FacesContext arg0, String arg1, jakarta.faces.component.ContextCallback arg2) static booleanisCompositeComponent(jakarta.faces.component.UIComponent arg0) booleanbooleanisInView()booleanisOmit()Flag indicating that the action of this element, will not be executed from client side (e.g. when the user clicks a button.booleanbooleanSpecify, if the command calls an JSF-Action.protected booleanisVisitable(jakarta.faces.component.visit.VisitContext arg0) voidvoidpopComponentFromEL(jakarta.faces.context.FacesContext arg0) voidprocessRestoreState(jakarta.faces.context.FacesContext arg0, Object arg1) processSaveState(jakarta.faces.context.FacesContext arg0) voidprocessUpdates(jakarta.faces.context.FacesContext arg0) voidprocessValidators(jakarta.faces.context.FacesContext arg0) voidpushComponentToEL(jakarta.faces.context.FacesContext arg0, jakarta.faces.component.UIComponent arg1) voidremoveActionListener(jakarta.faces.event.ActionListener arg0) protected voidremoveFacesListener(jakarta.faces.event.FacesListener arg0) static ObjectrestoreAttachedState(jakarta.faces.context.FacesContext arg0, Object arg1) voidrestoreState(jakarta.faces.context.FacesContext context, Object state) voidrestoreTransientState(jakarta.faces.context.FacesContext arg0, Object arg1) static ObjectsaveAttachedState(jakarta.faces.context.FacesContext arg0, Object arg1) saveState(jakarta.faces.context.FacesContext arg0) saveTransientState(jakarta.faces.context.FacesContext arg0) voidsetAccessKey(Character accessKey) voidsetActionExpression(jakarta.el.MethodExpression arg0) voidsetAutoSpacing(Boolean autoSpacing) voidsetConfirmation(String confirmation) voidsetCustomClass(CustomClass customClass) voidsetFragment(String fragment) voidvoidvoidsetImmediate(boolean arg0) voidsetInView(boolean arg0) voidvoidvoidvoidsetOmit(boolean omit) voidsetOutcome(String outcome) voidsetParent(jakarta.faces.component.UIComponent arg0) voidsetRendered(boolean arg0) voidsetRendererType(String arg0) voidsetTabIndex(Integer tabIndex) voidvoidvoidsetTransient(boolean arg0) voidsetTransition(boolean transition) voidvoidsetValueExpression(String arg0, jakarta.el.ValueExpression arg1) voidsubscribeToEvent(Class<? extends jakarta.faces.event.SystemEvent> arg0, jakarta.faces.event.ComponentSystemEventListener arg1) voidunsubscribeFromEvent(Class<? extends jakarta.faces.event.SystemEvent> arg0, jakarta.faces.event.ComponentSystemEventListener arg1) booleanvisitTree(jakarta.faces.component.visit.VisitContext arg0, jakarta.faces.component.visit.VisitCallback arg1) Methods inherited from class AbstractUICommand
getFieldId, isParentOfCommandsMethods inherited from class AbstractUICommandBase
isDisabled, isRendered, processDecodes, processEvent, queueEvent, setDisabledMethods inherited from class Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitMethods inherited from interface SupportsAutoSpacing
getAutoSpacingMethods inherited from interface Visual
getRendererType, isPlain
-
Field Details
-
COMPONENT_TYPE
-
COMPONENT_FAMILY
- See Also:
-
BEANINFO_KEY
- See Also:
-
COMPOSITE_COMPONENT_TYPE_KEY
- See Also:
-
COMPOSITE_FACET_NAME
- See Also:
-
FACETS_KEY
- See Also:
-
VIEW_LOCATION_KEY
- See Also:
-
ATTRS_WITH_DECLARED_DEFAULT_VALUES
- See Also:
-
bindings
Deprecated.
-
-
Constructor Details
-
UILink
public UILink()
-
-
Method Details
-
getEventNames
-
getDefaultEventName
-
getFamily
-
getImage
Url to an image to display.- Specified by:
getImagein classAbstractUICommand
-
setImage
-
getMarkup
-
setMarkup
-
getLink
Link to an arbitrary URL, either an internal link or an external link. For internal URLs, a session id will be added, if needed (when cookies disabled). The context path needs to be added manually e.g. #{request.contextPath}. For JSF navigation to a viewId use the outcome attribute!
The semantic of this attributes has been changed from Tobago 3 to 4!
- Specified by:
getLinkin classAbstractUICommandBase
-
setLink
-
getTabIndex
Controls the navigation of the focus through the input controls on a page with the Tab-Key. The navigation starts from the element with the lowest tabIndex value to the element with the highest value. Elements that have identical tabIndex values should be navigated in the order they appear in the character stream Elements that are disabled or with a negative tabIndex do not participate in the tabbing order.- Specified by:
getTabIndexin classAbstractUILink
-
setTabIndex
-
getConfirmation
Text to use as confirmation message.- Specified by:
getConfirmationin classAbstractUICommandBase
-
setConfirmation
-
getLabel
A localized user presentable label for this component.- Specified by:
getLabelin interfaceSupportsAccessKey- Specified by:
getLabelin classAbstractUICommand
-
setLabel
-
isTransition
public boolean isTransition()Specify, if the command calls an JSF-Action. Useful to switch off the Double-Submit-Check and Waiting-Behavior.
Default:true- Specified by:
isTransitionin classAbstractUICommandBase
-
setTransition
public void setTransition(boolean transition) -
getTarget
Name of a frame where the resource retrieved via this hyperlink is to be displayed.- Specified by:
getTargetin classAbstractUICommandBase
-
setTarget
-
getFragment
The identifier of the page fragment which should be brought into focus when the target page is rendered. The value of this attribute is appended to the end of target URL following a hash (#) mark. This notation is part of the standard URL syntax.- Specified by:
getFragmentin classAbstractUICommandBase
-
setFragment
-
getAutoSpacing
Automatically add spacing (margins/paddings) to the component for better positioning. Default is 'true' except the component is inside a: - header - footer - bar - sheet - tree - popover - link group - button group - before facet - after facet - label facet - bar facet- Specified by:
getAutoSpacingin interfaceSupportsAutoSpacing
-
setAutoSpacing
-
getAccessKey
The access key of this control.- Specified by:
getAccessKeyin interfaceSupportsAccessKey
-
setAccessKey
-
getCustomClass
Sets a CSS class in its parent, if the parent supports it. Which this feature it is possible to put a CSS class name into a component with the <tc:style> tag. Example:<tc:in> <tc:style customClass="my-emphasized"/> </tc:in>
One capability is, to used external CSS libs.
This feature should not be used imprudent. Because it might be unstable against changes in the renderered HTML code.- Specified by:
getCustomClassin interfaceVisual
-
setCustomClass
- Specified by:
setCustomClassin interfaceVisual
-
getTip
Text value to display as tooltip. -
setTip
-
isOmit
public boolean isOmit()Flag indicating that the action of this element, will not be executed from client side (e.g. when the user clicks a button. When setting this value to true, the action will not be executed by the Tobago, but it can executed by JavaScript. This attribute is useful, when you want to add JavaScript event handlers to commands manually. In this case you usually don't want a submit with a full reload of the page.
Default:false- Specified by:
isOmitin classAbstractUICommandBase
-
setOmit
public void setOmit(boolean omit) - Specified by:
setOmitin classAbstractUICommandBase
-
getOutcome
Link to an internal facelet page, like the outcome of an action. The context path will be added. A session id will be added, if needed.- Specified by:
getOutcomein classAbstractUICommandBase
-
setOutcome
-
restoreState
-
addClientBehavior
-
getClientBehaviors
-
broadcast
public void broadcast(jakarta.faces.event.FacesEvent arg0) throws jakarta.faces.event.AbortProcessingException - Throws:
jakarta.faces.event.AbortProcessingException
-
isImmediate
public boolean isImmediate() -
setImmediate
public void setImmediate(boolean arg0) -
getValue
-
setValue
-
getActionExpression
public jakarta.el.MethodExpression getActionExpression() -
setActionExpression
public void setActionExpression(jakarta.el.MethodExpression arg0) -
addActionListener
public void addActionListener(jakarta.faces.event.ActionListener arg0) -
removeActionListener
public void removeActionListener(jakarta.faces.event.ActionListener arg0) -
getActionListeners
public jakarta.faces.event.ActionListener[] getActionListeners() -
setId
-
setParent
public void setParent(jakarta.faces.component.UIComponent arg0) -
addClientBehavior
-
clearInitialState
public void clearInitialState() -
decode
public void decode(jakarta.faces.context.FacesContext arg0) -
encodeAll
- Throws:
IOException
-
encodeBegin
- Throws:
IOException
-
encodeChildren
- Throws:
IOException
-
encodeEnd
- Throws:
IOException
-
findComponent
-
getAttributes
-
getPassThroughAttributes
-
getChildCount
public int getChildCount() -
getChildren
-
getClientBehaviors
-
getClientId
-
getFacet
-
getFacetCount
public int getFacetCount() -
getFacets
-
getFacetsAndChildren
-
getId
-
getParent
public jakarta.faces.component.UIComponent getParent() -
getRendererType
-
getRendersChildren
public boolean getRendersChildren() -
invokeOnComponent
public boolean invokeOnComponent(jakarta.faces.context.FacesContext arg0, String arg1, jakarta.faces.component.ContextCallback arg2) throws jakarta.faces.FacesException - Throws:
jakarta.faces.FacesException
-
visitTree
public boolean visitTree(jakarta.faces.component.visit.VisitContext arg0, jakarta.faces.component.visit.VisitCallback arg1) -
isTransient
public boolean isTransient() -
markInitialState
public void markInitialState() -
addFacesListener
protected void addFacesListener(jakarta.faces.event.FacesListener arg0) -
getFacesContext
protected jakarta.faces.context.FacesContext getFacesContext() -
getFacesListeners
-
getRenderer
protected jakarta.faces.render.Renderer getRenderer(jakarta.faces.context.FacesContext arg0) -
removeFacesListener
protected void removeFacesListener(jakarta.faces.event.FacesListener arg0) -
processValidators
public void processValidators(jakarta.faces.context.FacesContext arg0) -
processUpdates
public void processUpdates(jakarta.faces.context.FacesContext arg0) -
processSaveState
-
processRestoreState
-
setTransient
public void setTransient(boolean arg0) -
saveAttachedState
-
restoreAttachedState
public static Object restoreAttachedState(jakarta.faces.context.FacesContext arg0, Object arg1) throws IllegalStateException - Throws:
IllegalStateException
-
saveState
-
setRendered
public void setRendered(boolean arg0) -
setRendererType
-
getPassThroughAttributes
-
initialStateMarked
public boolean initialStateMarked() -
isCompositeComponent
public static boolean isCompositeComponent(jakarta.faces.component.UIComponent arg0) -
isInView
public boolean isInView() -
isVisitable
protected boolean isVisitable(jakarta.faces.component.visit.VisitContext arg0) -
setValueExpression
-
getClientId
-
getCompositeComponentParent
public static jakarta.faces.component.UIComponent getCompositeComponentParent(jakarta.faces.component.UIComponent arg0) -
getContainerClientId
-
getCurrentComponent
public static jakarta.faces.component.UIComponent getCurrentComponent(jakarta.faces.context.FacesContext arg0) -
getCurrentCompositeComponent
public static jakarta.faces.component.UIComponent getCurrentCompositeComponent(jakarta.faces.context.FacesContext arg0) -
getListenersForEventClass
-
getNamingContainer
public jakarta.faces.component.UIComponent getNamingContainer() -
setInView
public void setInView(boolean arg0) -
getResourceBundleMap
-
getValueExpression
-
subscribeToEvent
public void subscribeToEvent(Class<? extends jakarta.faces.event.SystemEvent> arg0, jakarta.faces.event.ComponentSystemEventListener arg1) -
unsubscribeFromEvent
public void unsubscribeFromEvent(Class<? extends jakarta.faces.event.SystemEvent> arg0, jakarta.faces.event.ComponentSystemEventListener arg1) -
getStateHelper
protected jakarta.faces.component.StateHelper getStateHelper() -
getStateHelper
protected jakarta.faces.component.StateHelper getStateHelper(boolean arg0) -
getTransientStateHelper
public jakarta.faces.component.TransientStateHelper getTransientStateHelper() -
getTransientStateHelper
public jakarta.faces.component.TransientStateHelper getTransientStateHelper(boolean arg0) -
restoreTransientState
-
saveTransientState
-
popComponentFromEL
public void popComponentFromEL(jakarta.faces.context.FacesContext arg0) -
pushComponentToEL
public void pushComponentToEL(jakarta.faces.context.FacesContext arg0, jakarta.faces.component.UIComponent arg1)
-