);
?>Description: The language_select element works similarly to select and allows module developers to assign a language to entities, for example, (or to whatever piece of data they want). It prints a select box with the language options. By default, if the Language module is not enabled and no default value is provided, the select box will not be printed in the form, and the value submitted will always be LANGUAGE_NOT_SPECIFIED. If the Language module is enabled, a select form field will be printed in the form and will contain a set of languages as options.
+All the element options that a select field can use, can be also used for this new form element. In addition, there is a new property, “#languages”, which is a set of flags to specify what languages should appear as options.
+Properties: #access, #after_build, #ajax, #attributes, #default_value,
+#description, #disabled,
+#element_validate,
+#empty_option,
+#empty_value,
+#field_prefix, #field_suffix,
+#languages,
+#multiple,
+#options, #parents,
+#post_render, #prefix,
+#pre_render, #process,
+#required, #size, #states,
+#suffix, #theme, #theme_wrappers,
+#title, #title_display,
+#tree, #type,
+#weight
+
+Usage example (NodeFormController.php):
+<?php
$form['langcode'] = array(
'#title' => t('Language'),
'#type' => 'language_select',
'#default_value' => $node->langcode,
'#languages' => LANGUAGE_ALL,
'#access' => !variable_get('node_type_language_hidden_' . $node->type, TRUE),
);
?>
@@ -3387,6 +3481,14 @@ checkbox.
TRUE to add a select all box to each row of the table, FALSE to omit
the select all box. Only applies if #multiple is also TRUE.
+
+Used by: language_select
+Description: The #languages property is a set of flags to specify which languages should appear as options. The value of the #languages property is directly passed to language_list(), and is therefore used to populate the #options list by default. The following language constants can be used: LANGUAGE_CONFIGURABLE, LANGUAGE_LOCKED, LANGUAGE_ALL.
+
+Usage example (form_test.module — form_test_language_select()):
+Flags can be combined (bitwise), so you can have something like this:
+<?php
$form['languages_config_and_locked'] = array(
'#type' => 'language_select',
'#languages' => LANGUAGE_CONFIGURABLE | LANGUAGE_LOCKED,
);
?>
+
Used