JSF - h:inputTextarea
The h:inputText tag renders an HTML input element of the type "text".
JSF Tag
<h:inputTextarea row = "10" col = "10" value = "Hello World! Everything is fine!" readonly = "true"/>
Rendered Output
<textarea name = "j_idt18:j_idt20" readonly = "readonly"> Hello World! Everything is fine!</textarea>
Tag Attributes
| S.No | Attribute & Description |
|---|---|
| 1 | id Identifier for a component |
| 2 | binding Reference to the component that can be used in a backing bean |
| 3 | rendered A boolean; false suppresses rendering |
| 4 | styleClass Cascading stylesheet (CSS) class name |
| 5 | value A components value, typically a value binding |
| 6 | valueChangeListener A method binding to a method that responds to value changes |
| 7 | converter Converter class name |
| 8 | validator Class name of a validator thats created and attached to a component |
| 9 | required A boolean; if true, requires a value to be entered in the associated field |
| 10 | accesskey A key, typically combined with a system-defined metakey, that gives focus to an element |
| 11 | accept Comma-separated list of content types for a form |
| 12 | accept-charset Comma- or space-separated list of character encodings for a form. The accept-charset attribute is specified with the JSF HTML attribute named acceptcharset. |
| 13 | cols Number of columns |
| 14 | border Pixel value for an elements border width |
| 15 | charset Character encoding for a linked resource |
| 16 | coords Coordinates for an element whose shape is a rectangle, circle, or polygon |
| 17 | dir Direction for text. Valid values are ltr (left to right) and rtl (right to left). |
| 18 | disabled Disabled state of an input element or button |
| 19 | hreflang Base language of a resource specified with the href attribute; hreflang may only be used with href. |
| 20 | lang Base language of an elements attributes and text |
| 21 | rows Number of rows |
| 22 | readonly Read-only state of an input field; the text can be selected in a readonly field but not edited |
| 23 | style Inline style information |
| 24 | tabindex Numerical value specifying a tab index |
| 25 | target The name of a frame in which a document is opened |
| 26 | title A title, used for accessibility, that describes an element. Visual browsers typically create tooltips for the titles value |
| 27 | type Type of a link; for example, stylesheet |
| 28 | width Width of an element |
| 29 | onblur Element loses focus |
| 30 | onchange Elements value changes |
| 31 | onclick Mouse button is clicked over the element |
| 32 | ondblclick Mouse button is double-clicked over the element |
| 33 | onfocus Element receives focus |
| 34 | onkeydown Key is pressed |
| 35 | onkeypress Key is pressed and subsequently released |
| 36 | onkeyup Key is released |
| 37 | onmousedown Mouse button is pressed over the element |
| 38 | onmousemove Mouse moves over the element |
| 39 | onmouseout Mouse leaves the element’s area |
| 40 | onmouseover Mouse moves onto an element |
| 41 | onmouseup Mouse button is released |
| 42 | onreset Form is reset |
| 43 | onselect Text is selected in an input field |
| 44 | immediate Process validation early in the life cycle |
Example Application
Let us create a test JSF application to test the above tag.
| Step | Description |
|---|---|
| 1 | Create a project with a name helloworld under a package com.tutorialspoint.test as explained in the JSF - First Application chapter. |
| 2 | Modify home.xhtml as explained below. Keep rest of the files unchanged. |
| 3 | Compile and run the application to make sure business logic is working as per the requirements. |
| 4 | Finally, build the application in the form of war file and deploy it in Apache Tomcat Webserver. |
| 5 | Launch your web application using appropriate URL as explained below in the last step. |
home.xhtml
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns = "http://www.w3.org/1999/xhtml">
<head>
<title>JSF Tutorial!</title>
</head>
<body>
<h2>h:inputTextArea example</h2>
<hr />
<h:form>
<h3>Read-Only input text area</h3>
<h:inputTextarea row = "10" col = "10" value = "Hello World!
<br/> Everything is fine!" readonly = "true"/>
<h3>Normal input text area</h3>
<h:inputTextarea value = "Hello World! <br/> Everything is fine!"/>
</h:form>
</body>
</html>
Once you are ready with all the changes done, let us compile and run the application as we did in JSF - First Application chapter. If everything is fine with your application, this will produce the following result.