Capgemini / Capgemini/dcx-react-library

Details - Design System

Open
#684 0 comments 0 reactions 0 assignees View on GitHub
design-system
Dominant language
TypeScript
Stars
120
Forks
6
PR merge metrics
No merged PRs in 30d

Description

# Details - Design System

## 1 - Prerequisites

- Host element will have the `.dcx-details` class name.
- Host element will have the `.dcx-details--open` class name when the details is expanded.
- It will have sub-element with the `.dcx-details-text` class name.
- It will have sub-element with the `.dcx-details-summary` class name.
- It will have sub-element with the `.dcx-details-summary-text` class name.

## 2 - Overview

### 2.1 - Possible states

| Name | Description |
| ------- | ----------------------------------------- |
| Default | Instance without open prop or falsy value |
| Open | Instance with open prop and true value |

### 2.2 - Variants

- NONE

### 2.3 - Structure

- Details

| Element | Description |  Token Name |
| ------------ | --------------------------------- | ------------ |
| Details | The details container itself | details |
| Details Text | The text details container itself | details_text |
| Summary | The summary container itself | summary |
| Summary Text | The text summary container itself | summary_text |

### 2.4 - Tokens definition

Considerations:

- ❗ Take a close look to the Accordion component. It is a form element as well, the tokens and styling approach should be similar.
- Add the tokens to `src/design-system/tokens.json`
- Define all styles in `src/design-system/card.css`
- Add import to the new CSS file in `src/design-system/index.css`

Possible tokens:

- spacing-x-details
- border-color-details
- spacing-y-summary
- spacing-x-summary
- border-width-details
- etc.

Follow the [naming pattern](https://github.com/Capgemini/dcx-react-library/wiki/Contributing#11---naming-pattern)

## 3 - Storybook

Create the pages for:

- Playground
- Default
- AccessibleTheme
- DarkTheme
- MaterialTheme

On each MDX page make examples for each possible variant

## 4 - Initial setup

Please follow these steps to create your branch:

```bash
git checkout release/1.1.0
git pull
git checkout -b 'feature/details-design-system'
```

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.