@dxc-technology/halstack-react 0.0.0-e1a279c → 0.0.0-e201636

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (281) hide show
  1. package/BackgroundColorContext.d.ts +10 -0
  2. package/BackgroundColorContext.js +1 -4
  3. package/HalstackContext.d.ts +12 -0
  4. package/HalstackContext.js +295 -0
  5. package/accordion/Accordion.d.ts +1 -1
  6. package/accordion/Accordion.js +15 -47
  7. package/accordion/Accordion.stories.tsx +307 -0
  8. package/accordion/Accordion.test.js +72 -0
  9. package/accordion/types.d.ts +8 -8
  10. package/accordion-group/AccordionGroup.d.ts +1 -1
  11. package/accordion-group/AccordionGroup.js +15 -17
  12. package/accordion-group/AccordionGroup.stories.tsx +225 -0
  13. package/accordion-group/AccordionGroup.test.js +151 -0
  14. package/accordion-group/types.d.ts +8 -8
  15. package/alert/Alert.js +6 -3
  16. package/alert/Alert.test.js +92 -0
  17. package/alert/types.d.ts +1 -1
  18. package/badge/Badge.d.ts +4 -0
  19. package/badge/Badge.js +6 -4
  20. package/badge/types.d.ts +5 -0
  21. package/{radio → badge}/types.js +0 -0
  22. package/bleed/Bleed.d.ts +3 -0
  23. package/bleed/Bleed.js +84 -0
  24. package/bleed/Bleed.stories.tsx +342 -0
  25. package/bleed/types.d.ts +37 -0
  26. package/bleed/types.js +5 -0
  27. package/box/Box.d.ts +1 -1
  28. package/box/Box.js +26 -39
  29. package/box/Box.test.js +18 -0
  30. package/box/types.d.ts +0 -4
  31. package/button/Button.d.ts +1 -1
  32. package/button/Button.js +24 -27
  33. package/button/Button.stories.tsx +6 -8
  34. package/button/Button.test.js +35 -0
  35. package/button/types.d.ts +5 -9
  36. package/card/Card.js +32 -34
  37. package/card/Card.stories.tsx +201 -0
  38. package/card/Card.test.js +50 -0
  39. package/card/ice-cream.jpg +0 -0
  40. package/card/types.d.ts +4 -6
  41. package/checkbox/Checkbox.d.ts +1 -1
  42. package/checkbox/Checkbox.js +45 -41
  43. package/checkbox/Checkbox.stories.tsx +124 -128
  44. package/checkbox/Checkbox.test.js +78 -0
  45. package/checkbox/types.d.ts +9 -5
  46. package/chip/Chip.d.ts +4 -0
  47. package/chip/Chip.js +16 -76
  48. package/chip/Chip.stories.tsx +6 -8
  49. package/chip/Chip.test.js +56 -0
  50. package/chip/types.d.ts +45 -0
  51. package/chip/types.js +5 -0
  52. package/common/variables.js +234 -341
  53. package/date-input/DateInput.js +63 -52
  54. package/date-input/DateInput.stories.tsx +7 -7
  55. package/date-input/DateInput.test.js +479 -0
  56. package/date-input/types.d.ts +16 -9
  57. package/dialog/Dialog.js +8 -35
  58. package/dialog/Dialog.test.js +40 -0
  59. package/dropdown/Dropdown.d.ts +1 -1
  60. package/dropdown/Dropdown.js +22 -48
  61. package/dropdown/Dropdown.stories.tsx +249 -0
  62. package/dropdown/Dropdown.test.js +189 -0
  63. package/dropdown/types.d.ts +6 -15
  64. package/file-input/FileInput.d.ts +4 -0
  65. package/file-input/FileInput.js +172 -111
  66. package/file-input/FileInput.stories.tsx +507 -0
  67. package/file-input/FileInput.test.js +457 -0
  68. package/file-input/FileItem.d.ts +14 -0
  69. package/file-input/FileItem.js +16 -23
  70. package/file-input/types.d.ts +112 -0
  71. package/file-input/types.js +5 -0
  72. package/footer/Footer.d.ts +1 -1
  73. package/footer/Footer.js +32 -113
  74. package/footer/{Footer.stories.jsx → Footer.stories.tsx} +1 -22
  75. package/footer/Footer.test.js +109 -0
  76. package/footer/Icons.d.ts +2 -0
  77. package/footer/Icons.js +3 -3
  78. package/footer/types.d.ts +22 -18
  79. package/header/Header.js +29 -50
  80. package/header/Header.stories.tsx +172 -0
  81. package/header/Header.test.js +79 -0
  82. package/header/Icons.d.ts +2 -0
  83. package/header/types.d.ts +4 -2
  84. package/heading/Heading.d.ts +4 -0
  85. package/heading/Heading.js +7 -24
  86. package/heading/Heading.stories.tsx +54 -0
  87. package/heading/Heading.test.js +186 -0
  88. package/heading/types.d.ts +33 -0
  89. package/heading/types.js +5 -0
  90. package/inset/Inset.d.ts +3 -0
  91. package/inset/Inset.js +84 -0
  92. package/inset/Inset.stories.tsx +229 -0
  93. package/inset/types.d.ts +37 -0
  94. package/inset/types.js +5 -0
  95. package/layout/ApplicationLayout.d.ts +11 -0
  96. package/layout/ApplicationLayout.js +84 -120
  97. package/layout/ApplicationLayout.stories.tsx +126 -0
  98. package/layout/Icons.d.ts +5 -0
  99. package/layout/Icons.js +13 -2
  100. package/layout/SidenavContext.d.ts +5 -0
  101. package/layout/SidenavContext.js +19 -0
  102. package/layout/types.d.ts +52 -0
  103. package/layout/types.js +5 -0
  104. package/link/Link.d.ts +3 -2
  105. package/link/Link.js +61 -86
  106. package/link/Link.stories.tsx +131 -15
  107. package/link/Link.test.js +83 -0
  108. package/link/types.d.ts +9 -29
  109. package/list/List.d.ts +4 -0
  110. package/list/List.js +47 -0
  111. package/list/List.stories.tsx +95 -0
  112. package/list/types.d.ts +7 -0
  113. package/list/types.js +5 -0
  114. package/main.d.ts +12 -9
  115. package/main.js +72 -42
  116. package/number-input/NumberInput.js +14 -24
  117. package/number-input/NumberInput.stories.tsx +5 -5
  118. package/number-input/NumberInput.test.js +506 -0
  119. package/number-input/NumberInputContext.d.ts +4 -0
  120. package/number-input/NumberInputContext.js +5 -2
  121. package/number-input/numberInputContextTypes.d.ts +19 -0
  122. package/number-input/numberInputContextTypes.js +5 -0
  123. package/number-input/types.d.ts +17 -10
  124. package/package.json +9 -6
  125. package/paginator/Paginator.js +19 -46
  126. package/paginator/Paginator.test.js +266 -0
  127. package/password-input/PasswordInput.js +23 -19
  128. package/password-input/PasswordInput.stories.tsx +3 -3
  129. package/password-input/PasswordInput.test.js +180 -0
  130. package/password-input/types.d.ts +29 -19
  131. package/progress-bar/ProgressBar.js +5 -5
  132. package/progress-bar/ProgressBar.stories.jsx +11 -11
  133. package/progress-bar/ProgressBar.test.js +65 -0
  134. package/quick-nav/QuickNav.d.ts +4 -0
  135. package/quick-nav/QuickNav.js +112 -0
  136. package/quick-nav/QuickNav.stories.tsx +237 -0
  137. package/quick-nav/types.d.ts +21 -0
  138. package/quick-nav/types.js +5 -0
  139. package/radio-group/Radio.d.ts +4 -0
  140. package/radio-group/Radio.js +141 -0
  141. package/radio-group/RadioGroup.d.ts +4 -0
  142. package/radio-group/RadioGroup.js +282 -0
  143. package/radio-group/RadioGroup.stories.tsx +100 -0
  144. package/radio-group/RadioGroup.test.js +695 -0
  145. package/radio-group/types.d.ts +114 -0
  146. package/radio-group/types.js +5 -0
  147. package/resultsetTable/ResultsetTable.d.ts +4 -0
  148. package/resultsetTable/ResultsetTable.js +9 -29
  149. package/resultsetTable/ResultsetTable.stories.tsx +275 -0
  150. package/resultsetTable/ResultsetTable.test.js +306 -0
  151. package/resultsetTable/types.d.ts +67 -0
  152. package/resultsetTable/types.js +5 -0
  153. package/row/Row.d.ts +3 -0
  154. package/row/Row.js +127 -0
  155. package/row/Row.stories.tsx +237 -0
  156. package/row/types.d.ts +28 -0
  157. package/row/types.js +5 -0
  158. package/select/Icons.d.ts +10 -0
  159. package/select/Icons.js +93 -0
  160. package/select/Listbox.d.ts +4 -0
  161. package/select/Listbox.js +152 -0
  162. package/select/Option.d.ts +4 -0
  163. package/select/Option.js +110 -0
  164. package/select/Select.d.ts +4 -0
  165. package/select/Select.js +122 -342
  166. package/select/Select.stories.tsx +103 -81
  167. package/select/Select.test.js +2120 -0
  168. package/select/types.d.ts +213 -0
  169. package/select/types.js +5 -0
  170. package/sidenav/Sidenav.d.ts +1 -1
  171. package/sidenav/Sidenav.js +22 -11
  172. package/sidenav/Sidenav.stories.tsx +182 -0
  173. package/sidenav/Sidenav.test.js +56 -0
  174. package/slider/Slider.d.ts +1 -1
  175. package/slider/Slider.js +6 -5
  176. package/slider/Slider.stories.tsx +8 -8
  177. package/slider/Slider.test.js +150 -0
  178. package/slider/types.d.ts +4 -0
  179. package/spinner/Spinner.js +3 -3
  180. package/spinner/Spinner.stories.jsx +1 -0
  181. package/spinner/Spinner.test.js +64 -0
  182. package/stack/Stack.d.ts +3 -0
  183. package/stack/Stack.js +97 -0
  184. package/stack/Stack.stories.tsx +164 -0
  185. package/stack/types.d.ts +24 -0
  186. package/stack/types.js +5 -0
  187. package/switch/Switch.d.ts +1 -1
  188. package/switch/Switch.js +37 -21
  189. package/switch/Switch.stories.tsx +15 -15
  190. package/switch/Switch.test.js +98 -0
  191. package/switch/types.d.ts +6 -2
  192. package/table/Table.js +3 -3
  193. package/table/Table.stories.jsx +2 -1
  194. package/table/Table.test.js +26 -0
  195. package/tabs/Tabs.d.ts +1 -1
  196. package/tabs/Tabs.js +20 -20
  197. package/tabs/Tabs.stories.tsx +112 -0
  198. package/tabs/Tabs.test.js +140 -0
  199. package/tabs/types.d.ts +29 -18
  200. package/tabs-nav/NavTabs.d.ts +8 -0
  201. package/tabs-nav/NavTabs.js +125 -0
  202. package/tabs-nav/NavTabs.stories.tsx +170 -0
  203. package/tabs-nav/NavTabs.test.js +82 -0
  204. package/tabs-nav/Tab.d.ts +4 -0
  205. package/tabs-nav/Tab.js +132 -0
  206. package/tabs-nav/types.d.ts +53 -0
  207. package/tabs-nav/types.js +5 -0
  208. package/tag/Tag.d.ts +1 -1
  209. package/tag/Tag.js +18 -28
  210. package/tag/Tag.stories.tsx +26 -29
  211. package/tag/Tag.test.js +60 -0
  212. package/tag/types.d.ts +23 -14
  213. package/text/Text.d.ts +7 -0
  214. package/text/Text.js +30 -0
  215. package/text/Text.stories.tsx +19 -0
  216. package/text-input/Suggestion.d.ts +4 -0
  217. package/text-input/Suggestion.js +55 -0
  218. package/text-input/TextInput.d.ts +4 -0
  219. package/text-input/TextInput.js +91 -146
  220. package/text-input/TextInput.stories.tsx +474 -0
  221. package/text-input/TextInput.test.js +1712 -0
  222. package/text-input/types.d.ts +178 -0
  223. package/text-input/types.js +5 -0
  224. package/textarea/Textarea.d.ts +4 -0
  225. package/textarea/Textarea.js +39 -79
  226. package/textarea/Textarea.stories.jsx +37 -15
  227. package/textarea/Textarea.test.js +437 -0
  228. package/textarea/types.d.ts +137 -0
  229. package/textarea/types.js +5 -0
  230. package/toggle-group/ToggleGroup.d.ts +4 -0
  231. package/toggle-group/ToggleGroup.js +18 -46
  232. package/toggle-group/ToggleGroup.stories.tsx +27 -32
  233. package/toggle-group/ToggleGroup.test.js +156 -0
  234. package/toggle-group/types.d.ts +105 -0
  235. package/toggle-group/types.js +5 -0
  236. package/useTheme.d.ts +2 -0
  237. package/useTheme.js +2 -2
  238. package/useTranslatedLabels.d.ts +2 -0
  239. package/useTranslatedLabels.js +20 -0
  240. package/wizard/Wizard.d.ts +1 -1
  241. package/wizard/Wizard.js +107 -46
  242. package/wizard/{Wizard.stories.jsx → Wizard.stories.tsx} +13 -23
  243. package/wizard/Wizard.test.js +141 -0
  244. package/wizard/types.d.ts +9 -9
  245. package/ThemeContext.js +0 -246
  246. package/V3Select/V3Select.js +0 -455
  247. package/V3Select/index.d.ts +0 -27
  248. package/V3Textarea/V3Textarea.js +0 -260
  249. package/V3Textarea/index.d.ts +0 -27
  250. package/chip/index.d.ts +0 -22
  251. package/date/Date.js +0 -373
  252. package/date/index.d.ts +0 -27
  253. package/file-input/index.d.ts +0 -81
  254. package/heading/index.d.ts +0 -17
  255. package/input-text/Icons.js +0 -22
  256. package/input-text/InputText.js +0 -611
  257. package/input-text/index.d.ts +0 -36
  258. package/radio/Radio.d.ts +0 -4
  259. package/radio/Radio.js +0 -174
  260. package/radio/Radio.stories.tsx +0 -192
  261. package/radio/types.d.ts +0 -54
  262. package/resultsetTable/index.d.ts +0 -19
  263. package/select/index.d.ts +0 -131
  264. package/text-input/index.d.ts +0 -135
  265. package/textarea/index.d.ts +0 -117
  266. package/toggle/Toggle.js +0 -186
  267. package/toggle/index.d.ts +0 -21
  268. package/toggle-group/index.d.ts +0 -21
  269. package/upload/Upload.js +0 -201
  270. package/upload/buttons-upload/ButtonsUpload.js +0 -111
  271. package/upload/buttons-upload/Icons.js +0 -40
  272. package/upload/dragAndDropArea/DragAndDropArea.js +0 -225
  273. package/upload/dragAndDropArea/Icons.js +0 -39
  274. package/upload/file-upload/FileToUpload.js +0 -115
  275. package/upload/file-upload/Icons.js +0 -66
  276. package/upload/files-upload/FilesToUpload.js +0 -109
  277. package/upload/index.d.ts +0 -15
  278. package/upload/transaction/Icons.js +0 -160
  279. package/upload/transaction/Transaction.js +0 -104
  280. package/upload/transactions/Transactions.js +0 -94
  281. package/wizard/Icons.js +0 -65
