Saiba todas as features que te ajudarão a produzir sistemas mais rapidamente.
Elemento para ser utilizado quando há necessidade de fragmentar uma tarefa em etapas.
- Há necessidade de dividir uma tarefa extensa em passos.
- Há necessidade de mostrar para o usuário quantas etapas faltam para concluir a tarefa.
- Existe a possibilidade do usuário escolher um passo anterior para editar as informações inseridas.
- A tarefa puder ser resolvida em apenas um passo.
- O usuário não tiver possibilidade de editar as informações inseridas em passos anteriores.
| Seletor | Descrição |
|---|---|
| .ls-steps-nav .ls-active | Basta adicionar a classe na <li> de navegacão, pra ativar o botão e seu conteúdo respectivo ao carregar a página. |
| .ls-steps-nav .ls-actived | É adicionado via javascript sempre que um passo for habilitado, liberando a navegação das etapas anteriores. |
| ls-steps-content .ls-active | Classe adicionada via javascript que mostra o conteúdo respectivo da navegacão que está ativa. |
| [data-action="next"] | Atributo inserido no botão que segue o próximo fluxo do passo a passo. |
| [data-action="prev"] | Atributo inserido no botão que volta o fluxo anterior do passo a passo. |
| Método | Ação | |
|---|---|---|
| init() | Prepara os elementos pra funcionar como steps e adiciona os binds automáticos. | |
| nextStep() | Faz a troca para o próximo passo. | |
| steps:afternext | document | Lançado no método nextStep() depois de trocar o passo. |
| prevStep() | Faz a troca para o passo anterior. | |
| steps:afterprev | document | Lançado no método prevStep() depois de trocar o passo. |
| Evento | Target | Descrição |
|---|---|---|
| steps:next | document | Lançado no método nextStep() antes de trocar o passo. |
| steps:prev | document | Lançado no método prevStep() antes de trocar o passo. |
Você pode utilizar os eventos acima para impedir a troca de um determinado passo, veja um exemplo de como adicionar uma validação:
1
2
3
4
5
6
7
8
9
10
11
$(document).on('steps:next', function(e){
if (!valid) {
e.preventDefault();
}
});
$(document).on('steps:prev', function(e){
if (!valid) {
e.preventDefault();
}
});
Doloribus illum esse deserunt consectetur est voluptatibus expedita et. possimus laborum ut provident voluptatibus quis. aut tempora quod enim voluptas et et qui aliquid Ut facilis numquam recusandae rerum dicta qui maiores tempore deserunt et et voluptas. consequatur aut quia voluptas consequatur iste assumenda odio inventore. excepturi maxime iste dolorem pariatur nesciunt iusto doloremque commodi Dolores hic consequatur quos dolores ipsum explicabo et ad. dolorem id qui facere et et asperiores sed aut sit et perferendis ea modi aut. quaerat dolorem optio quibusdam et quos aut autem voluptatibus consectetur et sed. est earum ut deleniti. earum aut dolor quisquam et adipisci molestiae assumenda omnis blanditiis quos iusto temporibus
Sunt repudiandae libero quia ipsam minima nemo minus. necessitatibus est sed ullam necessitatibus repudiandae qui. autem debitis aperiam deleniti ratione itaque blanditiis et enim maiores vitae harum culpa ullam neque Architecto perferendis dignissimos maiores aliquid ad. veniam aut ab dolore iusto aliquid. aperiam nisi recusandae dignissimos iusto rem odio impedit nam. et est accusamus et dolore sit modi et non nam officia atque facere voluptatum Aliquid sint quibusdam consequatur qui et. sapiente alias laborum quia nihil voluptatem voluptas assumenda. adipisci iusto nostrum et aut rerum corrupti consequuntur illum. perferendis tempora ut exercitationem quis ut laboriosam est dolore quod modi quis sint quidem quae. est consequatur corporis sit et ipsa quam non voluptatum modi omnis provident dolor iste et
Maiores cum et est consequuntur aut ut voluptatem sunt enim natus nihil veniam fugit qui. inventore deleniti repudiandae praesentium quidem saepe dolorem. quo neque voluptas consequatur rerum quaerat dolor. itaque et aut at numquam quam et. omnis tempora quo facere quos ea molestiae quibusdam est cumque ipsam ipsum Accusamus optio perspiciatis id. eos sit enim ullam aut provident. laudantium dolor dolores eaque sunt voluptas non. ut consequatur maiores corrupti quis et sit itaque. voluptatibus id aspernatur ut voluptatem libero dolorem voluptatem laborum modi labore ex omnis enim iste. quam dolor id iure in et est totam qui dolore nisi sequi Reprehenderit occaecati tenetur necessitatibus corrupti. aliquid qui repellat quas. et et rerum et ea velit
Et a quae nesciunt ut eaque vero. quia est dolor necessitatibus corporis nostrum rerum voluptas magni. earum repudiandae aut enim ea quisquam mollitia assumenda illum voluptas tempora. tempora autem aspernatur ipsum sint non officia sit recusandae iste et dolor sed. quod ut modi nihil perferendis voluptatem distinctio quaerat. sequi mollitia ipsa asperiores non non qui voluptates alias et aliquam sunt Facilis error molestias quis unde et est ut maiores illum quia deleniti voluptatem ratione excepturi. aliquam quo quisquam repellendus quis. aut possimus beatae quisquam. deserunt corrupti et aliquam vel fugit voluptatibus assumenda accusantium. aut enim est sunt provident aliquam error deserunt voluptatem. earum laborum est adipisci cum veritatis ut distinctio. molestias et non sunt labore est tempora consequatur quasi sit necessitatibus vel Fugit eligendi ullam aut commodi at ut inventore necessitatibus. tenetur tempora molestiae incidunt et est aut et consequatur doloribus et harum. rem quaerat at sunt maiores illum neque facilis voluptates sit quibusdam omnis dolor. voluptatem sint excepturi incidunt est autem aut dolores est consequatur recusandae rerum et doloremque non. dolore delectus temporibus accusantium qui culpa sunt occaecati id repudiandae vel error distinctio provident dicta
Cupiditate libero quis consequuntur doloribus ducimus maiores error omnis ea sit. autem mollitia ut qui mollitia et repellat impedit qui ab expedita dicta ipsam aperiam sit. harum est optio numquam delectus tempora omnis autem aut inventore at dolor perspiciatis dolorem vero Et et dolorem autem debitis aliquid et itaque et omnis est. ut beatae natus eaque nostrum. illo inventore sint dolorem quia asperiores vitae est qui aut voluptatem corrupti Omnis atque aliquam atque sed sed expedita fuga voluptas illo. suscipit quae error accusamus soluta quas et. porro sit et exercitationem maxime est corporis. rerum aut est qui quibusdam consectetur et laudantium laborum occaecati aut blanditiis. quod amet atque ipsam libero. non consequatur dolore et
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
<div class="ls-steps">
<div class="ls-steps-mobile">
<a class="ls-steps-mobile-btn ls-ico-chevron-down"></a>
</div>
<ol class="ls-steps-nav">
<li>
<button class="ls-steps-btn" data-ls-module="steps" data-target="#step1" title="Informações"></button>
</li>
<li>
<button class="ls-steps-btn" data-ls-module="steps" data-target="#step2" title="Aparência"></button>
</li>
<li>
<button class="ls-steps-btn" data-ls-module="steps" data-target="#step3" title="Conteúdo"></button>
</li>
<li>
<button class="ls-steps-btn" data-ls-module="steps" data-target="#step4" title="Destinatários"></button>
</li>
<li>
<button class="ls-steps-btn" data-ls-module="steps" data-target="#step5" title="Envios"></button>
</li>
</ol>
<div class="ls-steps-main">
<div class="ls-steps-content" id="step1">
<p>Ducimus excepturi eum aspernatur quis quae atque optio sint eveniet occaecati. expedita soluta rem quas inventore. neque sapiente aliquid incidunt odit quasi libero. ullam dolor vel sunt rerum placeat
Eum in in velit sed. minus dignissimos eos eaque facere pariatur dolorem ut voluptatibus unde. quisquam laborum reiciendis velit rerum est quidem iusto suscipit
Vel fugit ad nisi quis. et aspernatur veniam atque corporis et rerum non. praesentium rerum iusto recusandae qui sapiente quia et velit est quasi. ipsam voluptate velit quis dolore culpa. voluptates repellendus molestiae quo</p>
<div class="ls-actions-btn">
<a href="#" class="ls-btn-primary ls-float-right" data-action="next">Próximo</a>
</div>
</div>
<div class="ls-steps-content" id="step2">
<p>Dolore vel quia doloribus. nostrum at est doloribus dolor ut voluptas nihil omnis maiores. quisquam dolor reiciendis deserunt a. voluptas cupiditate sunt quia amet dolores iste id delectus dolorem est in fugit maiores quia. quia eligendi cupiditate eaque hic neque voluptas. cum laborum occaecati ipsa
Voluptatem eligendi quasi fugit consectetur mollitia eaque excepturi et non nesciunt quia doloribus sunt. neque laborum eligendi officia quae consequatur ut. quia facilis a rerum voluptatem delectus aut et ut excepturi. animi eos maiores error voluptatem et culpa odio temporibus dolores ducimus repellendus eveniet. ab doloremque aut officia nostrum occaecati voluptates officia
Eveniet nostrum ab culpa enim et. eligendi veniam molestias et at porro nam autem provident omnis maxime. fugit voluptatem dolore veritatis libero recusandae ut consequatur vero ducimus voluptatem nobis. omnis iste quo omnis</p>
<div class="ls-actions-btn">
<a href="#" class="ls-btn" data-action="prev">Anterior</a>
<a href="#" class="ls-btn-primary ls-float-right" data-action="next">Próximo</a>
</div>
</div>
<div class="ls-steps-content" id="step3">
<p>Consequatur error aut sit et laboriosam dignissimos dolor dicta et enim tempora deleniti. odio quis omnis earum harum illum totam tempore corrupti rerum quis in enim omnis. quia necessitatibus placeat fuga ipsa harum laboriosam assumenda veniam perspiciatis quasi
Ut voluptas magnam dolorum odio est quia nihil sed consectetur eum quisquam vel ad. possimus aliquid velit qui. veniam nostrum aperiam omnis voluptas impedit. itaque rem fugit sit consequatur et dolores quisquam dicta dolores molestiae pariatur. modi vero dolore sed aliquid soluta fugit dolores suscipit voluptatem dicta sit. omnis omnis consequatur dignissimos iste corporis temporibus quibusdam suscipit delectus harum et maxime ab hic
Eius at soluta earum nobis. id voluptas eveniet beatae velit. dolorum placeat qui molestiae est aut quo</p>
<div class="ls-actions-btn">
<a href="#" class="ls-btn" data-action="prev">Anterior</a>
<a href="#" class="ls-btn-primary ls-float-right" data-action="next">Próximo</a>
</div>
</div>
<div class="ls-steps-content" id="step4">
<p>Quibusdam eaque vero ex et optio sed temporibus nam placeat. necessitatibus sapiente totam ea minima aut eum ut quidem. saepe libero porro est ad consequatur facere rerum eos minus dolore voluptas veniam cupiditate
Eum aut eos similique sunt nulla pariatur dignissimos fugiat consequatur omnis autem nesciunt placeat alias. amet consectetur dignissimos soluta reprehenderit. vero voluptas deleniti minus sed qui beatae ex sint cumque. rerum ducimus sunt illum quidem quia tempore aut corrupti aut explicabo repellat. recusandae repellendus itaque exercitationem veniam repudiandae et consequatur ex eius deserunt praesentium facere et architecto. nostrum quos vel repellat
Beatae nostrum inventore consequatur fugiat unde ea alias. consequatur temporibus iusto corporis quia in enim tempore qui vel sunt sint. tempora et tenetur dicta dolor eum eaque eum enim velit aperiam rem odit ut. vero alias accusantium eum velit ea earum delectus sequi veritatis possimus. et alias quos et modi voluptatem earum veritatis molestias</p>
<div class="ls-actions-btn">
<a href="#" class="ls-btn" data-action="prev">Anterior</a>
<a href="#" class="ls-btn-primary ls-float-right" data-action="next">Próximo</a>
</div>
</div>
<div class="ls-steps-content" id="step5">
<p>Ab dignissimos eveniet ex veniam et voluptas facilis consequatur esse at reiciendis aliquam. temporibus repudiandae beatae laboriosam delectus ipsam velit voluptas dolorem error molestiae. laboriosam consequatur ipsum aut sequi minima unde deserunt non ut
Veniam recusandae commodi inventore. porro vel eos est praesentium aut qui quis quos. beatae aliquam praesentium aspernatur
Ut quas ipsam repellendus nam ut corrupti. ea hic architecto fuga dicta nostrum vitae voluptas velit voluptas ex. qui quisquam et at sed dolor et beatae accusantium iste eveniet sint ipsam sit fuga. possimus quasi nisi odit ea qui non. cumque ex minus qui repudiandae ducimus soluta dignissimos. vel quia corrupti repudiandae praesentium consectetur velit dolore sequi corrupti dolore quae amet minus enim. eius inventore dolores repudiandae voluptatem dolorem non</p>
<div class="ls-actions-btn">
<a href="#" class="ls-btn" data-action="prev">Anterior</a>
<a href="#" class="ls-btn-primary ls-float-right">Finalizar</a>
</div>
</div>
</div>
</div>
Via javascript é adicionada as ARIAs abaixo:
| Estado do passo a passo | Elemento | Wai-aria |
|---|---|---|
| Default | .ls-steps-btn | aria-label="Texto inserido no botão" |
| Default | ls-steps-nav | role="tablist" |
| Default | .ls-steps-nav .ls-steps-btn | role="tab" |
| Default | ls-steps-content | role="tabpanel" |
| Navegação ativada | .ls-steps-nav .ls-active .ls-steps-btn | aria-selected="true" |
| Navegação desativada | .ls-steps-nav .ls-steps-btn | aria-selected="false" |
| Conteúdo exibido | .ls-steps-content .ls-active | aria-hidden="false" |
| Conteúdo não exibido | .ls-steps-content | aria-hidden="true" |