# vim: ts=3 sw=3 et ft=org
#+TITLE: Textarea Element Element
#+STYLE: <LINK href='../stylesheet.css' rel='stylesheet' type='text/css' />
#+AUTHOR: Rusty Klophaus (@rustyio)
#+OPTIONS:   H:2 num:1 toc:1 \n:nil @:t ::t |:t ^:t -:t f:t *:t <:t
#+EMAIL: 
#+TEXT: [[file:../index.org][Getting Started]] | [[file:../api.org][API]] | [[file:../elements.org][*Elements*]] | [[file:../actions.org][Actions]] | [[file:../validators.org][Validators]] | [[file:../handlers.org][Handlers]] | [[file:../config.org][Configuration Options]] | [[file:../about.org][About]]

* Textarea Element - #textarea {}

  The textarea element produces an HTML textarea.

** Usage

#+BEGIN_SRC erlang
   #textarea { text="Some text" }
#+END_SRC

** Attributes

   + text - (/string/) :: Set the textarea's contents.

   + html\_encode - (/boolean/) :: Set to true to safely html-encode the text.

   + placeholder - (/string/) :: Sets the placeholder text (text that will be
      in the textarea until the user focuses in the textarea). This uses the
      HTML5 placeholder attribute, which is only supported in newer browsers.
      To add support for older-browsers, you will need to link a placeholder
      script in your template. You can do this by adding the following to your
      template inside the =<head>= section after loading jQuery. 

#+BEGIN_SRC html
   <script src='/nitrogen/jquery.placeholder.js' type='text/javascript'></script>
#+END_SRC

   + html\_name - (/string/) :: The name attribute of the textarea.

** See Also

   + [[./base.html][base element]]

   + [[./button.html][button element]]

   + [[./textbox.html][textbox element]]

   + [[./password.html][password element]]

   + [[./checkbox.html][checkbox element]]

   + [[./dropdown.html][dropdown element]]

   + [[./option.html][option element]]

   + [[https://github.com/mathiasbynens/jquery-placeholder][jQuery Placeholder Readme]]
