vuetifyjs/vuetify

[Bug Report][3.5.2] v-stepper "non-linear" property not working as expected

Open

#19275 opened on Feb 26, 2024

View on GitHub
 (2 comments) (3 reactions) (0 assignees)TypeScript (40,995 stars) (7,139 forks)batch import
C: VStepperT: bugT: documentationgood first issue

Description

Environment

Vuetify Version: 3.5.2 Vue Version: 3.4.15 Browsers: Chrome 121.0.0.0 OS: Windows 10

Steps to reproduce

With "non-linear" property, ideally, user should be allowed to move through the steps when they click on the v-stepper-header. However, the property seems to have no effect. Only when "editable" is added, user is allowed to move non-linearly by clicking on the header.

Expected Behavior

Adding "non-linear" alone to the v-stepper should allow user to move from one step to another by clicking on the v-stepper-header.

Actual Behavior

Only when "editable" property is added, user can click on the steps to move non-linearly. "non-linear" seems to have no effect.

Reproduction Link

https://play.vuetifyjs.com/#...

Contributor guide

Tech stack
typescriptvue
Domain
frontend
Issue type
bug
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
3
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
1-3 hours
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
fresh
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
clear
Prerequisites
Basic knowledge of Vue componentsFamiliarity with Vuetify v stepper API
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
70
Research direction
The issue is in the VStepper component. Look at the VStepper implementation in packages/vuetify/src/components/VStepper/. The 'non linear' prop should allow clicking on step headers to navigate, but currently it only works when 'editable' is also set. Check the logic that handles click events on step headers, likely in VStepperHeader or VStepperStep. Find where the prop 'non linear' is used and ensure it independently enables step navigation. The reproduction link shows a minimal example; try to reproduce and debug the issue. Look for any conditional that checks for 'editable' before allowing navigation when 'non linear' is true. The fix likely involves modifying the click handler to also consider the 'non linear' prop.