@zohodesk/components 1.0.0-temp-242.6 → 1.0.0-temp-252

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 (257) hide show
  1. package/README.md +74 -14
  2. package/assets/Appearance/dark/mode/Component_v1_DarkMode.module.css +68 -0
  3. package/assets/Appearance/light/mode/Component_v1_LightMode.module.css +68 -0
  4. package/assets/Appearance/pureDark/mode/Component_v1_PureDarkMode.module.css +68 -0
  5. package/es/Avatar/Avatar.module.css +8 -8
  6. package/es/AvatarTeam/AvatarTeam.module.css +30 -30
  7. package/es/Button/css/Button.module.css +19 -19
  8. package/es/Buttongroup/Buttongroup.module.css +13 -35
  9. package/es/Card/Card.module.css +6 -4
  10. package/es/CheckBox/CheckBox.module.css +3 -10
  11. package/es/ColorSelect/_shared/ColorIndicator/ColorIndicator.module.css +4 -2
  12. package/es/DateTime/DateTime.module.css +22 -35
  13. package/es/DateTime/DateWidget.module.css +1 -1
  14. package/es/DateTime/YearView.module.css +8 -10
  15. package/es/DropBox/DropBoxElement/css/DropBoxElement.module.css +5 -4
  16. package/es/DropDown/DropDown.module.css +2 -1
  17. package/es/DropDown/DropDownHeading.module.css +4 -4
  18. package/es/DropDown/DropDownItem.module.css +5 -12
  19. package/es/DropDown/DropDownSearch.module.css +3 -3
  20. package/es/DropDown/DropDownSeparator.module.css +2 -1
  21. package/es/Label/Label.module.css +5 -5
  22. package/es/ListItem/ListItem.js +6 -4
  23. package/es/ListItem/ListItem.module.css +62 -66
  24. package/es/ListItem/ListItemWithAvatar.js +7 -5
  25. package/es/ListItem/ListItemWithCheckBox.js +9 -5
  26. package/es/ListItem/ListItemWithIcon.js +10 -7
  27. package/es/ListItem/ListItemWithRadio.js +9 -6
  28. package/es/ListItem/__tests__/__snapshots__/ListItem.spec.js.snap +4 -4
  29. package/es/ListItem/__tests__/__snapshots__/ListItemWithAvatar.spec.js.snap +131 -82
  30. package/es/ListItem/__tests__/__snapshots__/ListItemWithCheckBox.spec.js.snap +432 -390
  31. package/es/ListItem/__tests__/__snapshots__/ListItemWithIcon.spec.js.snap +141 -92
  32. package/es/ListItem/__tests__/__snapshots__/ListItemWithRadio.spec.js.snap +432 -390
  33. package/es/ListItem/props/defaultProps.js +2 -1
  34. package/es/ListItem/props/propTypes.js +4 -2
  35. package/es/MultiSelect/AdvancedGroupMultiSelect.js +14 -3
  36. package/es/MultiSelect/AdvancedMultiSelect.js +2 -0
  37. package/es/MultiSelect/EmptyState.js +16 -2
  38. package/es/MultiSelect/MobileHeader/MobileHeader.module.css +4 -3
  39. package/es/MultiSelect/MultiSelect.js +4 -2
  40. package/es/MultiSelect/MultiSelect.module.css +21 -34
  41. package/es/MultiSelect/MultiSelectWithAvatar.js +2 -0
  42. package/es/MultiSelect/SelectedOptions.module.css +6 -10
  43. package/es/MultiSelect/Suggestions.js +7 -2
  44. package/es/MultiSelect/__tests__/__snapshots__/AdvancedMultiSelect.spec.js.snap +10 -10
  45. package/es/MultiSelect/__tests__/__snapshots__/MultiSelectHeader.spec.js.snap +34 -28
  46. package/es/MultiSelect/__tests__/__snapshots__/Suggestions.spec.js.snap +20 -20
  47. package/es/MultiSelect/props/defaultProps.js +2 -0
  48. package/es/MultiSelect/props/propTypes.js +14 -3
  49. package/es/Popup/Popup.js +13 -12
  50. package/es/Radio/Radio.module.css +11 -12
  51. package/es/ResponsiveDropBox/ResponsiveDropBox.module.css +1 -1
  52. package/es/Ribbon/Ribbon.module.css +23 -29
  53. package/es/RippleEffect/RippleEffect.module.css +55 -17
  54. package/es/Select/GroupSelect.js +14 -4
  55. package/es/Select/Select.js +94 -72
  56. package/es/Select/Select.module.css +50 -17
  57. package/es/Select/SelectWithAvatar.js +14 -4
  58. package/es/Select/SelectWithIcon.js +14 -4
  59. package/es/Select/__tests__/__snapshots__/Select.spec.js.snap +88 -88
  60. package/es/Select/props/defaultProps.js +10 -4
  61. package/es/Select/props/propTypes.js +30 -5
  62. package/es/Stencils/Stencils.module.css +30 -14
  63. package/es/Switch/Switch.module.css +1 -8
  64. package/es/Tab/Tab.module.css +8 -15
  65. package/es/Tab/Tabs.module.css +12 -22
  66. package/es/Tag/Tag.module.css +21 -21
  67. package/es/TextBox/TextBox.module.css +9 -9
  68. package/es/TextBoxIcon/TextBoxIcon.module.css +1 -1
  69. package/es/Textarea/Textarea.module.css +18 -18
  70. package/es/Tooltip/Tooltip.module.css +5 -4
  71. package/es/Typography/Typography.js +18 -8
  72. package/es/Typography/__tests__/Typography.spec.js +198 -6
  73. package/es/Typography/__tests__/__snapshots__/Typography.spec.js.snap +1235 -2
  74. package/es/Typography/css/Typography.module.css +4 -0
  75. package/es/Typography/css/cssJSLogic.js +53 -21
  76. package/es/Typography/props/defaultProps.js +4 -3
  77. package/es/Typography/props/propTypes.js +68 -26
  78. package/es/Typography/utils/textHighlighter.js +4 -2
  79. package/es/common/avatarsizes.module.css +16 -16
  80. package/es/common/common.module.css +1 -1
  81. package/es/shared/ArrowIcon/ArrowIcon.module.css +3 -2
  82. package/es/shared/InputFieldLine/InputFieldLine.module.css +2 -2
  83. package/es/v1/Button/Button.js +201 -0
  84. package/es/v1/Button/README.md +110 -0
  85. package/es/v1/Button/__tests__/Button.spec.js +272 -0
  86. package/es/v1/Button/__tests__/__snapshots__/Button.spec.js.snap +1160 -0
  87. package/es/v1/Button/_shared/Loader/Loader.js +33 -0
  88. package/es/v1/Button/_shared/Loader/Loader_v1.module.css +42 -0
  89. package/es/v1/Button/_shared/Loader/__tests__/Loader.spec.js +21 -0
  90. package/es/v1/Button/_shared/Loader/__tests__/__snapshots__/Loader.spec.js.snap +49 -0
  91. package/es/v1/Button/_shared/Loader/props/defaultProps.js +4 -0
  92. package/es/v1/Button/_shared/Loader/props/propTypes.js +7 -0
  93. package/es/v1/Button/_shared/SuccessTick/SuccessTick.js +25 -0
  94. package/es/v1/Button/_shared/SuccessTick/SuccessTick_v1.module.css +21 -0
  95. package/es/v1/Button/_shared/SuccessTick/__tests__/SuccessTick.spec.js +21 -0
  96. package/es/v1/Button/_shared/SuccessTick/__tests__/__snapshots__/SuccessTick.spec.js.snap +31 -0
  97. package/es/v1/Button/_shared/SuccessTick/props/defaultProps.js +4 -0
  98. package/es/v1/Button/_shared/SuccessTick/props/propTypes.js +7 -0
  99. package/es/v1/Button/constants/index.js +82 -0
  100. package/es/v1/Button/css/Button_v1.module.css +119 -0
  101. package/es/v1/Button/css/cssJSLogic.js +96 -0
  102. package/es/v1/Button/index.js +2 -0
  103. package/es/v1/Button/props/defaultProps.js +26 -0
  104. package/es/v1/Button/props/propTypes.js +43 -0
  105. package/es/v1/Label/__tests__/__snapshots__/Label.spec.js.snap +40 -34
  106. package/es/v1/Switch/css/Switch_v1.module.css +28 -28
  107. package/es/v1/helpers/colorHelpers/background/backgroundColor.module.css +629 -0
  108. package/es/v1/helpers/colorHelpers/border/borderColor.module.css +489 -0
  109. package/es/v1/helpers/colorHelpers/colorHelper.js +176 -0
  110. package/es/v1/helpers/colorHelpers/constants/index.js +79 -0
  111. package/es/v1/helpers/colorHelpers/index.js +4 -0
  112. package/es/v1/helpers/colorHelpers/paletteUtilities.README.md +415 -0
  113. package/es/v1/helpers/colorHelpers/text/textColor.module.css +368 -0
  114. package/lib/Avatar/Avatar.module.css +8 -8
  115. package/lib/AvatarTeam/AvatarTeam.module.css +30 -30
  116. package/lib/Button/css/Button.module.css +19 -19
  117. package/lib/Buttongroup/Buttongroup.module.css +13 -35
  118. package/lib/Card/Card.module.css +6 -4
  119. package/lib/CheckBox/CheckBox.module.css +3 -10
  120. package/lib/ColorSelect/_shared/ColorIndicator/ColorIndicator.module.css +4 -2
  121. package/lib/DateTime/DateTime.module.css +22 -35
  122. package/lib/DateTime/DateWidget.module.css +1 -1
  123. package/lib/DateTime/YearView.module.css +8 -10
  124. package/lib/DropBox/DropBoxElement/css/DropBoxElement.module.css +5 -4
  125. package/lib/DropDown/DropDown.module.css +2 -1
  126. package/lib/DropDown/DropDownHeading.module.css +4 -4
  127. package/lib/DropDown/DropDownItem.module.css +5 -12
  128. package/lib/DropDown/DropDownSearch.module.css +3 -3
  129. package/lib/DropDown/DropDownSeparator.module.css +2 -1
  130. package/lib/Label/Label.module.css +5 -5
  131. package/lib/ListItem/ListItem.js +7 -4
  132. package/lib/ListItem/ListItem.module.css +62 -66
  133. package/lib/ListItem/ListItemWithAvatar.js +7 -5
  134. package/lib/ListItem/ListItemWithCheckBox.js +9 -5
  135. package/lib/ListItem/ListItemWithIcon.js +10 -7
  136. package/lib/ListItem/ListItemWithRadio.js +9 -6
  137. package/lib/ListItem/__tests__/__snapshots__/ListItem.spec.js.snap +4 -4
  138. package/lib/ListItem/__tests__/__snapshots__/ListItemWithAvatar.spec.js.snap +131 -82
  139. package/lib/ListItem/__tests__/__snapshots__/ListItemWithCheckBox.spec.js.snap +432 -390
  140. package/lib/ListItem/__tests__/__snapshots__/ListItemWithIcon.spec.js.snap +141 -92
  141. package/lib/ListItem/__tests__/__snapshots__/ListItemWithRadio.spec.js.snap +432 -390
  142. package/lib/ListItem/props/defaultProps.js +2 -1
  143. package/lib/ListItem/props/propTypes.js +4 -2
  144. package/lib/MultiSelect/AdvancedGroupMultiSelect.js +25 -16
  145. package/lib/MultiSelect/AdvancedMultiSelect.js +2 -0
  146. package/lib/MultiSelect/EmptyState.js +17 -2
  147. package/lib/MultiSelect/MobileHeader/MobileHeader.module.css +4 -3
  148. package/lib/MultiSelect/MultiSelect.js +4 -2
  149. package/lib/MultiSelect/MultiSelect.module.css +21 -34
  150. package/lib/MultiSelect/MultiSelectWithAvatar.js +2 -0
  151. package/lib/MultiSelect/SelectedOptions.module.css +6 -10
  152. package/lib/MultiSelect/Suggestions.js +6 -2
  153. package/lib/MultiSelect/__tests__/__snapshots__/AdvancedMultiSelect.spec.js.snap +10 -10
  154. package/lib/MultiSelect/__tests__/__snapshots__/MultiSelectHeader.spec.js.snap +34 -28
  155. package/lib/MultiSelect/__tests__/__snapshots__/Suggestions.spec.js.snap +20 -20
  156. package/lib/MultiSelect/props/defaultProps.js +2 -0
  157. package/lib/MultiSelect/props/propTypes.js +16 -5
  158. package/lib/Popup/Popup.js +13 -15
  159. package/lib/Radio/Radio.module.css +11 -12
  160. package/lib/ResponsiveDropBox/ResponsiveDropBox.module.css +1 -1
  161. package/lib/Ribbon/Ribbon.module.css +23 -29
  162. package/lib/RippleEffect/RippleEffect.module.css +55 -17
  163. package/lib/Select/GroupSelect.js +15 -4
  164. package/lib/Select/Select.js +94 -72
  165. package/lib/Select/Select.module.css +50 -17
  166. package/lib/Select/SelectWithAvatar.js +15 -4
  167. package/lib/Select/SelectWithIcon.js +15 -4
  168. package/lib/Select/__tests__/__snapshots__/Select.spec.js.snap +88 -88
  169. package/lib/Select/props/defaultProps.js +9 -6
  170. package/lib/Select/props/propTypes.js +30 -5
  171. package/lib/Stencils/Stencils.module.css +30 -14
  172. package/lib/Switch/Switch.module.css +1 -8
  173. package/lib/Tab/Tab.module.css +8 -15
  174. package/lib/Tab/Tabs.module.css +12 -22
  175. package/lib/Tag/Tag.module.css +21 -21
  176. package/lib/TextBox/TextBox.module.css +9 -9
  177. package/lib/TextBoxIcon/TextBoxIcon.module.css +1 -1
  178. package/lib/Textarea/Textarea.module.css +18 -18
  179. package/lib/Tooltip/Tooltip.module.css +5 -4
  180. package/lib/Typography/Typography.js +15 -5
  181. package/lib/Typography/__tests__/Typography.spec.js +284 -92
  182. package/lib/Typography/__tests__/__snapshots__/Typography.spec.js.snap +1235 -2
  183. package/lib/Typography/css/Typography.module.css +4 -0
  184. package/lib/Typography/css/cssJSLogic.js +38 -6
  185. package/lib/Typography/props/defaultProps.js +6 -3
  186. package/lib/Typography/props/propTypes.js +67 -23
  187. package/lib/Typography/utils/textHighlighter.js +6 -3
  188. package/lib/common/avatarsizes.module.css +16 -16
  189. package/lib/common/common.module.css +1 -1
  190. package/lib/shared/ArrowIcon/ArrowIcon.module.css +3 -2
  191. package/lib/shared/InputFieldLine/InputFieldLine.module.css +2 -2
  192. package/lib/v1/Button/Button.js +239 -0
  193. package/lib/v1/Button/README.md +110 -0
  194. package/lib/v1/Button/__tests__/Button.spec.js +293 -0
  195. package/lib/v1/Button/__tests__/__snapshots__/Button.spec.js.snap +1160 -0
  196. package/lib/v1/Button/_shared/Loader/Loader.js +43 -0
  197. package/lib/v1/Button/_shared/Loader/Loader_v1.module.css +42 -0
  198. package/lib/v1/Button/_shared/Loader/__tests__/Loader.spec.js +28 -0
  199. package/lib/v1/Button/_shared/Loader/__tests__/__snapshots__/Loader.spec.js.snap +49 -0
  200. package/lib/v1/Button/_shared/Loader/props/defaultProps.js +11 -0
  201. package/lib/v1/Button/_shared/Loader/props/propTypes.js +18 -0
  202. package/lib/v1/Button/_shared/SuccessTick/SuccessTick.js +35 -0
  203. package/lib/v1/Button/_shared/SuccessTick/SuccessTick_v1.module.css +21 -0
  204. package/lib/v1/Button/_shared/SuccessTick/__tests__/SuccessTick.spec.js +28 -0
  205. package/lib/v1/Button/_shared/SuccessTick/__tests__/__snapshots__/SuccessTick.spec.js.snap +31 -0
  206. package/lib/v1/Button/_shared/SuccessTick/props/defaultProps.js +11 -0
  207. package/lib/v1/Button/_shared/SuccessTick/props/propTypes.js +18 -0
  208. package/lib/v1/Button/constants/index.js +114 -0
  209. package/lib/v1/Button/css/Button_v1.module.css +119 -0
  210. package/lib/v1/Button/css/cssJSLogic.js +88 -0
  211. package/lib/v1/Button/index.js +21 -0
  212. package/lib/v1/Button/props/defaultProps.js +36 -0
  213. package/lib/v1/Button/props/propTypes.js +56 -0
  214. package/lib/v1/Label/__tests__/__snapshots__/Label.spec.js.snap +40 -34
  215. package/lib/v1/Switch/css/Switch_v1.module.css +28 -28
  216. package/lib/v1/helpers/colorHelpers/background/backgroundColor.module.css +629 -0
  217. package/lib/v1/helpers/colorHelpers/border/borderColor.module.css +489 -0
  218. package/lib/v1/helpers/colorHelpers/colorHelper.js +190 -0
  219. package/lib/v1/helpers/colorHelpers/constants/index.js +87 -0
  220. package/lib/v1/helpers/colorHelpers/index.js +57 -0
  221. package/lib/v1/helpers/colorHelpers/paletteUtilities.README.md +415 -0
  222. package/lib/v1/helpers/colorHelpers/text/textColor.module.css +368 -0
  223. package/package.json +27 -23
  224. package/_react-cli.config.js +0 -24
  225. package/assets/Appearance/dark/themes/blue/blue_CTA_DarkModifyCategory.module.css +0 -467
  226. package/assets/Appearance/dark/themes/blue/blue_CTA_DarkTheme.module.css +0 -36
  227. package/assets/Appearance/dark/themes/green/green_CTA_DarkModifyCategory.module.css +0 -467
  228. package/assets/Appearance/dark/themes/green/green_CTA_DarkTheme.module.css +0 -36
  229. package/assets/Appearance/dark/themes/orange/orange_CTA_DarkModifyCategory.module.css +0 -467
  230. package/assets/Appearance/dark/themes/orange/orange_CTA_DarkTheme.module.css +0 -36
  231. package/assets/Appearance/dark/themes/red/red_CTA_DarkModifyCategory.module.css +0 -467
  232. package/assets/Appearance/dark/themes/red/red_CTA_DarkTheme.module.css +0 -36
  233. package/assets/Appearance/dark/themes/yellow/yellow_CTA_DarkModifyCategory.module.css +0 -467
  234. package/assets/Appearance/dark/themes/yellow/yellow_CTA_DarkTheme.module.css +0 -36
  235. package/assets/Appearance/light/themes/blue/blue_CTA_LightModifyCategory.module.css +0 -467
  236. package/assets/Appearance/light/themes/blue/blue_CTA_LightTheme.module.css +0 -36
  237. package/assets/Appearance/light/themes/green/green_CTA_LightModifyCategory.module.css +0 -467
  238. package/assets/Appearance/light/themes/green/green_CTA_LightTheme.module.css +0 -36
  239. package/assets/Appearance/light/themes/orange/orange_CTA_LightModifyCategory.module.css +0 -467
  240. package/assets/Appearance/light/themes/orange/orange_CTA_LightTheme.module.css +0 -36
  241. package/assets/Appearance/light/themes/red/red_CTA_LightModifyCategory.module.css +0 -467
  242. package/assets/Appearance/light/themes/red/red_CTA_LightTheme.module.css +0 -36
  243. package/assets/Appearance/light/themes/yellow/yellow_CTA_LightModifyCategory.module.css +0 -467
  244. package/assets/Appearance/light/themes/yellow/yellow_CTA_LightTheme.module.css +0 -36
  245. package/assets/Appearance/pureDark/themes/blue/blue_CTA_PureDarkModifyCategory.module.css +0 -467
  246. package/assets/Appearance/pureDark/themes/blue/blue_CTA_PureDarkTheme.module.css +0 -36
  247. package/assets/Appearance/pureDark/themes/green/green_CTA_PureDarkModifyCategory.module.css +0 -467
  248. package/assets/Appearance/pureDark/themes/green/green_CTA_PureDarkTheme.module.css +0 -36
  249. package/assets/Appearance/pureDark/themes/orange/orange_CTA_PureDarkModifyCategory.module.css +0 -467
  250. package/assets/Appearance/pureDark/themes/orange/orange_CTA_PureDarkTheme.module.css +0 -36
  251. package/assets/Appearance/pureDark/themes/red/red_CTA_PureDarkModifyCategory.module.css +0 -467
  252. package/assets/Appearance/pureDark/themes/red/red_CTA_PureDarkTheme.module.css +0 -36
  253. package/assets/Appearance/pureDark/themes/yellow/yellow_CTA_PureDarkModifyCategory.module.css +0 -467
  254. package/assets/Appearance/pureDark/themes/yellow/yellow_CTA_PureDarkTheme.module.css +0 -36
  255. package/assets/Contrast/darkContrastLightness.module.css +0 -39
  256. package/assets/Contrast/lightContrastLightness.module.css +0 -39
  257. package/assets/Contrast/pureDarkContrastLightness.module.css +0 -39
