Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

New design for tabs block #3312

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
zenoachtig wants to merge 11 commits into main
base: main
Choose a base branch
Loading
from redesign-tabs
Open

New design for tabs block #3312

zenoachtig wants to merge 11 commits into main from redesign-tabs

Conversation

@zenoachtig
Copy link
Contributor

@zenoachtig zenoachtig commented Jun 12, 2025
edited
Loading

This PR redesigns the tabs block and gets it ready for alternative layouts and tab descriptions. With these changes, tabs look more modern and can become an important building block in landing pages.

Style

In its default use, tabs remain similar as before, just with some updated styling.

Screen.Recording.2025年06月23日.at.16.37.08.mov

Tabs wrap onto new lines if necessary.

Screenshot 2025年06月23日 at 16 40 33

Some examples of the new style in the wild:

Screenshot 2025年06月23日 at 16 46 15 Screenshot 2025年06月23日 at 16 47 38 Screenshot 2025年06月23日 at 16 48 06 Screenshot 2025年06月23日 at 16 49 16

Position

Two new properties are to be added on the Tabs block in the editor:

  • orientation: horizontal | vertical refers to the aria-orientation of the tabslist.
  • position: start | end refers to the logical position of the tabslist, based on the writing mode of the document. In LTR, start refers to the left and end refers to the right of the tabs.
    Taken together, these properties together determine what side of the container tabs appear on.

Supported values are:

  • horizontal + start: The default. A horizontal row of tabs, shown above the content.
  • vertical + start: A vertical column of tabs to the left (in LTR) of the content.
  • vertical + end: A vertical column of tabs to the right (in LTR) of the content.
  • We explicitly don't support horizontal + end, at least for now.

horizontal + start

Screen.Recording.2025年06月23日.at.16.37.08.mov

vertical + start

Screen.Recording.2025年06月23日.at.16.50.09.mov

vertical + end

Screen.Recording.2025年06月23日.at.16.50.41.mov

Description

A new description value (to be added on individual Tabs in the editor) can optionally be specified. When added, tabs take up a bit more padding and increase their font size. This is useful when building feature explanation blocks.

horizontal + start

Screen.Recording.2025年06月23日.at.16.51.11.mov

vertical + start

Screen.Recording.2025年06月23日.at.16.52.08.mov

vertical + end

Screen.Recording.2025年06月23日.at.16.52.40.mov

Mobile

On mobile, tab blocks (no matter their position) are shown side by side. When there are a lot of tabs or they take up a lot of width, they are shown in a scrolling container.

Default mobile experience

ScreenRecording_06-23-2025.16-57-24_1.MP4

With description set

ScreenRecording_06-23-2025.17-00-08_1.mov

Copy link

changeset-bot bot commented Jun 12, 2025
edited
Loading

🦋 Changeset detected

Latest commit: 44fb836

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package
Name Type
gitbook Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

Copy link

argos-ci bot commented Jun 12, 2025
edited
Loading

The latest updates on your projects. Learn more about Argos notifications ↗︎

Build Status Details Updated (UTC)
customers-v1 (Inspect) 👍 Changes approved 4 changed Jun 23, 2025, 3:16 PM
customers-v2 (Inspect) 👍 Changes approved 78 changed Jun 23, 2025, 3:19 PM
default (Inspect) 👍 Changes approved 12 changed Jun 23, 2025, 3:21 PM
v2-cloudflare (Inspect) 👍 Changes approved 12 changed Jun 23, 2025, 3:20 PM
v2-vercel (Inspect) ⚠️ Changes detected (Review) 12 changed, 1 failure Jun 23, 2025, 3:31 PM

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

AltStyle によって変換されたページ (->オリジナル) /