dijit.form.Textarea

Authors:Doug Hays, Bill Keese, Nikolai Onken
Developers:Doug Hays, Bill Keese
Available: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 programatically. Notice how we pass the name, style and value parameters into the object creation.

<script type="text/javascript">
  dojo.require("dijit.form.Textarea");
  dojo.addOnLoad(function(){
    var textarea = new dijit.form.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");
  });
</script>
<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.

<script type="text/javascript">
  dojo.require("dijit.form.Textarea");
</script>
<textarea id="textarea2" name="textarea2" dojoType="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.
Error in the documentation? Can’t find what you are looking for? Let us know!