Implement a Date widget with spinner input (no-calendar appearance)

Open
#781 2 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
55/100
Issue type
Feature
Clarity
Mostly clear
Activity status
Quiet
Tech stack
typescript

Research direction

Start with the existing DateInput component architecture and compare the intended behavior with the ODK Date Widget Reference. Define tests for the no-calendar appearance, including Date and DateTime questions, localized month names, and day limits across months and leap years. Done means three scrolling columns work and update consistently without the calendar grid.

Written by the indexing model from the issue text.

Description

front-end In Collect In Enketo
Description

Implement a Date widget with spinner input within the form renderer. This widget allows users to select a date by scrolling through separate vertical columns for Day, Month, and Year instead of using a standard grid-based calendar picker. This is triggered by the appearance="no-calendar" attribute in the XForm definition.

Key requirements include:

  • Three independent scrolling columns (spinners).
  • Dynamic adjustment of the "Day" column based on the selected Month and Year (e.g., February 29th logic for leap years).
  • Support for localization of month names.
  • Date and DateTime question types support "no-calendar"

Checklist
  • Does it need UI/UX design?
    • Yes
    • No
  • Does it need API design?
    • Yes
    • No
  • Does it need design around state flow?
    • Yes
    • No
  • Does it need a test plan?
    • Yes
    • No

User Stories
  • As a data collector entering a date far in the past,
    I want to use scrolling "flywheel" pickers rather than a calendar grid,
    so that I can navigate through decades much faster than clicking through individual months.

  • As a non-technical user,
    I want an intuitive scrolling interface for year selection,
    so that I don’t get stuck manually clicking through months because I didn't realize the year label in a calendar UI was a clickable shortcut.

  • As a data collector reading from a physical document,
    I want to input date components linearly using spinners,
    so that the digital entry process feels more analogous and direct compared to the printed information I am looking at.


Design

Dependencies
  • Existing DateInput component architecture.
  • Internationalization (i18n) library for localized month names.

Related Issues
Dominant language
TypeScript
Stars
38
Forks
24
PR merge metrics
No merged PRs in 30d

Getting set up

  • No Dockerfile or Docker Compose file
  • Has a pull request template
  • No contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from getodk/web-forms

All issues in getodk/web-forms

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.