Class Wizard
- All Implemented Interfaces:
Iterable<WizardStep>, ElementAttributeMethods<HTMLElement, Wizard>, ElementClassListMethods<HTMLElement, Wizard>, ElementConsumerMethods<HTMLElement, Wizard>, ElementContainerMethods<HTMLElement, Wizard>, ElementEventMethods<HTMLElement, Wizard>, ElementIdMethods<HTMLElement, Wizard>, ElementQueryMethods<HTMLElement>, HTMLElementAttributeMethods<HTMLElement, Wizard>, HTMLElementDataMethods<HTMLElement, Wizard>, HTMLElementStyleMethods<HTMLElement, Wizard>, HTMLElementVisibilityMethods<HTMLElement, Wizard>, IsElement<HTMLElement>, TypedBuilder<HTMLElement, Wizard>, Component, HasItems<HTMLElement, Wizard, WizardStep>
public class Wizard
extends BaseComponent<HTMLElement, Wizard>
implements HasItems<HTMLElement, Wizard, WizardStep>
A wizard provides a guided workflow that offers a path to complete a task, create an object or objects, or finish a series of
steps for some other outcome. Wizards should incite trust in the user and guide them through an otherwise overwhelming
experience.
- See Also:
-
Method Summary
Modifier and TypeMethodDescriptionadd(WizardHeader header) add(WizardStep item) Adds an item to the component.addHeader(WizardHeader header) voidcancel()voidclear()Clears all items from the component.booleanChecks whether the component contains an item associated with the given identifier.context()footer()header()height(int height) booleanisEmpty()Checks whether the collection of items in the component is empty.Retrieves the item associated with the specified identifier from the component.iterator()lastStep()nav()voidnext()onAdd(AddItemHandler<Wizard, WizardStep> onAdd) Registers a callback to be invoked whenever a new item is added to the component.onCancel(ComponentHandler<Wizard> handler) onFinish(ComponentHandler<Wizard> handler) onRemove(RemoveItemHandler<Wizard, WizardStep> onRemove) Registers a callback to be invoked whenever an item is removed from the component.onStepChange(WizardStepChangeHandler stepChangeHandler) onUpdate(UpdateItemHandler<Wizard, WizardStep> onUpdate) Registers a callback to be invoked whenever an item is updated in the component.voidprevious()Same as progressive(true)progressive(boolean progressive) Progressively shows steps, where all steps following the active step are hidden.voidremoveItem(String identifier) Removes an item from the component based on the provided identifier.voidvoidselect(WizardStep step) intsize()Retrieves the total number of items currently contained in the component.that()voidupdateItem(WizardStep item) Updates an existing item in the component.Same as visitRequired(true)visitRequired(boolean visitRequired) Disables steps that haven't been visited.static Wizardwizard()Methods inherited from class BaseComponent
componentType, element, registerComponentMethods inherited from class Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitMethods inherited from interface ElementAttributeMethods
aria, aria, aria, attr, attr, attr, role, roleMethods inherited from interface ElementClassListMethods
classList, classList, css, toggle, toggle, toggleMethods inherited from interface ElementConsumerMethods
apply, runMethods inherited from interface ElementContainerMethods
add, add, add, add, addAll, addAll, addAll, addAll, addAll, addAllMethods inherited from interface ElementEventMethods
on, on, onMethods inherited from interface ElementIdMethods
id, uniqueIdMethods inherited from interface ElementQueryMethods
closest, querySelector, querySelectorAllMethods inherited from interface HasItems
addItem, addItems, items, replaceItemElement, updateItem, updateItemMethods inherited from interface HTMLElementAttributeMethods
titleMethods inherited from interface HTMLElementDataMethods
data, dataMethods inherited from interface HTMLElementVisibilityMethods
hiddenMethods inherited from interface Iterable
forEach, spliterator
-
Method Details
-
wizard
-
add
Description copied from interface:HasItemsAdds an item to the component.- Specified by:
addin interfaceHasItems<HTMLElement, Wizard, WizardStep>- Parameters:
item- the item to be added to the component- Returns:
- the builder instance after the item has been added
-
addHeader
-
add
-
height
-
progressive
Same as progressive(true) -
progressive
Progressively shows steps, where all steps following the active step are hidden. Defaults to false. Must be called before adding steps. -
visitRequired
Same as visitRequired(true) -
visitRequired
Disables steps that haven't been visited. Defaults to false. Must be called before adding steps. -
that
- Specified by:
thatin interfaceTypedBuilder<HTMLElement, Wizard>
-
onAdd
Description copied from interface:HasItemsRegisters a callback to be invoked whenever a new item is added to the component.- Specified by:
onAddin interfaceHasItems<HTMLElement, Wizard, WizardStep>- Parameters:
onAdd- aAddItemHandlerthat takes the builder instance and the item being added as arguments- Returns:
- the builder instance after adding the callback
-
onCancel
-
onFinish
-
onUpdate
Description copied from interface:HasItemsRegisters a callback to be invoked whenever an item is updated in the component.- Specified by:
onUpdatein interfaceHasItems<HTMLElement, Wizard, WizardStep>- Parameters:
onUpdate- aUpdateItemHandlerthat takes the component, the previous state of the item, and the updated state of the item as arguments- Returns:
- the builder instance after adding the callback
-
onRemove
Description copied from interface:HasItemsRegisters a callback to be invoked whenever an item is removed from the component.- Specified by:
onRemovein interfaceHasItems<HTMLElement, Wizard, WizardStep>- Parameters:
onRemove- aRemoveItemHandlerthat takes the component and the item being removed as arguments- Returns:
- the builder instance after adding the callback
-
onStepChange
-
iterator
- Specified by:
iteratorin interfaceIterable<WizardStep>
-
size
public int size()Description copied from interface:HasItemsRetrieves the total number of items currently contained in the component.- Specified by:
sizein interfaceHasItems<HTMLElement, Wizard, WizardStep>- Returns:
- the number of items contained in the component
-
isEmpty
public boolean isEmpty()Description copied from interface:HasItemsChecks whether the collection of items in the component is empty.- Specified by:
isEmptyin interfaceHasItems<HTMLElement, Wizard, WizardStep>- Returns:
trueif the component contains no items;falseotherwise
-
contains
Description copied from interface:HasItemsChecks whether the component contains an item associated with the given identifier.- Specified by:
containsin interfaceHasItems<HTMLElement, Wizard, WizardStep>- Parameters:
identifier- the identifier of the item to be checked- Returns:
- true if the component contains an item associated with the provided identifier, false otherwise
-
item
Description copied from interface:HasItemsRetrieves the item associated with the specified identifier from the component.- Specified by:
itemin interfaceHasItems<HTMLElement, Wizard, WizardStep>- Parameters:
identifier- the identifier of the item to be retrieved- Returns:
- the item associated with the given identifier, or
nullif no item is found
-
updateItem
Description copied from interface:HasItemsUpdates an existing item in the component.- Specified by:
updateItemin interfaceHasItems<HTMLElement, Wizard, WizardStep>- Parameters:
item- the item to be updated
-
removeItem
Description copied from interface:HasItemsRemoves an item from the component based on the provided identifier.- Specified by:
removeItemin interfaceHasItems<HTMLElement, Wizard, WizardStep>- Parameters:
identifier- the identifier of the item to be removed
-
clear
public void clear()Description copied from interface:HasItemsClears all items from the component. This method removes any existing items within the component, leaving it empty. Any associated or registered callbacks related to the removal of items may be invoked as part of this operation.- Specified by:
clearin interfaceHasItems<HTMLElement, Wizard, WizardStep>
-
context
-
header
-
firstStep
-
lastStep
-
currentStep
-
previous
public void previous() -
next
public void next() -
select
-
select
-
cancel
public void cancel()
-