Creating steps

New in v12.9.0

Similar to a Page, grouping can be achieved by using the Step class. Other than with pages, with steps the developer can dictate the order of pages to be visited: the user is not able to move freely between pages but moves to the next/previous step with a next/previous button. Page and Step cannot be combined within a single parametrization.

A Step is defined in the parametrization similar to a Page. The labels of the next and previous buttons can be set per step:

from viktor.parametrization import ViktorParametrization, Step, TextField, NumberField


class Parametrization(ViktorParametrization):
    step_1 = Step('Step 1 - without views')
    step_1.input_1 = TextField('This is a text field')
    step_1.input_2 = NumberField('This is a number field')

    step_2 = Step('Step 2 - with views', views=['geometry_view', 'data_view'])
    step_2.input_1 = TextField('This is a text field')
    step_2.input_2 = NumberField('This is a number field')

Step 1 with no views

Step 2 with a GeometryView and a DataView

Button labels

The labels of the previous and next buttons can be set per step:

Step('Step 2', previous_label='Go to step 1', next_label='Go to step 3')

Validation of user input

New in v13.7.0

When implementing the on_next argument, the corresponding function is called when a user clicks the 'next' button to move to the next step. This can be used to, for example, validate the input of the current active step. Please note that the validation function cannot take longer than 3 seconds!

from viktor.errors import UserError
from viktor.parametrization import ViktorParametrization, Step, NumberField


def validate_step_1(params, **kwargs):
    if params.step_1.width > params.step_1.height:
        raise UserError("The design is not feasible")
        
        
class Parametrization(ViktorParametrization):
    step_1 = Step('Step 1', on_next=validate_step_1)
    step_1.width = NumberField('Width')
    step_1.height = NumberField('Height')

Generic constraints (e.g. min on a NumberField) are automatically validated by the platform. Additionally, fields can be marked as invalid.

tip

All individual kwargs can be added explicitly in the signature if needed:

def validate_step_1(params, entity_id, entity_name, **kwargs):
    ...