Skip to content

[JENKINS-75637] Fix System configuration page no longer having breadcrumb navigation #10715

Merged
krisstern merged 10 commits intojenkinsci:masterfrom
janfaracik:fix-breadcrumb-config-outline
Jul 18, 2025
Merged

[JENKINS-75637] Fix System configuration page no longer having breadcrumb navigation #10715
krisstern merged 10 commits intojenkinsci:masterfrom
janfaracik:fix-breadcrumb-config-outline

Conversation

@janfaracik
Copy link
Copy Markdown
Member

@janfaracik janfaracik commented Jun 2, 2025

See JENKINS-75637.

This PR restores the breadcrumb menu for pages that use breadcrumb-config-outline - currently just the Manage Jenkins > System page in core. To show the menu hover over the breadcrumb item and you'll see a list of the sections on the page.

image

Also fixes submenus not opening as expected.

Testing done

  • List shows

Proposed changelog entries

  • Fix System configuration page no longer having breadcrumb navigation

Proposed changelog category

/label bug

Proposed upgrade guidelines

N/A

Submitter checklist

  • The Jira issue, if it exists, is well-described.
  • The changelog entries and upgrade guidelines are appropriate for the audience affected by the change (users or developers, depending on the change) and are in the imperative mood (see examples). Fill in the Proposed upgrade guidelines section only if there are breaking changes or changes that may require extra steps from users during upgrade.
  • There is automated testing or an explanation as to why this change has no tests.
  • New public classes, fields, and methods are annotated with @Restricted or have @since TODO Javadocs, as appropriate.
  • New deprecations are annotated with @Deprecated(since = "TODO") or @Deprecated(forRemoval = true, since = "TODO"), if applicable.
  • New or substantially changed JavaScript is not defined inline and does not call eval to ease future introduction of Content Security Policy (CSP) directives (see documentation).
  • For dependency updates, there are links to external changelogs and, if possible, full differentials.
  • For new APIs and extension points, there is a link to at least one consumer.

Desired reviewers

N/A

Before the changes are marked as ready-for-merge:

Maintainer checklist

  • There are at least two (2) approvals for the pull request and no outstanding requests for change.
  • Conversations in the pull request are over, or it is explicit that a reviewer is not blocking the change.
  • Changelog entries in the pull request title and/or Proposed changelog entries are accurate, human-readable, and in the imperative mood.
  • Proper changelog labels are set so that the changelog can be generated automatically.
  • If the change needs additional upgrade steps from users, the upgrade-guide-needed label is set and there is a Proposed upgrade guidelines section in the pull request title (see example).
  • If it would make sense to backport the change to LTS, a Jira issue must exist, be a Bug or Improvement, and be labeled as lts-candidate to be considered (see query).

@comment-ops-bot comment-ops-bot Bot added the bug For changelog: Minor bug. Will be listed after features label Jun 2, 2025
@MarkEWaite MarkEWaite added the web-ui The PR includes WebUI changes which may need special expertise label Jun 4, 2025
@scherler
Copy link
Copy Markdown
Contributor

scherler commented Jun 9, 2025

LGTM

@jtnord
Copy link
Copy Markdown
Member

jtnord commented Jun 25, 2025

@janfaracik what is the status of this, is there something holdiing it up or an issue with the approach?

@MarkEWaite
Copy link
Copy Markdown
Contributor

@janfaracik I'm interested in this pull request as a possible backport for the 2.516.1 LTS release. Is there anything I can do to help it move from draft to ready for review?

@janfaracik janfaracik marked this pull request as ready for review July 2, 2025 08:22
@janfaracik
Copy link
Copy Markdown
Member Author

Hey folks.

I've opened up the PR for review - I've given it a spin and it's working as expected, my only issue with it is that the menu doesn't close when you click an item. I didn't see an easy way to fix that without the risk of introducing regressions unintentionally. If that behaviour is fine then this PR seems good to go.

@janfaracik
Copy link
Copy Markdown
Member Author

Updated this so that the menu now hides on item click. Would appreciate some testing on this to confirm I haven't broken anything -

I've tested:

  • Breadcrumb config outline works
  • Credentials breadcrumb item works
  • Repeatable list dropdown works
  • Design Library Menu page - works as expected

Comment thread src/main/js/components/dropdowns/utils.js
Copy link
Copy Markdown
Contributor

@scherler scherler left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I have tested on my system besides some of the points he tested and have found one regression but it is not due to this PR but I guess a general problem with #links type linking where the header will hide the heading

image

Besides my code change suggestion I think is ready go, i will create a ticket for the above so we can follow on it.

Comment thread core/src/main/resources/lib/layout/breadcrumb.jelly Outdated
@janfaracik
Copy link
Copy Markdown
Member Author

I have tested on my system besides some of the points he tested and have found one regression but it is not due to this PR but I guess a general problem with #links type linking where the header will hide the heading

image

Besides my code change suggestion I think is ready go, i will create a ticket for the above so we can follow on it.

Added a fix for this - thanks!

@github-actions github-actions Bot added the unresolved-merge-conflict There is a merge conflict with the target branch. label Jul 10, 2025
@github-actions
Copy link
Copy Markdown
Contributor

Please take a moment and address the merge conflicts of your pull request. Thanks!

@github-actions github-actions Bot removed the unresolved-merge-conflict There is a merge conflict with the target branch. label Jul 15, 2025
@timja timja requested a review from a team July 15, 2025 21:10
Comment thread src/main/js/components/dropdowns/utils.js
Copy link
Copy Markdown
Member

@timja timja left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM, seems fine now.

General UX of it isn't great and I don't think this should really be a thing but there should be better in-page navigation.

@timja
Copy link
Copy Markdown
Member

timja commented Jul 16, 2025

/label ready-for-merge


This PR is now ready for merge, after ~24 hours, we will merge it if there's no negative feedback.

Thanks!

@comment-ops-bot comment-ops-bot Bot added the ready-for-merge The PR is ready to go, and it will be merged soon if there is no negative feedback label Jul 16, 2025
Copy link
Copy Markdown

@A1exKH A1exKH left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM.

@alecharp
Copy link
Copy Markdown
Member

I think we forgot to merge this pull request. I don't have permissions to do so but can you @timja ?

@krisstern krisstern merged commit a765226 into jenkinsci:master Jul 18, 2025
18 checks passed
@krisstern
Copy link
Copy Markdown
Member

@alecharp merged

@timja timja deleted the fix-breadcrumb-config-outline branch July 24, 2025 18:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

bug For changelog: Minor bug. Will be listed after features ready-for-merge The PR is ready to go, and it will be merged soon if there is no negative feedback web-ui The PR includes WebUI changes which may need special expertise

Projects

None yet

Development

Successfully merging this pull request may close these issues.

8 participants