Project Documentation


Tag name: <s:loadBundle>
UIComponent class: org.apache.myfaces.custom.loadbundle.LoadBundle
Tag class: org.apache.myfaces.custom.loadbundle.LoadBundleTag
Component type: org.apache.myfaces.LoadBundle
Component family: org.apache.myfaces.LoadBundle

Extended 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.


Name Type Supports EL? Description
basename String Yes Path to the bundle-file in the class-path, e.g.: org.apache.myfaces.i18n.myprops
binding String Only EL Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression.
id String Yes An identifier for this particular component instance within a component view.

The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view

This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted.

rendered boolean Yes A boolean value that indicates whether this component should be rendered. Default value: true.
var String Yes Variable this bundle will be stored under, e.g. mybundle. Use #{mybundle.propertykey} or #{mybundle['propertykey']} to access the keys of the bundle.