active_admin_prism 0.1.3 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 72cc73689e83be856fdc1e2e321df486dc8cb6033bcca1380aae1d7aed8a15b0
-  data.tar.gz: 999e31015012d3dcb58de142de2fe050754fba7903612f259f8ab92709388c05
+  metadata.gz: 35f7f9fdd5aec6533abb2db1fc8289129bde147d99ae77410af86dae2fc58294
+  data.tar.gz: fedf27baf3454219273944d324e2a8fe3ffe4f36b4392415e6cf368517231ac0
 SHA512:
-  metadata.gz: f94ead774c60a6c285fa59c624c0f472cd7eb31c2a21d970a7609a74bb3f948d86754d32050d416c7fdfc2fb9fdaa915c3071f998a7832dacb02027ecc606052
-  data.tar.gz: b71bbf23aceebcf5febdc7690b4b27064d4d1b9dfe050254e931b15060398a35b55ea0a228220386098fd061e57633ab7e1d00ec3bc5af350db520bfdbb2f23f
+  metadata.gz: 889376a6a7a2efbd22327d2498f9514b3e2ffbd8fb6aac406d49ca9201e99633490b9c9ec73a4084e25d560d7858ce9d20f2f90ff5e383941efd63f0ed262fb3
+  data.tar.gz: 5d6aeef6bd4cc91cba408142d78c9bea49d99b0fe0113fcca8667df419251a4ec5e68237753e6dfe8a1343d95446447dbe9979dc3a14f80a3a2c2bc16da12574

data/CHANGELOG.md

@@ -1,5 +1,77 @@
 # Changelog
 
+## 0.1.4
+
+- A Pages nav item registered with no `icon:` now gets one automatically
+  (`auto_nav_icons`, on by default) — picked deterministically from a
+  generic subset of the built-in icon set based on the item's own label,
+  so the same label always gets the same icon rather than shuffling
+  between page loads. Mainly matters once the sidebar is collapsed to
+  its icon-only rail (`sidebar_collapsible`): an unassigned item used to
+  render there as just a bare, indistinguishable dot. `icon:` set
+  explicitly always wins; `auto_nav_icons = false` restores the old
+  no-icon-at-all behavior.
+- Every non-Filters sidebar section (ActiveAdmin core's own "Search
+  status" panel, when `active_filters_bar` is off, or a host's own custom
+  `sidebar "Title" do ... end` block) now flattens every link/button
+  inside it into a single "Sidebar Actions" Select2 dropdown when
+  `collapsible_filters` is on, instead of each rendering its own
+  individually collapsed icon button with nowhere near enough room in
+  the 72px gutter that assumed just one — wrapping every word onto its
+  own line, or spilling out unclipped over the main content, instead of
+  collapsing cleanly. This dropdown renders in the title bar, next to
+  (and styled identically to) the consolidated "Actions" dropdown below,
+  so the two read as one "more stuff lives here" row instead of two
+  disconnected mechanisms in different parts of the page. Picking an
+  option fires a real click on the underlying (hidden but still
+  DOM-attached, so Rails UJS's `data-method`/`data-confirm` keeps
+  working) link/button and resets right back to its placeholder — same
+  "jump menu" click-and-reset flow as the "Actions" dropdown, rather than
+  opening the section's content in a nested panel. The section itself is
+  discarded outright either way, never rendered in `#sidebar`. The
+  Filters panel itself is untouched by any of this — it always keeps its
+  own plain icon button exactly as before, whether or not any other
+  sections exist. A page with only Filters (the common case) shows no
+  dropdown at all.
+- A title bar with more than `action_items_dropdown_threshold` (default:
+  `0`, so this applies from a single extra `action_item` on) `action_item`
+  buttons now collapses all of them into a single Select2 "jump menu",
+  aligned with the index table's own right edge (not the page's corner,
+  which a table's own column-driven width often doesn't reach), instead
+  of rendering a multi-row wall of individual buttons — a resource
+  registering a dozen+ CSV upload / bulk-action links is a real example
+  this was built for. Sits in the same row as the "Sidebar Actions"
+  dropdown above when both exist on the same page, with a visible gap
+  before the (always excluded, always pinned to the true top-right
+  corner) "New Resource" button. Both this and the "Sidebar Actions"
+  dropdown above always show Select2's search box, even with just one or
+  two options — not gated behind a result-count threshold — so either
+  reads unambiguously as Select2 regardless of how many items it
+  currently has. Picking an option fires that action immediately (a
+  plain link navigates, a `button_to` form submits — whatever it
+  actually was, `data-confirm`/`data-method` included) and resets right
+  back to its placeholder. Purely client-side: it moves each existing
+  action_item element as-is into a hidden holding area and `.click()`s
+  the real trigger inside it, so whatever a host's own `action_item`
+  block rendered keeps working completely unmodified. Set
+  `config.action_items_dropdown = false` to always render every
+  action_item inline, matching this gem's behavior before this flag
+  existed.
+- The active-filters bar (`config.active_filters_bar`) now toggles the
+  Filters panel open/closed on click, same as the funnel icon, instead of
+  only ever opening it.
+- Following any Pages nav item — a plain leaf link, or a parent group
+  like "School" — while the sidebar is collapsed to its icon-only rail
+  (`config.sidebar_collapsible`) now expands it back out first. A
+  parent's own submenu is force-hidden by CSS while collapsed regardless
+  of its "open" class, so without this, clicking one did nothing visible
+  at all.
+- An index table wider than its container (many columns, a narrow
+  viewport) now fades in a subtle shadow on whichever edge still has
+  more columns to scroll toward, clearing once scrolled all the way to
+  that side — a table simply cut off flush at the container's edge
+  otherwise gave no indication scrolling was even possible.
+
 ## 0.1.3
 
 - A hamburger icon button next to the brand, at the top of the Prism

