mi6 / mi6/ic-ui-kit

List component

Open
#1,375 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

list component
Dominant language
TypeScript
Stars
53
Forks
63
Avg merge
2d 4h
Merged PRs (30d)
15

Description

## Summary
A list component provides a container for repeated items organized into lists. They can be used for a number of different use cases and handle the layout, scrolling, and other default behaviors of lists.

## 💬 Description
List components should handle:
- Nesting
- Grouping
- Titling
- Different item types
- Selection
- Scrolling
- Virtualisation
- Alignment
- Padding and margins
- Vertical and horizontal lists

## 💰 User value
This container component allows easy structuring of repeating UI elements taking away the work from the implementer to manage it.

## 📚 User Stories
If relevant, describe the high-level functionality as user stories.

*As an* ICDS user:
*I need* a list component
*So that* I can structure repeating lists of content.

## 📝 Acceptance Criteria
If relevant, describe in full detail the different interactions and edge cases that the component or patterns needs to fulfil.

*Given*
*When*
*Then*

## ✏ Designs
If there's a Figma design file (or other mock-up), include it here.

## 🧾 Guidance
If there's written guidance or documentation, include a link to it here.

## Additional info
Tell us anything else useful to help us understand your suggestion.

Contributor guide

Open the 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.

Research direction

The issue does not name a file, entry point, test, or design to inspect. First clarify the component's scope and acceptance criteria, especially for nesting, selection, virtualisation, scrolling, and layout; implementation is not ready to start from the issue alone.

Written by the indexing model from the issue text.

Assessment

Tech stack
typescript
Domain
frontend
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.