package/wizard/Wizard.js CHANGED
@@ -9,10 +9,10 @@ Object.defineProperty(exports, "__esModule", {
9
9
  });
10
10
  exports["default"] = void 0;
11
11
 
12
- var _taggedTemplateLiteral2 = _interopRequireDefault(require("@babel/runtime/helpers/taggedTemplateLiteral"));
13
-
14
12
  var _typeof2 = _interopRequireDefault(require("@babel/runtime/helpers/typeof"));
15
13
 
14
+ var _taggedTemplateLiteral2 = _interopRequireDefault(require("@babel/runtime/helpers/taggedTemplateLiteral"));
15
+
16
16
  var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
17
17
 
18
18
  var _react = _interopRequireWildcard(require("react"));
@@ -21,9 +21,7 @@ var _styledComponents = _interopRequireWildcard(require("styled-components"));
21
21
 
22
22
  var _variables = require("../common/variables.js");
23
23
 
24
- var _useTheme = _interopRequireDefault(require("../useTheme.js"));
25
-
26
- var _Icons = require("./Icons");
24
+ var _useTheme = _interopRequireDefault(require("../useTheme"));
27
25
 
28
26
  var _templateObject, _templateObject2, _templateObject3, _templateObject4, _templateObject5, _templateObject6, _templateObject7, _templateObject8, _templateObject9, _templateObject10, _templateObject11, _templateObject12, _templateObject13;
