Skip to content

option to specify screen width at which point navbar is merged into sidebar #1272

@trusktr

Description

@trusktr

Feature request

The existing mergeSidebar option is nifty: it allows you to merge the navbar into the sidebar for smaller screens, otherwise it won't look right.

However, the navbar can still look funky at certain sizes that are bigger than the mobile size (768px and up).

For example:

bad-navbar

What problem does this feature solve?

An option would prevent cases when the navbar doesn't fit well at the top, even if the screen width is bigger than mobile.

What does the proposed API look like?

A new option (maybe something like mergeNavbarAtWidth) would allow us to specify a width at which the navbar should be merged.

How should this be implemented in your opinion?

We need to update the mergeNavbar feature to operate at runtime any time the width of the Docsify app is updated, instead of only at the beginning. Then, we need to merge the navbar when the width is below the specified size in the mergeNavbarAtWidth option.

We need to make this operate on resizes because people may resize their window.

At the moment, the merging only happens once initially, but if we resize our window from desktop size to mobile size then the navbar will not be merged. In this video I shrink my window and the menu does not get merged:

no-merge

If you visit the site on your mobile phone (https://lume.io/docs), or do a refresh when your desktop browser window is on mobile size, then you will see the menu inside of the sidebar like the following:

mobile-menu

Are you willing to work on this yourself?

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions