bullet_train 1.30.0 → 1.30.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2b557b6927fba1606682c07f0fe0cb44e37e02a1051974ed6bf88ef9bd3234e6
-  data.tar.gz: 5ee2949f57d715683f3a3e5091c042fdc4be4c6e51669b3301c5654a072bb48d
+  metadata.gz: d9f6244b94a762526cb882b252268da769b8a57128a9c14146e8f59f02b4458b
+  data.tar.gz: 77aaadf410ce7bdc6fe99f84e3683e537b0c7699e57186f0f0729d23e42b1978
 SHA512:
-  metadata.gz: d3cc899b2d9b984608847279d380891c948a635ec92829b931369cc6ce7e1a3ca4e75df95e49c629a1fa17a6d163b95becd351d88a7e23d7e406aa45100cb2ca
-  data.tar.gz: e11f8580c554efe009775ba1bc18ac77bf03e58a5a69c8a667de6c24bb31c1f941c65f64e5ffd0dd1daca3c34981c8f6aebf6bfd94a3c590dd35d1990eebac92
+  metadata.gz: b28b0737f177702aea10af4e93180458d5ae7b7b731d5f7925042287ee376872b99b0a9816457d52c0eecd7e8e99d4fae962466104c004db30c92c49517f9eab
+  data.tar.gz: 609d5613617adb5819c61c2fe076126f1cff5a53074e254de6a622dcde0133c6ea1248ec3c0284acfa9e515fadcf4f05478058336066b8eab461e8487c4680da

data/docs/super-scaffolding/sortable.md

@@ -180,10 +180,10 @@ Using the example of a sortable `Page` model from above you'll want to update tw
 
 ### `app/views/account/pages/_page.html.erb`
 
-In `app/views/account/pages/_page.html.erb` you should add a `<td>` as the first cell in the `<tr>`. Be sure to include `data-sortable-target="handle"` on the cell so that the controller recognizes it as a handle.
+In `app/views/account/pages/_page.html.erb` you should add a `class="group"` attribute to the `<tr>`, and add a `<td>` containing a drag handle as the first cell inside the `<tr>`. Be sure to include `data-sortable-target="handle"` on the cell so that the controller recognizes it as a handle.
 
 ```html
-<tr data-id="<%= page.id %>">
+<tr data-id="<%= page.id %>" class="group"> <!-- Add the class attribute on this line! -->
     <td class="cursor-grab active:cursor-grabbing" data-sortable-target="handle"><i class="ti ti-menu opacity-25 group-hover:opacity-100"></i></td> <!-- Add this line! -->
     <!-- Your existing cells here -->
 </tr>
@@ -202,4 +202,39 @@ In `app/views/account/pages/_index.html.erb` you should add an empty `<td>` as t
 </thead>
 ```
 
+## Drag styling
 
+The visual styling of dragged items and drop targets is handled by the addition and removal of specific class names by the controller.
+
+To override the default styles you could write some custom CSS like this:
+
+```css
+  .sortable-active-dropzone {
+    /* Styles for the entire table when a drag is in progress. */
+  }
+
+  .sortable-active-item {
+    /* Styles for the item that is being dragged. */
+  }
+
+  .sortable-drop-target {
+    /* Styles for the empty space representing the new location for the item being dragged. */
+  }
+```
+
+Any styles you add to those classes will be combined with the defaults.
+
+If you'd like to start fresh with a clean set of classes you can tell the controller to use different class names by adding some data attributes to the primary `sortable` target (the `<tbody>` tag by default).
+
+For instance:
+
+```erb
+<tbody data-controller="sortable" data-sortable-reorder-path-value="<%= url_for [:reorder, :account, context, collection] %>"
+
+       <%# Use Stimulus class attributes to make the controller apply different class names: %>
+       data-sortable-active-dropzone-class="your-custom-active-dropzone-class-name"
+       data-sortable-active-item-class="your-custom-active-item-class-name"
+       data-sortable-drop-target-class="your-custom-drop-target-class-name"
+
+>
+```

data/lib/bullet_train/version.rb

@@ -1,3 +1,3 @@
 module BulletTrain
-  VERSION = "1.30.0"
+  VERSION = "1.30.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: bullet_train
 version: !ruby/object:Gem::Version
-  version: 1.30.0
+  version: 1.30.1
 platform: ruby
 authors:
 - Andrew Culver