Tab Group

Owned by
Elizabeth Tai
Last updated: Jun 28, 2024 by
Smita Nair
3 min read

Description

This macro is used for migrating content in Deck of Cards macros to Cloud and the migrated content in Cards macro are converted to Tab macros. This macro is primarily used for migration purposes and is not available in the Macro browser to be directly added to a page.

  • In Cloud, it is marked as a legacy macro because it is only compatible with Confluence Cloud Legacy Editor.

  • Use the Tab macro instead for tabbed content in Confluence Cloud’s new editor.

Notes about migration

  • In Server and Data Center, the macro is used to migrate Deck of Cards macros to Cloud.

  • Some legacy Macro parameters from Confluence Server are not supported. More details are available on our FAQ page. 

  • Server users migrating to Cloud will not lose data.

  • Some server-version parameters are currently unsupported and are ignored by the macro. For example, Server users migrating to Cloud will lose some CSS and UI functions.

The Tab Group macro must contain at least one Tab macro within its body.

Server

Cloud

Server

Cloud


Parameters

Name

Required

Available In

Migratable to Cloud?

Default Value

Description

Name

Required

Available In

Migratable to Cloud?

Default Value

Description

ID

 Yes

Server, Data Center, Cloud

Yes



The ID for the Tab Group. Must be unique to this page.

Tabs Location

 Yes

Server, Data Center, Cloud

Yes

Top

Choose the position to locate the tabs:

  • Top

  • Left

  • Right (Not supported in Composition Cloud, the position will default to "Top".)

Border color of the active tab

 Optional

Cloud

No

 

Choose a color for the border.

Background color of the active tab

 Optional

Cloud

No

 

Choose a background color of the active tab.

Border color of inactive tabs

 Optional

Cloud

No

 

Choose a color for the border of inactive tabs.

Background color of inactive tabs

 Optional

Cloud

No

 

Choose a background color for inactive tabs.

Width

 Optional

Server, Data Center

No

 

  • The width the content will be constrained to (not including any tabs).

  • If not set, the tabs expand to display their content.

Height

 Optional

Server, Data Center

No

 

  • The height the content will be constrained to (not including any tabs).

  • If not set, the tabs expand to display their content.

History

 Optional

Server, Data Center

No

true

If enabled, the tab will update the page URL when switching tabs and each navigation between the tabs will be treated as an entry in the browser history.

CSS Class

 Optional

Server, Data Center

No

 

The custom CSS class the deck is decorated by.

Start Hidden

 Optional

Server, Data Center

No

true

If set to false, the cards will be initially visible on the page until setup is complete.

Loop Cards

 Optional

Server, Data Center

No

 

If true, the deck will loop back to the beginning from the last card.

Next After (in Seconds)

 Optional

Server, Data Center

No

never

  • The number of seconds the slides will stay visible before moving to the next one.

  • By default the current slide will not transition until prompted by the user.

Effect Type

 Optional

Server, Data Center

No

none

The effect to use when moving to a new slide. You can set it to:

  • fade

  • none

Effect Duration (in Seconds)

 Optional

Server, Data Center

No

1

  • The number of seconds the transition will take to complete, e.g.: 1.5 or 10


Editor View


Macro Edit View

Â