---
title: 'Несколько слов о Drupal.Behaviors и $(document).ready()'
url: 'https://graker.ru/news/2011/02/10/neskolko_slov_o_drupalbehaviors_i_documentready'
language: ru
type: post
author: 'Роман Грачев'
published: '2011-02-10T18:33:39+03:00'
updated: '2016-08-08T17:51:51+03:00'
categories:
  - Друпальчики
---

# Несколько слов о Drupal.Behaviors и $(document).ready()

Сегодня неизвестный, но [бдительный пользователь](https://graker.ru/drupal/papers/ajax_form_submit#comment-2977) вновь напомнил мне о разнице между Drupal.behaviors и $(document).ready(). Причем так напомнил, что я уже обновил по горячим следам [jSlider Form API](https://graker.ru/project/jslider_form_api). Для закрепления, напишу об этой разнице несколько слов.

Дело в том, что некоторые (и я был в их числе) принимают Drupal.behaviors за полную замену $(document).ready(), дескать, в Друпале надо вот так — и все. Виной тому, с одной стороны, невнимательность, с другой — тот факт, что в 2009-м году [описание Drupal JavaScript API](http://drupal.org/node/205296) было не таким подробным, как теперь. Так или иначе, основная разница между ними заключается в том, что, тогда как $(document).ready() вызывается однократно, после готовности DOM, Drupal.behaviors может вызываться несколько раз: если скрипты подгружают по AJAX на страницу новые элементы и вызывают для них функцию Drupal.attachBehaviors().

При отладке с этим сталкиваешься не всегда, поэтому о разнице нетрудно забыть. Но в боевом режиме вляпаться легко. Достаточно поставить какой-нибудь [Vote Up/Down](http://drupal.org/project/vote_up_down) — и вот уже кнопки, генерируемые нашими скриптами, при каждом голосовании генерируются вторично, а формы начинают сохраняться по несколько раз подряд.

Чтобы избежать таких глюков, необходимо в Drupal.behaviors, во-первых, использовать переменную context, и во-вторых — присваивать обработанным однажды элементам соответствующий класс и проверять его наличие при обработке. Как в данном примере, добавленном к упомянутому описанию JS в Друпале:

```javascript
Drupal.behaviors.myModuleBehavior = function(context) {
  $('.module-class-object:not(.module-class-processed)', context).each(function () {
    $(this).addClass('module-class-processed');
    // Do things
  });
};
```

Кроме того, для глобальных задач (например, однократно добавить на страницу кнопку) можно по-прежнему пользоваться $(document).ready().
