stimulus_rails_datatables 0.4.0 → 0.5.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 33857a74b843142081e2c836a7ca6b9ea3478b5de62c641397de780174b3365c
-  data.tar.gz: fc7ceebc44032ec83db84357e9472c981c011f927581d051c5ed75d9de2785a1
+  metadata.gz: bbb9263b496e3deed5f28f35c19530d54cdc311a032da2eeeefb60c0c9dfa07d
+  data.tar.gz: 613bcfbd3ce0dd842d0bf1a3067b91ddb24cb5d773340726ae2851cd17040a15
 SHA512:
-  metadata.gz: 496590e1f982a96b81f0c65e4ae6f577f82b9d59bb3a6638e294a3fbeff96d391e92552b1f352316e4864f3c8a70fe4846bf01ae6cd955f046818b111e88d0f7
-  data.tar.gz: 886217d0aab41163e3d282e80c9144ada0f4b025f190753ce95c76fbfb9294ea65791ee1b078f75391b5a0e38b1bef4b4d7d71b4857223969fe20415903cb752
+  metadata.gz: 5619dd1eff78003687b588989cad96c353f52309eb184830764a5a42504033a61b5832bfc31fce8ef3fc856af7c4df30ebebc6554c3cfc1bb041b8a8b1c73ca7
+  data.tar.gz: d24f5d85abafab0b8dd73fd9ca3be0832efad5bdfc60caa98b2f0aa44990390792211432a46124ec6169fc54474787477dcbcb3e3fe282190c9b8d29fe1b6244

data/CHANGELOG.md

@@ -5,6 +5,70 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.5.1] - 2026-07-28
+
+### Changed
+- Updated system dependencies
+- Bumped concurrent-ruby, erb, json, loofah, net-imap, parser, rails-html-sanitizer, and rubocop; updated Bundler version
+
+## [0.5.0] - 2026-06-08
+
+### Added
+- Additional data handling for DataTables, with the JavaScript controller now dispatching additional-data events
+- Updated README with usage details for the new additional data events
+
+## [0.4.0] - 2026-06-05
+
+### Added
+- Custom header support in the DataTable helper
+- Support for dependent location filters, with enhancements to the filter controller
+
+## [0.3.1] - 2026-01-14
+
+### Changed
+- Updated the filter controller's local storage handling
+
+## [0.3.0] - 2026-01-09
+
+### Added
+- `set_value` option for filters, allowing programmatic selection of filter values
+
+## [0.2.3] - 2025-12-17
+
+### Changed
+- Enhanced DataTables configuration handling and updated installation instructions
+
+## [0.2.2] - 2025-12-17
+
+### Fixed
+- Fixed initializer for ActionController loading in the Engine
+
+## [0.2.1] - 2025-12-02
+
+### Added
+- `scrollX` and `stateSave` configuration options for datatables
+
+## [0.2.0] - 2025-12-01
+
+### Added
+- `scroll_x` option support
+
+## [0.1.3] - 2025-11-25
+
+### Added
+- `state_save` option to the `datatable_for` helper method
+
+## [0.1.2] - 2025-11-11
+
+### Changed
+- Refactored DataTable initialization to use custom options and added a draw callback event
+- Set a global DataTables default for `orderSequence`
+
+## [0.1.1] - 2025-11-09
+
+### Added
+- Support for overriding DataTables configuration via a generated config file
+
 ## [0.1.0] - 2025-11-09
 
 ### Added

data/README.md

@@ -96,7 +96,7 @@ Pass a block to render custom HTML in the column header instead of using `title:
       label: 'name',
       value: 'id',
       placeholder: 'Select Role',
-      set_value: 1 
+      set_value: 1
     }
   ) %>
 
@@ -233,6 +233,40 @@ class UserDatatable < StimulusRailsDatatables::BaseDatatable
 end
 ```
 
+### Additional Data
+
+You can return extra fields alongside the standard DataTables JSON response by defining `additional_data` in your datatable class. This is useful for displaying aggregate stats (e.g. counts, totals) that are scoped to the current filtered result set.
+
+```ruby
+class OrdersDatatable < StimulusRailsDatatables::BaseDatatable
+  def additional_data
+    { unread_orders_count: get_raw_records.where(is_read: false).count }
+  end
+
+  # ...
+end
+```
+
+Any element with a `data-datatable-field` attribute matching a key from `additional_data` will have its text content updated automatically after every draw (page change, sort, filter):
+
+```html
+<span data-datatable-field="unread_orders_count">0</span> unread orders
+```
+
+When you have **multiple datatables on the same page**, scope the element to a specific table using `data-for-datatable`:
+
+```html
+<span data-datatable-field="unread_orders_count" data-for-datatable="orders-table">0</span>
+```
+
+You can also listen for the `datatable:additional-data` event for custom JavaScript handling:
+
+```javascript
+document.addEventListener('datatable:additional-data', (e) => {
+  console.log(e.detail) // { unread_orders_count: 5 }
+})
+```
+
 ### JavaScript API
 
 ```javascript

data/app/assets/javascripts/stimulus_rails_datatables/datatables_controller.js

@@ -127,6 +127,34 @@ export default class extends Controller {
             detail: { table: appDataTable }
           }))
         })
+
+        // Dispatch additional_data returned by the server alongside standard DataTables fields
+        const STANDARD_DT_KEYS = new Set(['draw', 'recordsTotal', 'recordsFiltered', 'data', 'error'])
+        appDataTable.on('xhr', (_e, _settings, json) => {
+          if (!json) return
+          const additionalData = Object.fromEntries(
+            Object.entries(json).filter(([key]) => !STANDARD_DT_KEYS.has(key))
+          )
+          if (Object.keys(additionalData).length === 0) return
+
+          // Dispatch event so consumers can react programmatically
+          this.element.dispatchEvent(new CustomEvent('datatable:additional-data', {
+            bubbles: true,
+            detail: additionalData
+          }))
+
+          // Auto-update elements: <span data-datatable-field="unread_orders_count">
+          // Scope with optional data-for-datatable="<id>" to support multiple tables per page
+          // Single DOM query for all field elements, then group by field name to avoid N queries per key
+          document.querySelectorAll('[data-datatable-field]').forEach(el => {
+            const key = el.dataset.datatableField
+            if (!(key in additionalData)) return
+            const forId = el.dataset.forDatatable
+            if (!forId || forId === datatableId) {
+              el.textContent = additionalData[key]
+            }
+          })
+        })
       }
     }
 

data/lib/stimulus_rails_datatables/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module StimulusRailsDatatables
-  VERSION = '0.4.0'
+  VERSION = '0.5.1'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: stimulus_rails_datatables
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.1
 platform: ruby
 authors:
 - Den Meralpis
@@ -141,7 +141,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.10
+rubygems_version: 4.0.16
 specification_version: 4
 summary: Rails integration for DataTables with filters and remote data support
 test_files: []