rails_notion_like_multiselect 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: eba5478c36b1c52c1ad52b5b3fecb134f13f129a7fb73528f0df01f1a3a088ba
-  data.tar.gz: 20d97d8df49ddcb71b1b773959cd3f863b784bea06343b20b2ea5b33ee0eae2c
+  metadata.gz: e99bd8d6c2dd51ca270fa203e6f7ef9dbf7f5dee8e651de45127e548f9e18ef7
+  data.tar.gz: 6cb8d559d809f3ee124eb28dd5511f57ba98d4452fe74b720198029ec5ffc61e
 SHA512:
-  metadata.gz: 84346ab6b7bf5a8389e89abb6a6b1660837c3da90a48e0dd34045f110fc841a0f63e80a205d75996f51dc7288668ab02e3a2f57652e8f0e3f13de02696966161
-  data.tar.gz: 95fed342d1ff2045deec03ec2e2c292284e26ce1108fd37f05dc41fd01f87c3c4147a1e63bc1bb6d880dd4762a7fda721aae7838b23984620effc71e61359b05
+  metadata.gz: ad3946fdb3dd98c00be6a078dfede6d8f3d68526929dfd3baab054f99fa98a60617b26486ca9587f6ab16fd06832222e9f69f67a7d8c60139956cc7a1e9e77b7
+  data.tar.gz: 704516ab3dcb262260573e4870f85520ff361b4b374a96548c8e46121f77fd9407b4b9af2571f3dc3c36d1873baa22be013d4bc1dafaff96df1dd009f580d6d8

data/CHANGELOG.md

@@ -5,6 +5,24 @@ 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.2.0] - 2025-09-25
+
+### Added
+- Added `value_method` and `text_method` options for flexible attribute handling
+- Support for objects with custom attribute names (e.g., `slug` instead of `id`, `title` instead of `name`)
+- Enhanced documentation with examples for different data formats
+
+### Enhanced
+- Improved `extract_item_data` method to handle configurable attribute methods
+- Better support for hash formats with custom keys
+- Maintained backward compatibility with existing `id`/`name` defaults
+
+### Use Cases Supported
+- ActiveRecord objects with any attribute names: `value_method: :slug, text_method: :title`
+- Simple string arrays that return selected strings as-is
+- Hash formats with custom keys
+- Mixed data formats in the same collection
+
 ## [0.1.1] - 2025-09-25
 
 ### Fixed

data/README.md

