Drupal7 forms_api_reference.html

http://api.drupal.org/api/drupal/developer--topics--forms_api_reference.html/7

Form Controls

图例:

X= 可以被这个类型使用
- = 不能被这个类型使用

#type	checkbox	checkboxes	date	fieldset	file	machine_name	managed_file	password	password_confirm	radio	radios	select	tableselect	text_format	textarea	textfield	vertical_tabs	weight
#access	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	#access
#after_build	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	#after_build
#ajax	X	X	-	-	-	X	-	-	-	X	X	X	X	X	X	X	-	-	#ajax
#array_parents	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	#array_parents
#attached	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	#attached
#attributes	X	X	X	X	X	X	X	X	-	X	X	X	X	X	X	X	-	X	#attributes
#autocomplete_path	-	-	-	-	-	X	-	-	-	-	-	-	-	-	-	X	-	-	#autocomplete_path
#collapsed	-	-	-	X	-	-	-	-	-	-	-	-	-	-	-	-	-	-	#collapsed
#collapsible	-	-	-	X	-	-	-	-	-	-	-	-	-	-	-	-	-	-	#collapsible
#cols	-	-	-	-	-	-	-	-	-	-	-	-	-	X	X	-	-	-	#cols
#default_tab	-	-	-	-	-	-	-	-	-	-	-	-	-	-	-	-	X	-	#default_tab
#default_value	X	X	X	-	-	X	-	-	-	X	X	X	X	X	X	X	-	X	#default_value
#delta	-	-	-	-	-	-	-	-	-	-	-	-	-	-	-	-	-	X	#delta
#description	X	X	X	X	X	X	X	X	X	X	X	X	-	X	X	X	-	X	#description
#disabled	X	X	X	-	X	X	X	X	X	X	X	X	-	X	X	X	-	X	#disabled
#element_validate	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	#element_validate
#empty	-	-	-	-	-	-	-	-	-	-	-	-	X	-	-	-	-	-	#empty
#empty_option	-	-	-	-	-	-	-	-	-	-	-	X	-	-	-	-	-	-	#empty_option
#empty_value	-	-	-	-	-	-	-	-	-	-	-	X	-	-	-	-	-	-	#empty_value
#field_prefix	X	-	-	-	-	X	-	X	X	X	-	X	-	-	X	X	-	-	#field_prefix
#field_suffix	X	-	-	-	-	X	-	X	X	X	-	X	-	-	X	X	-	-	#field_suffix
#group	-	-	-	X	-	-	-	-	-	-	-	-	-	-	-	-	-	-	#group
#header	-	-	-	-	-	-	-	-	-	-	-	-	X	-	-	-	-	-	#header
#type	checkbox	checkboxes	date	fieldset	file	machine_name	managed_file	password	password_confirm	radio	radios	select	tableselect	text_format	textarea	textfield	vertical_tabs	weight	#type
#js_select	-	-	-	-	-	-	-	-	-	-	-	-	X	-	-	-	-	-	#js_select
#maxlength	-	-	-	-	-	X	-	X	-	-	-	-	-	-	-	X	-	-	#maxlength
#multiple	-	-	-	-	-	-	-	-	-	-	-	X	X	-	-	-	-	-	#multiple
#options	-	X	-	-	-	-	-	-	-	-	X	X	X	-	-	-	-	-	#options
#parents	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	#parents
#post_render	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	#post_render
#prefix	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	#prefix
#pre_render	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	#pre_render
#process	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	#process
#required	X	X	X	-	X	X	-	X	X	X	X	X	-	X	X	X	-	X	#required
#resizable	-	-	-	-	-	-	-	-	-	-	-	-	-	X	X	-	-	-	#resizable
#return_value	X	-	-	-	-	-	-	-	-	X	-	-	-	-	-	-	-	-	#return_value
#rows	-	-	-	-	-	-	-	-	-	-	-	-	-	X	X	-	-	-	#rows
#size	-	-	-	-	X	X	-	X	X	-	-	X	-	-	-	X	-	-	#size
#states	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	#states
#suffix	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	#suffix
#theme	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	#theme
#theme_wrappers	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	#theme_wrappers
#title	X	X	X	X	X	X	X	X	X	X	X	X	-	X	X	X	-	X	#title
#title_display	X	X	X	X	X	X	X	X	X	X	X	X	-	X	X	X	-	X	#title_display
#tree	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	#tree
#value_callback	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	#value_callback
#weight	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	#weight

