[Rails + Materialize] DateTimePickerがなかったので…

1 はじめに
2 前提条件
- 2.1 ビューのイメージ
3 モデルにゲッターとセッターを追加
4 入力フォームに追加
5 テストコードも書いてみる
6 さいごに

はじめに

こんにちは！
Materializeには便利なコンポーネントがたくさんあります。
DatePickerやTimePickerもその一つです。

Pickers

ただ、現状DateTimePickerはないようです。
Railsで日付+時間で操作したいこともあるかと思います。

たまたま要件として、フォームの中でDateTimeを扱う必要がでました。
私が考えた選択肢としては、

DateTimePickerを作る or 別のプラグインを入れる
RailsのFormヘルパーを使用する（その部分だけデザインが変わることを許容する）
DatePickerとTimePickerをそれぞれ使用し、DateTimeに変換する

今回は極力Materializeのフレームワークに載ったかたちで進めたい、ということもあったので、「3」を選択しました。
その他の選択肢もあるかと思います。
今回は参考になるかと思い、記事にまとめたいと思います。

前提条件

今回はイベントを管理するeventsテーブルに、開始日時を保存するstarted_atがあるとします。
started_atはdatetimeでDBに保存するものとします。

ビューのイメージ

上述の通り、MaterializeにDateTimePickerがないので、下記のように入力フォームを分けたいと思います。

モデルにゲッターとセッターを追加

started_atとは別で、started_at_hというメソッドを追加します。
このstarted_at_hに値が入ったら、started_atにDateTimeでセットします。

 class Event < ApplicationRecord # ... def started_at_h=(values) self.started_at = if values.is_a?(Hash) && values.key?('date') && values.key?('time') "#{values['date']} #{values['time']}" else Time.zone.now end end def started_at_h if started_at.present? { 'date' => started_at.strftime('%Y-%m-%d'), 'time' => started_at.strftime('%H-%M') } else { 'date' => '', 'time' => '' } end end end

classEvent<ApplicationRecord

# ...

defstarted_at_h=(values)

self.started_at=ifvalues.is_a?(Hash)&&values.key?('date')&&values.key?('time')

"#{values['date']} #{values['time']}"

else

Time.zone.now

end

defstarted_at_h

ifstarted_at.present?

{'date'=>started_at.strftime('%Y-%m-%d'),

'time'=>started_at.strftime('%H-%M')}

else

{'date'=>'','time'=>''}

end

started_at_hにはハッシュでdateとtimeを渡し、その値を使ってstarted_atを更新します。
逆に取り出す時は、started_atの値を操作します。

入力フォームに追加

JSファイルにて使用宣言

MaterializeのDatePickerとTimePickerを使用するためには、JSにて宣言する必要があります。

 // DatePicker var elem = document.querySelector('.datepicker'); var instance = M.Datepicker.init(elem, options); // TimePicker var elem = document.querySelector('.timepicker'); var instance = M.Timepicker.init(elem, options);

// DatePicker

varelem=document.querySelector('.datepicker');

varinstance=M.Datepicker.init(elem,options);

// TimePicker

varelem=document.querySelector('.timepicker');

varinstance=M.Timepicker.init(elem,options);

JQueryを使用している場合は、下記のようになります。

 $(document).ready(function(){ $('.datepicker').datepicker(); $('.timepicker').timepicker(); });

$(document).ready(function(){

$('.datepicker').datepicker();

$('.timepicker').timepicker();

});

HTML

フォームの方では、strated_at_hのnameで渡します。
nameはstarted_at_h[date]といったかたちで書くことで、submitした後ハッシュでパラメータを投げてくれます。

 <%= form_with(model: @event, local: true) do |form| %> <!-- ... --> <div class="row"> <div class="col s6 m6"> <%= form.label :started_at, '開始日' %> <%= form.text_field 'started_at_h[date]', { class: 'datepicker', value: @event.started_at_h['date'] } %> </div> <div class="col s6 m6"> <%= form.label :started_at, '開始時間', class: 'required' %> <%= form.text_field 'started_at_h[time]', { class: 'timepicker', value: @event.started_at_h['time']} %> </div> </div> <div class="row"> <%= form.submit %> </div> <% end %>

<%=form_with(model:@event,local:true)do|form|%>

<divclass="row">

<divclass="col s6 m6">

