StatefulButton
The stateful button is a button used to display an actionable icon.
Basic usage
Show editable code example
Any Paragon component or export may be added to the code example.
Custom icons and disabled states
Show editable code example
Any Paragon component or export may be added to the code example.
Custom states with Paragon icons
Show editable code example
Any Paragon component or export may be added to the code example.
Props API#
StatefulButton Props API
- className
string
- state
string
Default'default'Each state has:
- A label (required)
- An icon
- an option to be disabled
Control the state with the
state
prop. Example usage:<StatefulButton state="pending" labels={{ default: 'Download', pending: 'Downloading', complete: 'Downloaded', }} icons={{ default: <Icon className="fa fa-download" />, pending: <Icon className="fa fa-spinner fa-spin" />, complete: <Icon className="fa fa-check" />, }} disabledStates=['pending'] className='btn-primary mr-2' />
- labels
Object.<
Requirednode
>Required. Each state has a
label
. - icons
Object.<
node
>Default{ default: undefined, pending: <Icon src={SpinnerSimple} className={classNames('icon-spin')} />, complete: <Icon src={CheckCircleOutline} />, error: <Icon src={Cancel} />, }Required. Each state has an
icon
. - disabledStates
string
[]
Default['pending', 'complete']Required. Each state has a
disabledState
- onClick
func
Specifies the callback function when the button is clicked
Usage Insights#
StatefulButton
Project Name | Paragon Version | Instance Count | |
---|---|---|---|
frontend-app-account | 20.28.5 | 8 | |
frontend-app-admin-portal | 20.26.3 | 15 | |
frontend-app-authn | 20.34.0 | 7 | |
frontend-app-communications | 20.28.5 | 1 | |
frontend-app-course-authoring | 20.32.0 | 3 | |
frontend-app-discussions | 20.15.0 | 2 | |
frontend-app-gradebook | 19.25.4 | 1 | |
frontend-app-learner-dashboard | 20.19.0 | 1 | |
frontend-app-learner-portal-enterprise | 20.31.1 | 7 | |
frontend-app-learner-portal-programs | 20.28.4 | 1 | |
frontend-app-learner-record | 20.28.4 | 1 | |
frontend-app-learning | 20.28.4 | 1 | |
frontend-app-library-authoring | 20.30.1 | 4 | |
frontend-app-ora-grading | 19.9.0 | 2 | |
frontend-app-payment | 20.18.2 | 2 | |
frontend-app-profile | 20.32.3 | 1 | |
frontend-app-publisher | 20.28.5 | 1 | |
frontend-learner-portal-base | 12.2.0 | 2 | |
frontend-lib-special-exams | 20.22.4 | 1 |