h:inputTextarea

HtmlInputTextarea is a UIInput component that renders a field for editing multi-line text.

Immediate Usage

When the immediate attribute is true, the submitted value is converted and validated during APPLY_REQUEST_VALUES phase of the JSF lifecycle, rather than the normal PROCESS_VALIDATIONS phase.


Source Code

<ui:composition xmlns="http://www.w3.org/1999/xhtml" xmlns:f="http://xmlns.jcp.org/jsf/core"
	xmlns:h="http://xmlns.jcp.org/jsf/html"	xmlns:ui="http://xmlns.jcp.org/jsf/facelets">

	<!-- Example 1: ValueChangeListener execution when immediate is true -->
	<h:form>
		<h:messages globalOnly="true" styleClass="feedback" />
		<h:inputTextarea id="textarea" immediate="true" value="#{inputTextModelBean.text}"
			valueChangeListener="#{inputTextBackingBean.valueChangeListener}" />
		<hr />
		<h:commandButton action="#{inputTextBackingBean.submit}" value="#{i18n['submit']}">
			<f:ajax execute="@form" render="@form" />
		</h:commandButton>
		<h:outputText id="modelValue" value="#{inputTextModelBean.text}" />
	</h:form>

	<!-- Example 2: ValueChangeListener execution when immediate is false (the default) -->
	<h:form>
		<h:messages globalOnly="true" styleClass="feedback" />
		<h:inputTextarea id="textarea" value="#{inputTextModelBean.text}"
			valueChangeListener="#{inputTextBackingBean.valueChangeListener}" />
		<hr />
		<h:commandButton action="#{inputTextBackingBean.submit}" value="#{i18n['submit']}">
			<f:ajax execute="@form" render="@form" />
		</h:commandButton>
		<h:outputText id="modelValue" value="#{inputTextModelBean.text}" />
	</h:form>

</ui:composition>
@ManagedBean
@RequestScoped
public class InputTextModelBean {

	private Date date = new GregorianCalendar().getTime();
	private String text;

	public Date getDate() {
		return date;
	}

	public String getText() {
		return text;
	}

	public void setDate(Date date) {
		this.date = date;
	}

	public void setText(String text) {
		this.text = text;
	}
}
@ManagedBean
@RequestScoped
public class InputTextBackingBean {

	private static final Logger logger = LoggerFactory.getLogger(InputTextBackingBean.class);

	@ManagedProperty(value = "#{inputTextModelBean}")
	private InputTextModelBean inputTextModelBean;

	public void emailAddressValidator(FacesContext facesContext, UIComponent uiComponent, Object value)
		throws ValidatorException {

		if (value != null) {

			if (!value.toString().matches(".+[@].+[.].+")) {
				FacesMessage facesMessage = new FacesMessage();
				facesMessage.setSeverity(FacesMessage.SEVERITY_ERROR);
				throw new ValidatorException(facesMessage);
			}
		}
	}

	public void setInputTextModelBean(InputTextModelBean inputTextModelBean) {
		this.inputTextModelBean = inputTextModelBean;
	}

	public void submit() {

		Object value = inputTextModelBean.getText();

		if (value == null) {
			value = inputTextModelBean.getDate();
		}

		logger.info("You entered: " + value);
	}

	public void valueChangeListener(ValueChangeEvent valueChangeEvent) {

		FacesContext facesContext = FacesContext.getCurrentInstance();
		PhaseId phaseId = facesContext.getCurrentPhaseId();
		logger.debug("valueChangeListener: phaseId=[{0}]", phaseId.toString());

		String phaseName = phaseId.toString();
		FacesMessage facesMessage = new FacesMessage("The valueChangeListener method was called during the " +
				phaseName + " phase of the JSF lifecycle.");
		facesContext.addMessage(null, facesMessage);
	}
}
Liferay Faces Bridge Implementation 5.0.0 + Showcase Common 3.1.1 + Liferay Faces Util 3.4.1 + Mojarra 2.2.20