API page: https://api.drupal.org/api/drupal/developer!topics!forms_api_reference.h...
I'm very surprised that this documentation has an #options array example using drupal_map_assoc() on arrays of translated strings. The keys of the array, which contain the data to be stored upon submit, should not be passed through t() and translated, otherwise the form will break and stored data will be corrupted on multilingual sites. The corrected array for the example of a 'select' element would be
array(
'uk' => t('UK'),
'other' => t('Other'),
)
https://api.drupal.org/api/drupal/developer%21topics%21forms_api_referen...
Similarly for the checkboxes example:
array(
'SAT' => t('SAT'),
'ACT' => t('ACT'),
)The actual documentation text shows things correctly. It is really just the examples that are poor. These come from https://api.drupal.org/api/examples/form_example!form_example_states.inc... which should also know better! :)
Closed: won't fix
API documentation files
Not all content is available!
It's likely this issue predates Contrib.social: some issue and comment data are missing.
This is for the Drupal 7 Form API reference. Since Drupal 7 is past end-of-life this is now a "won't fix".
Work on documentation for form elements for supported versions of Drupal is at
📌
[meta] Move/Create Form Element Documentation
Active
and
🌱
[Meta] Improve documentation for Render and Form Elements
Active
.