@@ -201,6 +201,55 @@ For server-side creation of new items:
 ) %>
 ```
 
+### With Custom Attributes
+
+For objects with custom attribute names:
+
+```erb
+<!-- Using objects with slug/title instead of id/name -->
+<%= multiselect_field(
+  form,
+  :category_slugs,
+  collection: @categories,           # Objects with .slug and .title methods
+  selected: @game.categories,        # Selected objects
+  value_method: :slug,               # Use slug for the value
+  text_method: :title,               # Use title for display text
+  label: "Categories"
+) %>
+
+<!-- Using hash format with custom keys -->
+<%= multiselect_field(
+  form,
+  :author_ids,
+  collection: [
+    { author_id: 1, full_name: 'John Doe' },
+    { author_id: 2, full_name: 'Jane Smith' }
+  ],
+  selected: [{ author_id: 1, full_name: 'John Doe' }],
+  value_method: :author_id,          # Use author_id for the value
+  text_method: :full_name,           # Use full_name for display text
+  label: "Authors"
+) %>
+```
+
+### With Simple Strings
+
+For simple string arrays:
+
+```erb
+<!-- Strings as both value and display text -->
+<%= multiselect_field(
+  form,
+  :skills,
+  collection: ["Ruby", "JavaScript", "Python", "Go"],
+  selected: ["Ruby", "JavaScript"],
+  allow_create: true,
+  label: "Skills"
+) %>
+
+<!-- Selected values will be the strings themselves: ["Ruby", "JavaScript"] -->
+```
+
 ## Options
 
 | Option         | Type    | Default                 | Description                            |
@@ -215,6 +264,8 @@ For server-side creation of new items:
 | `api_endpoint` | String  | `nil`                   | API endpoint for server-side creation  |
 | `help_text`    | String  | `nil`                   | Help text below the field              |
 | `theme`        | String  | `"auto"`                | Theme mode: "light", "dark", or "auto" |
+| `value_method` | Symbol  | `:id`                   | Method to call for the value/id        |
+| `text_method`  | Symbol  | `:name`                 | Method to call for display text        |
 
 ## Keyboard Shortcuts
 

data/lib/rails_notion_like_multiselect/helpers/multiselect_helper.rb

@@ -18,6 +18,8 @@ module RailsNotionLikeMultiselect
       # @option options [String] :api_endpoint API endpoint for creating new items
       # @option options [String] :help_text Help text to display below the field
       # @option options [String] :theme Theme mode ('light', 'dark', or 'auto')
+      # @option options [Symbol] :value_method Method to call for the value/id (default: :id for objects, self for strings)
+      # @option options [Symbol] :text_method Method to call for display text (default: :name for objects, self for strings)
       #
       def multiselect_field(form, field, options = {})
         collection = options[:collection] || []
@@ -30,6 +32,8 @@ module RailsNotionLikeMultiselect
         api_endpoint = options[:api_endpoint]
         help_text = options[:help_text]
         theme = options[:theme] || 'auto'
+        value_method = options[:value_method] || :id
+        text_method = options[:text_method] || :name
         input_name = "#{form.object_name}[#{field}][]"
 
         # Determine theme-specific classes based on theme option
@@ -155,8 +159,7 @@ module RailsNotionLikeMultiselect
                                               data: { rails_notion_multiselect_target: 'selectedItems' },
                                               class: 'flex flex-wrap gap-1.5 items-center' do
               selected.map do |item|
-                item_id = item.respond_to?(:id) ? item.id.to_s : item.to_s
-                item_name = item.respond_to?(:name) ? item.name : item.to_s
+                item_id, item_name = extract_item_data(item, value_method, text_method)
 
                 content_tag :span,
                             class: badge_classes,
@@ -221,10 +224,9 @@ module RailsNotionLikeMultiselect
                         data: { rails_notion_multiselect_target: 'optionsList' },
                         class: 'max-h-60 overflow-auto py-1' do
               collection.map do |item|
-                item_id = item.respond_to?(:id) ? item.id.to_s : item.to_s
-                item_name = item.respond_to?(:name) ? item.name : item.to_s
+                item_id, item_name = extract_item_data(item, value_method, text_method)
                 is_selected = selected.any? { |s| 
-                  s_id = s.respond_to?(:id) ? s.id.to_s : s.to_s
+                  s_id, _ = extract_item_data(s, value_method, text_method)
                   s_id == item_id
                 }
 
@@ -258,7 +260,7 @@ module RailsNotionLikeMultiselect
           hidden_inputs_html = content_tag :div, data: { rails_notion_multiselect_target: 'hiddenInputs' } do
             if selected.any?
               selected.map do |item|
-                item_id = item.respond_to?(:id) ? item.id.to_s : item.to_s
+                item_id, _ = extract_item_data(item, value_method, text_method)
                 tag.input(type: 'hidden', name: input_name, value: item_id)
               end.join.html_safe
             else
@@ -282,6 +284,26 @@ module RailsNotionLikeMultiselect
 
           label_html + input_container_html + dropdown_html + hidden_inputs_html + help_text_html
         end
+
+        # Extracts id and name from various item formats (objects, hashes, strings)
+        # Returns [id, name] as strings
+        # @param item [Object] The item to extract data from
+        # @param value_method [Symbol] Method to call for the value/id
+        # @param text_method [Symbol] Method to call for display text
+        def extract_item_data(item, value_method = :id, text_method = :name)
+          if item.respond_to?(value_method) && item.respond_to?(text_method)
+            # ActiveRecord object or similar with custom methods
+            [item.send(value_method).to_s, item.send(text_method).to_s]
+          elsif item.is_a?(Hash)
+            # Hash with symbol or string keys
+            id = item[value_method] || item[value_method.to_s] || item[:id] || item['id']
+            name = item[text_method] || item[text_method.to_s] || item[:name] || item['name']
+            [id.to_s, name.to_s]
+          else
+            # Fallback - treat as string/number (both value and display are the same)
+            [item.to_s, item.to_s]
+          end
+        end
       end
     end
   end

data/lib/rails_notion_like_multiselect/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module RailsNotionLikeMultiselect
-  VERSION = "0.1.1"
+  VERSION = "0.2.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rails_notion_like_multiselect
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
 platform: ruby
 authors:
 - Sulman Baig