Skip to content
Last updated

Things to try

  • If you use the same tab set twice on a page (e.g. language selectors), does the selected value stay in sync? When we add two tabs with the same label then both of them are rendered

    tabs-sync.png
  • Can you deep link to a specific tab? If so, how does it work?

    We didn't find any documentation about links usage in tabs. When we tried to add a link with tab label as id (f.e. #JS) nothing has changed

  • What happens if a user hits “back” in the browser — does the tab remember its state?

    Tab does not remember it's state, when we go back to the tabs page the initial tab is opened by default.

  • Does your tab layout hold up in mobile view?

    Yes, even when we added 10+ tabs they looked good in mobile view preserving all visibility.

  • Document what you learn — especially if you discover weird behavior or nice surprises.

    We wanted to add link to the {% img %} and discovered that there is no such attribute as 'href'. It is still possible to do via default markdown link tag, but would be nice to have such possibility in our img markdoc tag.

When do tabs improve the experience? When do they make things worse?

  • It improves the experience when we have a lot of similar content on the page that can be grouped into tabs, so user does not need to scroll a lot.
  • However, it is not good when we want to make a comparison because in such case we need to go back and forth between tabs a lot of times and having two these items side-by-side would be more efficient.

Did anything feel clunky?

  • Everything went smoothly

Any layout bugs or surprises?

  • The only thing is how tabs with same label rendering works. Shouldn't they render separately even when the same label used?

Share your thoughts on the “things to try” — what worked, what didn’t, and what you’d avoid in real docs.

  • All docs examples were very similar. The only thing that changes is the content, but all syntax stays the same. Would be great if there were some nested tabs examples, how sync works with the same label works etc.