Comment ça marche ?

Ce plugin est une extension d'ActionView qui permet d'insérer dans vos vues le code nécessaire à l'affichage de sliders scriptaculous.

Il est dès lors possible de simplifier votre code HTML en évitant les nombreuses répétitions et les morceaux de code JS un peu partout.

Installation

Dans une console, à la racine de votre projet Rails, il vous suffit d'entrer la commande suivante :

    $ cd vendor/plugins  
    $ hg clone http://www.bitbucket.org/Bounga/scriptaculous-slider

ou pour une installation globale :

    $ sudo gem install scriptaculous_slider

puis dans le fichier environment.rb :

     config.gem 'scriptaculous_slider'

Vous devrez également utiliser la commande suivante :

      
     rake scriptaculous_slider_install

qui installe slider.js dans votre répertoire javascripts puisque qu'il n'est pas livré avec Rails.

Exemples d'utilisation

    <%= slider_stylesheet %>
    <%= slider_field :object, :method, :range => 1..10 %>
    <%= slider_element "my_slider", :range => 1..10, :hidden_fields => true %>

slider_element ne crée pas de hidden field par défaut mais vous pouvez forcer ce comportement.

slider_field créera automatiquement un hidden field qui sera automatiquement mis à jour quand vous utiliserez le slider.

slider_stylesheet crée un style pour les sliders ce qui peut vous servir de base pour la création de votre propre CSS.

Pour voir toutes les fonctionnalités disponibles, jettez un oeil sur les tests disponibles avec le code source de script.aculo.us : http://github.com/madrobby/scriptaculous/tree/master.

Pour les discussions à propos de ce plugin, utilisez le Google Group Prototype / Scriptaculous.

Et les sources ?!

Le projet est hébergé chez BitBucket. J'utilise le SCM Mercurial pour le contrôle des sources.

Vous pourrez donc le trouver à cette adresse : http://www.bitbucket.org/Bounga/scriptaculous-slider/.

Vous pouvez suivre les commits, avoir accès à de jolis graphes, récupérer les sources ou encore forker le projet !

Le mot de la fin

J'espère que ce plugin pourra vous être utile.

Tout rapports de problèmes, commentaires ou suggestions sont les bienvenues.