{"id":27998147,"url":"https://github.com/alphagov/miller-columns-element","last_synced_at":"2025-05-08T22:49:44.697Z","repository":{"id":37413175,"uuid":"154823326","full_name":"alphagov/miller-columns-element","owner":"alphagov","description":"Miller columns (cascading lists) for hierarchical topic selection on GOV.UK","archived":false,"fork":false,"pushed_at":"2025-05-02T16:14:35.000Z","size":3066,"stargazers_count":16,"open_issues_count":1,"forks_count":7,"subscribers_count":47,"default_branch":"main","last_synced_at":"2025-05-08T22:49:37.270Z","etag":null,"topics":["custom-elements","govuk","govuk-content-publisher","web-components"],"latest_commit_sha":null,"homepage":"https://alphagov.github.io/miller-columns-element/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alphagov.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2018-10-26T11:21:28.000Z","updated_at":"2025-05-02T16:13:30.000Z","dependencies_parsed_at":"2023-02-18T07:15:31.233Z","dependency_job_id":"24afcebc-9e52-4b92-83cf-aabe02cefa2a","html_url":"https://github.com/alphagov/miller-columns-element","commit_stats":{"total_commits":304,"total_committers":7,"mean_commits":43.42857142857143,"dds":0.6710526315789473,"last_synced_commit":"0eed71be4d1a5f576e7315ed5e7d0222ccd55f5c"},"previous_names":[],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alphagov%2Fmiller-columns-element","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alphagov%2Fmiller-columns-element/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alphagov%2Fmiller-columns-element/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alphagov%2Fmiller-columns-element/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alphagov","download_url":"https://codeload.github.com/alphagov/miller-columns-element/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253160827,"owners_count":21863624,"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":["custom-elements","govuk","govuk-content-publisher","web-components"],"created_at":"2025-05-08T22:49:44.135Z","updated_at":"2025-05-08T22:49:44.690Z","avatar_url":"https://github.com/alphagov.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# \u0026lt;miller-columns\u0026gt; element\n\nExpress a hierarchy by showing selectable lists of the items in each hierarchy level.\n\nSelection of any item shows that item’s children in the next list.\n\n## Installation\n\n```\nnpm install --save miller-columns-element\n```\n\n## Usage\n\nThis element is expected to be used in an application with [govuk-frontend](https://github.com/alphagov/govuk-frontend) installed. The expected CSS dependencies are outlined in [examples.scss](./examples.scss).\n\n```html\n\u003cp id=\"navigation-instructions\" class=\"govuk-body govuk-visually-hidden\"\u003e\n  Use the right arrow to explore sub-topics, use the up and down arrows to find other topics.\n\u003c/p\u003e\n\n\u003cmiller-columns-selected id=\"selected-items\" for=\"miller-columns\" class=\"miller-columns-selected\"\u003e\u003c/miller-columns-selected\u003e\n\n\u003cmiller-columns class=\"miller-columns\" for=\"taxonomy\" selected=\"selected-items\" id=\"miller-columns\" aria-describedby=\"navigation-instructions\"\u003e\n  \u003cul id=\"taxonomy\"\u003e\n    \u003cli\u003e\n      \u003cinput class=\"govuk-checkboxes__input\" type=\"checkbox\" id=\"parenting-childcare-and-children-s-services\"\u003e\n      \u003clabel class=\"govuk-label govuk-checkboxes__label\" for=\"parenting-childcare-and-children-s-services\"\u003e\n        Parenting, childcare and children's services\n      \u003c/label\u003e\n      \u003cul\u003e\n        \u003cli\u003e\n          \u003cinput class=\"govuk-checkboxes__input\" type=\"checkbox\" id=\"divorce-separation-and-legal-issues\"\u003e\n          \u003clabel class=\"govuk-label govuk-checkboxes__label\" for=\"divorce-separation-and-legal-issues\"\u003e\n            Divorce, separation and legal issues\n          \u003c/label\u003e\n        \u003c/li\u003e\n        \u003cli\u003e\n          \u003cinput class=\"govuk-checkboxes__input\" type=\"checkbox\" id=\"childcare-and-early-years\"\u003e\n          \u003clabel class=\"govuk-label govuk-checkboxes__label\" for=\"childcare-and-early-years\"\u003e\n            Childcare and early years\n          \u003c/label\u003e\n        \u003c/li\u003e\n      \u003c/ul\u003e\n    \u003c/li\u003e\n  \u003c/ul\u003e\n\u003c/miller-columns\u003e\n```\n\n## Browser support\n\nBrowsers without native [custom element support][support] require a [polyfill][].\n\n- Chrome\n- Firefox\n- Safari\n- Internet Explorer 11\n- Microsoft Edge\n\n[support]: https://caniuse.com/#feat=custom-elementsv1\n[polyfill]: https://github.com/webcomponents/custom-elements\n\n## Development\n\n```\nnpm install\nnpm test\n```\n\nTo continuously build files while developing run:\n\n```\nnpm run watch\n```\n\nTo install and run a local HTTP server using Node.js:\n\n```\nnpm install -g http-server\nhttp-server\n```\n\nTo manually check examples in a web browser or using BrowserStack:\n\n- `http://127.0.0.1:8080/examples/index.html` (default example)\n- `http://127.0.0.1:8080/examples/checkboxes-checked.html` (with pre-selected items at page load)\n- `http://127.0.0.1:8080/examples/miller-columns-test.html` (example used for tests)\n\nAlternatively, you can open one of the HTML files in the [`/examples`](https://github.com/alphagov/miller-columns-element/tree/master/examples) directory for a quick preview.\n\n## License\n\nDistributed under the MIT license. See LICENSE for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falphagov%2Fmiller-columns-element","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falphagov%2Fmiller-columns-element","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falphagov%2Fmiller-columns-element/lists"}