This library adds useful methods to Opera's Windows and Tabs API for extensions. It adds a global TabUtils object and extends Opera's BrowserTab, BrowserTabGroup and BrowserWindow objects with new methods and properties.
Just add js/api-extensions.js to your project and include it in your
extension's index.html with a <script> tag like so:
<script src="js/api-extensions.js"></script>
More in-depth documentation can be found in the jsdoc folder.
- Opera 12.00: BrowserTabManager.create() causes the addressbar to be focused when opening a tab in the background. The method is now rewritten to open tabs in the foreground, then immediately return focus to the original tab so that it opens in the background without switching keyboard focus to the address bar.
TabUtils.isTab(object)
Returns whether an object is a BrowserTab
TabUtils.isGroup(object)
Returns whether an object is a BrowserTabGroup
TabUtils.isWindow(object)
Returns whether an object is a BrowserWindow
TabUtils.isAccessible(tab)
Returns whether messages can be posted to a tab
TabUtils.firstTab(group)
Gets the leftmost tab within a tab group
TabUtils.lastTab(group)
Gets the rightmost tab within a tab group
TabUtils.nextSibling(item)
Gets the next tab or tab group within a tab or group's container.
TabUtils.nextTab(item)
Gets the tab immediately to the right of a tab or group
TabUtils.previousSibling(item)
Gets the previous tab or tab group within a tab or group's container.
TabUtils.previousTab(item)
Gets the tab immediately to the left of a tab or group
nextSibling
If the tab is part of a group, gets the next tab in the group. Otherwise, gets the next tab or tab group in the window.
nextTab
Gets the tab immediately to the right of this tab.
previousSibling
If the tab is part of a group, gets the previous tab in the group. Otherwise, gets the next tab or tab group in the window.
previousTab
Gets the tab immediately to the left of this tab.
ungroup(before = false)
Removes the tab from its current tab group. If the tab is not part of a group, does nothing.
- before (Boolean): Optional. If true, the tab will be placed to the left of its group. If false or omitted, the tab will be placed to the right.
firstTab
Gets the leftmost tab in the group
lastTab
Gets the rightmost tab in the group
nextSibling
Gets the next tab or group within the window
previousSibling
Gets the previous tab or group within the window
at(position)
Gets the tab at a given position in the group
insertAfter(tab, child)
Just like BrowserTabGroup.insert(tab, child), but inserts the tab to the
right of the child tab instead of before it.
move(tab, to)
Moves a tab to a new position within the group. If the position does not exist, the tab will be placed at the end of the group.
move(from, to)
Moves the tab at position from to a new position within the group. If the position does not exist, the tab will be placed at the end of the group.
ungroup()
Dissolves the tab group
expand()
Shortcut for tabGroup.update({ collapsed: false })
collapse()
Shortcut for tabGroup.update({ collapsed: true })
at(position)
Gets the tab or group at a given position in the window
insertAfter(tab, child)
Just like BrowserWindow.insert(tab, child), but inserts the tab or group to
the right of the child item instead of before it.
move(item, to)
Moves a tab or tab group to a new position within the window. If the position does not exist, the item will be placed at the end of the window.
move(from, to)
Moves the tab or group at position from to a new position within the window. If the position does not exist, the item will be placed at the end of the window.