View Source

h2. Overview
_Since 3.1_

You can use the _icecore:redirect_ tag to trigger a redirect immediately upon page load, upon any user interaction causing a render of the component, or at the server's discretion using push.

{tip}See the ICEfaces Showcase [Live Demo|http://icefaces-showcase.icesoft.org/showcase.jsf?grp=aceMenu&exp=redirectBean] of this component, complete with source code.{tip}

h2. Getting Started

To use the _icecore:redirect_ tag, first declare the core namespace:

{panel}
{code:html|borderStyle=dashed}<html ... xmlns:icecore="http://www.icefaces.org/icefaces/core">
{code}
{panel}Then add the _icecore:redirect_ tag to your page markup, setting the required _href_ attribute. Typically an EL expression would be used, so that server code may update the bean's href value and then do a push.

{panel}{code:xml|borderStyle=dashed}<h:body>
<icecore:redirect href="#{redirectBean.href}"/>
...
{code}
{panel}

h2. Attributes

{tip:title=TagLib Documentation}This section covers attributes involved in the typical use-cases for this component. For reference, the complete taglib documentation for this component is available [here|http://res.icesoft.org/docs/v4_latest/core/comps/tld/icecore/redirect.html].{tip}

{panel}
*href* - Allows control of the absolute or relative location to redirect to. This is a mandatory attribute specifying the href to redirect to. No redirect will happen while using an EL expression that evaluates to null or an empty string.
{panel}