@esri/calcite-components-react 5.0.0-next.62 → 5.0.0-next.64
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/README.md +12 -1
- package/package.json +3 -3
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
|
|
@@ -59,7 +68,9 @@ cp -r node_modules/@esri/calcite-components/dist/cdn/assets/* ./public/assets/
|
|
|
59
68
|
|
|
60
69
|
## Why not just use the web components directly?
|
|
61
70
|
|
|
62
|
-
|
|
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:
|
|
63
74
|
|
|
64
75
|
```jsx
|
|
65
76
|
const sliderEl = useRef(null);
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@esri/calcite-components-react",
|
|
3
|
-
"version": "5.0.0-next.
|
|
3
|
+
"version": "5.0.0-next.64",
|
|
4
4
|
"description": "A set of React components that wrap calcite components",
|
|
5
5
|
"homepage": "https://developers.arcgis.com/calcite-design-system/",
|
|
6
6
|
"repository": {
|
|
@@ -29,7 +29,7 @@
|
|
|
29
29
|
},
|
|
30
30
|
"dependencies": {
|
|
31
31
|
"@arcgis/lumina": ">=5.0.0-next.75 <6.0.0",
|
|
32
|
-
"@esri/calcite-components": "5.0.0-next.
|
|
32
|
+
"@esri/calcite-components": "5.0.0-next.64",
|
|
33
33
|
"@lit/react": "^1.0.8",
|
|
34
34
|
"lit": "^3.3.0"
|
|
35
35
|
},
|
|
@@ -40,5 +40,5 @@
|
|
|
40
40
|
"volta": {
|
|
41
41
|
"extends": "../../package.json"
|
|
42
42
|
},
|
|
43
|
-
"gitHead": "
|
|
43
|
+
"gitHead": "66c1959209a5cab94b190facf8a25410a8cf1ac2"
|
|
44
44
|
}
|