data/INTEGRATION.md

@@ -135,6 +135,9 @@ ActiveAdminPrism.configure do |config|
   config.menu_search = true                # default: true
   config.select2 = false                   # default: false (opt-in — see below)
   config.sidebar_collapsible = true        # default: true
+  config.action_items_dropdown = true      # default: true
+  config.action_items_dropdown_threshold = 3  # default: 3
+  config.auto_nav_icons = true             # default: true
 end
 
 ActiveAdminPrism.enable!
@@ -161,6 +164,9 @@ ActiveAdminPrism.enable!
 | `menu_search`                    | `true`  | No search box renders above the sidebar's "Pages" nav — see [Menu search](#menu-search). |
 | `select2`                        | `false` | **Opposite polarity from every other flag above — opt-in, not opt-out.** `false` (the default) leaves every `<select>` exactly as ActiveAdmin renders it. `true` auto-enhances *every* plain `<select>` (filters, form inputs, association pickers — no per-field setup) into a searchable Select2 widget — see [Select2](#select2). |
 | `sidebar_collapsible`             | `true`  | No hamburger toggle button renders next to the brand — the sidebar is always full width, with no way to collapse it to an icon-only rail. Desktop-only either way; the mobile off-canvas toggle is unaffected — see [Collapsible sidebar rail](#collapsible-sidebar-rail). |
+| `action_items_dropdown`          | `true`  | Every `action_item` always renders inline in the title bar, however many there are — no "Actions" dropdown consolidation. See [Consolidated action items](#consolidated-action-items). |
+| `action_items_dropdown_threshold` | `3`     | How many `action_item`s a title bar can have before `action_items_dropdown` (if on) collapses them into a dropdown. |
+| `auto_nav_icons`                 | `true`  | A Pages nav item with no explicit `icon:` renders with no icon at all (just its label, or a bare dot once collapsed to the icon-only rail) instead of an automatically-picked one — see [Automatic nav icons](#automatic-nav-icons). |
 
 **How this crosses the server/client boundary.** `sidebar`,
 `colorize_action_icons`, and the `login_*` flags are pure server-side
@@ -292,6 +298,21 @@ passes this hash through untouched) accepts: `:dashboard`, `:users`,
 `:home`, `:list`, `:folder`, `:bell`, `:search`, `:menu`, `:logout`,
 `:check`, `:x`, `:chevron_down`, `:eye`, `:pencil`, `:trash`, `:filter`.
 
+### Automatic nav icons
+
+A menu item registered with no `icon:` at all still gets one, picked from
+a generic subset of the icon set above (`:dashboard`, `:users`, `:cart`,
+`:box`, `:receipt`, `:credit_card`, `:message`, `:settings`, `:home`,
+`:list`, `:folder`, `:bell`, `:search`, `:globe`, `:eye`, `:pencil`,
+`:filter`) based on the item's own label — the same label always maps to
+the same icon (it's a deterministic hash, not re-rolled per request), so
+it never visibly changes between page loads. This is mainly about the
+collapsed icon-only rail (see below): without any icon at all, an
+unassigned item renders there as just a bare dot, indistinguishable from
+any other unassigned item. `icon:` set explicitly always wins. Turn it
+off with `config.auto_nav_icons = false` to go back to rendering no icon
+for such an item (this gem's behavior before this flag existed).
+
 ### Collapsible sidebar rail
 
 A hamburger icon button next to the brand, at the top of the sidebar,
@@ -626,17 +647,71 @@ jquery-rails/jquery-ujs. Turn off with `config.styled_confirms = false`.
 The "Filters" panel (ActiveAdmin's `filters_sidebar_section`) starts
 collapsed to a single filter-icon button; clicking it expands the full form
 in place (also keyboard-accessible — Enter/Space toggle it, and it exposes
-`aria-expanded`). The index table/main content area reflows to reclaim the
-freed-up width while collapsed, and gives it back when expanded. No setup
-needed, and it only targets that specific panel — any other sidebar section
-(dashboard panels, custom `sidebar :title do ... end` blocks) is untouched.
-Turn it off with `config.collapsible_filters = false` to always show it
-fully expanded, matching ActiveAdmin's own default (and the table/content
-area at its normal, non-reflowing width).
+`aria-expanded`). This is always how Filters behaves, whether or not any
+other collapsible sections exist — it's never grouped into a dropdown
+with anything else.
+
+Every *other* sidebar section — dashboard panels, ActiveAdmin's own
+"Search status" panel (when `active_filters_bar` is off), or any custom
+`sidebar "Title" do ... end` block a host registers — gets collapsed too,
+but consolidated into a single "More Actions" Select2 dropdown instead of
+each getting its own individually collapsed icon button: a stack of those
+has nowhere near enough room in the 72px gutter that assumes just one
+(Filters). This dropdown renders in the *title bar*, next to (and
+styled like) the consolidated action items dropdown below — see
+[Consolidated action items](#consolidated-action-items) — not inside
+`#sidebar` itself, so the two read as one "more stuff lives here" row
+instead of two disconnected mechanisms in different parts of the page.
+Picking an option from it opens that section (closing every other
+non-Filters one — one visible at a time, in `#sidebar`, same as ever)
+and reflows the table just like Filters opening does. A section's own
+header still opens/closes it directly too, keeping the dropdown in sync
+either way. A page with no sections besides Filters (the common case)
+shows no dropdown at all — just the one familiar icon button.
+
+Pass your own icon via `sidebar "More Actions", icon: :list do ... end`
+(any name from `lib/prism_icons.rb`) — it's only used on a section's own
+header once it's open, since the collapsed dropdown itself doesn't render
+per-section icons; anything else falls back to a generic one (`:filter`
+for the Filters section specifically, `:list` otherwise). The index
+table/main content area reflows to reclaim the freed-up width while
+*every* section is collapsed, giving it back the moment any one of them
+opens. Turn it off with `config.collapsible_filters = false` to always
+show every section fully expanded, matching ActiveAdmin's own default
+(and the table/content area at its normal, non-reflowing width).
 
 The reflow relies on the CSS `:has()` selector (broadly supported in
-current browsers); without it, the Filters panel still collapses/expands
-correctly, it just won't reclaim the extra width.
+current browsers); without it, sections still collapse/expand correctly,
+the reflow just won't reclaim the extra width.
+
+### Consolidated action items
+
+A title bar with more than `action_items_dropdown_threshold` (default:
+`3`) `action_item` buttons collapses all of them into a single Select2
+"jump menu", aligned with the index table's own right edge, instead of a
+multi-row wall of individual buttons — a resource registering a dozen+
+CSV upload / bulk-action links is a real example this was built for.
+(The table's own edge, not the page's: a table's column-driven width
+often doesn't reach the page's full content width, so aligning to the
+container instead would leave the dropdown looking stranded out past
+the table it belongs to.) Picking an option fires that action
+immediately (a plain `link_to` navigates, a `button_to` form submits —
+whatever it actually was, including its own `data-confirm`/`data-method`)
+and the dropdown resets right back to its placeholder, ready for the next
+pick — it's a trigger, not a persistent selection. Purely client-side DOM
+restructuring: `prism.js` moves each existing `action_item` element as-is
+(not a clone) into a hidden holding area and `.click()`s the real
+`<a>`/`<button>` inside it on selection, so whatever a host's own
+`action_item` block rendered keeps working completely unmodified. Select2
+itself is always available for this regardless of `config.select2` (that
+flag only controls auto-enhancing a *host's* own selects) — the library
+ships in this gem's JS either way. A page with only a couple of action
+items (a lone "New Resource" button, say) is left untouched, rendering
+inline exactly as ActiveAdmin does by default — the threshold exists so
+this only kicks in for pages that actually need it. Turn it off entirely
+with `config.action_items_dropdown = false`, or raise/lower
+`config.action_items_dropdown_threshold` to change how many buttons it
+takes before consolidation kicks in.
 
 ### Active filters bar
 
@@ -1035,30 +1110,80 @@ anything Prism itself renders:
     li.select2-results__message             <- "No results found" etc.
 ```
 
-### Filters sidebar panel (`#filters_sidebar_section`)
+### Collapsible sidebar sections (`.prism-collapsible-panel`)
 
-Only this specific `SidebarSection` (AA's built-in id for the Filters
-panel) gets the extra icon/collapse markup — any other sidebar section
-(dashboard panels, a host's own `sidebar :title do ... end`) is untouched:
+Every `SidebarSection` gets this markup — not just AA's built-in Filters
+panel; a host's own `sidebar "Title" do ... end` block gets it too:
 
 ```
 #sidebar                                <- AA's own right-hand content sidebar (not Prism's left nav)
-  .panel#filters_sidebar_section.prism-collapsible-panel[.open]
+  .panel.prism-collapsible-panel[#filters_sidebar_section][.open]
     > h3                                <- the icon-only button when collapsed
-      svg.prism-filter-icon
+      svg.prism-filter-icon             <- :filter for Filters, :list (or your own `icon:`) otherwise
       span.prism-filter-label           <- visually hidden (max-width:0) while collapsed
     .panel_contents                     <- max-height:0 while collapsed, animates open
-      form.filter_form
+      form.filter_form                  <- Filters section specifically
         .filter_form_field[.select_and_search][.filter_date_range]
 ```
 
 `.prism-collapsible-panel` and the icon/label markup are only added when
-`config.collapsible_filters` is `true`; `prism.js` mirrors the panel's
-`.open` state onto `body.prism-filters-open`, which is what
-`#active_admin_content`/`#sidebar`'s reflow rules key off (`:has()` — see
-[Collapsible "Filters" sidebar](#collapsible-filters-sidebar)). With the config `false`,
-`body.prism-filters-collapsible-disabled` is the backstop class that forces
-the panel back to always-expanded.
+`config.collapsible_filters` is `true`; `prism.js` mirrors the Filters
+section's `.open` state onto `body.prism-filters-open` specifically (kept
+for any host CSS already keying off it), but `#active_admin_content`/
+`#sidebar`'s own reflow rule keys off *any* section's `.open` via `:has()`
+instead — see [Collapsible "Filters" sidebar](#collapsible-filters-sidebar).
+With the config `false`, `body.prism-filters-collapsible-disabled` is the
+backstop class that forces every section back to always-expanded.
+
+With at least one collapsible section besides Filters, `prism.js` also
+adds `.prism-sidebar-multi-panel` to `#sidebar` — which does nothing but
+hide each non-Filters section's own collapsed-state `> h3` (above) via
+CSS
+(`#sidebar.prism-sidebar-multi-panel .prism-collapsible-panel:not(.open):not(#filters_sidebar_section) > h3`),
+since its trigger lives elsewhere now (Filters' own `> h3` is never
+hidden by this rule, regardless) — and inserts the actual dropdown into
+the *title bar's* shared row instead of into `#sidebar` itself:
+
+```
+#titlebar_right
+  div.action_items
+    span#prism-titlebar-actions-row.prism-titlebar-actions-row
+      span.prism-sidebar-panel-select-wrapper
+        select.prism-sidebar-panel-select   <- Select2-enhanced; one <option> per non-Filters section, by title
+      span.prism-action-items-dropdown      <- see below; may or may not be present on the same page
+```
+
+Selecting an option opens that section (in `#sidebar`, same as ever) and
+closes every other non-Filters one — Filters itself is excluded entirely
+and never appears in this dropdown's options.
+
+### Consolidated action items markup (`.prism-action-items-dropdown`)
+
+Only present once `action_item` count exceeds
+`config.action_items_dropdown_threshold` (see
+[Consolidated action items](#consolidated-action-items)); shares
+`#prism-titlebar-actions-row` above with the "More Actions" dropdown when
+both exist on the same page (whichever one exists lands in that shared
+row on its own otherwise):
+
+```
+#titlebar_right
+  div.action_items
+    span#prism-titlebar-actions-row.prism-titlebar-actions-row
+      span.prism-action-items-dropdown
+        select.prism-action-items-select      <- Select2-enhanced; one <option> per action_item, by its link/button text
+        div.prism-action-items-holding[hidden]
+          span.action_item                    <- every original action_item element, moved here as-is, never shown
+            a / form                          <- whatever a host's own action_item block rendered, untouched
+```
+
+Selecting an option finds the real `<a>`/`<button>`/`<input type=submit>`
+inside the matching `.action_item` in `.prism-action-items-holding` and
+`.click()`s it directly, then resets the select back to its placeholder.
+The whole `#prism-titlebar-actions-row` (not each dropdown individually)
+is what a separate script in `prism.js` aligns to the index table's own
+right edge — see [Consolidated action items](#consolidated-action-items)
+for why.
 
 ### Active filters bar (`#prism_active_filters_bar`)
 

data/README.md

@@ -12,7 +12,7 @@ theme, troubleshooting). This README is a quick start.
 ## Live demo
 
 A live demo dashboard is running at
-**[prism-demo.onrender.com/admin](https://prism-demo.onrender.com/admin)**:
+**[prism-demo.onrender.com/admin](https://prism-demo.onrender.com/admin/login)**:
 
 ```
 Username: admin@example.com
@@ -120,6 +120,8 @@ ActiveAdminPrism.configure do |config|
   config.menu_search = true             # search box that filters the sidebar's Pages nav
   config.select2 = false                # default: false — auto-enhance every <select> into Select2
   config.sidebar_collapsible = true     # sidebar collapses to an icon-only rail (desktop only)
+  config.action_items_dropdown = true   # many title-bar action_items collapse into an "Actions" dropdown
+  config.action_items_dropdown_threshold = 3
 end
 
 ActiveAdminPrism.enable!