What’s planned for Stimulus 1.1


Hey everybody. I wanted to share what we have planned for the next release of Stimulus, version 1.1, so folks know where we’re headed in the near future.

Please keep in mind that none of this is set in stone and we don’t have a specific timeline at the moment. :slight_smile:

Support for abstract CSS class names. It’s very common for a Stimulus controller to add, remove, or toggle CSS class names on its elements. However, hard-coding those class names in your controller makes it more difficult to reuse. We’ll add a data-class attribute so you can easily map your app- or component-specific CSS classes to abstract names in a controller.

Warning messages for common gotchas. We want to go out of our way to help people write idiomatic Stimulus code, so we’ll add an opt-out warning system that lets you know when you’re using the wrong casing convention or when you reference an unknown identifier.

An integrated test runner. We have a lovely solution for testing Stimulus controllers in our @stimulus/test package, but it’s currently only usable if you’re willing to read the source and set up your own harness. We want to bundle a basic test runner that’s configured for you so there’s no obstacle to writing tests.

An appendix to the Stimulus Handbook with full documentation for naming conventions and descriptor syntax. This information is currently spread out across several chapters in the Handbook. There is also at least one feature that is currently not documented because there was no place for it to go.

Full API documentation provided by TypeDoc. We’ll publish it on the web site, and it will also be available in your favorite editor via our TypeScript .d.ts files.

A public @stimulus/polyfills package for easy IE 11+ support.

Stimulus JS Roadmap - What to expect

Good stuff. Could you expand briefly about abstract CSS class names? Maybe a short example?

Also, is there any plan to bring some sort of “syntactic sugar” for dealing with conditional rendering? I’ve been spoiled by Vue’s v-if and v-show.


The appendix sounds excellent! The docs that are there are really good but an all-in-one-place overview would be super useful.


Also with the ability to render erb tags in the js file :hugs:


Are you using Rails with asset pipeline or webpack?

With asset pipeline you can already do this hello_controller.js.erb will preprocess and any erb tags will work as expected. Including access to helpers. I have not needed to do this recently with webpack though.


NO!? I shall try this now! Thanks!!!


Just tried, not working @pelted. I am using Webpacker.


Nevermind. Got it working here: https://github.com/rails/webpacker#erb


That would be lovely, especially an example of the preferred convention for multiword naming might avoid some initial confusion. :slight_smile:


Full API documentation

This would be awesome! Is there a way to generate API documentation for current version? (sorry not familiar with pre-compilers)


I would love to be able to append to the targets declaration array when extending a controller. For example, I have a base Form controller. If I need form-specific conditional logic, I have to redeclare all lof the base Form controllers targets in order to add additional targets for the child class. Not a big deal, but it would be nice.


That actually works already! Target definitions are additive so parent target properties are automatically inherited.

// base_controller.js
import { Controller } from "stimulus"

export default class extends Controller {
  static targets = [ "alpha", "beta" ]
// child_controller.js
import BaseController from "./base_controller"

export default class extends BaseController {
  static targets = [ "gamma" ]

  connect() {
    console.log(this.alphaTarget, this.betaTarget, this.gammaTarget) // 👍


Hi. I know you specificly say “we don’t have a specific timeline at the moment”… but it’s been 3 months. Just wondering if there’s a timeline for 1.1 anytime soon?

Also, just saw this awesome PR: https://github.com/turbolinks/turbolinks/pull/390 – wondering if/when that’ll be merged as well. That fixes a lot of timing issues we’re having to work around.


We hope to release beta versions of both Stimulus and Turbolinks soon. Still working out all the kinks: https://twitter.com/javan/status/1002673705158356993 :upside_down_face:


Do you need help? Is there a structure/source for the new Documentation that some community help would be appreciated on?