Release 150 tab split view functionality by rebloor · Pull Request #43589 · mdn/content

rebloor · 2026-03-26T18:17:33Z

Description

This PR addresses the dev-docs-needed requirements of:

Bug 2022549 tabs.move() taking a list of tabs should unsplit a split view when its tabs are explicitly listed apart
Bug 2016751 tabs.move() does not move a tab to the specified index when the destination is part of a split view

In addition, it adds a section summarizing the features for working with groups and split views in the working with the tab API article.

github-actions · 2026-03-26T18:19:03Z

Preview URLs (4 pages)

External URLs (5)

URL: /en-US/docs/Mozilla/Add-ons/WebExtensions/Working_with_the_Tabs_API
Title: Work with the Tabs API

https://github.com/w3c/webextensions/issues/967 (1 time) (Note! This may be a new URL 👀)
https://support.mozilla.org/en-US/kb/split-view-firefox (1 time) (Note! This may be a new URL 👀)
https://support.mozilla.org/en-US/kb/tab-groups (1 time) (Note! This may be a new URL 👀)

URL: /en-US/docs/Mozilla/Firefox/Releases/150
Title: Firefox 150 release notes for developers (Beta)

https://bugzil.la/2016762 (1 time) (Note! This may be a new URL 👀)
https://bugzil.la/2022549 (1 time) (Note! This may be a new URL 👀)

(comment last updated: 2026-03-29 23:15:46)

files/en-us/mozilla/add-ons/webextensions/api/tabs/move/index.md

Rob--W · 2026-03-26T18:26:00Z

