dijit/form/Textarea¶
| Authors: | Doug Hays, Bill Keese, Nikolai Onken |
|---|---|
| Developers: | Doug Hays, Bill Keese |
| since: | V1.0 |
A Textarea widget is like a regular HTML textarea element, but it dynamically resizes to fit the content of the text inside. It takes nearly all the parameters (name, value, etc.) that a vanilla textarea takes. The attribute rows is not supported since this widget adjusts the height. It is especially useful in an InlineEditBox. Note that when declaring a Textarea in markup you should use a <textarea> node to preserve the newline formatting.
Examples¶
Programmatic example¶
First we will create a Textarea widget programmatically. Notice how we pass the name, style and value parameters into the object creation.
require(["dojo/ready", "dijit/form/Textarea"], function(ready, Textarea){
ready(function(){
var textarea = new Textarea({
name: "myarea",
value: "Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod tincidunt ut laoreet dolore magna aliquam erat volutpat.",
style: "width:200px;"
}, "myarea");
});
});
<textarea id="myarea"></textarea>
Declarative example¶
Here we’ll create a Textarea widget declaratively. In this instance, the initial value is the child text node of the textarea element.
require(["dojo/parser", "dijit/form/Textarea"]);
<textarea id="textarea2" name="textarea2" data-dojo-type="dijit/form/Textarea" style="width:200px;">Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod tincidunt ut laoreet dolore magna aliquam erat volutpat.</textarea>
Accessibility¶
Keyboard¶
The Textarea widget uses native HTML textarea controls.
Known Issues (1.2 and before)¶
- On Firefox 2, the user must press the Tab key twice before keyboard focus moves to the next widget. (There is no problem when using Shift+Tab.)
- The attribute “cols” was not supported, but the CSS style width could be used instead.