[documentation] [Documentation task] Need review of example_element.module

[Eaton]

Issue status update for 
http://drupal.org/node/106490
Post a follow up: 
http://drupal.org/project/comments/add/106490

 Project:      Documentation
 Version:      <none>
 Component:    Documentation in CVS
 Category:     tasks
 Priority:     normal
 Assigned to:  Anonymous
 Reported by:  drewish
 Updated by:   Eaton
 Status:       active

"Each form element has a #type value that determines how it's treated by
the Form API and how it's ultimately rendered into HTML. hook_elements()
allows modules to define new element types, and tell the Form API what
default values they should automatically be populated with."




Eaton



Previous comments:
------------------------------------------------------------------------

Wed, 03 Jan 2007 01:34:02 +0000 : drewish

I've added example_element.module [1] to demonstrate how to create a new
form item #type. I'd love some reviews.
[1]
http://cvs.drupal.org/viewcvs/drupal/contributions/docs/developer/exampl...




------------------------------------------------------------------------

Wed, 03 Jan 2007 02:39:50 +0000 : sime

Looks good to me, just need to build up the comments.  If it's of any
use to you, here is an attempt at a nice user-friendly description of
hook_elements.


"Form elements are already familiar to anyone who uses Forms API.
Examples of core form elements are 'textfield', 'checkbox' and
'fieldset'. Drupal utilizes hook_elements() to define these FAPI types,
and this occurs in the core function system_elements().


By implementing hook_elements in your own module, you can create custom
form elements with their own properties, validation and theming."