Skip to content

Conversation

@SmartCodeJunctionInfinity

Context

SmartCarePlus and other embedded OHIF deployments need tighter UI control over the Study Browser sidebar:

  • Some workflows require hiding the header/filter bar entirely (kiosk, radiologist-only layouts, or embedded viewers).
  • Some apps need to override or remove default action icons.
  • In restricted studyMode setups, showing multiple study tabs creates confusion and mis-clicks.

This PR adds lightweight configuration hooks to support these use cases without affecting default behavior.


Changes & Results

✅ New customizations

  1. studyBrowser.hideHeader

    • Boolean flag to toggle the visibility of the Study Browser header + filter bar.
  2. studyBrowser.actionIcons

    • Allows overriding the default header action icons.
    • Can also be set to an empty array to hide all buttons.
  3. Primary-only tab filtering

    • When studyMode === "primary", the Study Browser automatically filters tabs to show only the primary study.

Behavior

Before

  • Header and actions were always visible.
  • Tabs always showed all studies.

After

  • Header visibility is configurable.
  • Header buttons are customizable or removable.
  • Tab list adapts automatically in restricted study modes.

All changes are backward-compatible. If no customization is provided, the current behavior remains unchanged.


Testing

  1. Run OHIF locally.
  2. Add any of the following to your customization config:
{
  studyBrowser: {
    hideHeader: true,
    actionIcons: [], // or custom icons
  }
}
  1. Load a multi-study case.

  2. Verify:

    • Header hides when enabled.
    • Action buttons change or disappear.
    • With studyMode = "primary", only the primary tab is shown.

Checklist

PR

  • My Pull Request title is descriptive, accurate and follows the semantic-release format and guidelines.

Code

  • My code has been well-documented (inline comments where behavior changes).

Public Documentation Updates

  • The documentation page has been updated as necessary for any public API additions or removals.
    (Can be added if maintainers want this exposed in official customization docs.)

Tested Environment

  • OS: Windows 10 Version 22H2
  • Node version: 20.20.0
  • Browser: Chrome (144.0.7559.61)

- Add 'studyBrowser.hideHeader' to toggle sidebar header/filter bar visibility.
- Add 'studyBrowser.actionIcons' to allow overriding or hiding sidebar header buttons.
- Implement automatic tab filtering to show only the primary study when 'studyMode' is restricted.
@netlify
Copy link

netlify bot commented Jan 22, 2026

👷 Deploy Preview for ohif-dev processing.

Name Link
🔨 Latest commit 4ce2137
🔍 Latest deploy log https://app.netlify.com/projects/ohif-dev/deploys/6971fe5ef63e630008c89b48

… including updated PWA assets and a dedicated config file.
…ing Viewer, and remove commit hash and GitHub link.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant