Components Forms

Questionnaire

Guide a reader through a short series of single-choice questions, then review the answers.

Live previewGo + JavaScript

Plan your print run

What are you printing?
Which finish do you prefer?

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
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
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
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
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
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

HTML head
<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.

Terminal
go run ./cmd/mono-ui add -out ./components questionnaire
Example properties (JSON)
example.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"
}