Apps configuration page scrolls to the bottom on load when a field hint contains a code block

Đang mở Phù hợp với người mới
#38,134 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 2 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
2/5
Thời gian dự kiến
1-3 giờ
Mức phù hợp với người mới
82/100
Loại issue
Lỗi
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
angular, javascript, typescript
Lĩnh vực
accessibility, frontend

Hướng nghiên cứu

Bắt đầu với directive được nêu tại core-web/apps/dotcms-ui/src/app/portlets/dot-apps/components/dot-apps-configuration-detail/directives/dot-apps-code-block.directive.ts và theo dõi cách nó tạo rồi chèn DotCopyButtonComponent. Thêm hoặc tìm một unit test cho luồng chèn này. Công việc hoàn tất khi nút sao chép được chèn không có thuộc tính autofocus, mã vẫn được sao chép và các tiêu chí chấp nhận đều đạt.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

dotCMS : Analytics Team : Falcon
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 dotAppsCodeBlocks directive turns each code block in a markdown hint into a box with a copy button (DotCopyButtonComponent). It renders that button outside the page with createComponent() and then inserts it.
  • PrimeNG's p-button adds autofocus="true" to its inner <button> whenever its autofocus input is not set. Its AutoFocus directive only removes the attribute when it gets exactly false, and an unset input arrives as undefined.
  • The browser focuses an element that is inserted into the page with autofocus already 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
  1. Go to Apps → Content Analytics and create a configuration for the System Host (/dotAdmin/#/apps/dotContentAnalytics-config/create/SYSTEM_HOST).
  2. Wait for the form to load.
  3. Notice that the page scrolls to "Advanced Configuration (JSON)".
  4. In DevTools, document.activeElement is the code block's copy button and has autofocus="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 dotAppsCodeBlocks has no autofocus attribute 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 (the hint of advancedConfig)
Ngôn ngữ chính
Java
Star
972
Fork
493
Merge trung bình
2 ngày 12 giờ
Pull request đã merge (30 ngày)
237

Chuẩn bị môi trường

Mở trong Codespaces

Khởi chạy dev container của dự án ngay trên trình duyệt, bằng tài khoản GitHub của bạn.

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của dotCMS/core

Tất cả issue của dotCMS/core

Issue tương tự

Thêm issue về Java

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.