http://api.drupal.org/api/drupal/developer--topics--forms_api_reference.html/7
Form Controls
图例:
X= 可以被这个类型使用
- = 不能被这个类型使用
特殊元素
#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
·
·
- #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