files/en-us/mozilla/add-ons/webextensions/working_with_the_tabs_api/index.md

    });
    ```

+## Working with tab groups and split views


Tab groups and split views are distinct features. Please list them separately.

Done and links updated

Rob--W · 2026-03-26T18:26:57Z

files/en-us/mozilla/add-ons/webextensions/working_with_the_tabs_api/index.md

+> Features to work with a tab group are provided in {{WebExtAPIRef("tabGroups")}}.
+
+> [!NOTE]
+> APIs to enable the creation and removal of split views (without moving or removing the tabs) are being developed under ([Firefox bug 2016928](https://bugzil.la/2016928)).


Let's use w3c/webextensions#967 as a reference instead. This is a cross-browser API design effort.

Rob--W · 2026-03-26T18:27:44Z

files/en-us/mozilla/firefox/releases/150/index.md

 ## Changes for add-on developers

+- The behavior of {{WebExtAPIRef("tabs.move")}} is updated for split views so that:
+  - The order of tabs in a split view can be swapped.


Please include bug numbers for reference, since we usually do so.

How did I miss those! Added

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> Co-authored-by: Rob Wu <rob@robwu.nl>

github-actions · 2026-03-26T21:43:33Z

files/en-us/mozilla/add-ons/webextensions/working_with_the_tabs_api/index.md

+
+> [!NOTE]
+> APIs to enable the creation and removal of split views (without moving or removing the tabs) are being developed under W3C
+web extensions issue [#967](https://github.com/w3c/webextensions/issues/967).


[mdn-linter] _{reported by reviewdog 🐶}

Suggested change

web extensions issue [#967](https://github.com/w3c/webextensions/issues/967).

> web extensions issue [#967](https://github.com/w3c/webextensions/issues/967).

files/en-us/mozilla/add-ons/webextensions/api/tabs/move/index.md

Rob--W · 2026-03-27T00:27:07Z

files/en-us/mozilla/add-ons/webextensions/api/tabs/move/index.md

 You can only move tabs to and from windows whose {{WebExtAPIRef('windows.WindowType', 'WindowType')}} is `"normal"`.

-When the call moves a tab or tabs in a split view, Firefox moves the tabs in the split view together to preserve the split view. In Chrome, moving a tab away from the other tab in a split view removes the split view.
+In Chrome, moving a tab away from the other tab in a split view removes the split view. This behavior may change in a future release.


Let's move this to a note below so that we introduce the split view behavior and only after that clarify that Chrome's behavior differs. I image that when the implementation changes that we want to document the standard behavior first and then have a note about older versions.

files/en-us/mozilla/add-ons/webextensions/working_with_the_tabs_api/index.md

Rob--W · 2026-03-27T00:44:03Z

files/en-us/mozilla/add-ons/webextensions/working_with_the_tabs_api/index.md


+## Working with tab groups
+
+Tab functionality enables users to create [group tabs](https://support.mozilla.org/en-US/kb/tab-groups).


I asked for a "split views" article because we don't have a better place to offer an overview of its capability and describe it.

For tab groups, the tabGroups API reference serves that purpose, and is linked from various places such as https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/tabs/Tab#groupid

Can we use that as the canonical place for the description of what tab groups are instead of linking to SUMO here (that SUMO article is already linked from tabGroups MDN page).

Rob--W · 2026-03-27T00:56:48Z

files/en-us/mozilla/add-ons/webextensions/working_with_the_tabs_api/index.md

+
+Tab functionality lets display two tabs side-by-side in a [split view](https://support.mozilla.org/en-US/kb/split-view-firefox).
+
+Various tab methods enable you to work with the content of groups and split views, including:


Please add text offering the following overview of relevant details. I am asking for this so we have one place where a dev can learn at once what they should do if they want to work with split views:

split view consists of exactly two adjacent tabs

when an individual tab of a split is moved, the other tab in the split moves with it to preserve the split (the emphasis here is to show that conceptually the pair of tabs in a split view should be regarded as one unit). The moved tab that moves along can be observed with tabs.onMoved.

when a tab is removed, the other tab in the split remains but is no longer part of a split view

given a tab, whether it is a member of a split view can be seen through its splitViewId property (https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/tabs/Tab#splitviewid ). Split view membership changes can be observed through tabs.onUpdated

Rob--W · 2026-03-27T01:03:19Z

files/en-us/mozilla/add-ons/webextensions/working_with_the_tabs_api/index.md

+> [!NOTE]
+> Features to work with a tab group are provided in {{WebExtAPIRef("tabGroups")}}.
+
+## Working with tab split views


As noted in the comment above I asked for a split view section to have a canonical place to document the split view concept. Can we link here instead of to SUMO in other places in the doc? Basically #43576 but then linking here instead of SUMO.

Co-authored-by: Rob Wu <rob@robwu.nl>

Release 150 tab split view functionality

2863217

rebloor requested a review from Rob--W March 26, 2026 18:17

rebloor self-assigned this Mar 26, 2026

rebloor added the Content:WebExt WebExtensions docs label Mar 26, 2026

rebloor requested review from a team as code owners March 26, 2026 18:17

rebloor requested review from dipikabh and removed request for a team March 26, 2026 18:17

github-actions bot added Content:Firefox Content in the Mozilla/Firefox subtree size/s [PR only] 6-50 LoC changed labels Mar 26, 2026

linter nits

6565561

Rob--W reviewed Mar 26, 2026

View reviewed changes

rebloor and others added 2 commits March 27, 2026 10:18

Apply suggestions from review

9328cb8

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> Co-authored-by: Rob Wu <rob@robwu.nl>

Feedback updates

8743634

github-actions bot added size/m [PR only] 51-500 LoC changed and removed size/s [PR only] 6-50 LoC changed labels Mar 26, 2026

github-actions bot reviewed Mar 26, 2026

View reviewed changes

joined lines

17dad6f

rebloor requested a review from Rob--W March 26, 2026 21:46

Rob--W reviewed Mar 27, 2026

View reviewed changes

Apply suggestions from @Rob--W

f4628ff

Co-authored-by: Rob Wu <rob@robwu.nl>

	web extensions issue [#967](https://github.com/w3c/webextensions/issues/967).
	> web extensions issue [#967](https://github.com/w3c/webextensions/issues/967).


		## Working with tab groups

		Tab functionality enables users to create [group tabs](https://support.mozilla.org/en-US/kb/tab-groups).


		Tab functionality lets display two tabs side-by-side in a [split view](https://support.mozilla.org/en-US/kb/split-view-firefox).

		Various tab methods enable you to work with the content of groups and split views, including:

Conversation

rebloor commented Mar 26, 2026

Description

Uh oh!

github-actions bot commented Mar 26, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

github-actions bot Mar 26, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

github-actions bot commented Mar 26, 2026 •

edited

Loading