@zohodesk/components 1.0.0-temp-260 → 1.0.0-temp-259.3
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.
- package/CHANGELOG.md +4 -0
- package/assets/Appearance/dark/mode/Component_v1_DarkMode.module.css +5 -20
- package/assets/Appearance/light/mode/Component_v1_LightMode.module.css +5 -20
- package/assets/Appearance/pureDark/mode/Component_v1_PureDarkMode.module.css +5 -20
- package/es/v1/Button/Button.js +160 -107
- package/es/v1/Button/README.md +106 -42
- package/es/v1/Button/__tests__/Button.spec.js +138 -47
- package/es/v1/Button/__tests__/__snapshots__/Button.spec.js.snap +1105 -332
- package/es/v1/Button/constants/index.js +26 -20
- package/es/v1/Button/constants/presets.js +149 -0
- package/es/v1/Button/css/Button_v1.module.css +33 -16
- package/es/v1/Button/css/cssJSLogic.js +56 -28
- package/es/v1/Button/props/defaultProps.js +2 -6
- package/es/v1/Button/props/propTypes.js +26 -8
- package/es/v1/helpers/colorHelpers/__tests__/colorHelper.spec.js +357 -0
- package/es/v1/helpers/colorHelpers/background/backgroundColor.module.css +40 -40
- package/es/v1/helpers/colorHelpers/border/borderColor.module.css +25 -25
- package/es/v1/helpers/colorHelpers/colorHelper.js +117 -139
- package/es/v1/helpers/colorHelpers/constants/index.js +45 -4
- package/es/v1/helpers/colorHelpers/index.js +0 -1
- package/es/v1/helpers/colorHelpers/text/textColor.module.css +35 -35
- package/lib/v1/Button/Button.js +179 -119
- package/lib/v1/Button/README.md +106 -42
- package/lib/v1/Button/__tests__/Button.spec.js +194 -87
- package/lib/v1/Button/__tests__/__snapshots__/Button.spec.js.snap +1105 -332
- package/lib/v1/Button/constants/index.js +31 -28
- package/lib/v1/Button/constants/presets.js +167 -0
- package/lib/v1/Button/css/Button_v1.module.css +33 -16
- package/lib/v1/Button/css/cssJSLogic.js +42 -19
- package/lib/v1/Button/props/defaultProps.js +1 -5
- package/lib/v1/Button/props/propTypes.js +41 -7
- package/lib/v1/helpers/colorHelpers/__tests__/colorHelper.spec.js +363 -0
- package/lib/v1/helpers/colorHelpers/background/backgroundColor.module.css +40 -40
- package/lib/v1/helpers/colorHelpers/border/borderColor.module.css +25 -25
- package/lib/v1/helpers/colorHelpers/colorHelper.js +127 -153
- package/lib/v1/helpers/colorHelpers/constants/index.js +45 -4
- package/lib/v1/helpers/colorHelpers/index.js +2 -24
- package/lib/v1/helpers/colorHelpers/text/textColor.module.css +35 -35
- package/package.json +4 -4
- package/es/AdvancedPopup/AdvancedPopup.js +0 -105
- package/lib/AdvancedPopup/AdvancedPopup.js +0 -122
package/lib/v1/Button/Button.js
CHANGED
|
@@ -5,7 +5,7 @@ function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" =
|
|
|
5
5
|
Object.defineProperty(exports, "__esModule", {
|
|
6
6
|
value: true
|
|
7
7
|
});
|
|
8
|
-
exports["default"] = void 0;
|
|
8
|
+
exports["default"] = exports.ButtonPresentational = void 0;
|
|
9
9
|
|
|
10
10
|
var _cssUtility = require("@dot-system/css-utility");
|
|
11
11
|
|
|
@@ -17,24 +17,24 @@ var _Icon = _interopRequireDefault(require("@zohodesk/icons/es/Icon"));
|
|
|
17
17
|
|
|
18
18
|
var _Flex = _interopRequireDefault(require("@zohodesk/layout/es/Flex/Flex"));
|
|
19
19
|
|
|
20
|
-
var _Typography = _interopRequireDefault(require("../../Typography/Typography"));
|
|
21
|
-
|
|
22
20
|
var _renderNode = _interopRequireWildcard(require("@zohodesk/utils/es/renderNode"));
|
|
23
21
|
|
|
24
|
-
var _propTypes = _interopRequireDefault(require("./props/propTypes"));
|
|
25
|
-
|
|
26
|
-
var _defaultProps = _interopRequireDefault(require("./props/defaultProps"));
|
|
27
|
-
|
|
28
22
|
var _constants = require("@zohodesk/dotkit/es/utils/constants");
|
|
29
23
|
|
|
30
24
|
var _constants2 = require("./constants");
|
|
31
25
|
|
|
26
|
+
var _Typography = _interopRequireDefault(require("../../Typography/Typography"));
|
|
27
|
+
|
|
32
28
|
var _Spinner = _interopRequireDefault(require("../shared/Spinner/Spinner"));
|
|
33
29
|
|
|
34
30
|
var _SuccessTick = _interopRequireDefault(require("../shared/SuccessTick/SuccessTick"));
|
|
35
31
|
|
|
36
32
|
var _cssJSLogic = _interopRequireDefault(require("./css/cssJSLogic"));
|
|
37
33
|
|
|
34
|
+
var _propTypes = _interopRequireDefault(require("./props/propTypes"));
|
|
35
|
+
|
|
36
|
+
var _defaultProps = _interopRequireDefault(require("./props/defaultProps"));
|
|
37
|
+
|
|
38
38
|
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
|
|
39
39
|
|
|
40
40
|
function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
|
|
@@ -53,17 +53,18 @@ var getTypographySize = function getTypographySize(size) {
|
|
|
53
53
|
return _constants2.TYPOGRAPHY_SIZE_MAP[size] || '13';
|
|
54
54
|
};
|
|
55
55
|
|
|
56
|
-
var
|
|
57
|
-
var
|
|
58
|
-
|
|
59
|
-
|
|
56
|
+
var ButtonPresentational = /*#__PURE__*/(0, _react.forwardRef)(function ButtonPresentational(props, ref) {
|
|
57
|
+
var isLoading = props.isLoading,
|
|
58
|
+
isSuccess = props.isSuccess,
|
|
59
|
+
isDisabled = props.isDisabled,
|
|
60
|
+
isDisabledState = props.isDisabledState,
|
|
61
|
+
overlayActive = props.overlayActive,
|
|
60
62
|
variant = props.variant,
|
|
61
|
-
|
|
63
|
+
iconPlacement = props.iconPlacement,
|
|
62
64
|
loaderPlacement = props.loaderPlacement,
|
|
63
65
|
size = props.size,
|
|
64
66
|
iconName = props.iconName,
|
|
65
67
|
iconSize = props.iconSize,
|
|
66
|
-
iconPlacement = props.iconPlacement,
|
|
67
68
|
renderIcon = props.renderIcon,
|
|
68
69
|
renderBefore = props.renderBefore,
|
|
69
70
|
renderAfter = props.renderAfter,
|
|
@@ -71,105 +72,94 @@ var Button = /*#__PURE__*/(0, _react.forwardRef)(function Button(props, ref) {
|
|
|
71
72
|
renderSuccess = props.renderSuccess,
|
|
72
73
|
children = props.children,
|
|
73
74
|
type = props.type,
|
|
74
|
-
onClick = props.onClick,
|
|
75
|
-
isDisabled = props.isDisabled,
|
|
76
|
-
isReadOnly = props.isReadOnly,
|
|
77
75
|
isSelected = props.isSelected,
|
|
78
|
-
shape = props.shape,
|
|
79
|
-
paletteShade = props.paletteShade,
|
|
80
|
-
disabledAppearance = props.disabledAppearance,
|
|
81
76
|
title = props.title,
|
|
82
77
|
customProps = props.customProps,
|
|
83
78
|
customAttributes = props.customAttributes,
|
|
84
79
|
a11yAttributes = props.a11yAttributes,
|
|
85
80
|
customId = props.customId,
|
|
86
|
-
testId = props.testId
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
var
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
81
|
+
testId = props.testId,
|
|
82
|
+
dataSelectorId = props.dataSelectorId,
|
|
83
|
+
handleClick = props.handleClick,
|
|
84
|
+
classNames = props.classNames;
|
|
85
|
+
var loaderOverlayClass = classNames.loaderOverlayClass,
|
|
86
|
+
successOverlayClass = classNames.successOverlayClass,
|
|
87
|
+
contentWrapperClass = classNames.contentWrapperClass,
|
|
88
|
+
textClassName = classNames.textClassName,
|
|
89
|
+
buttonClassName = classNames.buttonClassName,
|
|
90
|
+
iconClassName = classNames.iconClassName,
|
|
91
|
+
loaderClassName = classNames.loaderClassName,
|
|
92
|
+
successClassName = classNames.successClassName;
|
|
93
|
+
|
|
94
|
+
var _ref = customProps || _constants.DUMMY_OBJECT,
|
|
95
|
+
_ref$text = _ref.text,
|
|
96
|
+
contentProps = _ref$text === void 0 ? _constants.DUMMY_OBJECT : _ref$text,
|
|
97
|
+
_ref$icon = _ref.icon,
|
|
98
|
+
iconProps = _ref$icon === void 0 ? _constants.DUMMY_OBJECT : _ref$icon;
|
|
99
|
+
|
|
100
|
+
var _ref2 = customAttributes || _constants.DUMMY_OBJECT,
|
|
101
|
+
_ref2$button = _ref2.button,
|
|
102
|
+
buttonAttributes = _ref2$button === void 0 ? _constants.DUMMY_OBJECT : _ref2$button,
|
|
103
|
+
_ref2$contentWrapper = _ref2.contentWrapper,
|
|
104
|
+
contentWrapperAttributes = _ref2$contentWrapper === void 0 ? _constants.DUMMY_OBJECT : _ref2$contentWrapper,
|
|
105
|
+
_ref2$loader = _ref2.loader,
|
|
106
|
+
loaderAttributes = _ref2$loader === void 0 ? _constants.DUMMY_OBJECT : _ref2$loader,
|
|
107
|
+
_ref2$success = _ref2.success,
|
|
108
|
+
successAttributes = _ref2$success === void 0 ? _constants.DUMMY_OBJECT : _ref2$success,
|
|
109
|
+
_ref2$icon = _ref2.icon,
|
|
110
|
+
iconAttributes = _ref2$icon === void 0 ? _constants.DUMMY_OBJECT : _ref2$icon,
|
|
111
|
+
_ref2$text = _ref2.text,
|
|
112
|
+
textAttributes = _ref2$text === void 0 ? _constants.DUMMY_OBJECT : _ref2$text;
|
|
113
|
+
|
|
114
|
+
var iconTagAttributes = _objectSpread(_objectSpread({}, iconAttributes), {}, {
|
|
115
|
+
'data-test-id': testId ? "".concat(testId, "_icon") : undefined
|
|
116
|
+
});
|
|
118
117
|
|
|
119
|
-
|
|
120
|
-
};
|
|
118
|
+
var showIcon = variant !== _constants2.VARIANT.TEXT && (renderIcon || iconName);
|
|
121
119
|
|
|
122
120
|
var _renderLoader = function _renderLoader() {
|
|
123
|
-
if (!isLoading)
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
});
|
|
131
|
-
}
|
|
132
|
-
|
|
133
|
-
var loaderClassName = loaderPlacement === _constants2.LOADER_PLACEMENT.OVERLAY ? loaderOverlayClass : '';
|
|
134
|
-
return /*#__PURE__*/_react["default"].createElement(_Flex["default"], {
|
|
121
|
+
if (!isLoading) return null;
|
|
122
|
+
var isOverlay = loaderPlacement === _constants2.LOADER_PLACEMENT.OVERLAY;
|
|
123
|
+
var hasCustomLoader = (0, _renderNode.isRenderable)(renderLoader);
|
|
124
|
+
if (hasCustomLoader && !isOverlay) return (0, _renderNode["default"])(renderLoader, {
|
|
125
|
+
status: _constants2.STATUS.LOADING
|
|
126
|
+
});
|
|
127
|
+
return /*#__PURE__*/_react["default"].createElement(_Flex["default"], _extends({
|
|
135
128
|
$ui_displayMode: "flex",
|
|
136
129
|
$ui_alignItems: "center",
|
|
137
130
|
$ui_justifyContent: "center",
|
|
138
|
-
$ui_className:
|
|
131
|
+
$ui_className: isOverlay ? loaderOverlayClass : '',
|
|
139
132
|
testId: testId ? "".concat(testId, "_loader") : undefined
|
|
140
|
-
},
|
|
133
|
+
}, hasCustomLoader ? undefined : loaderAttributes), hasCustomLoader ? (0, _renderNode["default"])(renderLoader, {
|
|
134
|
+
status: _constants2.STATUS.LOADING
|
|
135
|
+
}) : /*#__PURE__*/_react["default"].createElement(_Spinner["default"], {
|
|
136
|
+
customClass: loaderClassName
|
|
137
|
+
}));
|
|
141
138
|
};
|
|
142
139
|
|
|
143
140
|
var _renderSuccess = function _renderSuccess() {
|
|
144
|
-
if (!isSuccess)
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
});
|
|
152
|
-
}
|
|
153
|
-
|
|
154
|
-
var successClassName = loaderPlacement === _constants2.LOADER_PLACEMENT.OVERLAY ? successOverlayClass : '';
|
|
155
|
-
return /*#__PURE__*/_react["default"].createElement(_Flex["default"], {
|
|
141
|
+
if (!isSuccess) return null;
|
|
142
|
+
var isOverlay = loaderPlacement === _constants2.LOADER_PLACEMENT.OVERLAY;
|
|
143
|
+
var hasCustomSuccess = (0, _renderNode.isRenderable)(renderSuccess);
|
|
144
|
+
if (hasCustomSuccess && !isOverlay) return (0, _renderNode["default"])(renderSuccess, {
|
|
145
|
+
status: _constants2.STATUS.SUCCESS
|
|
146
|
+
});
|
|
147
|
+
return /*#__PURE__*/_react["default"].createElement(_Flex["default"], _extends({
|
|
156
148
|
$ui_displayMode: "flex",
|
|
157
149
|
$ui_alignItems: "center",
|
|
158
150
|
$ui_justifyContent: "center",
|
|
159
|
-
$ui_className:
|
|
151
|
+
$ui_className: isOverlay ? successOverlayClass : '',
|
|
160
152
|
testId: testId ? "".concat(testId, "_success") : undefined
|
|
161
|
-
},
|
|
153
|
+
}, hasCustomSuccess ? undefined : successAttributes), hasCustomSuccess ? (0, _renderNode["default"])(renderSuccess, {
|
|
154
|
+
status: _constants2.STATUS.SUCCESS
|
|
155
|
+
}) : /*#__PURE__*/_react["default"].createElement(_SuccessTick["default"], {
|
|
156
|
+
customClass: successClassName
|
|
157
|
+
}));
|
|
162
158
|
};
|
|
163
159
|
|
|
164
160
|
var _renderIconNode = function _renderIconNode() {
|
|
165
|
-
if (!showIcon)
|
|
166
|
-
|
|
167
|
-
}
|
|
168
|
-
|
|
169
|
-
if ((0, _renderNode.isRenderable)(renderIcon)) {
|
|
170
|
-
return (0, _renderNode["default"])(renderIcon);
|
|
171
|
-
}
|
|
172
|
-
|
|
161
|
+
if (!showIcon) return null;
|
|
162
|
+
if ((0, _renderNode.isRenderable)(renderIcon)) return (0, _renderNode["default"])(renderIcon);
|
|
173
163
|
return /*#__PURE__*/_react["default"].createElement(_Icon["default"], _extends({}, iconProps, {
|
|
174
164
|
iconClass: iconClassName,
|
|
175
165
|
name: iconName,
|
|
@@ -179,59 +169,129 @@ var Button = /*#__PURE__*/(0, _react.forwardRef)(function Button(props, ref) {
|
|
|
179
169
|
}));
|
|
180
170
|
};
|
|
181
171
|
|
|
182
|
-
var _renderBeforeNode = function _renderBeforeNode() {
|
|
183
|
-
if (!(0, _renderNode.isRenderable)(renderBefore)) {
|
|
184
|
-
return null;
|
|
185
|
-
}
|
|
186
|
-
|
|
187
|
-
return (0, _renderNode["default"])(renderBefore, props);
|
|
188
|
-
};
|
|
189
|
-
|
|
190
|
-
var _renderAfterNode = function _renderAfterNode() {
|
|
191
|
-
if (!(0, _renderNode.isRenderable)(renderAfter)) {
|
|
192
|
-
return null;
|
|
193
|
-
}
|
|
194
|
-
|
|
195
|
-
return (0, _renderNode["default"])(renderAfter, props);
|
|
196
|
-
};
|
|
197
|
-
|
|
198
172
|
var _renderContent = function _renderContent() {
|
|
199
|
-
var shouldShowText = variant !== _constants2.VARIANT.ICON && children
|
|
173
|
+
var shouldShowText = variant !== _constants2.VARIANT.ICON && children != null && (typeof children !== 'string' || children.trim() !== '');
|
|
200
174
|
var showLoaderStart = isLoading && loaderPlacement === _constants2.LOADER_PLACEMENT.START;
|
|
201
175
|
var showLoaderAfter = isLoading && loaderPlacement === _constants2.LOADER_PLACEMENT.END;
|
|
202
176
|
var showSuccessStart = isSuccess && loaderPlacement === _constants2.LOADER_PLACEMENT.START;
|
|
203
177
|
var showSuccessAfter = isSuccess && loaderPlacement === _constants2.LOADER_PLACEMENT.END;
|
|
204
|
-
return /*#__PURE__*/_react["default"].createElement(_Flex["default"], {
|
|
178
|
+
return /*#__PURE__*/_react["default"].createElement(_Flex["default"], _extends({
|
|
205
179
|
$ui_displayMode: "flex",
|
|
206
180
|
$ui_direction: "row",
|
|
207
181
|
$flag_shrink: true,
|
|
208
182
|
$ui_alignItems: "center",
|
|
209
183
|
$ui_justifyContent: "center",
|
|
210
184
|
$ui_className: contentWrapperClass
|
|
211
|
-
}, showLoaderStart ? _renderLoader() : null, showSuccessStart ? _renderSuccess() : null,
|
|
185
|
+
}, contentWrapperAttributes), showLoaderStart ? _renderLoader() : null, showSuccessStart ? _renderSuccess() : null, (0, _renderNode.isRenderable)(renderBefore) ? (0, _renderNode["default"])(renderBefore, props) : null, iconPlacement === _constants2.ICON_PLACEMENT.LEFT ? _renderIconNode() : null, shouldShowText ? typeof children === 'string' ? /*#__PURE__*/_react["default"].createElement(_Typography["default"], _extends({
|
|
186
|
+
$ui_size: getTypographySize(size)
|
|
187
|
+
}, contentProps, {
|
|
188
|
+
tagAttributes: textAttributes,
|
|
212
189
|
$ui_className: textClassName,
|
|
213
|
-
$ui_size: getTypographySize(size),
|
|
214
190
|
$flag_dotted: variant !== _constants2.VARIANT.ICON
|
|
215
|
-
}), children) : null, iconPlacement === _constants2.ICON_PLACEMENT.RIGHT ? _renderIconNode() : null,
|
|
191
|
+
}), children) : children : null, iconPlacement === _constants2.ICON_PLACEMENT.RIGHT ? _renderIconNode() : null, (0, _renderNode.isRenderable)(renderAfter) ? (0, _renderNode["default"])(renderAfter, props) : null, showLoaderAfter ? _renderLoader() : null, showSuccessAfter ? _renderSuccess() : null);
|
|
216
192
|
};
|
|
217
193
|
|
|
218
|
-
var containerAttributes = _objectSpread(_objectSpread({},
|
|
219
|
-
'data-id': customId,
|
|
220
|
-
'data-test-id': testId,
|
|
194
|
+
var containerAttributes = _objectSpread(_objectSpread({}, buttonAttributes), {}, {
|
|
195
|
+
'data-id': isDisabled ? "".concat(customId, "_disabled") : customId,
|
|
196
|
+
'data-test-id': isDisabled ? "".concat(testId, "_disabled") : testId,
|
|
197
|
+
'data-selector-id': dataSelectorId,
|
|
221
198
|
'data-title': title
|
|
222
199
|
});
|
|
223
200
|
|
|
224
|
-
return /*#__PURE__*/_react["default"].createElement("button", _extends({}, containerAttributes,
|
|
201
|
+
return /*#__PURE__*/_react["default"].createElement("button", _extends({}, containerAttributes, {
|
|
202
|
+
"aria-busy": isLoading,
|
|
203
|
+
disabled: isDisabledState,
|
|
204
|
+
"aria-pressed": isSelected
|
|
205
|
+
}, a11yAttributes, {
|
|
225
206
|
ref: ref,
|
|
226
207
|
type: type,
|
|
227
208
|
className: (0, _cssUtility.cn)(buttonClassName),
|
|
228
|
-
|
|
229
|
-
"aria-disabled": isDisabledState,
|
|
230
|
-
"aria-readonly": isReadOnly,
|
|
231
|
-
"aria-pressed": isSelected,
|
|
232
|
-
onClick: _handleClick
|
|
209
|
+
onClick: handleClick
|
|
233
210
|
}), _renderContent(), overlayActive ? isLoading ? _renderLoader() : _renderSuccess() : null);
|
|
234
211
|
});
|
|
212
|
+
exports.ButtonPresentational = ButtonPresentational;
|
|
213
|
+
ButtonPresentational.displayName = 'ButtonPresentational';
|
|
214
|
+
var Button = /*#__PURE__*/(0, _react.forwardRef)(function Button(props, ref) {
|
|
215
|
+
var palette = props.palette,
|
|
216
|
+
appearance = props.appearance,
|
|
217
|
+
hoverAppearance = props.hoverAppearance,
|
|
218
|
+
selectedAppearance = props.selectedAppearance,
|
|
219
|
+
variant = props.variant,
|
|
220
|
+
status = props.status,
|
|
221
|
+
loaderPlacement = props.loaderPlacement,
|
|
222
|
+
size = props.size,
|
|
223
|
+
iconName = props.iconName,
|
|
224
|
+
iconSize = props.iconSize,
|
|
225
|
+
iconPlacement = props.iconPlacement,
|
|
226
|
+
renderIcon = props.renderIcon,
|
|
227
|
+
renderBefore = props.renderBefore,
|
|
228
|
+
renderAfter = props.renderAfter,
|
|
229
|
+
renderLoader = props.renderLoader,
|
|
230
|
+
renderSuccess = props.renderSuccess,
|
|
231
|
+
children = props.children,
|
|
232
|
+
type = props.type,
|
|
233
|
+
onClick = props.onClick,
|
|
234
|
+
isDisabled = props.isDisabled,
|
|
235
|
+
isSelected = props.isSelected,
|
|
236
|
+
shape = props.shape,
|
|
237
|
+
disabledAppearance = props.disabledAppearance,
|
|
238
|
+
title = props.title,
|
|
239
|
+
customProps = props.customProps,
|
|
240
|
+
customAttributes = props.customAttributes,
|
|
241
|
+
a11yAttributes = props.a11yAttributes,
|
|
242
|
+
customId = props.customId,
|
|
243
|
+
testId = props.testId,
|
|
244
|
+
dataSelectorId = props.dataSelectorId,
|
|
245
|
+
customClass = props.customClass;
|
|
246
|
+
var isLoading = status === _constants2.STATUS.LOADING;
|
|
247
|
+
var isSuccess = status === _constants2.STATUS.SUCCESS;
|
|
248
|
+
var isDisabledState = isDisabled || isLoading;
|
|
249
|
+
var overlayActive = (isLoading || isSuccess) && loaderPlacement === _constants2.LOADER_PLACEMENT.OVERLAY;
|
|
250
|
+
var classNames = (0, _react.useMemo)(function () {
|
|
251
|
+
return (0, _cssJSLogic["default"])({
|
|
252
|
+
props: props
|
|
253
|
+
});
|
|
254
|
+
}, [palette, appearance, hoverAppearance, selectedAppearance, size, variant, status, isDisabled, isSelected, shape, loaderPlacement, disabledAppearance, customClass]);
|
|
255
|
+
|
|
256
|
+
var handleClick = function handleClick(event) {
|
|
257
|
+
if (isDisabledState) return;
|
|
258
|
+
onClick(event);
|
|
259
|
+
};
|
|
260
|
+
|
|
261
|
+
var essentials = {
|
|
262
|
+
isLoading: isLoading,
|
|
263
|
+
isSuccess: isSuccess,
|
|
264
|
+
isDisabled: isDisabled,
|
|
265
|
+
isDisabledState: isDisabledState,
|
|
266
|
+
overlayActive: overlayActive,
|
|
267
|
+
variant: variant,
|
|
268
|
+
iconPlacement: iconPlacement,
|
|
269
|
+
loaderPlacement: loaderPlacement,
|
|
270
|
+
size: size,
|
|
271
|
+
iconName: iconName,
|
|
272
|
+
iconSize: iconSize,
|
|
273
|
+
renderIcon: renderIcon,
|
|
274
|
+
renderBefore: renderBefore,
|
|
275
|
+
renderAfter: renderAfter,
|
|
276
|
+
renderLoader: renderLoader,
|
|
277
|
+
renderSuccess: renderSuccess,
|
|
278
|
+
children: children,
|
|
279
|
+
type: type,
|
|
280
|
+
isSelected: isSelected,
|
|
281
|
+
title: title,
|
|
282
|
+
customProps: customProps,
|
|
283
|
+
customAttributes: customAttributes,
|
|
284
|
+
a11yAttributes: a11yAttributes,
|
|
285
|
+
customId: customId,
|
|
286
|
+
testId: testId,
|
|
287
|
+
dataSelectorId: dataSelectorId,
|
|
288
|
+
handleClick: handleClick
|
|
289
|
+
};
|
|
290
|
+
return /*#__PURE__*/_react["default"].createElement(ButtonPresentational, _extends({}, essentials, {
|
|
291
|
+
classNames: classNames,
|
|
292
|
+
ref: ref
|
|
293
|
+
}));
|
|
294
|
+
});
|
|
235
295
|
Button.propTypes = _propTypes["default"];
|
|
236
296
|
Button.defaultProps = _defaultProps["default"];
|
|
237
297
|
Button.displayName = 'Button';
|
package/lib/v1/Button/README.md
CHANGED
|
@@ -18,14 +18,49 @@ import Button from '@zohodesk/components/es/v1/Button/Button';
|
|
|
18
18
|
</Button>
|
|
19
19
|
```
|
|
20
20
|
|
|
21
|
-
### With Palette
|
|
21
|
+
### With Palette
|
|
22
22
|
|
|
23
23
|
```jsx
|
|
24
|
-
<Button palette="
|
|
24
|
+
<Button palette="brand">Save</Button>
|
|
25
25
|
<Button palette="danger">Delete</Button>
|
|
26
26
|
<Button palette="success">Confirm</Button>
|
|
27
27
|
```
|
|
28
28
|
|
|
29
|
+
### With Appearance
|
|
30
|
+
|
|
31
|
+
`appearance`, `hoverAppearance`, and `selectedAppearance` are objects with optional `bg`, `border`, and `text` keys. Each key accepts `true` (use palette color), `false` (suppress), or a palette name string.
|
|
32
|
+
|
|
33
|
+
```jsx
|
|
34
|
+
<Button palette="brand" appearance={{ bg: false, border: true }}>
|
|
35
|
+
Ghost
|
|
36
|
+
</Button>
|
|
37
|
+
|
|
38
|
+
<Button
|
|
39
|
+
palette="brand"
|
|
40
|
+
appearance={{ bg: false, border: true }}
|
|
41
|
+
hoverAppearance={{ bg: false, border: true }}
|
|
42
|
+
selectedAppearance={{ bg: false, border: true }}
|
|
43
|
+
>
|
|
44
|
+
Ghost with states
|
|
45
|
+
</Button>
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
### Using Presets
|
|
49
|
+
|
|
50
|
+
```jsx
|
|
51
|
+
import {
|
|
52
|
+
BRAND_GHOST,
|
|
53
|
+
BRAND_TEXT_ONLY,
|
|
54
|
+
SECONDARY_GHOST_BRAND_TINTED_ONSELECT,
|
|
55
|
+
BRAND_TINTED_OUTLINE,
|
|
56
|
+
BRAND_TEXT_TINTED_HOVER
|
|
57
|
+
} from '@zohodesk/components/es/v1/Button/constants/presets';
|
|
58
|
+
|
|
59
|
+
<Button {...BRAND_GHOST}>Brand Ghost</Button>
|
|
60
|
+
<Button {...BRAND_TEXT_ONLY}>Brand Text Only</Button>
|
|
61
|
+
<Button {...SECONDARY_GHOST_BRAND_TINTED_ONSELECT}>Secondary Ghost</Button>
|
|
62
|
+
```
|
|
63
|
+
|
|
29
64
|
### With Icon
|
|
30
65
|
|
|
31
66
|
```jsx
|
|
@@ -36,75 +71,104 @@ import Button from '@zohodesk/components/es/v1/Button/Button';
|
|
|
36
71
|
</Button>
|
|
37
72
|
```
|
|
38
73
|
|
|
39
|
-
### Loading State
|
|
74
|
+
### Loading / Success State
|
|
40
75
|
|
|
41
76
|
```jsx
|
|
42
|
-
<Button status="loading" loaderPlacement="overlay">
|
|
43
|
-
|
|
44
|
-
</Button>
|
|
45
|
-
|
|
46
|
-
<Button status="loading" loaderPlacement="start">
|
|
47
|
-
Loading
|
|
48
|
-
</Button>
|
|
77
|
+
<Button status="loading" loaderPlacement="overlay">Saving...</Button>
|
|
78
|
+
<Button status="loading" loaderPlacement="start">Loading</Button>
|
|
79
|
+
<Button status="success">Done</Button>
|
|
49
80
|
```
|
|
50
81
|
|
|
51
|
-
### Disabled
|
|
82
|
+
### Disabled
|
|
52
83
|
|
|
53
84
|
```jsx
|
|
54
85
|
<Button isDisabled>Disabled</Button>
|
|
55
|
-
<Button
|
|
86
|
+
<Button isDisabled disabledAppearance="strike">Disabled Strike</Button>
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
### Shape
|
|
90
|
+
|
|
91
|
+
```jsx
|
|
92
|
+
<Button shape="pill">Pill</Button>
|
|
93
|
+
<Button shape="rectangle">Rectangle</Button>
|
|
94
|
+
<Button shape="roundedRectangle">Rounded</Button>
|
|
56
95
|
```
|
|
57
96
|
|
|
58
97
|
## Props
|
|
59
98
|
|
|
60
99
|
| Prop | Type | Default | Description |
|
|
61
100
|
|---|---|---|---|
|
|
62
|
-
| `
|
|
63
|
-
| `
|
|
64
|
-
| `
|
|
65
|
-
| `
|
|
66
|
-
| `borderAppearance` | `oneOf: default, onHover, none` | `default` | Border behavior |
|
|
101
|
+
| `palette` | `oneOf: brand, brandLighter, info, infoLighter, secondary, secondaryLighter, danger, dangerLighter, success, successLighter, warning, warningLighter` | `''` | Color palette |
|
|
102
|
+
| `appearance` | `{ bg?, border?, text? }` | `{ bg: true, text: true }` | Color treatments at rest. Values: `true`, `false`, or a palette name |
|
|
103
|
+
| `hoverAppearance` | `{ bg?, border?, text? }` | `{ bg: true, text: true }` | Color treatments on hover/focus/active |
|
|
104
|
+
| `selectedAppearance` | `{ bg?, border?, text? }` | `{ bg: true, text: true }` | Color treatments when `isSelected` is true |
|
|
67
105
|
| `variant` | `oneOf: text, icon, iconWithText` | `text` | Display variant |
|
|
68
106
|
| `size` | `oneOf: small, medium, large, full` | `medium` | Size variant |
|
|
69
107
|
| `status` | `oneOf: default, loading, success` | `default` | Status state |
|
|
70
|
-
| `loaderPlacement` | `oneOf: start, end, overlay` | `overlay` | Where loader appears |
|
|
108
|
+
| `loaderPlacement` | `oneOf: start, end, overlay` | `overlay` | Where the loader appears |
|
|
109
|
+
| `shape` | `oneOf: pill, rectangle, roundedRectangle` | `roundedRectangle` | Border shape |
|
|
71
110
|
| `iconName` | `string` | — | Icon name from `@zohodesk/icons` |
|
|
72
111
|
| `iconSize` | `number` | `16` | Icon size in pixels |
|
|
73
112
|
| `iconPlacement` | `oneOf: left, right` | `left` | Icon position relative to text |
|
|
74
|
-
| `
|
|
75
|
-
| `
|
|
113
|
+
| `disabledAppearance` | `oneOf: none, dull, strike` | `dull` | Visual style when disabled |
|
|
114
|
+
| `isDisabled` | `bool` | `false` | Disables the button |
|
|
115
|
+
| `isSelected` | `bool` | `false` | Selected/pressed state (`aria-pressed`) |
|
|
116
|
+
| `type` | `oneOf: button, submit, reset` | `button` | HTML button type |
|
|
117
|
+
| `onClick` | `func` | — | Click handler (suppressed when disabled or loading) |
|
|
118
|
+
| `title` | `string` | — | Tooltip / `data-title` attribute |
|
|
119
|
+
| `children` | `node` | — | Button label content |
|
|
76
120
|
| `renderIcon` | `node \| func` | — | Custom icon render slot |
|
|
77
121
|
| `renderBefore` | `node \| func` | — | Slot before main content |
|
|
78
122
|
| `renderAfter` | `node \| func` | — | Slot after main content |
|
|
79
123
|
| `renderLoader` | `node \| func` | — | Custom loader render slot |
|
|
80
124
|
| `renderSuccess` | `node \| func` | — | Custom success render slot |
|
|
81
|
-
| `
|
|
82
|
-
| `
|
|
83
|
-
| `
|
|
84
|
-
| `
|
|
85
|
-
| `
|
|
86
|
-
| `
|
|
87
|
-
| `
|
|
88
|
-
|
|
125
|
+
| `customId` | `string` | — | `data-id` attribute |
|
|
126
|
+
| `testId` | `string` | — | `data-test-id` attribute |
|
|
127
|
+
| `dataSelectorId` | `string` | — | `data-selector-id` attribute |
|
|
128
|
+
| `a11yAttributes` | `object` | `{}` | Extra ARIA/accessibility attributes spread onto `<button>` |
|
|
129
|
+
| `customClass` | `{ wrapper?, text?, icon?, loader?, success? }` | `{}` | CSS class overrides per part |
|
|
130
|
+
| `customProps` | `{ text?, icon? }` | `{}` | Extra props forwarded to text/icon sub-elements |
|
|
131
|
+
| `customAttributes` | `{ button?, contentWrapper?, loader?, success?, icon?, text? }` | `{}` | Extra HTML attributes per internal element |
|
|
132
|
+
|
|
133
|
+
## Presets
|
|
134
|
+
|
|
135
|
+
Ready-made palette + appearance combinations exported from `constants/presets`:
|
|
136
|
+
|
|
137
|
+
| Name | Palette | Appearance | Description |
|
|
138
|
+
|---|---|---|---|
|
|
139
|
+
| `BRAND_GHOST` | `brand` | `{ bg: false, border: true }` | Transparent bg, brand border |
|
|
140
|
+
| `BRAND_TEXT_ONLY` | `brand` | `{ bg: false }` | Text only, no border |
|
|
141
|
+
| `BRAND_TINTED_OUTLINE` | `brandLighter` | `{ border: true }` | Tinted fill, brand border |
|
|
142
|
+
| `SUCCESS_GHOST` | `success` | `{ bg: false, border: true }` | Transparent bg, success border |
|
|
143
|
+
| `SUCCESS_TEXT_ONLY` | `success` | `{ bg: false }` | Text only, no border |
|
|
144
|
+
| `SUCCESS_TINTED_OUTLINE` | `successLighter` | `{ border: true }` | Tinted fill, success border |
|
|
145
|
+
| `SECONDARY_GHOST_BRAND_TINTED_ONSELECT` | `secondary` | `{ bg: false, border: true }` | Secondary ghost; selected state switches to brand tint |
|
|
146
|
+
| `BLACK_TEXT_BRAND_ONHOVER` | `brand` | `{ bg: false, text: 'black' }` | Black text, brand color on hover |
|
|
147
|
+
| `BRAND_BG_ONSELECT` | `brand` | `{ bg: false, border: true }` | Ghost without a defined selected state |
|
|
148
|
+
| `BRAND_TEXT_TINTED_HOVER` | `brandLighter` | `{ bg: false }` | Ghost that becomes tinted on hover |
|
|
149
|
+
| `BRAND_TEXT_TINTED_DANGER_HOVER` | `brandLighter` | `{ bg: false }` | Ghost that becomes danger-tinted on hover |
|
|
89
150
|
|
|
90
151
|
## Customization
|
|
91
152
|
|
|
92
153
|
### Parts
|
|
93
154
|
|
|
94
|
-
| Part | Element | Description |
|
|
155
|
+
| Part key | Element | Description |
|
|
95
156
|
|---|---|---|
|
|
96
|
-
| `
|
|
97
|
-
| `
|
|
98
|
-
|
|
99
|
-
|
|
157
|
+
| `button` | `<button>` | Outermost button element |
|
|
158
|
+
| `contentWrapper` | Inner `<Flex>` | Wraps icon + text content |
|
|
159
|
+
| `text` | `<Typography>` | Text label |
|
|
160
|
+
| `icon` | `<Icon>` | Icon element |
|
|
161
|
+
| `loader` | `<Flex>` | Loader wrapper |
|
|
162
|
+
| `success` | `<Flex>` | Success tick wrapper |
|
|
100
163
|
|
|
101
|
-
|
|
164
|
+
Pass class overrides via `customClass`, extra props via `customProps`, or arbitrary HTML attributes via `customAttributes`.
|
|
102
165
|
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
166
|
+
```jsx
|
|
167
|
+
<Button
|
|
168
|
+
customClass={{ wrapper: 'myBtn', text: 'myBtnText' }}
|
|
169
|
+
customAttributes={{ button: { 'data-analytics': 'save' } }}
|
|
170
|
+
a11yAttributes={{ 'aria-label': 'Save document' }}
|
|
171
|
+
>
|
|
172
|
+
Save
|
|
173
|
+
</Button>
|
|
174
|
+
```
|