Skip to content

Commit ce99c74

Browse files
committed
Merge branch 'component-chip' of https://github.com/dxc-technology/halstack-style-guide into component-chip
2 parents 7546515 + ca9d2eb commit ce99c74

File tree

17 files changed

+153
-131
lines changed

17 files changed

+153
-131
lines changed

.grenrc.yml

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -28,14 +28,17 @@
2828
- "component: input-password"
2929
- "component: input-number"
3030
- "component: text-area"
31+
- "component: toggle group"
3132
- "component: link"
3233
- "component: progress-bar"
3334
- "component: radio"
3435
- "component: select"
3536
- "component: sidenav"
3637
- "component: slider"
3738
- "component: spinner"
39+
- "component: switch"
3840
- "component: upload"
41+
- "component: wizard"
3942
- "type: enhancement :pencil2:"
4043
- "type: disparity :warning:"
4144
- "status: work in progress :+1:"

CHANGELOG.md

Lines changed: 127 additions & 87 deletions
Original file line numberDiff line numberDiff line change
@@ -1,38 +1,78 @@
1-
# Changelog
2-
3-
## 3.7.0 (06/09/2021)
4-
5-
#### Documentation:
6-
7-
- [Checkbox] Color specs update [#477](https://github.com/dxc-technology/halstack-style-guide/issues/477)
8-
- [Checkbox] Update component documentation to new template [#476](https://github.com/dxc-technology/halstack-style-guide/issues/476)
9-
- [Accordion] Remove heading anchors [#474](https://github.com/dxc-technology/halstack-style-guide/issues/474)
10-
- [Input-number] Component documentation [#466](https://github.com/dxc-technology/halstack-style-guide/issues/466)
11-
- [Color] Remove S, D and L color references from docs [#464](https://github.com/dxc-technology/halstack-style-guide/issues/464)
12-
- [Upload] Images update [#429](https://github.com/dxc-technology/halstack-style-guide/issues/429)
13-
- [Upload] Update component documentation to new template [#428](https://github.com/dxc-technology/halstack-style-guide/issues/428)
14-
- [Docs] Content contribution guidelines [#316](https://github.com/dxc-technology/halstack-style-guide/issues/316)
15-
- [Upload] Color specs update [#310](https://github.com/dxc-technology/halstack-style-guide/issues/310)
16-
- [Docs] Design contribution guidelines [#278](https://github.com/dxc-technology/halstack-style-guide/issues/278)
17-
18-
#### UI-Kit:
19-
20-
- [UI-Kit] Update component naming [#481](https://github.com/dxc-technology/halstack-style-guide/issues/481)
21-
- [Checkbox] Component spacing and sizing [#478](https://github.com/dxc-technology/halstack-style-guide/issues/478)
22-
- [Input-number] Ui-Kit component [#467](https://github.com/dxc-technology/halstack-style-guide/issues/467)
23-
- [Upload] Update UI-Kit component [#431](https://github.com/dxc-technology/halstack-style-guide/issues/431)
24-
25-
#### Fixes:
26-
27-
- [Upload] Component specs [#190](https://github.com/dxc-technology/halstack-style-guide/issues/190)
28-
29-
#### Site
30-
31-
- [Site] Add new components to `ignoreLabels` [#463](https://github.com/dxc-technology/halstack-style-guide/issues/463)
32-
33-
---
34-
35-
## 3.6.0 (23/08/2021)
1+
# Changelog
2+
3+
## 3.8.0 (21/09/2021)
4+
5+
#### Documentation:
6+
7+
- [Chip] Update component documentation to new template [#513](https://github.com/dxc-technology/halstack-style-guide/issues/513)
8+
- [Upload] Images update [#511](https://github.com/dxc-technology/halstack-style-guide/issues/511)
9+
- [Toggle-group] Update component documentation to new template [#501](https://github.com/dxc-technology/halstack-style-guide/issues/501)
10+
- [Button] Variant tokens update [#499](https://github.com/dxc-technology/halstack-style-guide/issues/499)
11+
- [Wizard] Update component documentation to new template [#489](https://github.com/dxc-technology/halstack-style-guide/issues/489)
12+
- [Switch] Update component documentation to new template [#488](https://github.com/dxc-technology/halstack-style-guide/issues/488)
13+
- [Switch] Images update [#487](https://github.com/dxc-technology/halstack-style-guide/issues/487)
14+
- [Checkbox] Update component documentation to new template [#476](https://github.com/dxc-technology/halstack-style-guide/issues/476)
15+
- [Text-area] Component documentation [#470](https://github.com/dxc-technology/halstack-style-guide/issues/470)
16+
- [Alert] Fixes on component specs [#437](https://github.com/dxc-technology/halstack-style-guide/issues/437)
17+
- [Textarea] Color specs update [#378](https://github.com/dxc-technology/halstack-style-guide/issues/378)
18+
- [Chip] Color specs update [#348](https://github.com/dxc-technology/halstack-style-guide/issues/348)
19+
- [Wizard] Images update [#339](https://github.com/dxc-technology/halstack-style-guide/issues/339)
20+
- [Toggle] Images update [#338](https://github.com/dxc-technology/halstack-style-guide/issues/338)
21+
- [Dialog] Images update [#336](https://github.com/dxc-technology/halstack-style-guide/issues/336)
22+
- [Chip] Documentation fixes [#323](https://github.com/dxc-technology/halstack-style-guide/issues/323)
23+
- [Footer] Documentation fixes [#322](https://github.com/dxc-technology/halstack-style-guide/issues/322)
24+
- [Switch] Color specs update [#309](https://github.com/dxc-technology/halstack-style-guide/issues/309)
25+
- [Wizard] Color specs update [#308](https://github.com/dxc-technology/halstack-style-guide/issues/308)
26+
- [Toggle] Color specs update [#307](https://github.com/dxc-technology/halstack-style-guide/issues/307)
27+
- [Button] Color specs update [#295](https://github.com/dxc-technology/halstack-style-guide/issues/295)
28+
29+
#### UI-Kit:
30+
31+
- [Text-area] UI-Kit component [#471](https://github.com/dxc-technology/halstack-style-guide/issues/471)
32+
33+
#### Fixes:
34+
35+
- [Switch] Component specs [#225](https://github.com/dxc-technology/halstack-style-guide/issues/225)
36+
37+
#### Site
38+
39+
- [Site] Design tokens page [#486](https://github.com/dxc-technology/halstack-style-guide/issues/486)
40+
41+
---
42+
43+
## 3.7.0 (06/09/2021)
44+
45+
#### Documentation:
46+
47+
- [Checkbox] Color specs update [#477](https://github.com/dxc-technology/halstack-style-guide/issues/477)
48+
- [Checkbox] Update component documentation to new template [#476](https://github.com/dxc-technology/halstack-style-guide/issues/476)
49+
- [Accordion] Remove heading anchors [#474](https://github.com/dxc-technology/halstack-style-guide/issues/474)
50+
- [Input-number] Component documentation [#466](https://github.com/dxc-technology/halstack-style-guide/issues/466)
51+
- [Color] Remove S, D and L color references from docs [#464](https://github.com/dxc-technology/halstack-style-guide/issues/464)
52+
- [Upload] Images update [#429](https://github.com/dxc-technology/halstack-style-guide/issues/429)
53+
- [Upload] Update component documentation to new template [#428](https://github.com/dxc-technology/halstack-style-guide/issues/428)
54+
- [Docs] Content contribution guidelines [#316](https://github.com/dxc-technology/halstack-style-guide/issues/316)
55+
- [Upload] Color specs update [#310](https://github.com/dxc-technology/halstack-style-guide/issues/310)
56+
- [Docs] Design contribution guidelines [#278](https://github.com/dxc-technology/halstack-style-guide/issues/278)
57+
58+
#### UI-Kit:
59+
60+
- [UI-Kit] Update component naming [#481](https://github.com/dxc-technology/halstack-style-guide/issues/481)
61+
- [Checkbox] Component spacing and sizing [#478](https://github.com/dxc-technology/halstack-style-guide/issues/478)
62+
- [Input-number] Ui-Kit component [#467](https://github.com/dxc-technology/halstack-style-guide/issues/467)
63+
- [Upload] Update UI-Kit component [#431](https://github.com/dxc-technology/halstack-style-guide/issues/431)
64+
65+
#### Fixes:
66+
67+
- [Upload] Component specs [#190](https://github.com/dxc-technology/halstack-style-guide/issues/190)
68+
69+
#### Site
70+
71+
- [Site] Add new components to `ignoreLabels` [#463](https://github.com/dxc-technology/halstack-style-guide/issues/463)
72+
73+
---
74+
75+
## 3.6.0 (23/08/2021)
3676

3777
#### Documentation:
3878

@@ -60,34 +100,34 @@
60100
#### Site
61101

62102
- [Site] Edit project README.md adding the public link to the library [#444](https://github.com/dxc-technology/halstack-style-guide/issues/444)
63-
64-
---
65-
66-
## 3.5.0 (09/08/2021)
67-
68-
#### Documentation:
69-
70-
- [Slider] Images update [#411](https://github.com/dxc-technology/halstack-style-guide/issues/411)
71-
- [Slider] Update component documentation to new template [#407](https://github.com/dxc-technology/halstack-style-guide/issues/407)
72-
- [Button] Update component documentation to new template [#375](https://github.com/dxc-technology/halstack-style-guide/issues/375)
73-
- [Alert] Update component documentation to new template [#372](https://github.com/dxc-technology/halstack-style-guide/issues/372)
74-
- [Button] Images update [#334](https://github.com/dxc-technology/halstack-style-guide/issues/334)
75-
- [Slider] Color specs update [#311](https://github.com/dxc-technology/halstack-style-guide/issues/311)
76-
- [Card] Color specs update [#296](https://github.com/dxc-technology/halstack-style-guide/issues/296)
77-
- [Button] Color specs update [#295](https://github.com/dxc-technology/halstack-style-guide/issues/295)
78-
- [Alert] Color specs update [#294](https://github.com/dxc-technology/halstack-style-guide/issues/294)
79-
80-
#### UI-Kit:
81-
82-
- [Slider] Update UI-Kit component [#424](https://github.com/dxc-technology/halstack-style-guide/issues/424)
83-
84-
#### Fixes:
85-
86-
- [Slider] Component specs [#224](https://github.com/dxc-technology/halstack-style-guide/issues/224)
87-
88-
---
89-
90-
## 3.4.0 (12/07/2021)
103+
104+
---
105+
106+
## 3.5.0 (09/08/2021)
107+
108+
#### Documentation:
109+
110+
- [Slider] Images update [#411](https://github.com/dxc-technology/halstack-style-guide/issues/411)
111+
- [Slider] Update component documentation to new template [#407](https://github.com/dxc-technology/halstack-style-guide/issues/407)
112+
- [Button] Update component documentation to new template [#375](https://github.com/dxc-technology/halstack-style-guide/issues/375)
113+
- [Alert] Update component documentation to new template [#372](https://github.com/dxc-technology/halstack-style-guide/issues/372)
114+
- [Button] Images update [#334](https://github.com/dxc-technology/halstack-style-guide/issues/334)
115+
- [Slider] Color specs update [#311](https://github.com/dxc-technology/halstack-style-guide/issues/311)
116+
- [Card] Color specs update [#296](https://github.com/dxc-technology/halstack-style-guide/issues/296)
117+
- [Button] Color specs update [#295](https://github.com/dxc-technology/halstack-style-guide/issues/295)
118+
- [Alert] Color specs update [#294](https://github.com/dxc-technology/halstack-style-guide/issues/294)
119+
120+
#### UI-Kit:
121+
122+
- [Slider] Update UI-Kit component [#424](https://github.com/dxc-technology/halstack-style-guide/issues/424)
123+
124+
#### Fixes:
125+
126+
- [Slider] Component specs [#224](https://github.com/dxc-technology/halstack-style-guide/issues/224)
127+
128+
---
129+
130+
## 3.4.0 (12/07/2021)
91131

92132
#### Documentation:
93133

@@ -113,10 +153,10 @@
113153

114154
- [Site] Remove .DS_Store files [#362](https://github.com/dxc-technology/halstack-style-guide/issues/362)
115155
- [Site] Automate release notes [#344](https://github.com/dxc-technology/halstack-style-guide/issues/344)
116-
117-
---
118-
119-
## 3.3.0 (30/06/2021)
156+
157+
---
158+
159+
## 3.3.0 (30/06/2021)
120160
## Documentation
121161

122162
* **Added**: Contribution guidelines #264 f713135f1a2ab169ff4778c3122c006d659b85ba
@@ -148,10 +188,10 @@
148188
* **Spinner**: Fixed component specs #228 e612fff7afe8a6ac12fdad69df98335c081e4ef8 8b378aa6cfb4cae87851fa8f8783ef0c6dd1d93b
149189

150190

151-
152-
---
153-
154-
## 3.2.0 (14/06/2021)
191+
192+
---
193+
194+
## 3.2.0 (14/06/2021)
155195
## Documentation
156196

157197
* **Added**: `dropdown` accessibility section #247 0b9231036358cfef0508ca4c2e9954e44c2511ab
@@ -177,10 +217,10 @@
177217
* **Link**: Fixed component specs #221 4a05ebe2c049383ea69545e9957c2b0b4283bb02
178218
* **Autocomplete**: Fixed component specs #220 638fbd5c93ae7ca5462b06efc52eb3bb90691575
179219
* **Wizard**: Fixed component specs #222 858778c2ec257f43b6c68d519a228b7dadcaecff
180-
181-
---
182-
183-
## 3.1.2 (02/06/2021)
220+
221+
---
222+
223+
## 3.1.2 (02/06/2021)
184224
## Documentation
185225

186226
- Added: `select` helper text #203 4f63bfdc47b70ef615484b51ff970b0956594895
@@ -216,10 +256,10 @@
216256
- **Select**: Fixed component specs #170 94db1cc80739600eb2b8fba4c61fcd97434789e8
217257
- **Checkbox**: Fixed component specs #192 4f3f6ec3d9711c3adc5084af7f67e1594ea1da20
218258
- **Radio button**: Fixed component specs #193 3b2b4fcd5848772edb94307e9bebd496dc9735c4
219-
- **Button**: Fixed component specs #160 d248465904ad94401bcd914a1cdb80820c01c776
220-
---
221-
222-
## 3.1.1 (17/05/2021)
259+
- **Button**: Fixed component specs #160 d248465904ad94401bcd914a1cdb80820c01c776
260+
---
261+
262+
## 3.1.1 (17/05/2021)
223263
## Documentation
224264

225265
* Added: `Box` component documentation #152 b56357c9a8c6f92a8fc52f88cbfe3e3fe174c57d
@@ -261,10 +301,10 @@
261301
* **Card**: Fixed component specs and update documentation images #58 8429c7e96b8c09b36ef8be395a528bd256e4ac1e
262302
* **Switch**: Fixed component specs #174 832be41b09d68324bf437f7c4b44be928854edd9
263303
* **Input**: Fixed component specs #45 0bcabe62768f1f5e4eb2293269eb3a853e18c65f
264-
* **Toggle-group**: Fixed outdated documentation #182 772ffd828e3eb418ad761df36078b1132220a1f6
265-
---
266-
267-
## 3.1.0 (03/05/2021)
304+
* **Toggle-group**: Fixed outdated documentation #182 772ffd828e3eb418ad761df36078b1132220a1f6
305+
---
306+
307+
## 3.1.0 (03/05/2021)
268308
## Documentation
269309

270310
* Added: Colors documentation and color design tokens #65 #67 bec369dfefba68fbf75bce20cb8e397af5d0f2e7
@@ -300,10 +340,10 @@
300340
* **Table**: Fixed `Table with Filter and Resulset` and `Table with Filter and HAL API connection` in UI-Kit. #56 8f1e4f0
301341
* **Dropdown**: Updated `dropdown` documentation specs. #39 f65d6fc
302342
* **Dropdown**: Updated UI-Kit `dropdown` component specs. #62 ad1851549ed0be70aa2ffc040b6a5e756ea244ef
303-
* **Color**: Fixed incorrect HEX & HSL values in color palette #146 4517910fed919c42f6b3387d3e058003b8d7328f
304-
---
305-
306-
## 3.0.0 (08/04/2021)
343+
* **Color**: Fixed incorrect HEX & HSL values in color palette #146 4517910fed919c42f6b3387d3e058003b8d7328f
344+
---
345+
346+
## 3.0.0 (08/04/2021)
307347
## Documentation
308348

309349
* Added: ```theme-inputs``` to principles/themes
6.14 MB
Binary file not shown.
1.15 MB
Binary file not shown.

guidelines/components/upload/README.md

Lines changed: 23 additions & 44 deletions
Original file line numberDiff line numberDiff line change
@@ -2,73 +2,52 @@
22

33
The upload component is used to choose files from any location in the local machine and update those files to the server where the application is hosted. It is a common procedure in applications where files are required like documents, images or other information in digital formats.
44

5-
## Appearance
5+
## Usage
66

7-
A limited area in the user interface is reserved for this purpose, letting the user select the files in two ways, either choosing the file through the file system of the operating system or dragging the file and dropping in the respective area.
8-
Once the file is displayed there, some characteristics are rendered:
9-
- A thumbnail of the file (in the case that it is available)
10-
- The name of the file
11-
- The size or other information of the file
12-
- An icon representing the actual status of the file (in progress, done, error)
13-
14-
When all the files are loaded and the user wants to upload the files to the server, the only action to be performed is the click on the upload button. If the action goes right, an alert message with a success status will be displayed, in other cases, an error will pop up indicating the reason.
15-
16-
### Modes
17-
18-
There are two different modes for the upload component, one of them is used to upload a single file thus the representation of the component is much simple and takes less space in the screen compared with the multi file upload version, which is used to select several files in a row.
19-
20-
Modes for the component: __single__ and __multiple__.
21-
22-
23-
### States
24-
25-
*Default state*
7+
- Use the specific mode based on the application requirements
8+
- Add some explanation text in the case that it is needed to clarify the information to the user
9+
- By default, the drag and drop appearance is handled by the browser, in case it wants to be customized is the responsibility of the developer
10+
- If the upload process fails, please show an error message avoiding technical or undetermined information (i.e '0x94 ERROR_PATH_BUSY') that won't be understood by the user of the application
2611

27-
![Upload with the default preview of the component](images/upload_preview.png)
2812

29-
*Drag and drop state*
3013

31-
![Upload with drag and drop action of a file](images/upload_dragdrop.png)
14+
## States
3215

33-
*Uploading state*
16+
### Default
3417

35-
![Upload with file uploading](images/upload_processing.png)
18+
![Upload with the default preview of the component](images/upload_default.png)
3619

37-
*File complete state*
20+
_Upload with the default preview of the component_
3821

39-
![Upload with a file already uploaded and added to the list](images/upload_uploaded.png)
22+
### Drag and drop
4023

41-
*Hover state with extra options*
24+
![Upload with drag and drop action of a file](images/upload_dragover.png)
4225

43-
![Upload with a hover action over the items to display more options](images/upload_hover.png)
26+
_Upload with drag and drop action of a file_
4427

45-
*Upload completion state*
28+
### Hover state
4629

47-
![Upload after cliclinkg the upload button with an alert reporting the state](images/upload_alert.png)
30+
![Example of an item hovered](images/upload_preview.png)
4831

49-
## Design tokens
32+
_Example of an item hovered_
5033

51-
Cannot be possible to configure or customize any parameter of the component to apply a theming.
34+
### Success and error
5235

53-
## Design Specifications
36+
Provide feedback to the users regarding the issues their files may face, or indicate that the files upload was succesfull. An alert type `success` or `error` should be placed on the top right corner of the upload container.
5437

55-
Since this component has many specifications to be detailed here, the best way to share the information with the interested people is throw the adobe cloud link in the Links and references section.
38+
![Component success feedback](images/upload_success.png)
5639

57-
### Responsive design
40+
_Component success feedback_
5841

59-
*This is pending*
42+
![Component error feedback](images/upload_error.png)
6043

61-
### User Interface Design Considerations
44+
_Component error feedback_
6245

63-
- Use the specific mode based on the application requirements
64-
- Add some explanation text in the case that it is needed to clarify the information to the user
65-
- By default, the drag and drop appearance is handled by the browser, in case it wants to be customized is the responsibility of the developer
66-
- If the upload process fails, please show an error message avoiding technical or undetermined information (i.e '0x94 ERROR_PATH_BUSY') that won't be understood by the user of the application
6746

6847
## Links and references
6948

70-
- Upload: https://xd.adobe.com/view/23e2cca4-5021-490a-a548-e99a9b4a2006-76b1/screen/0a80be63-f9b6-4436-a3f1-ced47070f70d/variables/
71-
- Single upload: https://xd.adobe.com/view/23e2cca4-5021-490a-a548-e99a9b4a2006-76b1/screen/f67eb530-b374-4d13-a1d8-ba4c1fba2e74/variables/
49+
- [React CDK component](https://developer.dxc.com/tools/react/next/#/components/upload)
50+
- [Angular CDK component](https://developer.dxc.com/tools/angular/next/#/components/upload)
7251

7352
____________________________________________________________
7453

-26.9 KB
Binary file not shown.
34.4 KB
Loading
-17.5 KB
Binary file not shown.
24.7 KB
Loading
55 KB
Loading

0 commit comments

Comments
 (0)