@@ -0,0 +1,110 @@
1
+ # Button
2
+
3
+ A composable button component with palette-based theming, loading/success status states, and flexible icon/content slots.
4
+
5
+ ## Import
6
+
7
+ ```jsx
8
+ import Button from '@zohodesk/components/es/v1/Button/Button';
9
+ ```
10
+
11
+ ## Usage
12
+
13
+ ### Default
14
+
15
+ ```jsx
16
+ <Button customId="saveBtn" testId="saveBtn">
17
+ Save changes
18
+ </Button>
19
+ ```
20
+
21
+ ### With Palette Variants
22
+
23
+ ```jsx
24
+ <Button palette="primary">Save</Button>
25
+ <Button palette="danger">Delete</Button>
26
+ <Button palette="success">Confirm</Button>
27
+ ```
28
+
29
+ ### With Icon
30
+
31
+ ```jsx
32
+ <Button variant="icon" iconName="ZD-plus" iconSize={20} />
33
+
34
+ <Button variant="iconWithText" iconName="ZD-plus" iconPlacement="left">
35
+ Add Item
36
+ </Button>
37
+ ```
38
+
39
+ ### Loading State
40
+
41
+ ```jsx
42
+ <Button status="loading" loaderPlacement="overlay">
43
+ Saving...
44
+ </Button>
45
+
46
+ <Button status="loading" loaderPlacement="start">
47
+ Loading
48
+ </Button>
49
+ ```
50
+
51
+ ### Disabled / Read Only
52
+
53
+ ```jsx
54
+ <Button isDisabled>Disabled</Button>
55
+ <Button isReadOnly>Read Only</Button>
56
+ ```
57
+
58
+ ## Props
59
+
60
+ | Prop | Type | Default | Description |
61
+ |---|---|---|---|
62
+ | `customId` | `string` | — | `data-id` attribute for automation |
63
+ | `testId` | `string` | — | `data-test-id` attribute for testing |
64
+ | `palette` | `oneOf: default, primary, secondary, danger, success` | `default` | Color palette |
65
+ | `bgAppearance` | `oneOf: filled, onHover, none` | `filled` | Background behavior |
66
+ | `borderAppearance` | `oneOf: default, onHover, none` | `default` | Border behavior |
67
+ | `variant` | `oneOf: text, icon, iconWithText` | `text` | Display variant |
68
+ | `size` | `oneOf: small, medium, large, full` | `medium` | Size variant |
69
+ | `status` | `oneOf: default, loading, success` | `default` | Status state |
70
+ | `loaderPlacement` | `oneOf: start, end, overlay` | `overlay` | Where loader appears |
71
+ | `iconName` | `string` | — | Icon name from `@zohodesk/icons` |
72
+ | `iconSize` | `number` | `16` | Icon size in pixels |
73
+ | `iconPlacement` | `oneOf: left, right` | `left` | Icon position relative to text |
74
+ | `paletteShade` | `oneOf: default, lighter` | `default` | Shade variant |
75
+ | `disabledAppearance` | `oneOf: none, dull, strike` | `dull` | Disabled visual style |
76
+ | `renderIcon` | `node \| func` | — | Custom icon render slot |
77
+ | `renderBefore` | `node \| func` | — | Slot before main content |
78
+ | `renderAfter` | `node \| func` | — | Slot after main content |
79
+ | `renderLoader` | `node \| func` | — | Custom loader render slot |
80
+ | `renderSuccess` | `node \| func` | — | Custom success render slot |
81
+ | `children` | `node` | — | Button text content |
82
+ | `type` | `oneOf: button, submit, reset` | `button` | HTML button type |
83
+ | `onClick` | `func` | — | Click event handler |
84
+ | `isDisabled` | `bool` | `false` | Disables the button |
85
+ | `isReadOnly` | `bool` | `false` | Read-only state |
86
+ | `isSelected` | `bool` | `false` | Selected/pressed state |
87
+ | `isRounded` | `bool` | `false` | Rounded border radius |
88
+ | `title` | `string` | — | Title/tooltip text |
89
+
90
+ ## Customization
91
+
92
+ ### Parts
93
+
94
+ | Part | Element | Description |
95
+ |---|---|---|
96
+ | `wrapper` | `<button>` root | The outermost button element |
97
+ | `text` | Typography | The text label |
98
+
99
+ ### CSS Custom Properties
100
+
101
+ The `.varClass` block in `Button.module.css` defines local custom properties that size variants override:
102
+
103
+ | Property | Default | Description |
104
+ |---|---|---|
105
+ | `--local-Button-radius` | `4px` | Border radius |
106
+ | `--local-Button-gap` | `8px` | Content gap |
107
+ | `--local-Button-padding-block` | `6px` | Block padding |
108
+ | `--local-Button-padding-inline` | `15px` | Inline padding |
109
+ | `--local-Button-min-width` | `90px` | Minimum width |
110
+ | `--local-Button-spinner-size` | `16px` | Spinner/tick size |
@@ -0,0 +1,272 @@
1
+ import React from 'react';
2
+ import { cleanup, render, screen } from '@testing-library/react';
3
+ import userEvent from '@testing-library/user-event';
4
+ import Button from "../Button";
5
+ import '@testing-library/jest-dom';
6
+ afterEach(() => {
7
+ cleanup();
8
+ });
9
+ describe('Button - Component', () => {
10
+ test('Should render with the basic set of default props', () => {
11
+ const {
12
+ asFragment
13
+ } = render( /*#__PURE__*/React.createElement(Button, null));
14
+ expect(asFragment()).toMatchSnapshot();
15
+ });
16
+ test('Should render with children', () => {
17
+ const {
18
+ asFragment
19
+ } = render( /*#__PURE__*/React.createElement(Button, null, "Click Me"));
20
+ expect(asFragment()).toMatchSnapshot();
21
+ });
22
+ const palette = ['default', 'primary', 'secondary', 'danger', 'success'];
23
+ test.each(palette)('Should render palette of buttons - %s', palette => {
24
+ const {
25
+ asFragment
26
+ } = render( /*#__PURE__*/React.createElement(Button, {
27
+ palette: palette
28
+ }));
29
+ expect(asFragment()).toMatchSnapshot();
30
+ });
31
+ const bgAppearance = ['default', 'onHover', 'none'];
32
+ test.each(bgAppearance)('Should render bgAppearance of buttons - %s', bg => {
33
+ const {
34
+ asFragment
35
+ } = render( /*#__PURE__*/React.createElement(Button, {
36
+ bgAppearance: bg
37
+ }));
38
+ expect(asFragment()).toMatchSnapshot();
39
+ });
40
+ const borderAppearance = ['default', 'onHover', 'none'];
41
+ test.each(borderAppearance)('Should render borderAppearance of buttons - %s', border => {
42
+ const {
43
+ asFragment
44
+ } = render( /*#__PURE__*/React.createElement(Button, {
45
+ borderAppearance: border
46
+ }));
47
+ expect(asFragment()).toMatchSnapshot();
48
+ });
49
+ const variant = ['text', 'icon', 'iconWithText'];
50
+ test.each(variant)('Should render variant of buttons - %s', variant => {
51
+ const {
52
+ asFragment
53
+ } = render( /*#__PURE__*/React.createElement(Button, {
54
+ variant: variant
55
+ }));
56
+ expect(asFragment()).toMatchSnapshot();
57
+ });
58
+ const size = ['small', 'medium', 'large', 'full'];
59
+ test.each(size)('Should render Sizes of buttons - %s', size => {
60
+ const {
61
+ asFragment
62
+ } = render( /*#__PURE__*/React.createElement(Button, {
63
+ size: size
64
+ }));
65
+ expect(asFragment()).toMatchSnapshot();
66
+ });
67
+ const status = ['default', 'loading', 'success'];
68
+ test.each(status)('Should render Status of buttons - %s', status => {
69
+ const {
70
+ asFragment
71
+ } = render( /*#__PURE__*/React.createElement(Button, {
72
+ status: status
73
+ }));
74
+ expect(asFragment()).toMatchSnapshot();
75
+ });
76
+ const loaderPlacement = ['start', 'end', 'overlay'];
77
+ test.each(loaderPlacement)('Should render loaderPlacement of buttons - %s', loaderPlacement => {
78
+ const {
79
+ asFragment
80
+ } = render( /*#__PURE__*/React.createElement(Button, {
81
+ status: "loading",
82
+ loaderPlacement: loaderPlacement
83
+ }));
84
+ expect(asFragment()).toMatchSnapshot();
85
+ });
86
+ test('Should render with iconName and iconSize ', () => {
87
+ const {
88
+ asFragment
89
+ } = render( /*#__PURE__*/React.createElement(Button, {
90
+ variant: "icon",
91
+ iconName: "ZD-plus",
92
+ iconSize: 20
93
+ }));
94
+ expect(asFragment()).toMatchSnapshot();
95
+ });
96
+ test('Should render with iconPlacement ', () => {
97
+ const {
98
+ asFragment
99
+ } = render( /*#__PURE__*/React.createElement(Button, {
100
+ variant: "iconWithText",
101
+ iconName: "ZD-plus",
102
+ iconPlacement: "right"
103
+ }, "Button"));
104
+ expect(asFragment()).toMatchSnapshot();
105
+ });
106
+ test('Should render with renderIcon', () => {
107
+ const {
108
+ asFragment
109
+ } = render( /*#__PURE__*/React.createElement(Button, {
110
+ variant: "icon",
111
+ renderIcon: () => /*#__PURE__*/React.createElement("span", null, "CustomIcon")
112
+ }));
113
+ expect(asFragment()).toMatchSnapshot();
114
+ });
115
+ test('Should render with renderBefore and renderAfter', () => {
116
+ const {
117
+ asFragment
118
+ } = render( /*#__PURE__*/React.createElement(Button, {
119
+ renderBefore: () => /*#__PURE__*/React.createElement("span", null, "Before"),
120
+ renderAfter: () => /*#__PURE__*/React.createElement("span", null, "After")
121
+ }, "Button"));
122
+ expect(asFragment()).toMatchSnapshot();
123
+ });
124
+ test('Should render with renderLoader', () => {
125
+ const {
126
+ asFragment
127
+ } = render( /*#__PURE__*/React.createElement(Button, {
128
+ status: "loading",
129
+ renderLoader: () => /*#__PURE__*/React.createElement("span", null, "Loading...")
130
+ }));
131
+ expect(asFragment()).toMatchSnapshot();
132
+ });
133
+ test('Should render with renderSuccess', () => {
134
+ const {
135
+ asFragment
136
+ } = render( /*#__PURE__*/React.createElement(Button, {
137
+ status: "success",
138
+ renderSuccess: () => /*#__PURE__*/React.createElement("span", null, "Success!")
139
+ }));
140
+ expect(asFragment()).toMatchSnapshot();
141
+ });
142
+ const type = ['button', 'submit', 'reset'];
143
+ test.each(type)('Should render type of buttons - %s', type => {
144
+ const {
145
+ asFragment
146
+ } = render( /*#__PURE__*/React.createElement(Button, {
147
+ type: type
148
+ }));
149
+ expect(asFragment()).toMatchSnapshot();
150
+ });
151
+ test('Should trigger onClick function', () => {
152
+ const onClick = jest.fn();
153
+ const {
154
+ getByRole
155
+ } = render( /*#__PURE__*/React.createElement(Button, {
156
+ onClick: onClick
157
+ }));
158
+ userEvent.click(getByRole('button'));
159
+ expect(onClick).toHaveBeenCalled();
160
+ });
161
+ test('Should be disabled when isDisabled prop is true', () => {
162
+ const {
163
+ asFragment
164
+ } = render( /*#__PURE__*/React.createElement(Button, {
165
+ isDisabled: true
166
+ }));
167
+ expect(asFragment()).toMatchSnapshot();
168
+ });
169
+ test('Should render with readOnly style when isReadOnly prop is true', () => {
170
+ const {
171
+ asFragment
172
+ } = render( /*#__PURE__*/React.createElement(Button, {
173
+ isReadOnly: true
174
+ }));
175
+ expect(asFragment()).toMatchSnapshot();
176
+ });
177
+ test('Should render with selected style when isSelected prop is true', () => {
178
+ const {
179
+ asFragment
180
+ } = render( /*#__PURE__*/React.createElement(Button, {
181
+ isSelected: true
182
+ }));
183
+ expect(asFragment()).toMatchSnapshot();
184
+ });
185
+ const shape = ['pill', 'rectangle', 'roundedRectangle'];
186
+ test.each(shape)('Should render shape of buttons - %s', shape => {
187
+ const {
188
+ asFragment
189
+ } = render( /*#__PURE__*/React.createElement(Button, {
190
+ shape: shape
191
+ }));
192
+ expect(asFragment()).toMatchSnapshot();
193
+ });
194
+ const paletteShade = ['default', 'lighter'];
195
+ test.each(paletteShade)('Should render paletteShade of buttons - %s', shade => {
196
+ const {
197
+ asFragment
198
+ } = render( /*#__PURE__*/React.createElement(Button, {
199
+ paletteShade: shade
200
+ }));
201
+ expect(asFragment()).toMatchSnapshot();
202
+ });
203
+ const disabledAppearance = ['none', 'dull', 'strike'];
204
+ test.each(disabledAppearance)('Should render disabledAppearance of buttons - %s', style => {
205
+ const {
206
+ asFragment
207
+ } = render( /*#__PURE__*/React.createElement(Button, {
208
+ isDisabled: true,
209
+ disabledAppearance: style
210
+ }));
211
+ expect(asFragment()).toMatchSnapshot();
212
+ });
213
+ test('Should render with title attribute', () => {
214
+ const {
215
+ asFragment
216
+ } = render( /*#__PURE__*/React.createElement(Button, {
217
+ title: "Button test title"
218
+ }));
219
+ expect(asFragment()).toMatchSnapshot();
220
+ });
221
+ test('Should apply customClass to wrapper and text', () => {
222
+ const {
223
+ asFragment
224
+ } = render( /*#__PURE__*/React.createElement(Button, {
225
+ customClass: {
226
+ wrapper: 'customButtonClass',
227
+ text: 'customTextClass'
228
+ }
229
+ }, "Button"));
230
+ expect(asFragment()).toMatchSnapshot();
231
+ });
232
+ test('Should apply customProps to wrapper, text and icon', () => {
233
+ const {
234
+ asFragment
235
+ } = render( /*#__PURE__*/React.createElement(Button, {
236
+ variant: "iconWithText",
237
+ iconName: "check",
238
+ customProps: {
239
+ wrapper: {
240
+ 'data-wrapper': 'wrapperProps'
241
+ },
242
+ text: {
243
+ 'data-text': 'textProps'
244
+ },
245
+ icon: {
246
+ 'data-icon': 'iconProps'
247
+ }
248
+ }
249
+ }, "Button"));
250
+ expect(asFragment()).toMatchSnapshot();
251
+ });
252
+ test('Should render with customId and testId', () => {
253
+ const {
254
+ asFragment
255
+ } = render( /*#__PURE__*/React.createElement(Button, {
256
+ customId: "customIdValue",
257
+ testId: "testIdValue"
258
+ }));
259
+ expect(asFragment()).toMatchSnapshot();
260
+ });
261
+ test('Should apply a11yAttributes to the button', () => {
262
+ const {
263
+ asFragment
264
+ } = render( /*#__PURE__*/React.createElement(Button, {
265
+ a11yAttributes: {
266
+ 'aria-label': 'Smart Button',
267
+ 'aria-describedby': 'button-description'
268
+ }
269
+ }, "Button"));
270
+ expect(asFragment()).toMatchSnapshot();
271
+ });
272
+ });