ember-steps

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #cli #claude-code #codex #developer-tools #react #windows

★ 88 Open GitHub ↗

Declaratively create wizards, tabbed UIs, and more

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# ember-steps

![CI](https://github.com/alexlafroscia/ember-steps/workflows/CI/badge.svg)

> Declaratively create wizards, tabs, or any interface with sections of the page that should be shown one-at-a-time

## Installation

```bash
ember install ember-steps
```

## Basic Usage

Using `ember-steps` starts with creating a `step-manager`.

```handlebars
<StepManager as |w|>
  We'll put some cool stuff in here in a moment
</StepManager>
```

Cool, right? Ehh, it doesn't do much yet -- we need to add some steps.

```handlebars
<StepManager as |w|>
  <w.Step @name='a'>
    This is the first step!
  </w.Step>

<w.Step @name='b'>
    This is the second step!
  </w.Step>
</StepManager>
```

As you may have guessed, the first `w.Step` component, `a`, will be visible initially, and `b` will be invisible. Note that these names are important. Why? Because we need a way to transition between them!

```handlebars
<StepManager as |w|>
  <w.Step @name='a'>
    This is the first step!

<button {{on 'click' (fn w.transition-to 'b')}}>
      Next, please!
    </button>
  </w.Step>

<w.Step @name='b'>
    This is the second step!

<button {{on 'click' (fn w.transition-to 'a')}}>
      Wait, go back!
    </button>
  </w.Step>
</StepManager>
```

The `<StepManager>` provides a [closure action][ember-closure-actions] that can be called with the name of a step to show that one, instead. One of the neat features of `ember-steps` is that there is no explicit order to the steps; show all of them, or only some. It's entirely up to you.

## Not-So-Basic Usage

The above examples show the basic idea, but there's more configuration (and power) available if you need it. Head over to [the cookbook][cookbook] to read more about what `ember-steps` can do!

## Compatibility Note

The following table can help determine which verison of `ember-steps` work with specific Ember versions

| `ember` Version   | `ember-steps` Version |
| :---------------- | :-------------------- |
| `3.13+`           | `v10.0.0`             |
| `3.6`             | `v9.0.0`              |
| `3.4` to `3.6`    | `v7.0.0`              |
| `3.3` to `2.16`   | `v6.1.3`              |
| `2.12` or earlier | `v4.0.0`              |

[ember-closure-actions]: https://guides.emberjs.com/v3.17.0/components/component-state-and-actions/
[cookbook]: https://alexlafroscia.github.io/ember-steps/docs/cookbook
[hash-helper]: http://emberjs.com/blog/2016/01/15/ember-2-3-released.html#toc_hash-helper

ember-steps

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README