Skip to content

Commit 51bab3f

Browse files
authored
docs(changelog): update touch gesture instructions for Angular 22 and… (#17350)
* docs(changelog): update touch gesture instructions for Angular 22 and HammerJS integration * docs(setup): fix formatting for touch gestures installation instructions
1 parent aaa9ba9 commit 51bab3f

3 files changed

Lines changed: 29 additions & 2 deletions

File tree

CHANGELOG.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -72,6 +72,16 @@ All notable changes for each version of this project will be documented in this
7272

7373
### General
7474

75+
- **Touch Gestures (HammerJS)** _(optional)_
76+
- `HammerModule`, previously exported from `@angular/platform-browser`, is no longer available in Angular 22. Touch gesture support (Slider, Drag & Drop, Carousel swipe, Navigation Drawer) is optional. To enable it, install the `hammerjs` package and add it to the `scripts` array in your project's `angular.json`:
77+
```bash
78+
npm install hammerjs
79+
```
80+
```json
81+
// angular.json — inside your project's architect.build.options
82+
"scripts": ["./node_modules/hammerjs/hammer.min.js"]
83+
```
84+
7585
- `IgxSelectComponent`
7686
- The default positioning strategy has changed from the internal overlap strategy to `AutoPositionStrategy`. The dropdown now opens below (or above, if there is not enough space) the input element, consistent with other connected components.
7787
- Added `IgxSelectOverlapPositionStrategy` - a new publicly exported strategy that preserves the previous behavior of aligning the selected item's text over the input text. To opt into the previous overlap behavior:

skills/igniteui-angular-components/references/directives.md

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -254,7 +254,14 @@ onDrop(event: IDropDroppedEventArgs) {
254254
Key drag events: `(dragStart)`, `(dragMove)`, `(dragEnd)`, `(dragClick)`, `(ghostCreate)`, `(ghostDestroy)`, `(transitioned)`.
255255
Key drop events: `(enter)`, `(leave)`, `(over)`, `(dropped)`.
256256

257-
> **NOTE:** For touch-based drag, add `importProvidersFrom(HammerModule)` to `app.config.ts` providers.
257+
> **NOTE (optional):** For touch-based drag, install `hammerjs` and add it to the `scripts` array in `angular.json`.
258+
> ```bash
259+
> npm install hammerjs
260+
> ```
261+
> ```json
262+
> // angular.json — inside your project's architect.build.options
263+
> "scripts": ["./node_modules/hammerjs/hammer.min.js"]
264+
> ```
258265
259266
## See Also
260267

skills/igniteui-angular-components/references/setup.md

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,17 @@ export const appConfig: ApplicationConfig = {
4343
| Provider | Package | Required for |
4444
|---|---|---|
4545
| `provideAnimations()` | `@angular/platform-browser/animations` | **All overlay and animated components** — Dialog, Combo, Select, Dropdown, Date/Time Picker, Snackbar, Toast, Banner, Navigation Drawer, Carousel, Overlay service |
46-
| `importProvidersFrom(HammerModule)` | `@angular/platform-browser` | OPTIONAL — touch gestures (Slider, Drag & Drop, swipe) |
46+
47+
> **Touch gestures** (Optional) (Slider, Drag & Drop, swipe) - To enable touch gesture support, install the `hammerjs` package and add it to the `scripts` array in your `angular.json`:
48+
>
49+
> ```bash
50+
> npm install hammerjs
51+
> ```
52+
>
53+
> ```json
54+
> // angular.json — inside your project's architect.build.options
55+
> "scripts": ["./node_modules/hammerjs/hammer.min.js"]
56+
> ```
4757
4858
> **`provideAnimationsAsync()`** lazy-loads the animations module — prefer it for SSR or when optimizing initial bundle size:
4959
> ```typescript

0 commit comments

Comments
 (0)