---
title: 'jSlider Form API'
url: 'https://graker.ru/news/2011/02/09/jslider_form_api'
language: ru
type: post
author: 'Роман Грачев'
published: '2011-02-09T13:15:14+03:00'
updated: '2017-03-13T13:09:44+03:00'
categories:
  - Программирование
  - Разработка
  - Друпальчики
---

# jSlider Form API

***Дорогие коллеги!
Модуль jSlider Form API переехал на Drupal.org: [http://drupal.org/project/jslider\_form\_api](http://drupal.org/project/jslider_form_api "http://drupal.org/project/jslider&#95;form&#95;api").
Дальнейшая поддержка и разработка модуля будет осуществляться там.***

Сделал еще один небольшой модуль для *Drupal 6.*x, называется ***jSlider Form API***. В модуле создается новый элемент для использования при создании форм Друпала. Элемент называется *transfer\_slider* и представляет собой виджет, разделяющий заданное число между двумя текстовыми полями с помощью слайдера [jQuery UI Slider](http://jqueryui.com/demos/slider/).

Кроме описания самого элемента, для наглядности в модуль включена тестовая страница по адресу `admin/settings/jslider_form_api_test`, выводящая форму с двумя слайдерами:

![Transfer Sliders](https://graker.ru/sites/default/files/styles/max_1300x1300/public/legacy/jslider_form_api_screenshot.png.webp?itok=wWEd-_S2)

Далее — подробности и особенности работы модуля.

Для создания слайдера используется библиотека *jQuery UI 1.6*, подтягиваемая через зависимость от модуля [jQuery UI](http://drupal.org/project/jquery_ui). Версия 1.6 используется для сохранения совместимости с другими скриптами в Друпале, так как версия 1.7 уже требует *jQuery 1.3*, а версия модуля [jQuery Update](http://drupal.org/project/jquery_update), устанавливающая *jQuery 1.3*, еще в альфе и не относится к рекомендованным релизам. Впрочем, обновление — когда оно потребуется — не составит труда.

Для использования элемента *transfer\_slider* при создании новой формы необходимо в функцию-конструктор формы добавить такой код:

```php
$form['test_slider'] = array(
  '#type' => 'transfer_slider',
  '#title' => t('Transfer from left to right'), //заголовок элемента
  '#left' => t('Left'), //заголовок текстового поля слева
  '#right' => t('Right'), //заголовок текстового поля справа
  '#left_value' => 0, //начальное значение слева
  '#right_value' => 200, //начальное значение справа
);
```

И все, элемент будет сгенерирован. После сохранения формы, значения элемента можно будет считать из массива `$form_state`, а именно — из `$form_state['values']['test_slider']['left']` и `$form_state['values']['test_slider']['right']` для левого и правого текстового поля соответственно.

Особенности работы элемента:

- валидация значений: проверка, что оба значения являются числами, проверка, что сумма двух значений после сохранения совпадает с суммой значений при создании элемента;
- при отключении *JavaScript* элемент будет по-прежнему работать (в виде двух текстовых полей без слайдера);
- при перемещении слайдера значения в текстовых полях справа и слева обновляются;
- при изменении числа в текстовом поле слева или справа с клавиатуры, другое текстовое поле и позиция слайдера — обновляются;
- при вводе с клавиатуры в текстовые поля осуществляется автовалидация: проверка ввода не-чисел и выхода за допустимый диапазон;
- для темизации элемента в модуль включен CSS-файл с дефолтным оформлением слайдера из библиотеки *jQuery UI*.

При создании модуля использовалась литература:

1. [Form API Reference](http://api.drupal.org/api/drupal/developer--topics--forms_api_reference.html/6).
2. [Creating Custom Elements Using Drupal 6.x](http://drupal.org/node/169815).
3. [Создание своего типа элемента для использования в формах](http://xandeadx.ru/blog/drupal/175).

Ниже все желающие могут скачать архив с модулем и оставить комментарий по теме.
