Skip to content

docs(tabs): document headerPosition for Angular and Web Components - #1016

Merged
ChronosSF merged 14 commits into
vnextfrom
vkombov/tabs-header-position
Nov 12, 2026
Merged

ChronosSF merged 14 commits into
vnextfrom
vkombov/tabs-header-position

Conversation

@viktorkombov

@viktorkombov viktorkombov commented Nov 4, 2026 •

Copy link
Copy Markdown
Contributor

Closes #1002
Closes #1003

Documents the new headerPosition option of the Tabs for Angular and Web Components, which places the tab headers in a column on the start or end side of the content. Adds a Header Position section and covers a column in Responsiveness, Properties, Keyboard Interaction, Screen Readers / ARIA, Styling, API References and FAQ.

Merge after the samples are deployed (IgniteUI/igniteui-angular-samples#4071, IgniteUI/igniteui-wc-examples#1309). The headerPosition and IgxTabsHeaderPosition API links render as plain code until a separate PR adds them to the ApiLink registries.

Checklist:

  • check topic's TOC/menu and paragraph headings
  • Include TOC topic labels in the topic content when it has a valuable update, is new, or is considered preview / beta
  • link to other topics using ./page.mdx or ../relative/path.mdx (.mdx extension required)
  • at the References section at the end of the topic add links to topics, samples, etc
  • reference API documentation instead of adding a section with API

  • use valid component names - [Data] Grid, IgxSelectComponent, <igx-combo>
  • use spell checker tool (VS Code, Grammarly, Microsoft Editor)
  • add inline code blocks for the names of classes / tags / properties
  • add language descriptor for the code blocks
  • check if links function by running the check-api/mdx npm commands
  • check if sample is working and fully visible in the topic
  • check if sample is working and fully visible in the StackBlitz
  • check if code blocks match the code in StackBlitz demo
  • add or update meaningful llms.description metadata and run npm run check:llms-metadata


  • do not resolve requested changes (leave that to the reviewer)

🤖 Generated with Claude Code

Hristo313 and others added 8 commits October 14, 2026 14:32
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- Replace the inline-styled grid with two DoDont blocks; texts and alts unchanged
- Crop the Do/Don't images to the bare tabs, since DoDont draws the frame and badge
- Bump igniteui-astro-components to 1.6.0, the first release with DoDont

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Add a Header Position section to the shared tabs topic, and cover a
column of tab headers in Responsiveness, Properties, Keyboard
Interaction, Screen Readers / ARIA, Accessibility Compliance, Styling,
API References and FAQ. The new content is shown for Angular and Web
Components only, because the React and Blazor packages don't have
headerPosition yet.

Closes #1002
Closes #1003

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@viktorkombov viktorkombov added 🛠️ status: in-development Issues and PRs with active development on them tabs labels Nov 4, 2026
@viktorkombov
viktorkombov requested a balanced review from Copilot November 4, 2026 11:25

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

🟡 Changes recommended

The Header Position embeds reference unavailable samples, leaving broken demos unless both embeds are replaced with TODO comments until the samples are implemented and deployed.

1 open issue
What changed in this PR

Updates the shared Tabs topic to document vertical tab headers through headerPosition for Angular and Web Components, while keeping the feature-specific content hidden from React and Blazor.

Changes:

  • Adds Header Position guidance, code snippets, and sample embeds.
  • Explains column alignment, sizing, scrolling, right-to-left behavior, and styling.
  • Updates properties, keyboard interaction, accessibility, API references, and FAQ.
File Description
docs/​xplat/​src/​content/​en/​components/​layouts/​tabs.mdx Documents vertical tab headers for Angular and Web Components throughout the shared Tabs topic.

Review effort: Balanced

viktorkombov and others added 2 commits November 10, 2026 18:19
…position

# Conflicts:
#	docs/xplat/src/content/en/components/layouts/tabs.mdx
Check the Header Position content against igniteui-angular and
igniteui-webcomponents master after both headerPosition PRs merged, and
fix what changed or was missing:

- column width: a narrow Web Components Tabs shares the width with the
  content, and an Angular column keeps its width
- long labels: a long word breaks, and the label is truncated with an
  ellipsis after the second line
- height: which containers limit the Tabs on each platform
- Bootstrap: the rounded outer corners apply to Web Components too
- router tabs: show the routed views beside the column in a flex row
- the versions that add headerPosition, the strictTemplates note for
  the bound value, and IgxTabsHeaderPosition in API References

Also follow the redesigned topic: move Header Position after States,
keep the column details in Header Position and the theme details in
Styling, and write "the Tabs component" in the new sentences.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

🟡 Changes recommended

Active demo embeds point to unavailable samples, and the new API references lack registry entries, leaving them without usable links.

2 open issues
1 resolved since last review

Review effort: Balanced

@ChronosSF ChronosSF left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

@viktorkombov , my main gripe with the change is that it's not very compliant with how we want the usage sections of the new topics to look. The usage sections have very concise descriptions that lean on the code snippet and sample, rather than prose. If you run the topic your section is probably bigger than all others combined. I went through the information and while it is rather nice, I think we can omit a lot of it as inferable. Remember that the docs are now aimed at bots first, rather than humans.

Do a rework on just the prose to compact it as much as possible and leave the inferable info out. You can PR it on top of this so we can compare .

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…ompact

docs(tabs): compact the headerPosition prose
@ChronosSF ChronosSF added ✅ status: verified Applies to PRs that have passed manual verification and removed 🛠️ status: in-development Issues and PRs with active development on them do not merge labels Nov 12, 2026
@ChronosSF
ChronosSF self-requested a review November 12, 2026 15:00
@ChronosSF
ChronosSF merged commit d2f70cf into vnext Nov 12, 2026
16 checks passed
@ChronosSF
ChronosSF deleted the vkombov/tabs-header-position branch November 12, 2026 15:01
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

tabs ✅ status: verified Applies to PRs that have passed manual verification

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Tabs (Web Components 7.5): vertical tab headers with headerPosition Tabs (Angular 22.3): vertical tab headers with headerPosition

4 participants