29
27
 
@@ -31,9 +29,64 @@ function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "functio
31
29
 
32
30
  function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || _typeof3(obj) !== "object" && typeof obj !== "function") { return { "default": obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj["default"] = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
33
31
 
32
+ var icons = {
33
+ validIcon: /*#__PURE__*/_react["default"].createElement("svg", {
34
+ id: "check_circle_black_18dp",
35
+ xmlns: "http://www.w3.org/2000/svg",
36
+ width: "18",
37
+ height: "18",
38
+ viewBox: "0 0 18 18"
39
+ }, /*#__PURE__*/_react["default"].createElement("path", {
40
+ id: "Path_2946",
41
+ "data-name": "Path 2946",
42
+ d: "M0,0H18V18H0Z",
43
+ fill: "none"
44
+ }), /*#__PURE__*/_react["default"].createElement("path", {
45
+ id: "Path_2947",
46
+ "data-name": "Path 2947",
47
+ d: "M9.986,4a5.986,5.986,0,1,0,5.986,5.986A5.994,5.994,0,0,0,9.986,4Zm-1.5,9.727L5.5,10.734,6.551,9.679l1.938,1.93L13.42,6.679l1.055,1.063Z",
48
+ transform: "translate(-0.986 -0.986)",
49
+ fill: "#eafaef",
50
+ opacity: "0.999"
51
+ }), /*#__PURE__*/_react["default"].createElement("path", {
52
+ id: "Path_2948",
53
+ "data-name": "Path 2948",
54
+ d: "M9.493,2a7.493,7.493,0,1,0,7.493,7.493A7.5,7.5,0,0,0,9.493,2Zm0,13.487a5.994,5.994,0,1,1,5.994-5.994A6,6,0,0,1,9.493,15.487Zm3.439-9.306L7.994,11.119,6.054,9.186,5,10.242l3,3,5.994-5.994Z",
55
+ transform: "translate(-0.493 -0.493)",
56
+ fill: "#24a148"
57
+ })),
58
+ invalidIcon: /*#__PURE__*/_react["default"].createElement("svg", {
59
+ id: "highlight_off_black_18dp",
60
+ xmlns: "http://www.w3.org/2000/svg",
61
+ width: "18",
62
+ height: "18",
63
+ viewBox: "0 0 18 18"
64
+ }, /*#__PURE__*/_react["default"].createElement("path", {
65
+ id: "Path_2943",
66
+ "data-name": "Path 2943",
67
+ d: "M0,0H18V18H0Z",
68
+ fill: "none"
69
+ }), /*#__PURE__*/_react["default"].createElement("path", {
70
+ id: "Path_2944",
71
+ "data-name": "Path 2944",
72
+ d: "M10,4a6,6,0,1,0,6,6A6.01,6.01,0,0,0,10,4Zm3,7.945L11.945,13,10,11.06,8.059,13,7,11.945,8.944,10,7,8.059,8.059,7,10,8.944,11.945,7,13,8.059,11.06,10Z",
73
+ transform: "translate(-1.002 -1.002)",
74
+ fill: "#ffe6e9"
75
+ }), /*#__PURE__*/_react["default"].createElement("path", {
76
+ id: "Path_2945",
77
+ "data-name": "Path 2945",
78
+ d: "M11.444,6.5,9.5,8.443,7.558,6.5,6.5,7.558,8.443,9.5,6.5,11.444,7.558,12.5,9.5,10.558,11.444,12.5,12.5,11.444,10.558,9.5,12.5,7.558ZM9.5,2A7.5,7.5,0,1,0,17,9.5,7.494,7.494,0,0,0,9.5,2Zm0,13.5a6,6,0,1,1,6-6A6.009,6.009,0,0,1,9.5,15.5Z",
79
+ transform: "translate(-0.501 -0.501)",
80
+ fill: "#d0011b"
81
+ }))
82
+ };
83
+
34
84
  var DxcWizard = function DxcWizard(_ref) {
85
+ var _ref2;
86
+
35
87
  var _ref$mode = _ref.mode,
36
88
  mode = _ref$mode === void 0 ? "horizontal" : _ref$mode,
89
+ defaultCurrentStep = _ref.defaultCurrentStep,
37
90
  currentStep = _ref.currentStep,
38
91
  onStepClick = _ref.onStepClick,
39
92
  steps = _ref.steps,
@@ -41,7 +94,7 @@ var DxcWizard = function DxcWizard(_ref) {
41
94
  _ref$tabIndex = _ref.tabIndex,
42
95
  tabIndex = _ref$tabIndex === void 0 ? 0 : _ref$tabIndex;
43
96
 
44
- var _useState = (0, _react.useState)(currentStep || 0),
97
+ var _useState = (0, _react.useState)((_ref2 = currentStep !== null && currentStep !== void 0 ? currentStep : defaultCurrentStep) !== null && _ref2 !== void 0 ? _ref2 : 0),
45
98
  _useState2 = (0, _slicedToArray2["default"])(_useState, 2),
46
99
  innerCurrent = _useState2[0],
47
100
  setInnerCurrentStep = _useState2[1];
@@ -63,48 +116,54 @@ var DxcWizard = function DxcWizard(_ref) {
63
116
  theme: colorsTheme.wizard
64
117
  }, /*#__PURE__*/_react["default"].createElement(StepsContainer, {
65
118
  mode: mode,
66
- margin: margin
119
+ margin: margin,
120
+ role: "group"
67
121
  }, steps === null || steps === void 0 ? void 0 : steps.map(function (step, i) {
68
122
  return /*#__PURE__*/_react["default"].createElement(StepContainer, {
69
123
  key: "step".concat(i),
70
124
  mode: mode,
71
125
  lastStep: i === (steps === null || steps === void 0 ? void 0 : steps.length) - 1
72
126
  }, /*#__PURE__*/_react["default"].createElement(Step, {
73
- tabIndex: tabIndex,
74
127
  onClick: function onClick() {
75
- return handleStepClick(i);
128
+ handleStepClick(i);
76
129
  },
77
- mode: mode,
78
130
  disabled: step.disabled,
131
+ mode: mode,
79
132
  first: i === 0,
80
- last: i === (steps === null || steps === void 0 ? void 0 : steps.length) - 1
81
- }, /*#__PURE__*/_react["default"].createElement(StepHeader, null, /*#__PURE__*/_react["default"].createElement(IconContainer, {
133
+ last: i === (steps === null || steps === void 0 ? void 0 : steps.length) - 1,
134
+ "aria-current": renderedCurrent === i ? "step" : "false",
135
+ tabIndex: tabIndex
136
+ }, /*#__PURE__*/_react["default"].createElement(StepHeader, {
137
+ validityIcon: step.valid !== undefined
138
+ }, /*#__PURE__*/_react["default"].createElement(IconContainer, {
82
139
  current: i === renderedCurrent,
83
140
  visited: i < renderedCurrent,
84
141
  disabled: step.disabled
85
142
  }, step.icon ? /*#__PURE__*/_react["default"].createElement(StepIconContainer, {
86
143
  disabled: step.disabled
87
- }, (0, _typeof2["default"])(step.icon) === "object" ? step.icon : /*#__PURE__*/_react["default"].createElement(step.icon)) : step.iconSrc ? /*#__PURE__*/_react["default"].createElement(Icon, {
88
- src: step.iconSrc
89
- }) : /*#__PURE__*/_react["default"].createElement(Number, {
144
+ }, typeof step.icon === "string" ? /*#__PURE__*/_react["default"].createElement(Icon, {
145
+ src: step.icon
146
+ }) : step.icon) : /*#__PURE__*/_react["default"].createElement(Number, {
90
147
  disabled: step.disabled,
91
148
  current: i === renderedCurrent
92
- }, i + 1)), step.valid !== undefined ? step.valid ? /*#__PURE__*/_react["default"].createElement(ValidityIconContainer, null, _Icons.validIcon) : /*#__PURE__*/_react["default"].createElement(ValidityIconContainer, null, _Icons.invalidIcon) : ""), step.label || step.description ? /*#__PURE__*/_react["default"].createElement(InfoContainer, null, step.label ? /*#__PURE__*/_react["default"].createElement(Label, {
149
+ }, i + 1)), step.valid !== undefined && (step.valid ? /*#__PURE__*/_react["default"].createElement(ValidityIconContainer, null, icons.validIcon) : /*#__PURE__*/_react["default"].createElement(ValidityIconContainer, null, icons.invalidIcon))), (step.label || step.description) && /*#__PURE__*/_react["default"].createElement(InfoContainer, null, step.label && /*#__PURE__*/_react["default"].createElement(Label, {
150
+ current: i === renderedCurrent,
93
151
  disabled: step.disabled,
94
152
  visited: i <= innerCurrent
95
- }, step.label) : "", step.description ? /*#__PURE__*/_react["default"].createElement(Description, {
153
+ }, step.label), step.description && /*#__PURE__*/_react["default"].createElement(Description, {
154
+ current: i === renderedCurrent,
96
155
  disabled: step.disabled,
97
156
  visited: i <= innerCurrent
98
- }, step.description) : "") : ""), i === steps.length - 1 ? "" : /*#__PURE__*/_react["default"].createElement(StepSeparator, {
157
+ }, step.description))), i === steps.length - 1 ? "" : /*#__PURE__*/_react["default"].createElement(StepSeparator, {
99
158
  mode: mode
100
159
  }));
101
160
  })));
102
161
  };
103
162
 
104
- var StepsContainer = _styledComponents["default"].div(_templateObject || (_templateObject = (0, _taggedTemplateLiteral2["default"])(["\n display: inline-flex;\n flex-direction: ", ";\n justify-content: \"center\";\n ", ";\n font-family: ", ";\n\n margin: ", ";\n margin-top: ", ";\n margin-right: ", ";\n margin-bottom: ", ";\n margin-left: ", ";\n"])), function (props) {
163
+ var StepsContainer = _styledComponents["default"].div(_templateObject || (_templateObject = (0, _taggedTemplateLiteral2["default"])(["\n display: flex;\n flex-direction: ", ";\n justify-content: \"center\";\n ", ";\n font-family: ", ";\n\n margin: ", ";\n margin-top: ", ";\n margin-right: ", ";\n margin-bottom: ", ";\n margin-left: ", ";\n"])), function (props) {
105
164
  return props.mode === "vertical" ? "column" : "row";
106
165
  }, function (props) {
107
- return props.mode === "vertical" ? "height: 500px" : "width: 100%";
166
+ return props.mode === "vertical" && "height: 500px";
108
167
  }, function (props) {
109
168
  return props.theme.fontFamily;
110
169
  }, function (props) {
@@ -139,42 +198,44 @@ var Step = _styledComponents["default"].button(_templateObject3 || (_templateObj
139
198
  return props.theme.focusColor;
140
199
  });
141
200
 
142
- var StepHeader = _styledComponents["default"].div(_templateObject4 || (_templateObject4 = (0, _taggedTemplateLiteral2["default"])(["\n position: relative;\n display: inline-flex;\n padding-bottom: 4px;\n"])));
201
+ var StepHeader = _styledComponents["default"].div(_templateObject4 || (_templateObject4 = (0, _taggedTemplateLiteral2["default"])(["\n position: relative;\n display: inline-flex;\n ", "\n"])), function (props) {
202
+ return props.validityIcon && "padding-bottom: 4px;";
203
+ });
143
204
 
144
- var IconContainer = _styledComponents["default"].div(_templateObject5 || (_templateObject5 = (0, _taggedTemplateLiteral2["default"])(["\n width: ", ";\n height: ", ";\n\n ", "\n ", ";\n\n border-radius: ", ";\n display: flex;\n justify-content: center;\n align-items: center;\n"])), function (props) {
145
- return props.disabled ? props.theme.disabledCircleWidth : props.current ? props.theme.selectedCircleWidth : props.theme.circleWidth;
205
+ var IconContainer = _styledComponents["default"].div(_templateObject5 || (_templateObject5 = (0, _taggedTemplateLiteral2["default"])(["\n width: ", ";\n height: ", ";\n\n ", "\n ", ";\n\n border-radius: ", ";\n\n display: flex;\n justify-content: center;\n align-items: center;\n"])), function (props) {
206
+ return props.disabled ? props.theme.disabledStepWidth : props.current ? props.theme.selectedStepWidth : props.theme.stepWidth;
146
207
  }, function (props) {
147
- return props.disabled ? props.theme.disabledCircleHeight : props.current ? props.theme.selectedCircleHeight : props.theme.circleHeight;
208
+ return props.disabled ? props.theme.disabledStepHeight : props.current ? props.theme.selectedStepHeight : props.theme.stepHeight;
148
209
  }, function (props) {
149
- return "\n ".concat(!props.current && !props.disabled ? "border: ".concat(props.theme.circleBorderThickness, " ").concat(props.theme.circleBorderStyle, " ").concat(props.theme.circleBorderColor, ";") : props.current ? "border: ".concat(props.theme.selectedCircleBorderThickness, " ").concat(props.theme.selectedCircleBorderStyle, " ").concat(props.theme.selectedCircleBorderColor, ";") : props.disabled ? "border: ".concat(props.theme.disabledCircleBorderThickness, " ").concat(props.theme.disabledCircleBorderStyle, " ").concat(props.theme.disabledCircleBorderColor, ";") : "", "\n background: ").concat(props.disabled ? "".concat(props.theme.disabledBackgroundColor) : props.current ? "".concat(props.theme.stepContainerSelectedBackgroundColor) : "".concat(props.theme.stepContainerBackgroundColor), ";\n ");
210
+ return "\n ".concat(props.disabled ? "border: ".concat(props.theme.disabledStepBorderThickness, " ").concat(props.theme.disabledStepBorderStyle, " ").concat(props.theme.disabledStepBorderColor, ";") : props.current ? "border: ".concat(props.theme.selectedStepBorderThickness, " ").concat(props.theme.selectedStepBorderStyle, " ").concat(props.theme.selectedStepBorderColor, ";") : props.visited ? "border: ".concat(props.theme.stepBorderThickness, " ").concat(props.theme.stepBorderStyle, " ").concat(props.theme.visitedStepBorderColor, ";") : "border: ".concat(props.theme.stepBorderThickness, " ").concat(props.theme.stepBorderStyle, " ").concat(props.theme.unvisitedStepBorderColor, ";"), "\n background: ").concat(props.disabled ? "".concat(props.theme.disabledStepBackgroundColor) : props.current ? "".concat(props.theme.selectedStepBackgroundColor) : !props.visited ? "".concat(props.theme.unvisitedStepBackgroundColor) : "".concat(props.theme.visitedStepBackgroundColor), ";\n ");
150
211
  }, function (props) {
151
- return props.disabled ? "color: ".concat(props.theme.disabledFontColor, ";") : "color: ".concat(props.current ? props.theme.stepContainerSelectedFontColor : props.theme.stepContainerFontColor, ";");
212
+ return props.disabled ? "color: ".concat(props.theme.disabledStepFontColor, ";") : "color: ".concat(props.current ? props.theme.selectedStepFontColor : !props.visited ? props.theme.unvisitedStepFontColor : props.theme.visitedStepFontColor, ";");
152
213
  }, function (props) {
153
- return !props.current && !props.disabled ? props.theme.circleBorderRadius : props.current ? props.theme.selectedCircleBorderRadius : props.disabled ? props.theme.disabledCircleBorderRadius : "";
214
+ return !props.current && !props.disabled ? props.theme.stepBorderRadius : props.current ? props.theme.selectedStepBorderRadius : props.disabled ? props.theme.disabledStepBorderRadius : "";
154
215
  });
155
216
 
156
217
  var Icon = _styledComponents["default"].img(_templateObject6 || (_templateObject6 = (0, _taggedTemplateLiteral2["default"])(["\n width: ", ";\n height: ", ";\n"])), function (props) {
157
- return props.theme.stepContainerIconSize;
218
+ return props.theme.stepIconSize;
158
219
  }, function (props) {
159
- return props.theme.stepContainerIconSize;
220
+ return props.theme.stepIconSize;
160
221
  });
161
222
 
162
223
  var StepIconContainer = _styledComponents["default"].div(_templateObject7 || (_templateObject7 = (0, _taggedTemplateLiteral2["default"])(["\n width: ", ";\n height: ", ";\n overflow: hidden;\n img,\n svg {\n height: 100%;\n width: 100%;\n }\n"])), function (props) {
163
- return props.theme.stepContainerIconSize;
224
+ return props.theme.stepIconSize;
164
225
  }, function (props) {
165
- return props.theme.stepContainerIconSize;
226
+ return props.theme.stepIconSize;
166
227
  });
167
228
 
168
229
  var Number = _styledComponents["default"].p(_templateObject8 || (_templateObject8 = (0, _taggedTemplateLiteral2["default"])(["\n font-size: ", ";\n font-family: ", ";\n font-style: ", ";\n font-weight: ", ";\n letter-spacing: ", ";\n opacity: 1;\n margin: 0px 0px 0px 1px;\n"])), function (props) {
169
- return props.theme.stepContainerFontSize;
230
+ return props.theme.stepFontSize;
170
231
  }, function (props) {
171
- return props.theme.stepContainerFontFamily;
232
+ return props.theme.stepFontFamily;
172
233
  }, function (props) {
173
- return props.theme.stepContainerFontStyle;
234
+ return props.theme.stepFontStyle;
174
235
  }, function (props) {
175
- return props.theme.stepContainerFontWeight;
236
+ return props.theme.stepFontWeight;
176
237
  }, function (props) {
177
- return props.theme.stepContainerLetterSpacing;
238
+ return props.theme.stepFontTracking;
178
239
  });
179
240
 
180
241
  var ValidityIconContainer = _styledComponents["default"].div(_templateObject9 || (_templateObject9 = (0, _taggedTemplateLiteral2["default"])(["\n width: 18px;\n height: 18px;\n position: absolute;\n top: 22.5px;\n left: 22.5px;\n"])));
@@ -192,29 +253,29 @@ var Label = _styledComponents["default"].p(_templateObject11 || (_templateObject
192
253
  }, function (props) {
193
254
  return props.theme.labelFontWeight;
194
255
  }, function (props) {
195
- return props.theme.labelLetterSpacing;
256
+ return props.theme.labelFontTracking;
196
257
  }, function (props) {
197
- return props.disabled ? "color: ".concat(props.theme.disabledFontColor, ";") : "color: ".concat(props.visited ? props.theme.visitedLabelFontColor : props.theme.labelFontColor, ";");
258
+ return props.disabled ? "color: ".concat(props.theme.disabledLabelFontColor, ";") : "color: ".concat(!props.visited ? props.theme.unvisitedLabelFontColor : props.current ? props.theme.selectedLabelFontColor : props.theme.visitedLabelFontColor, ";");
198
259
  }, function (props) {
199
260
  return props.theme.labelFontTextTransform;
200
261
  });
201
262
 
202
263
  var Description = _styledComponents["default"].p(_templateObject12 || (_templateObject12 = (0, _taggedTemplateLiteral2["default"])(["\n text-align: ", ";\n font-family: ", ";\n font-size: ", ";\n font-style: ", ";\n font-weight: ", ";\n letter-spacing: ", ";\n text-transform: ", ";\n ", ";\n margin: 0;\n"])), function (props) {
203
- return props.theme.descriptionTextAlign;
264
+ return props.theme.helperTextTextAlign;
204
265
  }, function (props) {
205
- return props.theme.descriptionFontFamily;
266
+ return props.theme.helperTextFontFamily;
206
267
  }, function (props) {
207
- return props.theme.descriptionFontSize;
268
+ return props.theme.helperTextFontSize;
208
269
  }, function (props) {
209
- return props.theme.descriptionFontStyle;
270
+ return props.theme.helperTextFontStyle;
210
271
  }, function (props) {
211
- return props.theme.descriptionFontWeight;
272
+ return props.theme.helperTextFontWeight;
212
273
  }, function (props) {
213
- return props.theme.descriptionLetterSpacing;
274
+ return props.theme.helperTextFontTracking;
214
275
  }, function (props) {
215
- return props.theme.descriptionFontTextTransform;
276
+ return props.theme.helperTextFontTextTransform;
216
277
  }, function (props) {
217
- return props.disabled ? "color: ".concat(props.theme.disabledFontColor, ";") : "color: ".concat(props.visited ? props.theme.visitedDescriptionFontColor : props.theme.descriptionFontColor, ";");
278
+ return props.disabled ? "color: ".concat(props.theme.disabledHelperTextFontColor, ";") : "color: ".concat(!props.visited ? props.theme.unvisitedHelperTextFontColor : props.current ? props.theme.selectedHelperTextFontColor : props.theme.visitedHelperTextFontColor, ";");
218
279
  });
219
280
 
220
281
  var StepSeparator = _styledComponents["default"].div(_templateObject13 || (_templateObject13 = (0, _taggedTemplateLiteral2["default"])(["\n width: ", ";\n height: ", ";\n ", "\n border: ", ";\n opacity: 1;\n flex-grow: 1;\n"])), function (props) {
@@ -9,23 +9,18 @@ export default {
9
9
  component: DxcWizard,
10
10
  };
11
11
 
12
- const favoriteSVG = () => {
13
- return (
14
- <svg viewBox="0 0 24 24" fill="currentColor">
15
- <path d="M0 0h24v24H0z" fill="none" />
16
- <path d="M12 21.35l-1.45-1.32C5.4 15.36 2 12.28 2 8.5 2 5.42 4.42 3 7.5 3c1.74 0 3.41.81 4.5 2.09C13.09 3.81 14.76 3 16.5 3 19.58 3 22 5.42 22 8.5c0 3.78-3.4 6.86-8.55 11.54L12 21.35z" />
17
- </svg>
18
- );
19
- };
20
-
21
- const largeIcon = () => {
22
- return (
23
- <svg xmlns="http://www.w3.org/2000/svg" height="48px" viewBox="0 0 24 24" width="48px" fill="currentColor">
24
- <path d="M0 0h24v24H0z" fill="none" />
25
- <path d="M10 20v-6h4v6h5v-8h3L12 3 2 12h3v8z" />
26
- </svg>
27
- );
28
- };
12
+ const favoriteSVG = (
13
+ <svg viewBox="0 0 24 24" fill="currentColor">
14
+ <path d="M0 0h24v24H0z" fill="none" />
15
+ <path d="M12 21.35l-1.45-1.32C5.4 15.36 2 12.28 2 8.5 2 5.42 4.42 3 7.5 3c1.74 0 3.41.81 4.5 2.09C13.09 3.81 14.76 3 16.5 3 19.58 3 22 5.42 22 8.5c0 3.78-3.4 6.86-8.55 11.54L12 21.35z" />
16
+ </svg>
17
+ );
18
+ const largeIcon = (
19
+ <svg xmlns="http://www.w3.org/2000/svg" height="48px" viewBox="0 0 24 24" width="48px" fill="currentColor">
20
+ <path d="M0 0h24v24H0z" fill="none" />
21
+ <path d="M10 20v-6h4v6h5v-8h3L12 3 2 12h3v8z" />
22
+ </svg>
23
+ );
29
24
 
30
25
  const stepWithLabel = [
31
26
  {
@@ -41,7 +36,6 @@ const stepWithLabel = [
41
36
  label: "Forth step",
42
37
  },
43
38
  ];
44
-
45
39
  const stepWithLabelDescription = [
46
40
  {
47
41
  label: "First step",
@@ -62,7 +56,6 @@ const stepWithLabelDescription = [
62
56
  valid: false,
63
57
  },
64
58
  ];
65
-
66
59
  const stepWithLongDescription = [
67
60
  {
68
61
  label: "First step",
@@ -80,7 +73,6 @@ const stepWithLongDescription = [
80
73
  "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. ",
81
74
  },
82
75
  ];
83
-
84
76
  const stepDisabled = [
85
77
  {
86
78
  label: "First step",
@@ -106,7 +98,6 @@ const stepDisabled = [
106
98
  disabled: true,
107
99
  },
108
100
  ];
109
-
110
101
  const stepIcons = [
111
102
  {
112
103
  label: "First step",
@@ -121,7 +112,6 @@ const stepIcons = [
121
112
  icon: favoriteSVG,
122
113
  },
123
114
  ];
124
-
125
115
  const stepLargeIcons = [
126
116
  {
127
117
  label: "First step",
@@ -141,7 +131,7 @@ export const Chromatic = () => (
141
131
  <>
142
132
  <ExampleContainer>
143
133
  <Title title="Current step in the third step, labels and description" theme="light" level={4} />
144
- <DxcWizard currentStep={2} steps={stepWithLabelDescription}></DxcWizard>
134
+ <DxcWizard defaultCurrentStep={2} steps={stepWithLabelDescription}></DxcWizard>
145
135
  <Title title="With long description in horizontal" theme="light" level={4} />
146
136
  <DxcWizard steps={stepWithLongDescription}></DxcWizard>
147
137
  <Title title="With long description in vertical" theme="light" level={4} />
@@ -0,0 +1,141 @@
1
+ "use strict";
2
+
3
+ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
4
+
5
+ var _react = _interopRequireDefault(require("react"));
6
+
7
+ var _react2 = require("@testing-library/react");
8
+
9
+ var _Wizard = _interopRequireDefault(require("./Wizard"));
10
+
11
+ describe("Wizard components tests", function () {
12
+ test("Wizard renders with correct steps", function () {
13
+ var _render = (0, _react2.render)( /*#__PURE__*/_react["default"].createElement(_Wizard["default"], {
14
+ steps: [{
15
+ label: "first-step"
16
+ }, {
17
+ label: "second-step"
18
+ }]
19
+ })),
20
+ getByText = _render.getByText,
21
+ getAllByRole = _render.getAllByRole;
22
+
23
+ var steps = getAllByRole("button");
24
+ expect(getByText("first-step")).toBeTruthy();
25
+ expect(getByText("second-step")).toBeTruthy();
26
+ expect(steps[0].getAttribute("aria-current")).toBe("step");
27
+ expect(steps[1].getAttribute("aria-current")).toBe("false");
28
+ });
29
+ test("Wizard renders with initially selected step", function () {
30
+ var _render2 = (0, _react2.render)( /*#__PURE__*/_react["default"].createElement(_Wizard["default"], {
31
+ defaultCurrentStep: 1,
32
+ steps: [{
33
+ label: "first-step"
34
+ }, {
35
+ label: "second-step"
36
+ }]
37
+ })),
38
+ getAllByRole = _render2.getAllByRole;
39
+
40
+ var steps = getAllByRole("button");
41
+ expect(steps[1].getAttribute("aria-current")).toBe("step");
42
+ });
43
+ test("Click on step text", function () {
44
+ var onClick = jest.fn();
45
+
46
+ var _render3 = (0, _react2.render)( /*#__PURE__*/_react["default"].createElement(_Wizard["default"], {
47
+ onStepClick: onClick,
48
+ steps: [{
49
+ label: "first-step"
50
+ }]
51
+ })),
52
+ getByText = _render3.getByText;
53
+
54
+ var step = getByText("first-step");
55
+
56
+ _react2.fireEvent.click(step);
57
+
58
+ expect(onClick).toHaveBeenCalled();
59
+ });
60
+ test("Click on step description", function () {
61
+ var onClick = jest.fn();
62
+
63
+ var _render4 = (0, _react2.render)( /*#__PURE__*/_react["default"].createElement(_Wizard["default"], {
64
+ onStepClick: onClick,
65
+ steps: [{
66
+ label: "first-step",
67
+ description: "step-description"
68
+ }]
69
+ })),
70
+ getByText = _render4.getByText;
71
+
72
+ var step = getByText("step-description");
73
+
74
+ _react2.fireEvent.click(step);
75
+
76
+ expect(onClick).toHaveBeenCalled();
77
+ });
78
+ test("Click on step number", function () {
79
+ var onClick = jest.fn();
80
+
81
+ var _render5 = (0, _react2.render)( /*#__PURE__*/_react["default"].createElement(_Wizard["default"], {
82
+ onStepClick: onClick,
83
+ steps: [{
84
+ label: "first-step"
85
+ }]
86
+ })),
87
+ getByText = _render5.getByText;
88
+
89
+ var step = getByText("1");
90
+
91
+ _react2.fireEvent.click(step);
92
+
93
+ expect(onClick).toHaveBeenCalled();
94
+ });
95
+ test("Click on disable step", function () {
96
+ var onClick = jest.fn();
97
+
98
+ var _render6 = (0, _react2.render)( /*#__PURE__*/_react["default"].createElement(_Wizard["default"], {
99
+ onStepClick: onClick,
100
+ steps: [{
101
+ label: "first-step"
102
+ }, {
103
+ label: "second-step",
104
+ disabled: true
105
+ }]
106
+ })),
107
+ getByText = _render6.getByText;
108
+
109
+ var step = getByText("second-step");
110
+
111
+ _react2.fireEvent.click(step);
112
+
113
+ expect(onClick).toHaveBeenCalledTimes(0);
114
+ });
115
+ test("Controlled wizard function is called", function () {
116
+ var onClick = jest.fn(function (i) {
117
+ return i;
118
+ });
119
+
120
+ var _render7 = (0, _react2.render)( /*#__PURE__*/_react["default"].createElement(_Wizard["default"], {
121
+ currentStep: 0,
122
+ onStepClick: onClick,
123
+ steps: [{
124
+ label: "first-step"
125
+ }, {
126
+ label: "second-step"
127
+ }]
128
+ })),
129
+ getAllByRole = _render7.getAllByRole;
130
+
131
+ var steps = getAllByRole("button");
132
+
133
+ _react2.fireEvent.click(steps[1]);
134
+
135
+ _react2.fireEvent.click(steps[0]);
136
+
137
+ expect(onClick).toHaveBeenCalledTimes(2);
138
+ expect(onClick).toHaveBeenNthCalledWith(1, 1);
139
+ expect(onClick).toHaveBeenNthCalledWith(2, 0);
140
+ });
141
+ });
package/wizard/types.d.ts CHANGED
@@ -6,7 +6,7 @@ declare type Margin = {
6
6
  left?: Space;
7
7
  right?: Space;
8
8
  };
9
- declare type SVG = React.SVGProps<SVGSVGElement> | React.FunctionComponent<React.SVGProps<SVGSVGElement>>;
9
+ declare type SVG = React.SVGProps<SVGSVGElement>;
10
10
  declare type Step = {
11
11
  /**
12
12
  * Step label.
@@ -17,13 +17,9 @@ declare type Step = {
17
17
  */
18
18
  description?: string;
19
19
  /**
20
- * Element used as the icon to be displayed in the step.
20
+ * Element or path used as the icon displayed in the step.
21
21
  */
22
- icon?: SVG;
23
- /**
24
- * @deprecated URL of the icon to be displayed in the step.
25
- */
26
- iconSrc?: string;
22
+ icon?: string | SVG;
27
23
  /**
28
24
  * Whether the step is disabled or not.
29
25
  */
@@ -39,7 +35,11 @@ declare type Props = {
39
35
  */
40
36
  mode?: "horizontal" | "vertical";
41
37
  /**
42
- * Defines which step is marked as the current. The numeration starts in 0.
38
+ * Initially selected step, only when it is uncontrolled.
39
+ */
40
+ defaultCurrentStep?: number;
41
+ /**
42
+ * Defines which step is marked as the current. The numeration starts at 0.
43
43
  */
44
44
  currentStep?: number;
45
45
  /**
@@ -50,7 +50,7 @@ declare type Props = {
50
50
  /**
51
51
  * An array of objects representing the steps.
52
52
  */
53
- steps: [Step, ...Step[]];
53
+ steps: Step[];
54
54
  /**
55
55
  * Size of the margin to be applied to the component ('xxsmall' | 'xsmall' | 'small' | 'medium' | 'large' | 'xlarge' | 'xxlarge').
56
56
  * You can pass an object with 'top', 'bottom', 'left' and 'right' properties in order to specify different margin sizes.