advanced_select 0.1.4 → 0.1.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9be8d05d537d5e36a565546c0f821c68a6a62cd5e3978cbbe23d3ef7451c1f2a
-  data.tar.gz: c6c4c0667ef096fd55e57024621eb9a21d2338ecbef2c2305e2bf2edab0fad4d
+  metadata.gz: 12aa609bf191df8feb5cdbcbe6c56052cf1e41737bd87d4122b99d65d8788009
+  data.tar.gz: d49f89a642d10f28aa141c6ef7728335adbc5168fef7f3ba6aba828f164b2477
 SHA512:
-  metadata.gz: 492cee1cf22c71e9c6e328052bb3ff7c49d519816c06ebe8610f2c0d07d2cbcfd9ebe09383ac3a69e696497295a34015aa467f004d46e40194ae4cc7d7538473
-  data.tar.gz: 65b3749af47dc024f475284c0998657190f5c68c27da5578d93dfd35669a4eb9c319d3b1b6df1a07fb16157eb0f8897ed4154ab7b54f5e49d8ad7dda3d1bec84
+  metadata.gz: 53132d110065de787848345926574700a2cc2a4b8666d4e0f740c85f4a552950f268378e9aa73d04e1b404612e481f1c364fd3a07cd5a397dfff3c18b6d78122
+  data.tar.gz: 3e07f94cffddcdbdeb08576c54903ff5d1a5498db40224f5341a5826c3bacbcad59c9fb5254ccbf36449254702102681c16a6547ff9acc4f0e613bb08c72fe94

data/README.md

