form_set_error

includes/form.inc, строка 792

Версии
5: form_set_error($name = NULL, $message = '')
6: form_set_error($name = NULL, $message = '', $reset = FALSE)

Устанавливает ошибку для указанного элемента формы.

Параметры

$name Имя элемента формы. Если свойство '#parents' элемента формы является массивом ('foo', 'bar', 'baz'), то вы можете установить ошибку на 'foo' или 'foo][bar][baz'. Установка ошибки на 'foo' привет к ошибке на тех элементах, у которых массив '#parents' начинается с 'foo'.

$message Сообщение об ошибке, показываемое пользователю.

$reset Сброс статического кэша ошибок формы.

Возвращаемое значение

Никогда не используйте возвращаемое значение этой функции. Вместо этого используйте функции form_get_errors() и form_get_error().

Связанные темы

▸ 66 функции вызывают form_set_error()

▾ 66 функции вызывают form_set_error()

категория формы накопителя утверждает in modules/aggregator/aggregator.admin.inc: Утвердите подчинение формы подачи формы накопителя
aggregator_form_feed_validate in modules/aggregator/aggregator.admin.inc: Validate aggregator_form_feed form submissions.
block_add_block_form_validate in modules/block/block.admin.inc
block_admin_configure_validate in modules/block/block.admin.inc
book_admin_edit_validate in modules/book/book.admin.inc: Check that the book has not been changed while using the form. See alsobook_admin_edit()
book_admin_settings_validate in modules/book/book.admin.inc: Валидатор формы настройки книги.
comment_admin_overview_validate in modules/comment/comment.admin.inc: Validate comment_admin_overview form submissions.
comment_validate in modules/comment/comment.module: Проверка данных комментария.
contact_admin_edit_validate in modules/contact/contact.admin.inc: Валидатор формы страницы редактирования категорий контактов.
contact_mail_page_validate in modules/contact/contact.pages.inc: Validate the site-wide contact page form submission.
dblog_filter_form_validate in modules/dblog/dblog.admin.inc: Validate result from dblog administration filter form.
do_search in modules/search/search.module: Do a query on the full-text search index for a word or words.
drupal_validate_form in includes/form.inc: Проверяет отправленные пользователем данные формы из $form_state, используя функции проверки, заданные в структурированном массиве формы.
file_check_directory in includes/file.inc: Check that the directory exists and is writable. Directories need to have execute permissions to be considered a directory by FTP servers, etc.
file_save_upload in includes/file.inc: Сохраняет загруженный файл в новое место. Исходный файл должен быть загружен и обработан.
filter_admin_format_form_validate in modules/filter/filter.admin.inc: Validate filter format form submissions.
form_error in includes/form.inc: Устанавливает флаг наличия ошибки для $element.
form_get_error in includes/form.inc: Return the error message filed against the form with the specified name.
form_get_errors in includes/form.inc: Возвращает ассоциативный массив всех ошибок на форме.
forum_nodeapi in modules/forum/forum.module: Implementation of hook_nodeapi().
hook_prepare in developer/hooks/node.php: Этот хук используется модулями, которые работают с нодами. Он вызывается после загрузки ноды, но перед тем, как нода будет отображена в форме добавления/редактирования.
hook_validate in developer/hooks/node.php: Проверяет форму редактирования ноды.
image_gd_settings in includes/image.gd.inc: Retrieve settings for the GD2 toolkit.
image_gd_settings_validate in includes/image.gd.inc: Validate the submitted GD settings.
locale_languages_edit_form_validate in includes/locale.inc: Validate the language editing form. Reused for custom language addition too.
locale_languages_predefined_form_validate in includes/locale.inc: Validate the language addition form.
locale_translate_edit_form_validate in includes/locale.inc: Validate string editing form submissions.
menu_edit_item_validate in modules/menu/menu.admin.inc: Validate form values for a menu link being added or edited.
menu_edit_menu_validate in modules/menu/menu.admin.inc: Validates the human and machine-readable names when adding or editing a menu.
multipage_form_example_custom_validate in developer/examples/multipage_form_example.module: Validate our form.
nodeapi_example_nodeapi in developer/examples/nodeapi_example.module: Реализация hook_nodeapi().
node_admin_nodes_validate in modules/node/node.admin.inc: Validate node_admin_nodes form submissions.
node_assign_owner_action_validate in modules/node/node.module
node_example_validate in developer/examples/node_example.module: Реализация hook_validate().
node_type_form_validate in modules/node/content_types.inc: Implementation of hook_form_validate().
node_validate in modules/node/node.module: Perform validation checks on the given node.
openid_begin in modules/openid/openid.module: The initial step of OpenID authentication responsible for the following: Perform discovery on the claimed OpenID. If possible, create an association with the Provider's endpoint. Create the authentication request. Perform the appropriate redirect.
openid_user_add_validate in modules/openid/openid.pages.inc
path_admin_form_validate in modules/path/path.admin.inc: Verify that a new URL alias is valid
path_nodeapi in modules/path/path.module: Реализация hook_nodeapi().
poll_validate in modules/poll/poll.module: Implementation of hook_validate().
poll_view_voting_validate in modules/poll/poll.module: Validation function for processing votes
profile_field_form_validate in modules/profile/profile.admin.inc: Validate profile_field_form submissions.
profile_validate_profile in modules/profile/profile.module
search_form_submit in modules/search/search.pages.inc: Process a search form submission.
system_send_email_action_validate in modules/system/system.module: Validate system_send_email_action form submissions.
system_site_information_settings_validate in modules/system/system.admin.inc: Validate the submitted site-information form.
taxonomy_form_term_validate in modules/taxonomy/taxonomy.admin.inc: Validation handler for the term edit form. Ensure numeric weight values. See alsotaxonomy_form_term()
taxonomy_node_validate in modules/taxonomy/taxonomy.module: Make sure incoming vids are free tagging enabled.
throttle_admin_settings_validate in modules/throttle/throttle.admin.inc
trigger_assign_form_validate in modules/trigger/trigger.admin.inc: Validation function for trigger_assign_form().
update_settings_validate in modules/update/update.settings.inc: Validation callback for the settings form.
upload_admin_settings_validate in modules/upload/upload.admin.inc: Form API callback to validate the upload settings form.
upload_js in modules/upload/upload.module: Коллбэк меню для JavaScript загрузок файлов.
user_admin_access_check_validate in modules/user/user.admin.inc
user_admin_account_validate in modules/user/user.admin.inc
user_admin_role_validate in modules/user/user.admin.inc
user_authenticate in modules/user/user.module: Try to log in the user locally.
user_edit_validate in modules/user/user.pages.inc
user_login_final_validate in modules/user/user.module: A validate handler on the login form. Should be the last validator. Sets an error if user has not been authenticated yet.
user_login_name_validate in modules/user/user.module: A FAPI validate handler. Sets an error if supplied username has been blocked or denied access.
user_pass_validate in modules/user/user.pages.inc
user_profile_form_validate in modules/user/user.pages.inc: Validation function for the user account and profile editing form.
user_validate_picture in modules/user/user.module
_install_settings_form_validate in ./install.php: Helper function for install_settings_validate.
_user_edit_validate in modules/user/user.module

Код

<?php
function form_set_error($name = NULL, $message = '', $reset = FALSE) {
  static $form = array();
  if ($reset) {
    $form = array();
  }
  if (isset($name) && !isset($form[$name])) {
    $form[$name] = $message;
    if ($message) {
      drupal_set_message($message, 'error');
    }
  }
  return $form;
}
?>

Пользовательские комментарии

#1 2010-08-11, warobushek

Если нужно установить ошибку на элемент из fieldset для которого tree = TRUE, то нужно использовать следующую конструкцию
form_set_error('fieldset_name][element_name');

Войдите или зарегистрируйтесь, чтобы получить возможность отправлять комментарии

Параметры

Возвращаемое значение

Parameters

Return value

Связанные темы

▸ 66 функции вызывают form_set_error()

▾ 66 функции вызывают form_set_error()

Код

Пользовательские комментарии

Вход в систему

Документация