yummy-guide-generic-administrate 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7a900e85ac77c86b162da45de406b17c80f1aa18340da95f6d02ac45ca8ce259
-  data.tar.gz: 80d5fca1e0d8248f26906395613ff1974b0704d306cece30985f2ebf954a7b67
+  metadata.gz: 82f8a49b6cf64da8e522b0290770f402b7f387ba989d5e38ff0d17232b8a7ff2
+  data.tar.gz: '0648859c41c97f9bf5d6a5bef998fca7e8685a2a5b5d617bfbd1830d75d08fa9'
 SHA512:
-  metadata.gz: 105bcc475d2ac342e51ff9765dda3ca8e3709949a1b72d471182ec90c6a3df1fe17bc014a09bce4ef27f4976e0dddc41d2457ea4b2b8424345a5cb4a24c69cfe
-  data.tar.gz: afca6ea454ec4ddb804234954df68ab30790a58bc109a8555afaab9d012fd480aed5c3cff3d749cd5ca001851d10a0d788f82180821877f60be0ef83fcd1d155
+  metadata.gz: 8e7752a04124f92bd2abdbb7d6f5e16284c593ff33166cd9429a202146ea0de5ca35e812c80bf69bb96eb1b1179daec5584ba66fa0c55fd9bc8921c78a072aef
+  data.tar.gz: 6d109d78f58cc76f4d125a6027aa28f4d048c0c3233b97b0b5c244edab96757f5c20c078461ca5975b6cf3cc3af5a32030bdd87563de9d38aa11167d31d57060

data/README.md

@@ -41,11 +41,14 @@ bundle install
   - 一覧テーブルの固定列数、リンク生成、action partial 解決を補助する helper
 - `YummyGuide::Administrate::FilterFormHelper`
   - datetime フィルターや checkbox group の組み立てを補助する helper
+- `YummyGuide::Administrate::DatetimeInputHelper`
+  - 管理画面フォーム用の date + time 入力 helper
 - 共通 partial / assets
   - collection partial
   - fixed table header partial
   - filter form partial
   - `clipboards.js`
+  - `datetime_input.js`
   - `fixed_submit_actions.js`
   - `filter_form.js`
   - `sticky_left_columns.js`
@@ -97,6 +100,7 @@ class Admin::ApplicationController < Administrate::ApplicationController
   include YummyGuide::Administrate::DatetimeFilterParameters
 
   helper YummyGuide::Administrate::CollectionHelper
+  helper YummyGuide::Administrate::DatetimeInputHelper
   helper YummyGuide::Administrate::FilterFormHelper
 end
 ```
@@ -171,7 +175,8 @@ gem には専用 partial があります。
 
 この slot を置かない場合でも、JS が table の直前に自動生成します。配置を制御
 したいときだけ明示してください。desktop では LMJ と同じく、`main-content__body--flush`
-と組み合わせることで fixed header のクリップ幅が一覧 body と揃います。
+と組み合わせることで fixed header のクリップ幅が一覧 body と揃い、一覧 wrapper
+自体には縦スクロールを持たせません。
 
 #### 3. 自前の table partial を使う場合
 
@@ -239,6 +244,39 @@ filter form の枠と datetime 入力 partial を組み合わせて利用でき
 <% end %>
 ```
 
+### Datetime input helper
+
+通常フォームで日付と時刻を分けた入力 UI を使う場合は、`DatetimeInputHelper`
+を読み込んで `admin_datetime_*` helper を使います。既存の LMJ 互換として、
+helper 名は `admin_` prefix のまま提供しています。
+
+```erb
+<%= admin_datetime_field_tag(
+      "coupon[expiration_date]",
+      @coupon.expiration_date,
+      required: true,
+      default_current_time: @coupon.new_record?
+    ) %>
+
+<%= admin_split_datetime_field_tag(
+      date_name: "coupon[expiration_date_date]",
+      hour_name: "coupon[expiration_date_hour]",
+      minute_name: "coupon[expiration_date_minute]",
+      value: @coupon.expiration_date
+    ) %>
+
+<%= admin_date_and_time_field_tag(
+      date_name: "reservation_task[due_date_on]",
+      time_name: "reservation_task[due_time]",
+      value: @reservation_task.due_at
+    ) %>
+
+<%= admin_time_field_tag("option[valid_from_time]", @option.valid_from_time) %>
+```
+
+`datetime_input.js` は visible な date / time 入力と hidden の送信値を同期し、
+不正な日付や時刻の submit を抑止します。
+
 controller 側では、必要な filter key を指定して datetime パラメータを正規化します。
 
 ```ruby
@@ -261,6 +299,7 @@ end
 
 ```js
 //= require yummy_guide_administrate/clipboards
+//= require yummy_guide_administrate/datetime_input
 //= require yummy_guide_administrate/fixed_submit_actions
 //= require yummy_guide_administrate/filter_form
 //= require yummy_guide_administrate/sticky_left_columns