@@ -16,6 +16,8 @@ AdvancedSelect is a small Rails engine for rendering an advanced select input wi
 - [Basic Local Select](#basic-local-select)
 - [Remote Search](#remote-search)
 - [Multiple Select](#multiple-select)
+- [Count Summary](#count-summary)
+- [Selection Tooltip](#selection-tooltip)
 - [Add Mode](#add-mode)
 - [Dependent Fields](#dependent-fields)
 - [Custom Option Content](#custom-option-content)
@@ -75,7 +77,7 @@ AdvancedSelect does not provide query objects, model concerns, authorization log
 Add the gem to the host Rails app:
 
 ```ruby
-gem "advanced_select", "~> 0.1.4"
+gem "advanced_select", "~> 0.1.5"
 ```
 
 Run the installer:
@@ -428,6 +430,91 @@ Pass `include_hidden: false` to opt out — for example, when your controller re
 ) %>
 ```
 
+### Count Summary
+
+By default a multiple select collapses its trigger to the first two selected labels plus an `& +N` token. For long selections — or when the detail belongs in a [tooltip](#selection-tooltip) — pass `summary_mode: :count` to render a single `"N selected"` label instead:
+
+```erb
+<%= advanced_select_tag(
+  "record[item_ids][]",
+  id: "record_item_ids",
+  selected: selected_options,
+  options: options,
+  placeholder: t(".items_placeholder"),
+  multiple: true,
+  summary_mode: :count
+) %>
+```
+
+The label text comes from the `shared.advanced_select.selected_count` translation (`"%{count} selected"`), so override it per locale to localize or reword it. `summary_mode` only affects multiple selects; single selects always show the selected label.
+
+### Selection Tooltip
+
+Multiple selects can show an optional tooltip when the user hovers the trigger — handy together with `summary_mode: :count`, where the trigger only shows a count and the tooltip reveals the detail. The tooltip is hover-driven (no info icon) and is positioned with CSS below the trigger.
+
+Pass `tooltip: true` for a built-in list of the selected display labels:
+
+```erb
+<%= advanced_select_tag(
+  "record[item_ids][]",
+  id: "record_item_ids",
+  selected: selected_options,
+  options: options,
+  placeholder: t(".items_placeholder"),
+  multiple: true,
+  summary_mode: :count,
+  tooltip: true
+) %>
+```
+
+The built-in list stays in sync as the selection changes on the client.
+
+For richer layouts — a table, badges, compatibility columns, etc. — pass `tooltip_partial:` instead. The partial receives `selected_options` and `options` as locals and may render any markup:
+
+```erb
+<%= advanced_select_tag(
+  "record[alternative_ids][]",
+  id: "record_alternative_ids",
+  selected: selected_options,
+  options: options,
+  placeholder: t(".alternatives_placeholder"),
+  multiple: true,
+  summary_mode: :count,
+  tooltip_partial: "alternatives/tooltip"
+) %>
+```
+
+The partial is rendered on the server for the initial selection, and the controller keeps it in sync client-side as the selection changes — no Turbo Stream round-trip. To opt in, mark the row container and provide a one-row `<template>` the controller clones per selected option:
+
+- `data-advanced-select-tooltip-list` on the element that holds the rows (the same hook the built-in list uses).
+- `<template data-advanced-select-tooltip-template>` containing the markup for a single selected row.
+- `data-advanced-select-tooltip-field="…"` on the elements inside the template that should be filled in. Available fields are `id`, `value`, `label`, and `display_label`; values are written with `textContent` (text only, no markup).
+
+```erb
+<%# app/views/alternatives/_tooltip.html.erb %>
+<table>
+  <thead>
+    <tr><th>Code &amp; Name</th><th>Type</th></tr>
+  </thead>
+  <tbody data-advanced-select-tooltip-list>
+    <% selected_options.each do |option| %>
+      <tr>
+        <td><%= option.fetch(:display_label) %></td>
+        <td><%= option.fetch(:value) %></td>
+      </tr>
+    <% end %>
+  </tbody>
+  <template data-advanced-select-tooltip-template>
+    <tr>
+      <td data-advanced-select-tooltip-field="display_label"></td>
+      <td data-advanced-select-tooltip-field="value"></td>
+    </tr>
+  </template>
+</table>
+```
+
+The initial server-rendered rows stay until the first change, then the controller rebuilds them from the template — so just like `tooltip: true`, the custom tooltip updates client-side automatically. A custom partial without a `<template>` still renders once and stays static, which is fine for display-only content.
+
 ### Add Mode
 
 Set `add_mode: true` when users may submit a new typed value:
@@ -675,12 +762,19 @@ advanced_select_tag(
   include_hidden: true,
   auto_select_single: true,
   eager: true,
+  summary_mode: :tokens,
+  tooltip: false,
+  tooltip_partial: nil,
   option_content_partial: nil,
   classes: {},
   append_classes: {}
 )
 ```
 
+`summary_mode:` controls how a multiple select renders its collapsed trigger label. The default `:tokens` shows the first two selected display labels followed by `& +N`. Pass `:count` to render a single localized `"N selected"` summary instead (see [Count Summary](#count-summary)).
+
+`tooltip:` / `tooltip_partial:` enable an optional hover tooltip on the trigger (see [Selection Tooltip](#selection-tooltip)).
+
 `advanced_select_options_tag`:
 
 ```ruby
@@ -738,8 +832,12 @@ shared:
     empty: "No options found"
     error: "Options could not be loaded"
     loading: "Loading..."
+    search_placeholder: "Search..."
+    selected_count: "%{count} selected"
 ```
 
+`selected_count` is used by the [count summary](#count-summary) (`summary_mode: :count`).
+
 Override these keys in the host app as needed.
 
 ## Styling
@@ -851,6 +949,7 @@ Common styling hooks:
 
 - `.ui-advanced-select-trigger` controls the visible input button, border, radius, height, background, and focus outline.
 - `.ui-advanced-select-dropdown` controls the popup container, border, radius, shadow, width, and `z-index`.
+- `.ui-advanced-select-tooltip`, `.ui-advanced-select-tooltip-list`, and `.ui-advanced-select-tooltip-item` control the optional [selection tooltip](#selection-tooltip) container and its built-in list. The tooltip is positioned with CSS (`position: absolute` below the trigger); adjust `top`, `min-width`, or `z-index` here if your layout needs it.
 - `.ui-advanced-select-options` controls the scroll container and default `max-height`.
 - `.ui-advanced-select-option` controls option row spacing, hover state, and font sizing.
 - `.ui-advanced-select-option[aria-selected="true"]` controls selected option colors.

data/app/assets/stylesheets/advanced_select/advanced_select.css

@@ -101,6 +101,40 @@
   z-index: 20;
 }
 
+.ui-advanced-select-tooltip {
+  background: #ffffff;
+  border: 1px solid #e5e7eb;
+  border-radius: 0.75rem;
+  box-shadow: 0 10px 15px -3px rgb(0 0 0 / 0.1), 0 4px 6px -4px rgb(0 0 0 / 0.1);
+  box-sizing: border-box;
+  color: #374151;
+  font-size: 0.875rem;
+  left: 0;
+  line-height: 1.25rem;
+  margin-top: 0.25rem;
+  min-width: 100%;
+  padding: 0.75rem 1rem;
+  position: absolute;
+  top: 100%;
+  width: max-content;
+  z-index: 30;
+}
+
+.ui-advanced-select-tooltip-list {
+  display: flex;
+  flex-direction: column;
+  gap: 0.25rem;
+  list-style: none;
+  margin: 0;
+  padding: 0;
+}
+
+.ui-advanced-select-tooltip-item {
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
 .ui-advanced-select-search {
   border: 1px solid #e5e7eb;
   border-radius: 0.5rem;

data/app/javascript/advanced_select/advanced_select_controller.js

@@ -2,7 +2,7 @@ import { Controller } from "@hotwired/stimulus"
 import { Turbo } from "@hotwired/turbo-rails"
 
 export default class extends Controller {
-  static targets = ["hiddenFields", "trigger", "summary", "dropdown", "search", "options", "caret", "clear"]
+  static targets = ["hiddenFields", "trigger", "summary", "dropdown", "search", "options", "caret", "clear", "tooltip"]
   static values = {
     addMode: Boolean,
     autoSelectSingle: { type: Boolean, default: true },
@@ -19,6 +19,8 @@ export default class extends Controller {
     placeholder: String,
     searchable: Boolean,
     selected: Array,
+    selectedCountText: String,
+    summaryMode: { type: String, default: "tokens" },
     targetId: String,
     url: String
   }
@@ -30,6 +32,7 @@ export default class extends Controller {
     this.placeholderClass = this.element.dataset.advancedSelectPlaceholderClass || "ui-advanced-select-placeholder"
     this.valueClass = this.element.dataset.advancedSelectValueClass || "ui-advanced-select-value"
     this.tokenClass = this.element.dataset.advancedSelectTokenClass || "ui-advanced-select-token"
+    this.tooltipItemClass = this.element.dataset.advancedSelectTooltipItemClass || "ui-advanced-select-tooltip-item"
     this.loadingClass = this.element.dataset.advancedSelectLoadingClass || "ui-advanced-select-loading"
     this.errorClass = this.element.dataset.advancedSelectErrorClass || "ui-advanced-select-error"
     this.emptyClass = this.element.dataset.advancedSelectEmptyClass || "ui-advanced-select-empty"
@@ -48,6 +51,7 @@ export default class extends Controller {
 
   disconnect() {
     window.clearTimeout(this.timer)
+    window.clearTimeout(this.tooltipHideTimer)
     document.removeEventListener("click", this.close)
 
     if (this.dependentChangeListener) {
@@ -66,6 +70,7 @@ export default class extends Controller {
   }
 
   open() {
+    this.hideTooltip(true)
     this.dropdownTarget.classList.remove("hidden")
     this.triggerTarget.setAttribute("aria-expanded", "true")
     document.addEventListener("click", this.close)
@@ -302,6 +307,7 @@ export default class extends Controller {
   renderSelection() {
     this.hiddenFieldsTarget.replaceChildren(...this.hiddenFieldElements)
     this.summaryTarget.replaceChildren(...this.selectionElements)
+    this.renderTooltip()
     this.renderOptionsState()
     this.caretTarget.classList.toggle("hidden", this.selectedValue.length > 0)
     this.clearTarget.classList.toggle("hidden", this.selectedValue.length === 0)
@@ -471,6 +477,10 @@ export default class extends Controller {
       return [this.textElement("span", this.valueClass, this.displayLabel(this.selectedValue[0]))]
     }
 
+    if (this.summaryModeValue === "count") {
+      return [this.textElement("span", this.valueClass, this.selectedCountLabel(this.selectedValue.length))]
+    }
+
     const tokens = this.selectedValue.slice(0, 2).map((option) => this.textElement("span", this.tokenClass, this.displayLabel(option)))
 
     if (this.selectedValue.length > 2) {
@@ -480,10 +490,123 @@ export default class extends Controller {
     return tokens
   }
 
+  selectedCountLabel(count) {
+    return (this.selectedCountTextValue || "%{count}").replace("%{count}", count)
+  }
+
   displayLabel(option) {
     return option.displayLabel || option.label
   }
 
+  showTooltip() {
+    if (!this.hasTooltipTarget || this.expanded || this.selectedValue.length === 0) {
+      return
+    }
+
+    window.clearTimeout(this.tooltipHideTimer)
+    this.tooltipTarget.classList.remove("hidden")
+  }
+
+  hideTooltip(immediate = false) {
+    if (!this.hasTooltipTarget) {
+      return
+    }
+
+    window.clearTimeout(this.tooltipHideTimer)
+
+    if (immediate === true) {
+      this.tooltipTarget.classList.add("hidden")
+    } else {
+      this.tooltipHideTimer = window.setTimeout(() => this.tooltipTarget.classList.add("hidden"), 150)
+    }
+  }
+
+  keepTooltip() {
+    window.clearTimeout(this.tooltipHideTimer)
+  }
+
+  renderTooltip() {
+    if (!this.hasTooltipTarget) {
+      return
+    }
+
+    if (this.tooltipTarget.hasAttribute("data-advanced-select-tooltip-custom")) {
+      this.renderCustomTooltip()
+      return
+    }
+
+    this.renderBuiltInTooltip()
+  }
+
+  renderBuiltInTooltip() {
+    const list = this.tooltipTarget.querySelector("[data-advanced-select-tooltip-list]")
+    if (!list) {
+      return
+    }
+
+    list.replaceChildren(
+      ...this.selectedValue.map((option) => this.textElement("li", this.tooltipItemClass, this.displayLabel(option)))
+    )
+
+    if (this.selectedValue.length === 0) {
+      this.hideTooltip(true)
+    }
+  }
+
+  renderCustomTooltip() {
+    const list = this.tooltipTarget.querySelector("[data-advanced-select-tooltip-list]")
+    const template = this.customTooltipTemplate()
+
+    if (!list || !template) {
+      if (this.selectedValue.length === 0) {
+        this.hideTooltip(true)
+      }
+      return
+    }
+
+    list.replaceChildren(
+      ...this.selectedValue.map((option) => this.customTooltipElement(template, option))
+    )
+
+    if (this.selectedValue.length === 0) {
+      this.hideTooltip(true)
+    }
+  }
+
+  customTooltipTemplate() {
+    if (this.customTooltipTemplateContent) {
+      return this.customTooltipTemplateContent
+    }
+
+    const template = this.tooltipTarget.querySelector("template[data-advanced-select-tooltip-template]")
+    if (!template) {
+      return null
+    }
+
+    this.customTooltipTemplateContent = template.content.cloneNode(true)
+    template.remove()
+    return this.customTooltipTemplateContent
+  }
+
+  customTooltipElement(template, option) {
+    const fragment = template.cloneNode(true)
+    fragment.querySelectorAll("[data-advanced-select-tooltip-field]").forEach((element) => {
+      element.textContent = this.tooltipFieldValue(option, element.dataset.advancedSelectTooltipField)
+    })
+
+    return fragment
+  }
+
+  tooltipFieldValue(option, field) {
+    if (field === "display_label" || field === "displayLabel") {
+      return this.displayLabel(option)
+    }
+
+    const camelizedField = field.replace(/_([a-z])/g, (_match, character) => character.toUpperCase())
+    const value = option[field] ?? option[camelizedField]
+    return value === undefined || value === null ? "" : value.toString()
+  }
+
   textElement(tagName, className, text) {
     const element = document.createElement(tagName)
     element.className = className

data/app/views/advanced_select/_select.html.erb

@@ -15,9 +15,12 @@
      data-advanced-select-include-hidden-value="<%= include_hidden %>"
      data-advanced-select-auto-select-single-value="<%= auto_select_single %>"
      data-advanced-select-eager-value="<%= eager %>"
+     data-advanced-select-summary-mode-value="<%= summary_mode %>"
+     data-advanced-select-selected-count-text-value="<%= t("shared.advanced_select.selected_count", count: "%{count}") %>"
      data-advanced-select-placeholder-class="<%= advanced_select_class(class_map, :placeholder) %>"
      data-advanced-select-value-class="<%= advanced_select_class(class_map, :value) %>"
      data-advanced-select-token-class="<%= advanced_select_class(class_map, :token) %>"
+     data-advanced-select-tooltip-item-class="<%= advanced_select_class(class_map, :tooltip_item) %>"
      data-advanced-select-empty-class="<%= advanced_select_class(class_map, :empty) %>"
      data-advanced-select-loading-class="<%= advanced_select_class(class_map, :loading) %>"
      data-advanced-select-error-class="<%= advanced_select_class(class_map, :error) %>"
@@ -38,6 +41,8 @@
     <% end %>
   </div>
 
+  <% tooltip_enabled = tooltip || tooltip_partial.present? %>
+  
   <button type="button"
           id="<%= "#{id}_trigger" %>"
           class="<%= advanced_select_class(class_map, :trigger) %>"
@@ -45,14 +50,33 @@
           aria-expanded="false"
           aria-controls="<%= "#{id}_dropdown" %>"
           data-advanced-select-target="trigger"
-          data-action="advanced-select#toggle keydown->advanced-select#keydown">
+          data-action="advanced-select#toggle keydown->advanced-select#keydown<%= " mouseenter->advanced-select#showTooltip mouseleave->advanced-select#hideTooltip" if tooltip_enabled %>">
     <span id="<%= "#{id}_summary" %>" class="<%= advanced_select_class(class_map, :summary) %>" data-advanced-select-target="summary">
-      <%= render partial: "advanced_select/summary", locals: { selected_options: selected_options, multiple: multiple, placeholder: placeholder, class_map: class_map } %>
+      <%= render partial: "advanced_select/summary", locals: { selected_options: selected_options, multiple: multiple, placeholder: placeholder, summary_mode: summary_mode, class_map: class_map } %>
     </span>
     <span id="<%= "#{id}_caret" %>" class="<%= [advanced_select_class(class_map, :caret), ("hidden" if selected_options.any?)].compact.join(" ") %>" data-advanced-select-target="caret">&#8964;</span>
     <span id="<%= "#{id}_clear" %>" class="<%= [advanced_select_class(class_map, :clear), ("hidden" if selected_options.empty?)].compact.join(" ") %>" data-advanced-select-target="clear" data-action="click->advanced-select#clear">&times;</span>
   </button>
 
+  <% if tooltip_enabled %>
+    <div id="<%= "#{id}_tooltip" %>"
+         class="<%= [advanced_select_class(class_map, :tooltip), "hidden"].join(" ") %>"
+         role="tooltip"
+         data-advanced-select-target="tooltip"
+         <%= "data-advanced-select-tooltip-custom" if tooltip_partial.present? %>
+         data-action="mouseenter->advanced-select#keepTooltip mouseleave->advanced-select#hideTooltip">
+      <% if tooltip_partial.present? %>
+        <%= render partial: tooltip_partial, locals: { selected_options: selected_options, options: options } %>
+      <% else %>
+        <ul class="<%= advanced_select_class(class_map, :tooltip_list) %>" data-advanced-select-tooltip-list>
+          <% selected_options.each do |option| %>
+            <li class="<%= advanced_select_class(class_map, :tooltip_item) %>"><%= option.fetch(:display_label) %></li>
+          <% end %>
+        </ul>
+      <% end %>
+    </div>
+  <% end %>
+
   <div id="<%= "#{id}_dropdown" %>"
        class="<%= [advanced_select_class(class_map, :dropdown), "hidden"].join(" ") %>"
        data-advanced-select-target="dropdown">

data/app/views/advanced_select/_summary.html.erb

@@ -1,10 +1,15 @@
+<% summary_mode = local_assigns.fetch(:summary_mode, :tokens) %>
 <% if selected_options.any? %>
   <% if multiple %>
-    <% selected_options.first(2).each do |option| %>
-      <span class="<%= advanced_select_class(class_map, :token) %>"><%= option.fetch(:display_label) %></span>
-    <% end %>
-    <% if selected_options.size > 2 %>
-      <span class="<%= advanced_select_class(class_map, :token) %>"><%= "& +#{selected_options.size - 2}" %></span>
+    <% if summary_mode.to_s == "count" %>
+      <span class="<%= advanced_select_class(class_map, :value) %>"><%= t("shared.advanced_select.selected_count", count: selected_options.size) %></span>
+    <% else %>
+      <% selected_options.first(2).each do |option| %>
+        <span class="<%= advanced_select_class(class_map, :token) %>"><%= option.fetch(:display_label) %></span>
+      <% end %>
+      <% if selected_options.size > 2 %>
+        <span class="<%= advanced_select_class(class_map, :token) %>"><%= "& +#{selected_options.size - 2}" %></span>
+      <% end %>
     <% end %>
   <% else %>
     <span class="<%= advanced_select_class(class_map, :value) %>"><%= selected_options.first.fetch(:display_label) %></span>

data/config/locales/en.yml

@@ -6,3 +6,4 @@ en:
       error: "Options could not be loaded"
       loading: "Loading..."
       search_placeholder: "Search..."
+      selected_count: "%{count} selected"

data/config/locales/tr.yml

@@ -6,3 +6,4 @@ tr:
       error: "Seçenekler yüklenemedi"
       loading: "Yükleniyor..."
       search_placeholder: "Ara..."
+      selected_count: "%{count} seçili"

data/lib/advanced_select/class_map.rb

@@ -9,6 +9,9 @@ module AdvancedSelect
       token: "ui-advanced-select-token",
       caret: "ui-advanced-select-caret",
       clear: "ui-advanced-select-clear",
+      tooltip: "ui-advanced-select-tooltip",
+      tooltip_list: "ui-advanced-select-tooltip-list",
+      tooltip_item: "ui-advanced-select-tooltip-item",
       dropdown: "ui-advanced-select-dropdown",
       search: "ui-advanced-select-search",
       options: "ui-advanced-select-options",

data/lib/advanced_select/helper.rb

@@ -1,6 +1,6 @@
 module AdvancedSelect
   module Helper
-    def advanced_select_tag(name, id:, selected:, options:, placeholder:, options_url: nil, multiple: false, searchable: true, add_mode: false, dependent_fields: {}, include_hidden: true, auto_select_single: true, eager: true, option_content_partial: nil, classes: {}, append_classes: {})
+    def advanced_select_tag(name, id:, selected:, options:, placeholder:, options_url: nil, multiple: false, searchable: true, add_mode: false, dependent_fields: {}, include_hidden: true, auto_select_single: true, eager: true, summary_mode: :tokens, tooltip: false, tooltip_partial: nil, option_content_partial: nil, classes: {}, append_classes: {})
       selected_options = advanced_select_selected_options(selected)
       class_map = advanced_select_class_map(classes, append_classes)
 
@@ -18,6 +18,9 @@ module AdvancedSelect
         include_hidden: include_hidden,
         auto_select_single: auto_select_single,
         eager: eager,
+        summary_mode: summary_mode,
+        tooltip: tooltip,
+        tooltip_partial: tooltip_partial,
         target_id: "#{id}_options",
         option_content_partial: option_content_partial,
         class_map: class_map

data/lib/advanced_select/version.rb

@@ -1,3 +1,3 @@
 module AdvancedSelect
-  VERSION = "0.1.4"
+  VERSION = "0.1.6"
 end

data/lib/generators/advanced_select/install/templates/advanced_select.css

@@ -101,6 +101,40 @@
   z-index: 20;
 }
 
+.ui-advanced-select-tooltip {
+  background: #ffffff;
+  border: 1px solid #e5e7eb;
+  border-radius: 0.75rem;
+  box-shadow: 0 10px 15px -3px rgb(0 0 0 / 0.1), 0 4px 6px -4px rgb(0 0 0 / 0.1);
+  box-sizing: border-box;
+  color: #374151;
+  font-size: 0.875rem;
+  left: 0;
+  line-height: 1.25rem;
+  margin-top: 0.25rem;
+  min-width: 100%;
+  padding: 0.75rem 1rem;
+  position: absolute;
+  top: 100%;
+  width: max-content;
+  z-index: 30;
+}
+
+.ui-advanced-select-tooltip-list {
+  display: flex;
+  flex-direction: column;
+  gap: 0.25rem;
+  list-style: none;
+  margin: 0;
+  padding: 0;
+}
+
+.ui-advanced-select-tooltip-item {
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
 .ui-advanced-select-search {
   border: 1px solid #e5e7eb;
   border-radius: 0.5rem;

data/lib/generators/advanced_select/install/templates/advanced_select_controller.js

@@ -2,7 +2,7 @@ import { Controller } from "@hotwired/stimulus"
 import { Turbo } from "@hotwired/turbo-rails"
 
 export default class extends Controller {
-  static targets = ["hiddenFields", "trigger", "summary", "dropdown", "search", "options", "caret", "clear"]
+  static targets = ["hiddenFields", "trigger", "summary", "dropdown", "search", "options", "caret", "clear", "tooltip"]
   static values = {
     addMode: Boolean,
     autoSelectSingle: { type: Boolean, default: true },
@@ -19,6 +19,8 @@ export default class extends Controller {
     placeholder: String,
     searchable: Boolean,
     selected: Array,
+    selectedCountText: String,
+    summaryMode: { type: String, default: "tokens" },
     targetId: String,
     url: String
   }
@@ -30,6 +32,7 @@ export default class extends Controller {
     this.placeholderClass = this.element.dataset.advancedSelectPlaceholderClass || "ui-advanced-select-placeholder"
     this.valueClass = this.element.dataset.advancedSelectValueClass || "ui-advanced-select-value"
     this.tokenClass = this.element.dataset.advancedSelectTokenClass || "ui-advanced-select-token"
+    this.tooltipItemClass = this.element.dataset.advancedSelectTooltipItemClass || "ui-advanced-select-tooltip-item"
     this.loadingClass = this.element.dataset.advancedSelectLoadingClass || "ui-advanced-select-loading"
     this.errorClass = this.element.dataset.advancedSelectErrorClass || "ui-advanced-select-error"
     this.emptyClass = this.element.dataset.advancedSelectEmptyClass || "ui-advanced-select-empty"
@@ -48,6 +51,7 @@ export default class extends Controller {
 
   disconnect() {
     window.clearTimeout(this.timer)
+    window.clearTimeout(this.tooltipHideTimer)
     document.removeEventListener("click", this.close)
 
     if (this.dependentChangeListener) {
@@ -66,6 +70,7 @@ export default class extends Controller {
   }
 
   open() {
+    this.hideTooltip(true)
     this.dropdownTarget.classList.remove("hidden")
     this.triggerTarget.setAttribute("aria-expanded", "true")
     document.addEventListener("click", this.close)
@@ -302,6 +307,7 @@ export default class extends Controller {
   renderSelection() {
     this.hiddenFieldsTarget.replaceChildren(...this.hiddenFieldElements)
     this.summaryTarget.replaceChildren(...this.selectionElements)
+    this.renderTooltip()
     this.renderOptionsState()
     this.caretTarget.classList.toggle("hidden", this.selectedValue.length > 0)
     this.clearTarget.classList.toggle("hidden", this.selectedValue.length === 0)
@@ -473,6 +479,10 @@ export default class extends Controller {
       return [this.textElement("span", this.valueClass, this.displayLabel(this.selectedValue[0]))]
     }
 
+    if (this.summaryModeValue === "count") {
+      return [this.textElement("span", this.valueClass, this.selectedCountLabel(this.selectedValue.length))]
+    }
+
     const tokens = this.selectedValue.slice(0, 2).map((option) => this.textElement("span", this.tokenClass, this.displayLabel(option)))
 
     if (this.selectedValue.length > 2) {
@@ -482,10 +492,60 @@ export default class extends Controller {
     return tokens
   }
 
+  selectedCountLabel(count) {
+    return (this.selectedCountTextValue || "%{count}").replace("%{count}", count)
+  }
+
   displayLabel(option) {
     return option.displayLabel || option.label
   }
 
+  showTooltip() {
+    if (!this.hasTooltipTarget || this.expanded || this.selectedValue.length === 0) {
+      return
+    }
+
+    window.clearTimeout(this.tooltipHideTimer)
+    this.tooltipTarget.classList.remove("hidden")
+  }
+
+  hideTooltip(immediate = false) {
+    if (!this.hasTooltipTarget) {
+      return
+    }
+
+    window.clearTimeout(this.tooltipHideTimer)
+
+    if (immediate === true) {
+      this.tooltipTarget.classList.add("hidden")
+    } else {
+      this.tooltipHideTimer = window.setTimeout(() => this.tooltipTarget.classList.add("hidden"), 150)
+    }
+  }
+
+  keepTooltip() {
+    window.clearTimeout(this.tooltipHideTimer)
+  }
+
+  renderTooltip() {
+    if (!this.hasTooltipTarget || this.tooltipTarget.hasAttribute("data-advanced-select-tooltip-custom")) {
+      return
+    }
+
+    const list = this.tooltipTarget.querySelector("[data-advanced-select-tooltip-list]")
+    if (!list) {
+      return
+    }
+
+    list.replaceChildren(
+      ...this.selectedValue.map((option) => this.textElement("li", this.tooltipItemClass, this.displayLabel(option)))
+    )
+
+    if (this.selectedValue.length === 0) {
+      this.hideTooltip(true)
+    }
+  }
+
   textElement(tagName, className, text) {
     const element = document.createElement(tagName)
     element.className = className

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: advanced_select
 version: !ruby/object:Gem::Version
-  version: 0.1.4
+  version: 0.1.6
 platform: ruby
 authors:
 - Mehmet Celik