calendar_date_select: Calendário Javascript no Rails
Continuando minha jornada no aprendizado do Rails, deparei-me com a tarefa de preencher um formulário com datas. A opção de disponibilizar ao usuário a visualização de um calendário para escolha de uma data é bastante aplicada hoje em dia devido a facilidade e beleza disponibilizada.
Com o Rails, dei uma olhada na gem calendar_date_select e este atendeu às necessidades além de ser muito fácil configurar e inserir em seu código.
Instalando
Bem, utilizei para exemplo Rails 2.3.8.
Caso você deseje apenas instalar em um projeto, escolha:
$ cd my_app
$ script/plugin install http://calendardateselect.googlecode.com/svn/tags/calendar_date_select
Isto instalará o plugin dentro do diretório my_app/vendor/plugins
Você também pode optar por instalar a gem em seu ambiente
$ gem install calendar_date_select
sendo a versão mais atual até a confecção deste post a 1.6.1 e adicionar ao arquivo environment.rb a dependência de sua aplicação com a gem:
Utilizando
De forma simples e resumida, primeiramente, devemos adicionar em nosso layout, a chamada para os arquivos javascripts do Rails:
em seguida a chamada aos arquivos javascript e css do calendário:
O calendar_date_select proporciona diversas maneiras de utilização. Você pode conferir diversas formas de integração com o seu projeto no site demo. No caso mais simples, para a inserção de uma data em um formulário, apenas adicionamos na view do formulário:
No meu caso, como a data é um atributo de meu modelo Edição do Evento, associei-o:
<%= f.label :start_date %><br />
<%= calendar_date_select_tag "event_edition[start_date]", @event_edition.start_date %>
<% end %>

