? fapi.title_display.937018.6.patch.txt
Index: forms_api_reference.html
===================================================================
RCS file: /cvs/drupal-contrib/contributions/docs/developer/topics/forms_api_reference.html,v
retrieving revision 1.137
diff -r1.137 forms_api_reference.html
859a860,878
>
1325a1357
> #title_display = 'after'
1362a1395
> #title_display = 'after'
1466c1499,1500
< #theme_wrappers, #title,
---
> #theme_wrappers,
> #title, #title_display,
1494c1528,1529
< #theme_wrappers, #title,
---
> #theme_wrappers,
> #title, #title_display,
1539c1574
< #title,
---
> #title, #title_display,
1566c1601,1602
< #suffix, #theme, #theme_wrappers, #title,
---
> #suffix, #theme, #theme_wrappers,
> #title, #title_display,
1606c1642,1643
< #suffix, #theme, #theme_wrappers, #title,
---
> #suffix, #theme, #theme_wrappers,
> #title, #title_display,
1698c1735,1736
< #title, #tree,
---
> #title, #title_display,
> #tree,
1778c1816,1817
< #suffix, #theme, #theme_wrappers, #title,
---
> #suffix, #theme, #theme_wrappers,
> #title, #title_display,
1803c1842,1843
< #suffix, #theme, #theme_wrappers, #title,
---
> #suffix, #theme, #theme_wrappers,
> #title, #title_display,
1829c1869,1870
< #suffix, #theme, #theme_wrappers, #title,
---
> #suffix, #theme, #theme_wrappers,
> #title, #title_display,
1847c1888,1889
< #suffix, #theme, #theme_wrappers, #title,
---
> #suffix, #theme, #theme_wrappers,
> #title, #title_display,
1876c1918,1919
< #suffix, #theme, #theme_wrappers, #title,
---
> #suffix, #theme, #theme_wrappers,
> #title, #title_display,
1971c2014,2015
< #title, #tree,
---
> #title, #title_display,
> #tree,
2001c2045,2046
< #title, #tree,
---
> #title, #title_display,
> #tree,
2081c2126,2127
< #title, #tree,
---
> #title, #title_display,
> #tree,
3482a3529,3558
>
>
> Used by: checkbox, checkboxes, date, fieldset, file, item, password,
> password_confirm, radio,
> radios, select, textarea, textfield, weight
>
> Description: Indicates how the #title property should be rendered.
>
> Values: String.
>
> Possible values
>
> - before: The label is output before the element. This is the default. The label includes the #title and the required marker, if #required.
> - after: The label is output after the element. For example, this is used for radio and checkbox #type elements as set in system_elements(). If the #title is empty but the field is #required, the label will contain only the required marker.
> - invisible: Labels are critical for screen readers to enable them to properly navigate through forms but can be visually distracting. This property hides the label for everyone except screen readers.
> - attribute: Set the title attribute on the element to create a tooltip but output no label element. This is supported only for checkboxes and radios in form_pre_render_conditional_form_element(). It is used where a visual label is not needed, such as a table of checkboxes where the row and column provide the context. The tooltip will include the title and required marker.
>
>
> Usage example (block.module):
>
> <?php
> $form['blocks'][$key]['weight'] = array(
> '#type' => 'weight',
> '#default_value' => $block['weight'],
> '#delta' => $weight_delta,
> '#title_display' => 'invisible',
> '#title' => t('Weight for @block block', array('@block' => $block['info'])),
> );
> ?>
>