Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 400,000 packages pre-installed, including stimulus-tabs with all npm packages installed. Try it out:

var stimulusTabs = require("stimulus-tabs")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

stimulus-tabs v1.0.5

A simple tabs controller for Stimulus.js

Stimulus Tabs

A simple tabs controller for Stimulus.js

Codepen Demo

Basic Usage

First run yarn add stimulus-tabs to install


import { Application } from "stimulus"
import TabsController from 'stimulus-tabs'

const application = Application.start()
application.register("my-tabs", TabsController)


Define each tab in data-tabs separate each value with a space.

<div data-controller="my-tabs" data-tabs="business personal"
      <!-- default is selected-tab -->
  <a data-action="my-tabs#showBusiness" href="#">Business tab</a>
  <a data-action="my-tabs#showPersonal" href="#">Personal</a>

  <div class="tabs-content">
    <div data-target="">...</div>
    <div data-target="my-tabs.personal">...</div>

Now as we click on a tab, that tab's content is revealed. That's all you need to have functional tabs.

Initial tab

By default the first tab name defined in data-tabs will be the first tab. For example if you have data-tabs="business personal" business will be the first tab.

You can also set the first tab in the like so:

<div data-controller="my-tabs" data-my-tabs-selected-tab="personal">


There is a selected callback which is called when one selects a tab

To utilize it, you will need to extend TabsController

export default class extends TabsController {
  selected() {
    const htmlContent = fetchSomeData()



There are four getters which you can use (in a callback for example)

  1. this.selectedContent returns the selected tab's content element (the target)
  2. this.selectedTab returns the selected tab element (button for example)
  3. this.previousContent previous returns the selected tab's content element (the target)
  4. this.previousTab returns the previous tab element (button for example)

For initial state please use Stimulus' connect callback, but you must call super


Please don't hide the content elements with CSS or it won't work. You don't need any css for the tabs to work.


Write tests


Bug reports and pull requests are welcome on GitHub at This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.


This package is available as open source under the terms of the MIT License.


RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free