特殊元素

#type	actions	button	container	image_button	submit	form	hidden	token	markup	item	value
#access	X	X	X	X	X	X	X	X	X	X	-
#action	-	-	-	-	-	X	-	-	-	-	-
#after_build	X	X	X	X	X	X	X	X	X	X	-
#ajax	-	X	-	X	X	-	X	-	-	-	-
#attributes	X	X	X	X	X	X	-	-	-	-	-
#button_type	-	X	-	X	X	-	-	-	-	-	-
#default_value	-	-	-	-	-	-	X	X	-	-	-
#description	-	-	-	-	-	-	-	-	-	X	-
#disabled	-	X	-	X	X	-	-	-	-	-	-
#element_validate	-	X	-	X	X	-	X	X	X	X	-
#executes_submit_callback	-	X	-	X	X	-	-	-	-	-	-
#limit_validation_errors	-	X	-	X	X	-	-	-	-	-	-
#markup	-	-	-	-	-	-	-	-	X	X	-
#method	-	-	-	-	-	X	-	-	-	-	-
#name	-	X	-	-	X	-	-	-	-	-	-
#parents	X	X	X	X	X	-	X	X	X	X	-
#post_render	X	X	X	X	X	X	X	X	X	X	-
#prefix	X	X	X	X	X	X	X	X	X	X	-
#pre_render	X	X	X	X	X	X	X	X	X	X	-
#process	X	X	X	X	X	X	X	X	X	X	-
#return_value	-	-	-	X	-	-	-	-	-	-	-
#src	-	-	-	X	-	-	-	-	-	-	-
#submit	-	X	-	X	X	X	-	-	-	-	-
#suffix	X	X	X	X	X	X	X	X	X	X	-
#theme	X	X	X	X	X	X	X	X	X	X	-
#theme_wrappers	X	X	X	X	X	X	X	X	X	X	-
#title	-	-	-	-	-	-	-	-	-	X	-
#title_display	-	-	-	-	-	-	-	-	-	X	-
#tree	X	X	X	X	X	X	X	X	X	X	-
#validate	-	X	-	X	X	X	-	-	-	-	-
#value	-	X	-	X	X	-	X	X	-	-	X
#weight	X	X	X	X	X	-	X	X	X	X	-
#type	actions	button	container	image_button	submit	form	hidden	token	markup	item	value

默认值Default Values

每个元素自动拥有这些默认值（见system_element_info（））：

• #description = NULL
• #attributes = array()
• #required = FALSE
• #tree = FALSE
• #parents = array()

下面是一个并不需要设置（在system_element_info（）中 ）的默认值的列表：

 

• button
  • #name = 'op'
  • #button_type = 'submit'
  • #executes_submit_callback = FALSE
  • #ajax['event'] = 'mousedown'
• checkbox
  • #return_value = 1
  • #ajax['event'] = 'change'
  • #title_display = 'after'
• checkboxes
  • #tree = TRUE
• fieldset
  • #collapsible = FALSE
  • #collapsed = FALSE
• file
  • #size = 60
• form

·   

• • #method = 'post'
  • #action = request_uri()
• image_button
  • #button_type = 'submit'
  • #executes_submit_callback = TRUE
  • #ajax['event'] = 'mousedown'
• radio

·   

• • #ajax['event'] = 'change'
  • #title_display = 'after'
• password

·   

• • #size = 60
  • #maxlength = 128
  • #ajax['event'] = 'blur'
• password_confirm

·   

• • #size = 60
• submit

·   

• • #name = 'op'
  • #button_type = 'submit'
  • #executes_submit_callback = TRUE
  • #ajax['event'] = 'mousedown'
• textarea
  • #cols = 60
  • #resizable = TRUE
  • #rows = 5
  • #ajax['event'] = 'blur'
• textfield

·   

• • #size = 60
  • #maxlength = 128
  • #autocomplete_path = FALSE
  • #ajax['event'] = 'blur'
• weight
  • #delta = 10