application shell Settings: the settings list and the opened setting scroll as one page - a setting picked low in a long list opens out of view

Open Beginner friendly
#8,636 1 comment 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
76/100
Issue type
Bug
Clarity
Clearly specified
Activity status
Active
Tech stack
css, html
Domain
frontend

Research direction

Open components/resources/resources-application/src/main/resources/META-INF/dirigible/application/views/_settings.html and compare its left split panel with template-application-ui-harmonia-java/ui/shell/settings.html.template lines 18-19. Bound the panel and list heights so the list scrolls on its own, then confirm the right panel's local pages (region-language, tenant-configuration, document-numbering) and the iframe keep their own scroll. Done when a list longer than the window, in both short and tall windows, opens a low entry with the setting visible from its top.

Written by the indexing model from the issue text.

Description

Problem

In the application shell's Settings (the aggregated shell, e.g. a BusinessIntents "Склад" app -> Настройки), the list of settings on the left and the opened setting on the right scroll together, as one page.

With many modules the list is long (20+ entries). Choosing an entry low in it (Payment Methods is the 15th) leaves the page scrolled down, so the opened setting on the right starts above the visible area: the right side looks blank until the user scrolls back up.

Seen during a store test run (BusinessIntents store modules, Bulgarian UI).

Cause

components/resources/resources-application/src/main/resources/META-INF/dirigible/application/views/_settings.html, the left split panel:

<div x-h-split-panel data-size="25%" data-min="200">
  <div class="vbox gap-2 p-3">
    ...
    <ul x-h-list :aria-label="...">

Neither the panel's wrapper nor the list has a height bound or overflow-auto, so a long list overflows the panel and the scroll lands on an ancestor shared by both columns.

The per-project settings page generated for a single module already does this right: template-application-ui-harmonia-java/ui/shell/settings.html.template:18-19

<div class="vbox size-full min-w-0">
  <ul x-h-list class="flex-1 overflow-auto" ...>

Steps to reproduce

  1. Publish enough modules that the application shell's Settings lists more entries than fit the window height (e.g. the BusinessIntents store set).
  2. Open Settings, scroll the list down and pick an entry near the bottom.

Expected: the list scrolls on its own; the opened setting fills the right side from its top.
Actual: the whole page scrolls; the right side shows nothing until scrolled back up.

Suggested fix

  • Left panel wrapper: vbox gap-2 p-3 size-full min-h-0, and the list class="flex-1 overflow-auto", as in the per-project settings.html.template.
  • Check the right panel keeps its own scroll for the locally rendered pages (region-language, tenant-configuration, document-numbering, ...), which already carry size-full overflow-auto, and the iframe (absolute, full size).
  • Verify in a browser with a list longer than the window, in both a short and a tall window.
Dominant language
Java
Stars
278
Forks
97
Avg merge
15h 33m
Merged PRs (30d)
301

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from eclipse-dirigible/dirigible

All issues in eclipse-dirigible/dirigible

Similar issues

More Java issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.