<%=form.label:started_at,'開始日'%>

<%=form.text_field'started_at_h[date]',{class:'datepicker',

value:@event.started_at_h['date']}%>

</div>

<divclass="col s6 m6">

<%=form.label:started_at,'開始時間',class:'required'%>

<%=form.text_field'started_at_h[time]',{class:'timepicker',

value:@event.started_at_h['time']}%>

</div>

<divclass="row">

<%=form.submit%>

</div>

<%end%>

コントローラーのストロングパラメータを修正

フォームから値を受け取る時は、スタロングパラメータを使用することが多いと思います。
受け取る際には、started_atではなく、started_at_hにし、ハッシュを指定します。

 def event_params params.fetch(:event, {}).permit( # ... { started_at_h: [] }, ) end

defevent_params

params.fetch(:event,{}).permit(

# ...

{started_at_h:[]},

)

end

テストコードも書いてみる

モデルのstarted_at_hについてテストコードも書きました。
こちらもこれで良いのかよく分からないので参考程度にご覧ください。

 require 'rails_helper' RSpec.describe Event, type: :model do describe '#started_at_h' do let(:event) { FactoryGirl.build(:event) } context 'when set params' do it 'ハッシュが渡されればその日付のDateTimeが返る' do params = { 'date' => '2018-01-14', 'time' => '10:06' } event.started_at_h = params expect(event.started_at.strftime('%Y-%m-%d %H-%M')).to eq DateTime.new(2018, 1, 14, 10, 6).strftime('%Y-%m-%d %H-%M') end it 'ハッシュが渡されなければ本日のDateTimeが返る' do params = {} event.started_at_h = params # 時間がずれてテストがコケる可能性があるので日付だけ比較 expect(event.started_at.strftime('%Y-%m-%d')).to eq Time.zone.now.strftime('%Y-%m-%d') end end context 'when get params' do it '対象の日付が空であれば、空で返る' do event.started_at = '' expect_param = { 'date' => '', 'time' => '' } expect(event.started_at_h).to eq expect_param end it 'すでに値がセットされていれば、その日付のハッシュが返る' do time = Time.zone.now event.started_at = time expect_param = { 'date' => time.strftime('%Y-%m-%d'), 'time' => time.strftime('%H-%M') } expect(event.started_at_h).to eq expect_param end end end end

require'rails_helper'

RSpec.describe Event,type::model do

describe'#started_at_h'do

let(:event){FactoryGirl.build(:event)}

context'when set params'do

it'ハッシュが渡されればその日付のDateTimeが返る'do

params={'date'=>'2018-01-14','time'=>'10:06'}

event.started_at_h=params

expect(event.started_at.strftime('%Y-%m-%d %H-%M')).toeq DateTime.new(2018,1,14,10,6).strftime('%Y-%m-%d %H-%M')

end

it'ハッシュが渡されなければ本日のDateTimeが返る'do

params={}

event.started_at_h=params

# 時間がずれてテストがコケる可能性があるので日付だけ比較

expect(event.started_at.strftime('%Y-%m-%d')).toeq Time.zone.now.strftime('%Y-%m-%d')

end

context'when get params'do

it'対象の日付が空であれば、空で返る'do

event.started_at=''

expect_param={'date'=>'','time'=>''}

expect(event.started_at_h).toeq expect_param

end

it'すでに値がセットされていれば、その日付のハッシュが返る'do

time=Time.zone.now

event.started_at=time

expect_param={'date'=>time.strftime('%Y-%m-%d'),'time'=>time.strftime('%H-%M')}

expect(event.started_at_h).toeq expect_param

end

さいごに

今回の件に対する良い対応なのかは分かりませんが、一例としてご覧いただければ嬉しく思います。
また、もし他に良い方法があればご教授いただきたく思います。

日	月	火	水	木	金	土
	1	2	3	4	5	6
7	8	9	10	11	12	13
14	15	16	17	18	19	20
21	22	23	24	25	26	27
28	29	30	31

[Rails + Materialize] DateTimePickerがなかったので…

はじめに

前提条件

ビューのイメージ

モデルにゲッターとセッターを追加

入力フォームに追加

JSファイルにて使用宣言

HTML

コントローラーのストロングパラメータを修正

テストコードも書いてみる

さいごに

フォロー

アプリ情報