Enhance test input documentation with conditional visibility feature.#101
Open
projkov wants to merge 2 commits into
Open
Enhance test input documentation with conditional visibility feature.#101projkov wants to merge 2 commits into
projkov wants to merge 2 commits into
Conversation
karlnaden
requested changes
Feb 12, 2026
| - `description:` - a description which is displayed in the UI. | ||
| - `type:` - controls the type of HTML input element used in the UI. Currently | ||
| there are 5 possible values: | ||
| there are 6 possible values: |
Contributor
There was a problem hiding this comment.
Looks like the count was off before
Suggested change
| there are 6 possible values: | |
| there are 7 possible values: |
| end | ||
| ``` | ||
|
|
||
| ### Conditional visibility for inputs |
Contributor
There was a problem hiding this comment.
Suggested change
| ### Conditional visibility for inputs | |
| ### Conditional UI visibility for inputs |
| Locking an input can force it to use a value from a previous test's output, or | ||
| the default value. | ||
| - `hidden:` - (**default: false**) hide the input from the UI. Must be used with either `optional: true` or `locked: true`. | ||
| - `enable_when` - (**optional**) adds conditional visibility for inputs. It's a hash with `input_name` and `value`. |
Contributor
There was a problem hiding this comment.
Suggested change
| - `enable_when` - (**optional**) adds conditional visibility for inputs. It's a hash with `input_name` and `value`. | |
| - `enable_when` - (**optional**) adds conditional UI visibility for the input, causing it to be displayed only when the indicated input has the specified value. The value is a hash with keys `input_name` and `value`. |
karlnaden
requested changes
May 21, 2026
Contributor
karlnaden
left a comment
karlnaden
left a comment
There was a problem hiding this comment.
Looks great - 3 small tweaks requested.
Comment on lines
+277
to
+278
| 5. All dependent inputs are `optional: true` so hidden fields do not block submitting the modal. | ||
| 6. The group is `optional` so the entire demo can be skipped, matching the inferno-core demonstration pattern. |
Contributor
There was a problem hiding this comment.
remove list entry 6 - not relevant
|
|
||
| A **select** input works the same way as radio for the controlling field. | ||
|
|
||
| The following example is adapted from the inferno-core demo suite. It models supplying a FHIR Bundle in one of three mutually exclusive ways: paste JSON, provide a URL, or run a `$summary` operation (FHIR server URL and patient ID). |
Contributor
There was a problem hiding this comment.
Update to:
The following example models supplying a FHIR Bundle in one of three mutually exclusive ways: paste JSON, provide a URL, or run a $summary operation (FHIR server URL and patient ID).
|
|
||
| When a test needs related inputs but only some apply at a time, `enable_when` controls **conditional visibility in the inputs modal only**. It does not change how inputs are defined in the DSL or how values are read in `run` blocks. Use it when several inputs represent **alternative paths** for the same data—showing every field at once would clutter the modal or confuse users. A typical pattern is a single radio or select choice that reveals only the fields relevant to the selected method. | ||
|
|
||
| **Semantics:** |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Updates the docs site for the
enable-when-docswork: documents theenable_wheninput option and conditional visibility, adds the missingselectinput type, and fixes a few doc typos/formatting issues.Changes
Inputs and outputs (
docs/writing-tests/test-inputs-outputs.md)enable_whenand when to use it (e.g. with Radio or Select inputs), with a full example (radio +enable_whenfor bundle source).enable_whenin the input options list as (optional) withinput_nameandvalue.'select'type to the list and update the count to "6 possible values."'checkbox→'checkbox', double space intitle:description, trailing spaces in AuthInfo code blocks, and list continuation indentation under "Behind the Scenes."Other
docs/concepts.md: Fix unclosed quote in figurealt("Diagram of Inferno Deployment→"Diagram of Inferno Deployment")..tool-versions: Ensure newline at end of file.Gemfile.lock: Addarm64-darwin-25platform (from localbundle install).