@atlaskit/select 21.8.3 → 21.8.4
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 +8 -0
- package/dist/cjs/popup-select/components.compiled.css +1 -1
- package/dist/cjs/popup-select/components.js +2 -8
- package/dist/cjs/popup-select/popup-select.js +1 -2
- package/dist/cjs/select.js +1 -1
- package/dist/es2019/popup-select/components.compiled.css +1 -1
- package/dist/es2019/popup-select/components.js +1 -2
- package/dist/es2019/popup-select/popup-select.js +1 -2
- package/dist/es2019/select.js +1 -1
- package/dist/esm/popup-select/components.compiled.css +1 -1
- package/dist/esm/popup-select/components.js +2 -8
- package/dist/esm/popup-select/popup-select.js +1 -2
- package/dist/esm/select.js +1 -1
- package/package.json +7 -7
- package/select.docs.tsx +153 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,13 @@
|
|
|
1
1
|
# @atlaskit/select
|
|
2
2
|
|
|
3
|
+
## 21.8.4
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- [`7aef1e49e90ea`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/7aef1e49e90ea) -
|
|
8
|
+
Removes redundant fallback color values via @atlaskit/theme
|
|
9
|
+
- Updated dependencies
|
|
10
|
+
|
|
3
11
|
## 21.8.3
|
|
4
12
|
|
|
5
13
|
### Patch Changes
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
|
|
2
2
|
._2rko12b0{border-radius:var(--ds-radius-small,4px)}
|
|
3
3
|
._2rko1mok{border-radius:var(--ds-radius-large,8px)}._12l2v77o{margin-inline-end:var(--ds-space-025,2px)}
|
|
4
|
-
.
|
|
4
|
+
._16qs130s{box-shadow:var(--ds-shadow-overlay,0 8px 9pt #1e1f2126,0 0 1px #1e1f214f)}
|
|
5
5
|
._1bsbzwfg{width:2pc}
|
|
6
6
|
._1pby16oo{z-index:510}
|
|
7
7
|
._1q51u2gc{padding-block-start:var(--ds-space-100,8px)}
|
|
@@ -13,17 +13,13 @@ var React = _react;
|
|
|
13
13
|
var _runtime = require("@compiled/react/runtime");
|
|
14
14
|
var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
|
|
15
15
|
var _objectWithoutProperties2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutProperties"));
|
|
16
|
-
var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
|
|
17
16
|
var _search = _interopRequireDefault(require("@atlaskit/icon/core/search"));
|
|
18
17
|
var _platformFeatureFlags = require("@atlaskit/platform-feature-flags");
|
|
19
18
|
var _reactSelect = require("@atlaskit/react-select");
|
|
20
|
-
var _colors = require("@atlaskit/theme/colors");
|
|
21
19
|
var _constants = require("@atlaskit/theme/constants");
|
|
22
20
|
var _visuallyHidden = _interopRequireDefault(require("@atlaskit/visually-hidden"));
|
|
23
21
|
var _excluded = ["innerRef", "innerProps"];
|
|
24
22
|
function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function _interopRequireWildcard(e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != _typeof(e) && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (var _t in e) "default" !== _t && {}.hasOwnProperty.call(e, _t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, _t)) && (i.get || i.set) ? o(f, _t, i) : f[_t] = e[_t]); return f; })(e, t); }
|
|
25
|
-
function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
|
|
26
|
-
function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { (0, _defineProperty2.default)(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
|
|
27
23
|
// ==============================
|
|
28
24
|
// Styled Components
|
|
29
25
|
// ==============================
|
|
@@ -42,12 +38,10 @@ var MenuDialog = exports.MenuDialog = /*#__PURE__*/(0, _react.forwardRef)(functi
|
|
|
42
38
|
testId = _ref.testId;
|
|
43
39
|
return /*#__PURE__*/React.createElement("div", {
|
|
44
40
|
ref: ref,
|
|
41
|
+
style: style,
|
|
45
42
|
id: id,
|
|
46
43
|
"data-testid": testId && "".concat(testId, "--menu"),
|
|
47
|
-
className: (0, _runtime.ax)(["_2rko12b0 _1pby16oo _bfhk1bhr
|
|
48
|
-
style: _objectSpread(_objectSpread({}, style), {}, {
|
|
49
|
-
"--_z6sjud": (0, _runtime.ix)("var(--ds-shadow-overlay, ".concat("0 0 0 1px ".concat(_colors.N40A, ", 0 4px 11px ").concat(_colors.N40A), ")"))
|
|
50
|
-
})
|
|
44
|
+
className: (0, _runtime.ax)(["_2rko12b0 _1pby16oo _bfhk1bhr _16qs130s", (0, _platformFeatureFlags.fg)('platform-dst-shape-theme-default') && "_2rko1mok"])
|
|
51
45
|
}, children);
|
|
52
46
|
});
|
|
53
47
|
|
|
@@ -23,7 +23,6 @@ var _shallowEqual = require("shallow-equal");
|
|
|
23
23
|
var _useId = require("@atlaskit/ds-lib/use-id");
|
|
24
24
|
var _platformFeatureFlags = require("@atlaskit/platform-feature-flags");
|
|
25
25
|
var _reactSelect = require("@atlaskit/react-select");
|
|
26
|
-
var _colors = require("@atlaskit/theme/colors");
|
|
27
26
|
var _select = _interopRequireDefault(require("../select"));
|
|
28
27
|
var _components = require("./components");
|
|
29
28
|
var _notifyOpenLayerObserver = require("./notify-open-layer-observer");
|
|
@@ -89,7 +88,7 @@ var PopupSelect = exports.default = /*#__PURE__*/function (_PureComponent) {
|
|
|
89
88
|
(0, _defineProperty2.default)(_this, "defaultStyles", {
|
|
90
89
|
groupHeading: function groupHeading(provided) {
|
|
91
90
|
return _objectSpread(_objectSpread({}, provided), {}, {
|
|
92
|
-
color: "var(--ds-text-subtlest,
|
|
91
|
+
color: "var(--ds-text-subtlest, #6B6E76)"
|
|
93
92
|
});
|
|
94
93
|
}
|
|
95
94
|
});
|
package/dist/cjs/select.js
CHANGED
|
@@ -11,7 +11,7 @@ var _createSelect = _interopRequireDefault(require("./create-select"));
|
|
|
11
11
|
/* eslint-disable @repo/internal/react/require-jsdoc */
|
|
12
12
|
|
|
13
13
|
var packageName = "@atlaskit/select";
|
|
14
|
-
var packageVersion = "21.8.
|
|
14
|
+
var packageVersion = "21.8.4";
|
|
15
15
|
var SelectWithoutAnalytics = exports.SelectWithoutAnalytics = (0, _createSelect.default)(_async.default);
|
|
16
16
|
var createAndFireEventOnAtlaskit = (0, _analyticsNext.createAndFireEvent)('atlaskit');
|
|
17
17
|
var Select = (0, _analyticsNext.withAnalyticsContext)({
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
|
|
2
2
|
._2rko12b0{border-radius:var(--ds-radius-small,4px)}
|
|
3
3
|
._2rko1mok{border-radius:var(--ds-radius-large,8px)}._12l2v77o{margin-inline-end:var(--ds-space-025,2px)}
|
|
4
|
-
.
|
|
4
|
+
._16qs130s{box-shadow:var(--ds-shadow-overlay,0 8px 9pt #1e1f2126,0 0 1px #1e1f214f)}
|
|
5
5
|
._1bsbzwfg{width:2pc}
|
|
6
6
|
._1pby16oo{z-index:510}
|
|
7
7
|
._1q51u2gc{padding-block-start:var(--ds-space-100,8px)}
|
|
@@ -7,7 +7,6 @@ import { forwardRef } from 'react';
|
|
|
7
7
|
import SearchIcon from '@atlaskit/icon/core/search';
|
|
8
8
|
import { fg } from '@atlaskit/platform-feature-flags';
|
|
9
9
|
import { components } from '@atlaskit/react-select';
|
|
10
|
-
import { N40A } from '@atlaskit/theme/colors';
|
|
11
10
|
import { layers } from '@atlaskit/theme/constants';
|
|
12
11
|
import VisuallyHidden from '@atlaskit/visually-hidden';
|
|
13
12
|
|
|
@@ -33,7 +32,7 @@ export const MenuDialog = /*#__PURE__*/forwardRef(({
|
|
|
33
32
|
style: style,
|
|
34
33
|
id: id,
|
|
35
34
|
"data-testid": testId && `${testId}--menu`,
|
|
36
|
-
className: ax(["_2rko12b0 _1pby16oo _bfhk1bhr
|
|
35
|
+
className: ax(["_2rko12b0 _1pby16oo _bfhk1bhr _16qs130s", fg('platform-dst-shape-theme-default') && "_2rko1mok"])
|
|
37
36
|
}, children);
|
|
38
37
|
});
|
|
39
38
|
|
|
@@ -9,7 +9,6 @@ import { shallowEqualObjects } from 'shallow-equal';
|
|
|
9
9
|
import { IdProvider } from '@atlaskit/ds-lib/use-id';
|
|
10
10
|
import { fg } from '@atlaskit/platform-feature-flags';
|
|
11
11
|
import { mergeStyles } from '@atlaskit/react-select';
|
|
12
|
-
import { N80 } from '@atlaskit/theme/colors';
|
|
13
12
|
import Select from '../select';
|
|
14
13
|
import { defaultComponents, DummyControl, MenuDialog } from './components';
|
|
15
14
|
import { NotifyOpenLayerObserver } from './notify-open-layer-observer';
|
|
@@ -60,7 +59,7 @@ export default class PopupSelect extends PureComponent {
|
|
|
60
59
|
_defineProperty(this, "defaultStyles", {
|
|
61
60
|
groupHeading: provided => ({
|
|
62
61
|
...provided,
|
|
63
|
-
color:
|
|
62
|
+
color: "var(--ds-text-subtlest, #6B6E76)"
|
|
64
63
|
})
|
|
65
64
|
});
|
|
66
65
|
_defineProperty(this, "isOpenControlled", this.props.isOpen !== undefined);
|
package/dist/es2019/select.js
CHANGED
|
@@ -3,7 +3,7 @@ import { createAndFireEvent, withAnalyticsContext, withAnalyticsEvents } from '@
|
|
|
3
3
|
import AsyncSelect from '@atlaskit/react-select/async';
|
|
4
4
|
import createSelect from './create-select';
|
|
5
5
|
const packageName = "@atlaskit/select";
|
|
6
|
-
const packageVersion = "21.8.
|
|
6
|
+
const packageVersion = "21.8.4";
|
|
7
7
|
export const SelectWithoutAnalytics = createSelect(AsyncSelect);
|
|
8
8
|
const createAndFireEventOnAtlaskit = createAndFireEvent('atlaskit');
|
|
9
9
|
const Select = withAnalyticsContext({
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
|
|
2
2
|
._2rko12b0{border-radius:var(--ds-radius-small,4px)}
|
|
3
3
|
._2rko1mok{border-radius:var(--ds-radius-large,8px)}._12l2v77o{margin-inline-end:var(--ds-space-025,2px)}
|
|
4
|
-
.
|
|
4
|
+
._16qs130s{box-shadow:var(--ds-shadow-overlay,0 8px 9pt #1e1f2126,0 0 1px #1e1f214f)}
|
|
5
5
|
._1bsbzwfg{width:2pc}
|
|
6
6
|
._1pby16oo{z-index:510}
|
|
7
7
|
._1q51u2gc{padding-block-start:var(--ds-space-100,8px)}
|
|
@@ -1,18 +1,14 @@
|
|
|
1
1
|
/* components.tsx generated by @compiled/babel-plugin v0.39.1 */
|
|
2
2
|
import _extends from "@babel/runtime/helpers/extends";
|
|
3
3
|
import _objectWithoutProperties from "@babel/runtime/helpers/objectWithoutProperties";
|
|
4
|
-
import _defineProperty from "@babel/runtime/helpers/defineProperty";
|
|
5
4
|
var _excluded = ["innerRef", "innerProps"];
|
|
6
5
|
import "./components.compiled.css";
|
|
7
6
|
import * as React from 'react';
|
|
8
7
|
import { ax, ix } from "@compiled/react/runtime";
|
|
9
|
-
function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
|
|
10
|
-
function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
|
|
11
8
|
import { forwardRef } from 'react';
|
|
12
9
|
import SearchIcon from '@atlaskit/icon/core/search';
|
|
13
10
|
import { fg } from '@atlaskit/platform-feature-flags';
|
|
14
11
|
import { components } from '@atlaskit/react-select';
|
|
15
|
-
import { N40A } from '@atlaskit/theme/colors';
|
|
16
12
|
import { layers } from '@atlaskit/theme/constants';
|
|
17
13
|
import VisuallyHidden from '@atlaskit/visually-hidden';
|
|
18
14
|
|
|
@@ -34,12 +30,10 @@ export var MenuDialog = /*#__PURE__*/forwardRef(function (_ref, ref) {
|
|
|
34
30
|
testId = _ref.testId;
|
|
35
31
|
return /*#__PURE__*/React.createElement("div", {
|
|
36
32
|
ref: ref,
|
|
33
|
+
style: style,
|
|
37
34
|
id: id,
|
|
38
35
|
"data-testid": testId && "".concat(testId, "--menu"),
|
|
39
|
-
className: ax(["_2rko12b0 _1pby16oo _bfhk1bhr
|
|
40
|
-
style: _objectSpread(_objectSpread({}, style), {}, {
|
|
41
|
-
"--_z6sjud": ix("var(--ds-shadow-overlay, ".concat("0 0 0 1px ".concat(N40A, ", 0 4px 11px ").concat(N40A), ")"))
|
|
42
|
-
})
|
|
36
|
+
className: ax(["_2rko12b0 _1pby16oo _bfhk1bhr _16qs130s", fg('platform-dst-shape-theme-default') && "_2rko1mok"])
|
|
43
37
|
}, children);
|
|
44
38
|
});
|
|
45
39
|
|
|
@@ -20,7 +20,6 @@ import { shallowEqualObjects } from 'shallow-equal';
|
|
|
20
20
|
import { IdProvider } from '@atlaskit/ds-lib/use-id';
|
|
21
21
|
import { fg } from '@atlaskit/platform-feature-flags';
|
|
22
22
|
import { mergeStyles } from '@atlaskit/react-select';
|
|
23
|
-
import { N80 } from '@atlaskit/theme/colors';
|
|
24
23
|
import Select from '../select';
|
|
25
24
|
import { defaultComponents, DummyControl, MenuDialog } from './components';
|
|
26
25
|
import { NotifyOpenLayerObserver } from './notify-open-layer-observer';
|
|
@@ -80,7 +79,7 @@ var PopupSelect = /*#__PURE__*/function (_PureComponent) {
|
|
|
80
79
|
_defineProperty(_this, "defaultStyles", {
|
|
81
80
|
groupHeading: function groupHeading(provided) {
|
|
82
81
|
return _objectSpread(_objectSpread({}, provided), {}, {
|
|
83
|
-
color: "var(--ds-text-subtlest,
|
|
82
|
+
color: "var(--ds-text-subtlest, #6B6E76)"
|
|
84
83
|
});
|
|
85
84
|
}
|
|
86
85
|
});
|
package/dist/esm/select.js
CHANGED
|
@@ -3,7 +3,7 @@ import { createAndFireEvent, withAnalyticsContext, withAnalyticsEvents } from '@
|
|
|
3
3
|
import AsyncSelect from '@atlaskit/react-select/async';
|
|
4
4
|
import createSelect from './create-select';
|
|
5
5
|
var packageName = "@atlaskit/select";
|
|
6
|
-
var packageVersion = "21.8.
|
|
6
|
+
var packageVersion = "21.8.4";
|
|
7
7
|
export var SelectWithoutAnalytics = createSelect(AsyncSelect);
|
|
8
8
|
var createAndFireEventOnAtlaskit = createAndFireEvent('atlaskit');
|
|
9
9
|
var Select = withAnalyticsContext({
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@atlaskit/select",
|
|
3
|
-
"version": "21.8.
|
|
3
|
+
"version": "21.8.4",
|
|
4
4
|
"description": "Select allows users to make a single selection or multiple selections from a list of options.",
|
|
5
5
|
"publishConfig": {
|
|
6
6
|
"registry": "https://registry.npmjs.org/"
|
|
@@ -32,15 +32,15 @@
|
|
|
32
32
|
}
|
|
33
33
|
},
|
|
34
34
|
"dependencies": {
|
|
35
|
-
"@atlaskit/analytics-next": "^11.
|
|
35
|
+
"@atlaskit/analytics-next": "^11.2.0",
|
|
36
36
|
"@atlaskit/ds-lib": "^6.0.0",
|
|
37
|
-
"@atlaskit/icon": "^33.
|
|
37
|
+
"@atlaskit/icon": "^33.1.0",
|
|
38
38
|
"@atlaskit/layering": "^3.6.0",
|
|
39
39
|
"@atlaskit/platform-feature-flags": "^1.1.0",
|
|
40
|
-
"@atlaskit/primitives": "^18.
|
|
40
|
+
"@atlaskit/primitives": "^18.1.0",
|
|
41
41
|
"@atlaskit/react-select": "^3.14.0",
|
|
42
42
|
"@atlaskit/theme": "^22.0.0",
|
|
43
|
-
"@atlaskit/tokens": "^11.
|
|
43
|
+
"@atlaskit/tokens": "^11.4.0",
|
|
44
44
|
"@atlaskit/visually-hidden": "^3.0.0",
|
|
45
45
|
"@babel/runtime": "^7.0.0",
|
|
46
46
|
"@compiled/react": "^0.20.0",
|
|
@@ -62,10 +62,10 @@
|
|
|
62
62
|
"@atlaskit/checkbox": "^17.3.0",
|
|
63
63
|
"@atlaskit/docs": "^11.7.0",
|
|
64
64
|
"@atlaskit/drawer": "^12.0.0",
|
|
65
|
-
"@atlaskit/form": "^15.
|
|
65
|
+
"@atlaskit/form": "^15.5.0",
|
|
66
66
|
"@atlaskit/link": "^3.3.0",
|
|
67
67
|
"@atlaskit/logo": "^19.10.0",
|
|
68
|
-
"@atlaskit/modal-dialog": "^14.
|
|
68
|
+
"@atlaskit/modal-dialog": "^14.13.0",
|
|
69
69
|
"@atlaskit/radio": "^8.4.0",
|
|
70
70
|
"@atlaskit/section-message": "^8.12.0",
|
|
71
71
|
"@atlassian/feature-flags-test-utils": "^1.0.0",
|
package/select.docs.tsx
CHANGED
|
@@ -5,7 +5,8 @@ import type { ComponentStructuredContentSource } from '@atlassian/structured-doc
|
|
|
5
5
|
const documentation: ComponentStructuredContentSource[] = [
|
|
6
6
|
{
|
|
7
7
|
name: 'Select',
|
|
8
|
-
description:
|
|
8
|
+
description:
|
|
9
|
+
'Select allows users to make a single selection or multiple selections from a list of options.',
|
|
9
10
|
status: 'general-availability',
|
|
10
11
|
import: {
|
|
11
12
|
name: 'Select',
|
|
@@ -46,6 +47,157 @@ const documentation: ComponentStructuredContentSource[] = [
|
|
|
46
47
|
keywords: ['select', 'dropdown', 'form', 'input', 'options', 'choice', 'picker'],
|
|
47
48
|
categories: ['form'],
|
|
48
49
|
},
|
|
50
|
+
{
|
|
51
|
+
name: 'AsyncSelect',
|
|
52
|
+
description:
|
|
53
|
+
'A select component that loads options asynchronously. Use when options are fetched from an API or loaded on demand.',
|
|
54
|
+
status: 'general-availability',
|
|
55
|
+
import: {
|
|
56
|
+
name: 'AsyncSelect',
|
|
57
|
+
package: '@atlaskit/select',
|
|
58
|
+
type: 'named',
|
|
59
|
+
packagePath: path.resolve(__dirname),
|
|
60
|
+
packageJson: require('./package.json'),
|
|
61
|
+
},
|
|
62
|
+
usageGuidelines: [
|
|
63
|
+
'Use for options loaded from API or async data',
|
|
64
|
+
'Provide clear loading states while fetching',
|
|
65
|
+
'Cache options when users search repeatedly',
|
|
66
|
+
],
|
|
67
|
+
examples: [
|
|
68
|
+
{
|
|
69
|
+
name: 'Async select',
|
|
70
|
+
description: 'Async select with loadOptions for remote or deferred options.',
|
|
71
|
+
source: path.resolve(__dirname, './examples/constellation/select-async.tsx'),
|
|
72
|
+
},
|
|
73
|
+
],
|
|
74
|
+
keywords: ['select', 'async', 'dropdown', 'form', 'api'],
|
|
75
|
+
categories: ['form'],
|
|
76
|
+
},
|
|
77
|
+
{
|
|
78
|
+
name: 'CreatableSelect',
|
|
79
|
+
description:
|
|
80
|
+
'A select that allows users to create new options. Use when users can add custom values not in the predefined list.',
|
|
81
|
+
status: 'general-availability',
|
|
82
|
+
import: {
|
|
83
|
+
name: 'CreatableSelect',
|
|
84
|
+
package: '@atlaskit/select',
|
|
85
|
+
type: 'named',
|
|
86
|
+
packagePath: path.resolve(__dirname),
|
|
87
|
+
packageJson: require('./package.json'),
|
|
88
|
+
},
|
|
89
|
+
usageGuidelines: [
|
|
90
|
+
'Use when users need to add custom options',
|
|
91
|
+
'Validate new values before creation',
|
|
92
|
+
],
|
|
93
|
+
examples: [
|
|
94
|
+
{
|
|
95
|
+
name: 'Creatable select',
|
|
96
|
+
description: 'Creatable select for adding options not in the list.',
|
|
97
|
+
source: path.resolve(__dirname, './examples/constellation/select-creatable.tsx'),
|
|
98
|
+
},
|
|
99
|
+
],
|
|
100
|
+
keywords: ['select', 'creatable', 'dropdown', 'form', 'custom'],
|
|
101
|
+
categories: ['form'],
|
|
102
|
+
},
|
|
103
|
+
{
|
|
104
|
+
name: 'PopupSelect',
|
|
105
|
+
description:
|
|
106
|
+
'A select that opens in a popup overlay. Use when the select needs to render in a portal or overlay context.',
|
|
107
|
+
status: 'general-availability',
|
|
108
|
+
import: {
|
|
109
|
+
name: 'PopupSelect',
|
|
110
|
+
package: '@atlaskit/select',
|
|
111
|
+
type: 'named',
|
|
112
|
+
packagePath: path.resolve(__dirname),
|
|
113
|
+
packageJson: require('./package.json'),
|
|
114
|
+
},
|
|
115
|
+
usageGuidelines: [
|
|
116
|
+
'Use when select must render in overlay/portal',
|
|
117
|
+
'Consider z-index and layering with modals',
|
|
118
|
+
'Ensure proper focus management',
|
|
119
|
+
],
|
|
120
|
+
examples: [
|
|
121
|
+
{
|
|
122
|
+
name: 'Popup select',
|
|
123
|
+
description: 'Popup select with filterable options in an overlay.',
|
|
124
|
+
source: path.resolve(__dirname, './examples/constellation/select-popup.tsx'),
|
|
125
|
+
},
|
|
126
|
+
],
|
|
127
|
+
keywords: ['select', 'popup', 'dropdown', 'overlay', 'portal'],
|
|
128
|
+
categories: ['form'],
|
|
129
|
+
},
|
|
130
|
+
{
|
|
131
|
+
name: 'CheckboxSelect',
|
|
132
|
+
description:
|
|
133
|
+
'A multi-select with checkbox indicators for each option. Use when multiple selections need explicit visual confirmation.',
|
|
134
|
+
status: 'general-availability',
|
|
135
|
+
import: {
|
|
136
|
+
name: 'CheckboxSelect',
|
|
137
|
+
package: '@atlaskit/select',
|
|
138
|
+
type: 'named',
|
|
139
|
+
packagePath: path.resolve(__dirname),
|
|
140
|
+
packageJson: require('./package.json'),
|
|
141
|
+
},
|
|
142
|
+
usageGuidelines: ['Use for multi-select when checkbox affordance improves clarity'],
|
|
143
|
+
examples: [
|
|
144
|
+
{
|
|
145
|
+
name: 'Checkbox select',
|
|
146
|
+
description: 'Multi-select with checkbox indicators per option.',
|
|
147
|
+
source: path.resolve(__dirname, './examples/constellation/select-checkbox.tsx'),
|
|
148
|
+
},
|
|
149
|
+
],
|
|
150
|
+
keywords: ['select', 'checkbox', 'multi', 'dropdown', 'form'],
|
|
151
|
+
categories: ['form'],
|
|
152
|
+
},
|
|
153
|
+
{
|
|
154
|
+
name: 'RadioSelect',
|
|
155
|
+
description:
|
|
156
|
+
'A single-select with radio indicators for each option. Use when radio-style selection affordance is needed.',
|
|
157
|
+
status: 'general-availability',
|
|
158
|
+
import: {
|
|
159
|
+
name: 'RadioSelect',
|
|
160
|
+
package: '@atlaskit/select',
|
|
161
|
+
type: 'named',
|
|
162
|
+
packagePath: path.resolve(__dirname),
|
|
163
|
+
packageJson: require('./package.json'),
|
|
164
|
+
},
|
|
165
|
+
usageGuidelines: ['Use for single-select when radio affordance improves clarity'],
|
|
166
|
+
examples: [
|
|
167
|
+
{
|
|
168
|
+
name: 'Radio select',
|
|
169
|
+
description: 'Single-select with radio indicators per option.',
|
|
170
|
+
source: path.resolve(__dirname, './examples/constellation/select-radio.tsx'),
|
|
171
|
+
},
|
|
172
|
+
],
|
|
173
|
+
keywords: ['select', 'radio', 'single', 'dropdown', 'form'],
|
|
174
|
+
categories: ['form'],
|
|
175
|
+
},
|
|
176
|
+
{
|
|
177
|
+
name: 'CountrySelect',
|
|
178
|
+
description: 'A select pre-configured for country selection with country data.',
|
|
179
|
+
status: 'general-availability',
|
|
180
|
+
import: {
|
|
181
|
+
name: 'CountrySelect',
|
|
182
|
+
package: '@atlaskit/select',
|
|
183
|
+
type: 'named',
|
|
184
|
+
packagePath: path.resolve(__dirname),
|
|
185
|
+
packageJson: require('./package.json'),
|
|
186
|
+
},
|
|
187
|
+
usageGuidelines: [
|
|
188
|
+
'Use for country selection in forms',
|
|
189
|
+
'Provides built-in country options and search',
|
|
190
|
+
],
|
|
191
|
+
examples: [
|
|
192
|
+
{
|
|
193
|
+
name: 'Country select',
|
|
194
|
+
description: 'Country select with built-in country list and search.',
|
|
195
|
+
source: path.resolve(__dirname, './examples/constellation/select-country.tsx'),
|
|
196
|
+
},
|
|
197
|
+
],
|
|
198
|
+
keywords: ['select', 'country', 'dropdown', 'form', 'localization'],
|
|
199
|
+
categories: ['form'],
|
|
200
|
+
},
|
|
49
201
|
];
|
|
50
202
|
|
|
51
203
|
export default documentation;
|