Tomahawk sandbox tag library.


Standard Syntax:
     <%@ taglib prefix="s" uri="http://myfaces.apache.org/sandbox" %>

XML Syntax:
     <anyxmlelement xmlns:s="http://myfaces.apache.org/sandbox" />

Enhanced standard JSP actions and custom MyFaces actions.

Tag Library Information
Display NameTomahawk sandbox tag library.
Version1.0
Short Names
URIhttp://myfaces.apache.org/sandbox
 

Tag Summary
accordionPanelA group of panels, which can be opened and closed. See attribute layout for further description on how opening and closing works. Extends standard panelGroup by user role support.
ajaxChildComboBoxRefreshes contents through an ajax call when the parent combo box's value is changed. This component is to be used in conjunction with a regular combo box or list box. When the selected value of the latter changes, it executes an ajax call to the specified method to refresh its contents based on the new selected value.
autoUpdateDataTableExtended data_table that adds some additional features to the standard data_table action: see attribute descriptions for preserveDataModel, sortColumn, sortAscending and preserveSort. NOTE: This component is deprecated. Use periodicalUpdate mechanism of partial page rendering instead
validationScriptNo Description
conversationputs a bean into the conversation context add a bean under context control
endConversationend a conversation
ensureConversation

Ensures a named conversation is running

check if a conversation is active.

The way this is done here is sub-optimal, once we are on jsf 1.2 it should be possible to check this before ANY rendering - and maybe to invoke a navigation then

