Release 150 tab split view functionality (mdn#43589)

* Release 150 tab split view functionality

* linter nits

* Apply suggestions from review

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

* Feedback updates

* joined lines

* Apply suggestions from @Rob--W

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

* Feedback updates, including:
- removing working with tab groups from working with the tabs API article and adding additional details to the tabGroups API overview.
- adding additional details to the working with split tabs in the working with the tabs API article
- adding links to the working with split tabs section in the working with the tabs ID article
- rewording the information about moving a tab in a split view

* Apply suggestions from code review

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

* nits

---------

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

Author: 3 people

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

@@ -10,7 +10,14 @@ This API enables extensions to modify and rearrange [tab groups](https://support
 
 Tab groups may persist across browser restarts as part of session restore. Tab groups in private browsing windows do not persist across restarts. When a tab group is restored, its `groupId` may differ from its original value.
 
-The `tabGroups` API doesn't offer the ability to create or remove tab groups. Use the {{WebExtAPIRef("tabs.group()")}} and {{WebExtAPIRef("tabs.ungroup()")}} methods instead. To query the position of a tab group within a window, use {{WebExtAPIRef("tabs.query()")}}. These APIs in the `tabs` namespace don't require any permissions.
+The `tabGroups` API doesn't offer the ability to create, alter, or remove tab groups. Use:
+
+- {{WebExtAPIRef("tabs.group")}} and {{WebExtAPIRef("tabs.ungroup")}} to create or remove groups.
+- {{WebExtAPIRef("tabs.move")}} to move tabs within, into, or out of a group.
+- {{WebExtAPIRef("tabs.remove")}} to close tabs in a group, and close the group if the tab was the last one in the group.
+- {{WebExtAPIRef("tabs.query")}} to query the position of a tab group within a window.
+
+These APIs in the `tabs` namespace don't require any permissions.
 
 ## Permissions
 

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

@@ -50,7 +50,7 @@ Many tab operations use a Tab `id`. Tab `id`s are guaranteed to be unique to a s
 - {{WebExtAPIRef("tabs.TAB_ID_NONE")}}
   - : A special ID value given to tabs that are not browser tabs (for example, tabs in devtools windows).
 - {{WebExtAPIRef("tabs.SPLIT_VIEW_ID_NONE")}}
-  - : A special ID value given to tabs that aren't in a split view.
+  - : A special ID value given to tabs that aren't in a [split view](/en-US/docs/Mozilla/Add-ons/WebExtensions/Working_with_the_Tabs_API#working_with_tab_split_views).
 
 ## Functions
 

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

@@ -10,7 +10,15 @@ Moves one or more tabs to a new position in the same window or to a different wi
 
 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.
+When tabs associated with a [split view](/en-US/docs/Mozilla/Add-ons/WebExtensions/Working_with_the_Tabs_API#working_with_tab_split_views) are moved:
+
+- When both tabs in a split are specified and they remain adjacent but their order is changed, the tabs are swapped in the split view.
+- When both tabs in a split view are specified but are separated by one or more tabs, the tabs are moved and the split view removed.
+- When only one of the tabs in a split view is moved:
+  - In Firefox, the other tab is moved to preserve the split view. The tabs are re-ordered if necessary.
+    > [!NOTE]
+    > In Firefox 149 only, when a call moves a tab or tabs in a split view, the tabs in the split view are moved together, but the order of the tabs is unchanged.
+  - In Chrome, moving a tab away from the other tab in the split view removes the split view. (This behavior may change in a future release.) Otherwise, the tabs are re-ordered as necessary.
 
 ## Syntax
 

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

@@ -108,7 +108,7 @@ Lists the changes to the state of the tab that is updated. To learn more about t
 - `pinned` {{optional_inline}}
   - : `boolean`. The tab's new pinned state.
 - `splitViewId` {{optional_inline}}
-  - : `integer`. The ID of the split view the tab belongs to. Set to {{WebExtAPIRef('tabs.SPLIT_VIEW_ID_NONE')}} when the tab doesn't belong to a split view.
+  - : `integer`. The ID of the [split view](/en-US/docs/Mozilla/Add-ons/WebExtensions/Working_with_the_Tabs_API#working_with_tab_split_views) the tab belongs to. Set to {{WebExtAPIRef('tabs.SPLIT_VIEW_ID_NONE')}} when the tab doesn't belong to a split view.
 - `status` {{optional_inline}}
   - : `string`. The status of the tab. Can be either _loading_ or _complete_.
 - `title` {{optional_inline}}

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

@@ -49,7 +49,7 @@ let querying = browser.tabs.query(queryInfo)
     - `pinned` {{optional_inline}}
       - : `boolean`. Whether the tabs are pinned.
     - `splitViewId` {{optional_inline}}
-      - : `integer`. The ID of the split view the tab belongs to. Set to {{WebExtAPIRef('tabs.SPLIT_VIEW_ID_NONE')}} to query the tabs that don't belong to a split view.
+      - : `integer`. The ID of the [split view](/en-US/docs/Mozilla/Add-ons/WebExtensions/Working_with_the_Tabs_API#working_with_tab_split_views) the tab belongs to. Set to {{WebExtAPIRef('tabs.SPLIT_VIEW_ID_NONE')}} to query the tabs that don't belong to a split view.
     - `status` {{optional_inline}}
       - : {{WebExtAPIRef('tabs.TabStatus')}}. Whether the tabs have completed loading.
     - `title` {{optional_inline}}

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

@@ -10,8 +10,8 @@ Closes one or more tabs.
 
 If any of the tabs are:
 
-- part of a split view, the split view is removed.
-- the last tab in a group, the group is removed.
+- part of a [split view](/en-US/docs/Mozilla/Add-ons/WebExtensions/Working_with_the_Tabs_API#working_with_tab_split_views), the split view is removed.
+- the last tab in a {{WebExtAPIRef("tabGroups","group")}}, the group is removed.
 
 ## Syntax
 

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

@@ -6,7 +6,7 @@ browser-compat: webextensions.api.tabs.SPLIT_VIEW_ID_NONE
 sidebar: addonsidebar
 ---
 
-A special ID value given to tabs that aren't in a split view.
+A special ID value given to tabs that aren't in a [split view](/en-US/docs/Mozilla/Add-ons/WebExtensions/Working_with_the_Tabs_API#working_with_tab_split_views).
 
 Its value is `-1`.
 

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

@@ -65,7 +65,7 @@ Values of this type are objects. They contain the following properties:
 - `sessionId` {{optional_inline}}
   - : `string`. The session ID used to uniquely identify a `Tab` obtained from the {{WebExtAPIRef('sessions')}} API.
 - `splitViewId` {{optional_inline}}
-  - : `integer`. The ID of the split view the tab belongs to. Set to {{WebExtAPIRef('tabs.SPLIT_VIEW_ID_NONE')}} when the tab doesn't belong to a split view.
+  - : `integer`. The ID of the [split view](/en-US/docs/Mozilla/Add-ons/WebExtensions/Working_with_the_Tabs_API#working_with_tab_split_views) the tab belongs to. Set to {{WebExtAPIRef('tabs.SPLIT_VIEW_ID_NONE')}} when the tab doesn't belong to a split view.
 - `status` {{optional_inline}}
   - : `string`. Either _loading_ or _complete_.
 - `successorTabId` {{optional_inline}}

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

@@ -7,15 +7,16 @@ sidebar: addonsidebar
 
 Tabs let a user open several web pages in their browser window and then switch between those web pages. With the Tabs API, you can work with and manipulate these tabs to create utilities that provide users with new ways to work with tabs or to deliver the features of your extension.
 
-In this how-to article we'll look at:
+This how-to article look at:
 
 - Permissions needed to use the Tabs API.
 - Discovering more about tabs and their properties using {{WebExtAPIRef("tabs.query")}}.
 - Creating, duplicating, moving, updating, reloading, and removing tabs.
 - Manipulating a tab's zoom level.
 - Manipulating a tab's CSS.
+- Manipulating tab groups and [split views](#working_with_tab_split_views).
 
-We then conclude by looking at some other, miscellaneous features offered by the API.
+The article concludes by looking at some other, miscellaneous features offered by the API.
 
 > [!NOTE]
 > There are some Tab API features covered elsewhere. These are the methods you can use to manipulate tab content with scripts ({{WebExtAPIRef("tabs.connect")}}, {{WebExtAPIRef("tabs.sendMessage")}}, and {{WebExtAPIRef("tabs.executeScript")}}). If you want more information on these methods, see the Concepts article [Content scripts](/en-US/docs/Mozilla/Add-ons/WebExtensions/Content_scripts) and the how-to guide [Modify a web page](/en-US/docs/Mozilla/Add-ons/WebExtensions/Modify_a_web_page).
@@ -553,6 +554,19 @@ Let's walk through how it's set up.
     });
     ```
 
+## Working with tab split views
+
+Tab functionality lets users display two tabs, side-by-side in a [split view](https://support.mozilla.org/en-US/kb/split-view-firefox).
+
+In the UI, a split view is treated as one unit, so that when someone moves a tab in a split, the other tab in the split moves with it, preserving the split. Your extension can observe the moved tab using {{WebExtAPIRef("tabs.onMoved")}}. The split behavior is the same when moving one tab in the split with {{WebExtAPIRef("tabs.move")}}. However, specifying both split tabs in a move and placing a tab between them closes the split.
+
+When someone closes one of the tabs in a split, the split view closes and the other tab remains. Your extension can remove a split's tab using {{WebExtAPIRef("tabs.remove")}}.
+
+Your extension can find out if a tab is in a split view using its [`splitViewId`](/en-US/docs/Mozilla/Add-ons/WebExtensions/API/tabs/Tab#splitviewid). Split view membership changes are observed using {{WebExtAPIRef("tabs.onUpdated")}}.
+
+> [!NOTE]
+> APIs to enable the creation and removal of split views (without moving or removing the tabs) are being developed under [issue #967](https://github.com/w3c/webextensions/issues/967) of W3C's WebExtensions Community Group (WECG).
+
 ## Some other interesting abilities
 
 There are a couple of other Tabs API features that don't fit into one of the earlier sections:

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

@@ -81,6 +81,10 @@ Firefox 150 is the current [Beta version of Firefox](https://www.firefox.com/en-
 
 ## 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. ([Firefox bug 2016762](https://bugzil.la/2016762))
+  - When the list of tabs includes both split view tabs and places one or more tabs between them, the tabs are moved apart and the split view closed. ([Firefox bug 2022549](https://bugzil.la/2022549))
+
 <!-- ### Removals -->
 
 <!-- ### Other -->