@esri/calcite-components-react 5.0.0-next.9 → 5.0.0
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/LICENSE.md +1 -1
- package/README.md +16 -13
- package/{THIRD-PARTY-LICENSES.md → THIRD-PARTY-NOTICES.md} +27 -1
- package/dist/components.d.ts +210 -108
- package/dist/components.js +105 -1
- package/package.json +6 -6
package/LICENSE.md
CHANGED
package/README.md
CHANGED
|
@@ -2,6 +2,15 @@
|
|
|
2
2
|
|
|
3
3
|
This package provides React wrappers for [Calcite components](https://developers.arcgis.com/calcite-design-system/components/). Refer to the [React example](https://github.com/Esri/calcite-design-system/tree/dev/examples/components/react) for a minimal application using this package.
|
|
4
4
|
|
|
5
|
+
## Deprecation Notice
|
|
6
|
+
|
|
7
|
+
> [!WARNING]
|
|
8
|
+
> Calcite Components React is deprecated in v5.0.0 and will be removed in v6.0.0.
|
|
9
|
+
|
|
10
|
+
The `@esri/calcite-components-react` package was originally developed for use with React 18 where wrappers were necessary to use custom elements. With React 19's custom element support, these wrappers are no longer needed.
|
|
11
|
+
|
|
12
|
+
Consider upgrading to React 19+ and using <code>@esri/calcite-components</code> directly.
|
|
13
|
+
|
|
5
14
|
## Installation
|
|
6
15
|
|
|
7
16
|
```sh
|
|
@@ -49,25 +58,19 @@ Since you manually defined the custom elements on the window, you only need to i
|
|
|
49
58
|
import { CalciteButton, CalciteIcon, CalciteSlider } from "@esri/calcite-components-react";
|
|
50
59
|
```
|
|
51
60
|
|
|
52
|
-
## Import stylesheet
|
|
53
|
-
|
|
54
|
-
Import the global stylesheet into your app (only do this once):
|
|
55
|
-
|
|
56
|
-
```js
|
|
57
|
-
import "@esri/calcite-components/dist/calcite/calcite.css";
|
|
58
|
-
```
|
|
59
|
-
|
|
60
61
|
## Copy Assets
|
|
61
62
|
|
|
62
63
|
Some components (icon, date-picker) rely on assets being available at a particular path. If using assets locally, you'll need to copy these over to your public folder. Something like:
|
|
63
64
|
|
|
64
65
|
```sh
|
|
65
|
-
cp -r node_modules/@esri/calcite-components/dist/
|
|
66
|
+
cp -r node_modules/@esri/calcite-components/dist/cdn/assets/* ./public/assets/
|
|
66
67
|
```
|
|
67
68
|
|
|
68
69
|
## Why not just use the web components directly?
|
|
69
70
|
|
|
70
|
-
|
|
71
|
+
With React 19+'s native support for custom elements, you can now use <code>@esri/calcite-components</code> directly. See the [Calcite Components React Deprecation Notice](#deprecation-notice) for additional information.
|
|
72
|
+
|
|
73
|
+
Because React 18 and earlier versions use a synthetic event system, the custom events emitted from Calcite Components won't work with JSX in React. For example, if you are using standard web components to update a value when the `calcite-slider` component changes, you need to save a ref to the element and add a listener:
|
|
71
74
|
|
|
72
75
|
```jsx
|
|
73
76
|
const sliderEl = useRef(null);
|
|
@@ -102,7 +105,7 @@ We welcome contributions to this project. See the [CONTRIBUTING.md](https://gith
|
|
|
102
105
|
|
|
103
106
|
## License
|
|
104
107
|
|
|
105
|
-
COPYRIGHT
|
|
108
|
+
COPYRIGHT Esri - <https://js.arcgis.com/5.0/LICENSE.txt>
|
|
106
109
|
|
|
107
110
|
All rights reserved under the copyright laws of the United States and applicable international laws, treaties, and conventions.
|
|
108
111
|
|
|
@@ -114,6 +117,6 @@ For additional information, refer to [Calcite's licensing](https://developers.ar
|
|
|
114
117
|
|
|
115
118
|
email: <contracts@esri.com>
|
|
116
119
|
|
|
117
|
-
## Third-party
|
|
120
|
+
## Third-party notices
|
|
118
121
|
|
|
119
|
-
See [THIRD-PARTY-
|
|
122
|
+
See [THIRD-PARTY-NOTICES.md](./THIRD-PARTY-NOTICES.md).
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
## Third Party
|
|
1
|
+
## Third Party Notices
|
|
2
2
|
|
|
3
3
|
@floating-ui/core
|
|
4
4
|
@floating-ui/dom
|
|
@@ -353,6 +353,32 @@ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
|
353
353
|
|
|
354
354
|
---
|
|
355
355
|
|
|
356
|
+
scheduler
|
|
357
|
+
|
|
358
|
+
MIT License
|
|
359
|
+
|
|
360
|
+
Copyright (c) Meta Platforms, Inc. and affiliates.
|
|
361
|
+
|
|
362
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
363
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
364
|
+
in the Software without restriction, including without limitation the rights
|
|
365
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
366
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
367
|
+
furnished to do so, subject to the following conditions:
|
|
368
|
+
|
|
369
|
+
The above copyright notice and this permission notice shall be included in all
|
|
370
|
+
copies or substantial portions of the Software.
|
|
371
|
+
|
|
372
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
373
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
374
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
375
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
376
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
377
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
378
|
+
SOFTWARE.
|
|
379
|
+
|
|
380
|
+
---
|
|
381
|
+
|
|
356
382
|
sortablejs
|
|
357
383
|
|
|
358
384
|
MIT License
|