Components Forms
Questionnaire
Guide a reader through a short series of single-choice questions, then review the answers.
Plan your print run
Your answers
Usage
Each question in Items has Label and Options, with Label and Value on each option. The step controls enforce one choice per question. Answers remain native radio values in the surrounding form; the final screen lets the reader review and edit.
Register questionnaire with Head and pass its properties to Render. Go setup guide
Go usage
err := mono.UI.Render(w, "questionnaire", mono.Props{
"Items": []any{
map[string]any{
"Label": "What are you printing?",
"Options": []any{
map[string]any{
"Label": "A booklet",
"Value": "booklet",
},
map[string]any{
"Label": "An art print",
"Value": "print",
},
},
},
map[string]any{
"Label": "Which finish do you prefer?",
"Options": []any{
map[string]any{
"Label": "Uncoated",
"Value": "uncoated",
},
map[string]any{
"Label": "Satin",
"Value": "satin",
},
},
},
},
"Label": "Plan your print run",
})Rendered HTML
<section id="demo-questionnaire" data-mono="questionnaire" class="mu-stack" aria-labelledby="demo-questionnaire-title">
<h3 id="demo-questionnaire-title" class="mu-title">Plan your print run</h3>
<p class="mu-small mu-muted" data-step role="status"></p>
<div data-questions>
<fieldset>
<legend tabindex="-1" class="mu-label">What are you printing?</legend>
<label class="mu-row"><input type="radio" name="demo-questionnaire-0" value="booklet" ><span>A booklet</span></label><label class="mu-row"><input type="radio" name="demo-questionnaire-0" value="print" ><span>An art print</span></label>
</fieldset><fieldset>
<legend tabindex="-1" class="mu-label">Which finish do you prefer?</legend>
<label class="mu-row"><input type="radio" name="demo-questionnaire-1" value="uncoated" ><span>Uncoated</span></label><label class="mu-row"><input type="radio" name="demo-questionnaire-1" value="satin" ><span>Satin</span></label>
</fieldset>
</div>
<section data-review hidden><h4 tabindex="-1" class="mu-label">Your answers</h4><dl></dl></section>
<div class="mu-row" data-controls hidden><button type="button" class="mu-btn" data-back>Back</button><button type="button" class="mu-btn mu-primary" data-forward>Continue</button></div>
</section>Go template
<section id="{{.ID}}" data-mono="questionnaire" class="mu-stack" aria-labelledby="{{.ID}}-title">
<h3 id="{{.ID}}-title" class="mu-title">{{.Label}}</h3>
<p class="mu-small mu-muted" data-step role="status"></p>
<div data-questions>
{{range $i,$question := .Items}}<fieldset>
<legend tabindex="-1" class="mu-label">{{$question.Label}}</legend>
{{range $question.Options}}<label class="mu-row"><input type="radio" name="{{or $.Name $.ID}}-{{$i}}" value="{{.Value}}" {{if .Checked}}checked{{end}}><span>{{.Label}}</span></label>{{end}}
</fieldset>{{end}}
</div>
<section data-review hidden><h4 tabindex="-1" class="mu-label">Your answers</h4><dl></dl></section>
<div class="mu-row" data-controls hidden><button type="button" class="mu-btn" data-back>Back</button><button type="button" class="mu-btn mu-primary" data-forward>Continue</button></div>
</section>Component CSS
[data-mono="questionnaire"] fieldset { min-inline-size: 0; border: 0; padding: 0; margin: 0 0 .55rem; }
[data-mono="questionnaire"] fieldset label { margin: .35rem 0; }
[data-mono="questionnaire"] input { accent-color: #171717; }
[data-mono="questionnaire"] dd { margin: 0 0 .55rem; font-weight: 650; }
[data-mono="questionnaire"] [data-controls][hidden] { display: none; }JavaScript module
export function mount(root) {
const pages = [...root.querySelectorAll('fieldset')];
if (!pages.length) return;
const review = root.querySelector('[data-review]');
const step = root.querySelector('[data-step]');
const controls = root.querySelector('[data-controls]');
const back = controls.querySelector('[data-back]');
const forward = controls.querySelector('[data-forward]');
let index = 0;
function show(focus = true) {
const atReview = index === pages.length;
pages.forEach((page, i) => { page.hidden = i !== index; });
review.hidden = !atReview;
step.textContent = atReview ? 'Review complete.' : 'Question ' + (index + 1) + ' of ' + pages.length;
back.hidden = index === 0;
back.textContent = atReview ? 'Edit answers' : 'Back';
forward.hidden = atReview;
forward.textContent = index === pages.length - 1 ? 'Review answers' : 'Continue';
if (atReview) {
const list = review.querySelector('dl');
list.replaceChildren();
for (const page of pages) {
const term = document.createElement('dt');
const answer = document.createElement('dd');
term.textContent = page.querySelector('legend').textContent;
answer.textContent = page.querySelector('input:checked')?.closest('label')?.textContent.trim() || 'Unanswered';
list.append(term, answer);
}
}
if (focus) (atReview ? review.querySelector('h4') : pages[index].querySelector('legend')).focus();
}
back.addEventListener('click', () => { index = index === pages.length ? 0 : Math.max(0, index - 1); show(); });
forward.addEventListener('click', () => {
if (!pages[index].querySelector('input:checked')) {
step.textContent = 'Choose an answer to continue.';
pages[index].querySelector('input')?.focus();
return;
}
index++;
show();
});
root.closest('form')?.addEventListener('reset', () => setTimeout(() => { index = 0; show(false); }, 0));
controls.hidden = false;
show(false);
}Use the HTML in a static site
Copy the rendered HTML above. Download these assets into the same folder as your page, then add the tags below to its head.
Shared CSS Component CSS Ready-to-use module
<link rel="stylesheet" href="./base.css">
<link rel="stylesheet" href="./questionnaire.css">
<script type="module" src="./questionnaire.js"></script>Copy into your project
Run this command from the Mono checkout. Set -out to the component directory in your application.
go run ./cmd/mono-ui add -out ./components questionnaireExample properties (JSON)
{
"Items": [
{
"Label": "What are you printing?",
"Options": [
{
"Label": "A booklet",
"Value": "booklet"
},
{
"Label": "An art print",
"Value": "print"
}
]
},
{
"Label": "Which finish do you prefer?",
"Options": [
{
"Label": "Uncoated",
"Value": "uncoated"
},
{
"Label": "Satin",
"Value": "satin"
}
]
}
],
"Label": "Plan your print run"
}