separateConversationContextSeparates the current context from the children. e.g. commandLinks will start a new conversation context separate the current context from the to be rendered children. E.g. when you render commandLinks they will start a new conversationContext
startConversationstart a conversation
modalDialogModal Dojo Dialog (is not working with overridden 'onload')
layoutingContentPaneBase content pane for the dojo layouts jsfed dojo content pane
layoutingSplitPanePanelGroup which supports a partialTriggers Attribute similar to the one in Trinidad
floatingPanePanelGroup which supports a partialTriggers Attribute similar to the one in Trinidad
layoutingTitlePaneTitle Pane layouting element. TitlePane Component class
effectprovides javascript effects which are from the script.aculo.us library and from the fat fade anything technique library
fieldsetRenders an HTML Fieldset
fishEyeCommandLinkCommandLink component that can be used in nodeStamp facet
fishEyeNavigationMenuProvide a FishEye toolbar component from the DOJO toolkit A Mac OSX-style toolbar, using the DOJO toolkit.
focusNo Description
formRenders a HTML form element which allow defining a different scheme, servername or port for the action url to which the form is submited
graphicImageDynamicExtends standard graphicImage.
ifMessageProvide a component that will optionally render its children if the specified component(s) specified has a message. Renders children if any of the component(s) specified in "for" has a message in the context.
imageLoopHTML image loop component. Image loop/slide show component. Provides Javascript methods to control image loop behaviour. Methods: getImageLoop(id) - get image loop object with id, play() - play loop, stop() - stop loop, accelerate() - accelerate loop until minDelay reached, decelerate() - decelerate loop until maxDelay reached, setImageIndex(index) - show image with index, reset() - reset settings to origin values, getImageCount() - get number of images loaded
imageLoopItemsImage loop items.
imageLoopItemImage loop item.
commandButtonAjaxExtends standard commandButton allowing for dynamic ajax submitting of the form.
inputTextAjaxExtends standard inputText allowing for dynamic ajax submitting.
selectBooleanCheckboxAjaxExtends standard selectBooleanCheckbox by user role support.
selectManyCheckboxAjaxExtends standard selectManyCheckbox allowing for dynamic ajax submitting. Current limitations - Bound value must be a Collection of Strings!
selectOneRadioAjaxExtends standard selectOneRadio allowing for dynamic ajax submitting.
listenerAllows a component to listen for events on another component with AJAX input elements. On is the id of the component you want to listen on. eventType is what happened to the component, for instance "onChange" action is what to do if the event occurs, default is "update". Will be able to call arbitrary javascript functions too. NOTE: eventType and action are NOT implemented yet
messageMyFaces extension to the standard messages tag: see summaryDetailSeparator attribute
limitRenderedTag that allows for selective rendering based on a count or by child index Component that only renders a subset of its children components. Provides functionality that the JSTL choose tag has, but leverages the {@link javax.faces.component.UIComponent#isRendered()} method instead of using when tags with test attributes.

It can either use a filter type of "count" or "index". If count, the given number of children will be rendered (so for example, a value of 2 will cause the first two children that are have a true isRendered result to be rendered. If index, it will render the given indexes.

See the taglib for more documentation

loadBundleExtended loadbundle which does its job in all life-cycle phases or even on calling LoadBundle.loadBundle() - not only when rendering happens... A load-bundle alternative which allows to use load-bundle even on AJAX-enabled pages.

A component that allows to load bundles not only on rendering, but whenever the page author needs it. By default, it loads it on every lifecycle phase except restore-state and save-state.*

The core-load-bundle only loads its message-bundle on rendering - this load-bundle does it on every life-cycle, and optionally whenever the method loadBundle is called.

mediaNo Description
outputLinkDynamicExtends standard outputLink but links to a dynamically rendered resource (image, file, ...).
passwordStrengthNo Description
pprPanelGroupAJAX component which supports updating its children via AJAX calls. These updates can occur regularly or based on triggering input components.
pprSubmitPPRSubmitTag can be attached to command components, enabling PPR-request inside UIData components
roundedDivComponent that allows for a rounded border effect on DIV tags that is supported in CSS2 compatible browsers and IE6. Component that generates a DIV tag with rounded corners that may be either 3D or 2D in appearence.
scopeScope control which does basically the same as savestate but bypasses the serialization and utilizes the session directly
scriptAdds (java)script to the browser
selectOneRowEnhancement for a data-table to select one Row with a radio button. The row-index is stored in the vealu-binding
stateChangedNotifierA component that listens to changes in the components Shows a confirmation window if some of the input fields of the form have changed its value
subFormA SubForm which will allow for partial validation and model update.

A subform to an existing form. Inputs in this form will only be validated and updated, if a t:commandButton or t:commandLink has been clicked with an actionFor attribute which references the client-id of this subform. Optionally, the validation will trigger if a commandButton or commandLink embedded in this subform has been clicked, except if this command is a t:commandButton or t:commandLink with an actionFor attribute which doesn't reference the client-id of this subform.

Components will be validated and updated only if either a child-component of this form caused the submit of the form, or an extended commandLink or commandButton with the actionFor attribute set to the client-id of this component was used.

You can have several comma-separated entries in the actionFor-attribute - with this it's possible to validate and update more than one subForm at once.

submitOnEventAttach an event handler to an input element or use a global event handler to submit a form by "clicking" on a link or button
inputSuggestProvides an input textbox with "suggest" functionality.
inputSuggestAjaxProvides an input textbox with "suggest" functionality, using an ajax request to the server.
outputTextExtending the outputText component in order to introduce the for attribute.
tableSuggestAjaxProvides an input textbox with "suggest" functionality, using an ajax request to the server. The popUp contains a table where each column value can be set to a specific dom node (through dom node id).
filterTableNo Description
sortableColumnNo Description
xmlTemplateTransforms XML using and XSL stylesheet. Used to transform XML (from either a String or URL) using either XSLT or Velocity.
timedNotifierDisplays a timed notifier tag
toggleGroupContainer class allows user to toggle between view/edit mode. Extends PanelGroup. Allows user to have several toggleLink in a group. When the togglePanel is toggled, the toggleGroup will be hidden.
toggleLinkExtends standard outputLink but links to a dynamically rendered resource (image, file, ...). Should be nested within an HtmlToggleGroup component. Controls nested within this component will be displayed in 'view' mode, controls outside this component (within the parent HtmlToggleGroup) will be displayed in 'edit' mode.
togglePanelContainer class allows user to toggle between view/edit mode. Extends PanelGroup. Allows user to toggle between 'view' mode and 'edit' mode. In the togglePanel, include a toggleLink. When the toggleLink is clicked, the rest of the group is shown, and the link is hidden.
convertDateTimeSimple convert that overrides the spec DateTimeConverter and uses TimeZone.getDefault() as the base timezone, rather than GMT. Convert date time using normal system timezone like it should
convertNumberConverter which uses either the manually set destType or the value binding to determine the correct destination type to convert the number to This tag creates a number formatting converter and associates it with the nearest parent UIComponent. It uses either the manually set destType or the value binding to determine the correct destination type to convert the number to. Unless otherwise specified, all attributes accept static values or EL expressions.
convertStringUtilsConverts the format of a string Provides runtime modification of a string. Uses Apache Lang StringUtils and WordUtils to peform operations.

Example:

convertBooleanConverter that translates between boolean values (true/false) and alternate versions of those boolean values like (yes/no), (1/0), and (way/no way).

To customize the representation of a boolean true and false, use {@link #setTrueValue(String)} and {@link #setFalseValue(String)} respectively. If not configured with these setter methods, it defaults to true and false.

The values are case sensitive.

validateCompareToValidates this component against another component. Specify the foreign component with the for={foreign-component-id} attribute. Valid operator attribute values: equals: eq, ==, =, not equals: ne, !=, greater than: gt, >, less than: lt, <, greater than or equals: ge, >=, less than or equals: le, <= If the comparator attribute is specified, the component values are compared using the specified java.util.Comparator object. If no comparator is specified, the component values must implement Comparable and are compared using compareTo(). If either value or foreign value does not implement Comparable and no Comparator is specified, validation always succeeds. Put this validator on the bottom-most component to insure that the foreign component's value has been converted and validated first. However, this validator will attempt to convert and validate the foreign component's value if this has not already occurred. This process may not be identical to the standard JSF conversion and validation process. The validation error message key is currently hardcoded as "{0} value <{1}> must be {2} {3} value <{4}>" where {0} is the parent component id, {1} is the parent component value, {2} is the operator name, {3} is the foreign component id, and {4} is the foreign component value. The alternateOperatorName attribute can specify a custom operator name. For example, use "after" instead of "greater than" when comparing dates. The message attribute can specify an alternate validation error message key. For example, use "{0} must be {2} {3}" to remove values from the message. faces-config.xml configuration: CompareTo validator org.apache.myfaces.validator.CompareTo org.apache.myfaces.custom.comparetovalidator.CompareToValidator Facelets configuration (inside a taglib.xml file): compareToValidator org.apache.myfaces.validator.CompareTo Example usage: Known issues: - Operator names should be localized. - The default message key should be localized. - Perhaps an exception should be thrown if the two values are not Comparable and no Comparator is specified.
validateCSVValidation by validating comma separated values individually.
validateISBNA custom validator for isbn codes, based upons Jakarta Commons.
validateUrlA custom validator for url format, based upons Jakarta Commons.
exporterActionListenerExport datatable contents to an excel file or a pdf file.
valueChangeNotifier

ValueChangeNotifier

Like valueChangeListener, but will send valueChange events after the UPDATE_MODEL phase.
This simply means you CAN update your model values within such an event now.
  • It wont be overwritten by the model update
  • And wont trigger another valueChange if you update a value with an valueChangeListener attached
 


Java, JSP, and JavaServer Pages are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries. Copyright 2002-3 Sun Microsystems, Inc. 4150 Network Circle Santa Clara, CA 95054, U.S.A. All Rights Reserved.