{"id":29170273,"url":"https://github.com/mendixlabs/wizardsteps","last_synced_at":"2025-07-01T12:39:45.045Z","repository":{"id":48861503,"uuid":"53428469","full_name":"mendixlabs/WizardSteps","owner":"mendixlabs","description":"Provides an enhanced widget version of the Wizard Steps from the Mendix UI Framework pagetemplates.","archived":false,"fork":false,"pushed_at":"2021-07-12T13:37:39.000Z","size":1397,"stargazers_count":1,"open_issues_count":2,"forks_count":1,"subscribers_count":10,"default_branch":"master","last_synced_at":"2024-04-13T17:55:37.274Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mendixlabs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-03-08T16:43:30.000Z","updated_at":"2021-07-12T13:37:42.000Z","dependencies_parsed_at":"2022-09-03T14:20:33.209Z","dependency_job_id":null,"html_url":"https://github.com/mendixlabs/WizardSteps","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/mendixlabs/WizardSteps","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mendixlabs%2FWizardSteps","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mendixlabs%2FWizardSteps/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mendixlabs%2FWizardSteps/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mendixlabs%2FWizardSteps/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mendixlabs","download_url":"https://codeload.github.com/mendixlabs/WizardSteps/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mendixlabs%2FWizardSteps/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262964057,"owners_count":23391943,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-07-01T12:39:38.283Z","updated_at":"2025-07-01T12:39:45.017Z","avatar_url":"https://github.com/mendixlabs.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# WizardSteps\n\n  \u003ca href=\"https://appstore.home.mendix.com/link/modeler/\"\u003e\n    \u003cimg alt=\"GitHub issues\" src=\"https://img.shields.io/badge/Studio%20version-8.12%2B-blue.svg?style=for-the-badge\" target=\"_blank\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://appstore.home.mendix.com/link/modeler/\"\u003e\n    \u003cimg alt=\"GitHub issues\" src=\"https://img.shields.io/badge/Mendix%209-Yes-blue.svg?style=for-the-badge\u0026logo=mendix\" target=\"_blank\" /\u003e\n  \u003c/a\u003e\n\nProvides an enhanced widget version of the Wizard Steps Header from the Mendix UI Framework pagetemplates.\n\n## Contributing\n\nFor more information on contributing to this repository visit [Contributing to a GitHub repository](https://world.mendix.com/display/howto50/Contributing+to+a+GitHub+repository)!\n\n## Description\n\nThe WizardSteps widget provides an enhanced version of the Mendix UI Framework Pagetemplates Wizard Steps. Offering additional options such as allowing for conditional wizard steps, vertical and horizontal layouts, numbering modes and many other possibilities. (Note that no pagetemplates nor Mendix Framework is needed to work with this widget)\n\n## Implementation\n\nThe WizardSteps widget will need some modeling work to be done. Basically we need to create a WizardStepsList containing all the Wizard Steps that are relevant.\n\n1. Create a Wizard Step entity containing:\n\n- Title : String\n- Subtitle (optional) : String\n- Status (normal, active, visited) : Enumeration\n- Sort attribute: Integer\n\n2. Create a Wizard Step List entity containing all the steps.\n3. Create a Microflow that retrieves the Wizard Steps and returns them in a list.\n4. Create the actual Step- and Listobjects with data in them.\n5. Add the WizardSteps widget to a page and configure the widget as required.\n\n## Settings\n\n### General\n\n- Progress Wizard: style the wizard like the progress version from the Mendix UI Framework.\n- Layout Mode: Whether to use horizontal or vertical layout for the steps. Horizontal is default.\n- Numbering Mode: How to number and show or not show this number in the steps.\n- Full Width: Divide the total width of the wizard into equal columns for each step. If set to false, the steps themselves will determine the needed width. Note: only applicable for horizontal layout Mode\n- Onclick microflow: Which microflow needs to be triggered on clicking a step. The actual step object will be returned by the widget.\n\n### Data source\n\n- Wizard step object: the entity that is the wizard step.\n- Data microflow for steps: the microflow that returns a list of WizardStep objects.\n- Use context object: Used for the onClick microflow. If set to false, the contextobject will not be part of the call.\n\n### Step definition\n\n- Title\n- Subtitle\n- Status\n- Sort attribute\n\n## Notes\n\nLogic needs to be modeled in Mendix itself with regards to getting to next or previous steps. The Widget itself is very 'dumb' in that way and needs to be. Every step can be clicked, so the intended behaviour will need to be handled in Mendix.\n\nThe original foundation version of the WizardSteps widget actually had other datasource options as well such as XPath and by Association to collect these. We've created a separate branch ([original-bloated-version](https://github.com/mendix/WizardSteps/tree/original-bloated-version) of this version which can be viewed in Github.\n\nThe latest (but not always appstore ready) version can be found on [github](https://github.com/mendix/WizardSteps)\n\n## Compatibility\n\nThe widget was created in Mendix version 5.18 but it should work from 5.14.1 onwards although untested.\nThe latest Mendix version tested was 9.3.\n\n## Release Notes\n\n1.0 appstore release:\n\n- first appstore version of the widget\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmendixlabs%2Fwizardsteps","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmendixlabs%2Fwizardsteps","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmendixlabs%2Fwizardsteps/lists"}