Apps configuration page scrolls to the bottom on load when a field hint contains a code block
Maintainers usually reply within 2 days
Nobody has claimed this yet.
Assessment
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Newbie friendliness
- 82/100
- Issue type
- Bug
- Clarity
- Clearly specified
- Activity status
- Active
- Tech stack
- angular, javascript, typescript
- Domain
- accessibility, frontend
Research direction
Start with the named directive at core-web/apps/dotcms-ui/src/app/portlets/dot-apps/components/dot-apps-configuration-detail/directives/dot-apps-code-block.directive.ts and trace how it creates and inserts DotCopyButtonComponent. Add or locate a unit test for that insertion path. Done means the inserted copy button has no autofocus attribute, the code still copies, and the acceptance criteria pass.
Written by the indexing model from the issue text.
Description
Problem Statement
When an App's configuration page loads, it scrolls down to the "Advanced Configuration (JSON)" field instead of staying at the top. Users land in the middle of the form and have to scroll back up to see the first fields. You can see it on the Content Analytics App.
The jump happens because the copy button inside the hint's code block gets focus by itself.
- The
dotAppsCodeBlocksdirective turns each code block in a markdown hint into a box with a copy button (DotCopyButtonComponent). It renders that button outside the page withcreateComponent()and then inserts it. - PrimeNG's
p-buttonaddsautofocus="true"to its inner<button>whenever itsautofocusinput is not set. ItsAutoFocusdirective only removes the attribute when it gets exactlyfalse, and an unset input arrives asundefined. - The browser focuses an element that is inserted into the page with
autofocusalready on it, and scrolls to it. Buttons that were already on the page don't trigger this. This one does, because it is inserted after being rendered.
This affects any App whose YAML puts a fenced code block in a field hint. The App YAML has no setting that controls this; the fix has to be in the frontend.
https://github.com/user-attachments/assets/67afb58c-9907-49c3-96e1-1bc5f36cc03a
Steps to Reproduce
- Go to Apps → Content Analytics and create a configuration for the System Host (
/dotAdmin/#/apps/dotContentAnalytics-config/create/SYSTEM_HOST). - Wait for the form to load.
- Notice that the page scrolls to "Advanced Configuration (JSON)".
- In DevTools,
document.activeElementis the code block's copy button and hasautofocus="true".
Acceptance Criteria
- An App configuration page opens scrolled to the top, even when a field hint contains a code block.
- Nothing in the hint's code block takes focus on page load.
- The copy button in the code block still shows and copies the code.
- A unit test covers that the copy button created by
dotAppsCodeBlockshas noautofocusattribute when it is inserted.
dotCMS Version
main (introduced with the code block directive in #37897).
Severity
Low - Minor issue or cosmetic
Links
- PR that added the directive: #37897
- Directive:
core-web/apps/dotcms-ui/src/app/portlets/dot-apps/components/dot-apps-configuration-detail/directives/dot-apps-code-block.directive.ts - App descriptor where it shows up:
dotCMS/src/main/resources/apps/dotContentAnalytics-config.yml(thehintofadvancedConfig)
- Dominant language
- Java
- Stars
- 972
- Forks
- 493
- Avg merge
- 2d 12h
- Merged PRs (30d)
- 237
Getting set up
Starts the project's dev container in your browser, under your own GitHub account.
- No Dockerfile or Docker Compose file
- Has a pull request template
- Read the contributing guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from dotCMS/core
-
OKR : Customer Support Team : Maintenance Type : Defect
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
Maintainers usually reply within 2 days
-
Opening content from Content Search replaces the "Search" breadcrumb in the new Edit Content screenOpendotCMS: New Edit Contentlet OKR : Customer Support Team : Falcon Type : Defect
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
Maintainers usually reply within 2 days
-
Escape the Binary field hint in the legacy content editor so an apostrophe doesn't break the fieldOpenOKR : Customer Support Team : Maintenance Type : Defect
Difficulty 2/5 1-3 hours Newbie friendliness 79/100
Maintainers usually reply within 2 days
-
dotCMS : Permissions OKR : Customer Support Team : Maintenance Type : Defect
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
Maintainers usually reply within 2 days
-
OKR : Customer Support Team : Maintenance Type : Defect
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
Maintainers usually reply within 2 days
Similar issues
-
enhancement
Difficulty 2/5 1-3 hours Newbie friendliness 70/100
it-at-m/Wahllokalsystem#3846 ·
Maintainers usually reply within 2 days
-
Area/Connector module/solace Priority/Low Type/Bug
Difficulty 2/5 1-3 hours Newbie friendliness 77/100
ballerina-platform/ballerina-library#9849 ·
Maintainers usually reply within 1 day
-
Difficulty 1/5 Under an hour Newbie friendliness 65/100
Vakore/ZappierGames#327 ·
-
bug
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
Maintainers usually reply within 1 day
-
Radix number block generates NaN after switching a negative or decimal number to binary, octal or hexPossibly taken @matthewalberto claimed this today. Open
Difficulty 2/5 1-3 hours Newbie friendliness 64/100
mit-cml/appinventor-sources#4246 · 1 comment ·
Maintainers usually reply within 1 day