@stackline/angular-multiselect-dropdown 21.2.0 → 21.2.1
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 +14 -11
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -3,16 +3,19 @@
|
|
|
3
3
|
> A maintained Angular multiselect dropdown for classic Angular forms workflows, with search, grouping, custom item and badge templates, lazy loading, custom CSS/SCSS theming, accessibility-focused and keyboard/ARIA tested support, and support for both template-driven and reactive forms.
|
|
4
4
|
|
|
5
5
|
[](https://www.npmjs.com/package/@stackline/angular-multiselect-dropdown)
|
|
6
|
-
[](https://www.npmjs.com/package/@stackline/angular-multiselect-dropdown)
|
|
7
6
|
[](https://www.npmjs.com/package/@stackline/angular-multiselect-dropdown)
|
|
8
7
|
[](https://github.com/alexandroit/angular-multiselect-dropdown/blob/master/LICENSE)
|
|
9
8
|
[](https://alexandro.net/docs/angular/multiselect/angular-21/)
|
|
10
9
|
[](https://www.typescriptlang.org)
|
|
11
|
-
[](https://www.reddit.com/r/Stackline/)
|
|
12
11
|
|
|
13
|
-
**[Documentation & Live Demos](https://alexandro.net/docs/angular/multiselect/)** | **[Angular 21 Demo](https://alexandro.net/docs/angular/multiselect/angular-21/)** | **[StackBlitz Playground](https://stackblitz.com/github/alexandroit/stackline-angular-multiselect-angular-21?startScript=start&initialpath=%2Fbasic)** | **[npm](https://www.npmjs.com/package/@stackline/angular-multiselect-dropdown)** | **[Issues](https://github.com/alexandroit/angular-multiselect-dropdown/issues)** | **[Repository](https://github.com/alexandroit/angular-multiselect-dropdown)**
|
|
12
|
+
**[Documentation & Live Demos](https://alexandro.net/docs/angular/multiselect/)** | **[Angular 21 Demo](https://alexandro.net/docs/angular/multiselect/angular-21/)** | **[StackBlitz Playground](https://stackblitz.com/github/alexandroit/stackline-angular-multiselect-angular-21?startScript=start&initialpath=%2Fbasic)** | **[npm](https://www.npmjs.com/package/@stackline/angular-multiselect-dropdown)** | **[Issues](https://github.com/alexandroit/angular-multiselect-dropdown/issues)** | **[Repository](https://github.com/alexandroit/angular-multiselect-dropdown)** | **[Community Discussions](https://www.reddit.com/r/Stackline/)**
|
|
14
13
|
|
|
15
|
-
|
|
14
|
+
<p align="center">
|
|
15
|
+
<img src="https://alexandro.net/images/public/2026/06/dropdownlist.gif" alt="@stackline/angular-multiselect-dropdown live dropdown preview" width="420">
|
|
16
|
+
</p>
|
|
17
|
+
|
|
18
|
+
**Latest tested package release:** `21.2.1` for Angular `21.x`
|
|
16
19
|
|
|
17
20
|
---
|
|
18
21
|
|
|
@@ -24,9 +27,9 @@
|
|
|
24
27
|
|
|
25
28
|
The original `angular2-multiselect-dropdown` package became difficult to keep current across multiple Angular generations. This maintained package keeps the classic API and template structure intact, introduces the new primary selector `<angular-multiselect>`, preserves the legacy alias `<angular2-multiselect>`, and publishes the project line by line so older applications can keep a predictable upgrade path.
|
|
26
29
|
|
|
27
|
-
The repository contains the full documentation matrix from Angular 2 through Angular 21. The current tested package release is `21.2.
|
|
30
|
+
The repository contains the full documentation matrix from Angular 2 through Angular 21. The current tested package release is `21.2.1` for Angular 21.x applications.
|
|
28
31
|
|
|
29
|
-
The Angular 21 package is compatible with Angular 21.x and was tested in a real Angular 21.2.14 application before npm publication. The 21.2.
|
|
32
|
+
The Angular 21 package is compatible with Angular 21.x and was tested in a real Angular 21.2.14 application before npm publication. The 21.2.x line includes accessibility-focused keyboard navigation, focus handling, and ARIA support for the dropdown trigger, clear-all action, selected chips, listbox, and lazy-loaded results. It ports the React 19.1.x combobox contract into Angular patterns: configurable keyboard behavior, matching `aria-selected` plus `aria-checked`, selected-object preservation across async data refreshes, richer template contexts, and renderless state helpers for custom Angular HTML.
|
|
30
33
|
|
|
31
34
|
## Features
|
|
32
35
|
|
|
@@ -84,7 +87,7 @@ Peer ranges are intentionally bounded to the tested Angular major. The Angular 2
|
|
|
84
87
|
|
|
85
88
|
| Package family | Framework family | Peer range | Tested release window | Demo link |
|
|
86
89
|
| :---: | :---: | :---: | :---: | :--- |
|
|
87
|
-
| **21.x** | **Angular 21 only** | **`>=21.0.0 <22.0.0`** | **21.2.
|
|
90
|
+
| **21.x** | **Angular 21 only** | **`>=21.0.0 <22.0.0`** | **21.2.1 -> 21.2.14** | [Angular 21 family docs](https://alexandro.net/docs/angular/multiselect/angular-21/) |
|
|
88
91
|
| **20.x** | **Angular 20 only** | **`>=20.0.0 <21.0.0`** | **20.0.1 -> 20.3.21** | [Angular 20 family docs](https://alexandro.net/docs/angular/multiselect/angular-20/) |
|
|
89
92
|
| **19.x** | **Angular 19 only** | **`>=19.0.0 <20.0.0`** | **19.0.1 -> 19.2.22** | [Angular 19 family docs](https://alexandro.net/docs/angular/multiselect/angular-19/) |
|
|
90
93
|
| **18.x** | **Angular 18 only** | **`>=18.0.0 <19.0.0`** | **18.0.1 -> 18.2.14** | [Angular 18 family docs](https://alexandro.net/docs/angular/multiselect/angular-18/) |
|
|
@@ -138,10 +141,10 @@ The editable StackBlitz entry is one Angular 21 playground with isolated lazy ro
|
|
|
138
141
|
## Installation
|
|
139
142
|
|
|
140
143
|
```bash
|
|
141
|
-
npm install @stackline/angular-multiselect-dropdown@21.2.
|
|
144
|
+
npm install @stackline/angular-multiselect-dropdown@21.2.1 --save-exact
|
|
142
145
|
```
|
|
143
146
|
|
|
144
|
-
Install `21.2.
|
|
147
|
+
Install `21.2.1` for Angular 21.x applications. This line keeps the tested Angular 21 behavior, makes `<angular-multiselect>` the documented standard selector, keeps `<angular2-multiselect>` only as a legacy compatibility alias, adds the accessibility-focused and keyboard/ARIA tested interaction contract, fixes responsive dropdown width handling, preserves selected objects during async refreshes, and keeps dropdown surfaces opaque in clipped containers.
|
|
145
148
|
|
|
146
149
|
## Setup
|
|
147
150
|
|
|
@@ -237,7 +240,7 @@ dropdownSettings = {
|
|
|
237
240
|
|
|
238
241
|
## Official Angular 21 Test Matrix
|
|
239
242
|
|
|
240
|
-
The published Angular 21 release was tested in a real Angular `21.2.14` application with `@stackline/angular-multiselect-dropdown@21.2.
|
|
243
|
+
The published Angular 21 release was tested in a real Angular `21.2.14` application with `@stackline/angular-multiselect-dropdown@21.2.1`. The docs now use the same examples from that test app, including the accessibility-focused keyboard, focus, and ARIA behavior, responsive dropdown width handling, opaque menu surfaces, and dialog-safe positioning added in this release line.
|
|
241
244
|
|
|
242
245
|
Switch between skins through the settings object:
|
|
243
246
|
|
|
@@ -420,7 +423,7 @@ settings = {
|
|
|
420
423
|
};
|
|
421
424
|
```
|
|
422
425
|
|
|
423
|
-
In `21.2.
|
|
426
|
+
In the `21.2.x` line, `tagToBody: true` renders the open panel outside clipping containers, keeps it aligned to the original trigger, keeps the menu surface opaque, recalculates position on scroll and resize, and cleans it up on close or destroy. `appendToBody: true` is also accepted as an alias for teams that prefer that name.
|
|
424
427
|
|
|
425
428
|
## Events
|
|
426
429
|
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "../../../node_modules/ng-packagr/package.schema.json",
|
|
3
3
|
"name": "@stackline/angular-multiselect-dropdown",
|
|
4
|
-
"version": "21.2.
|
|
4
|
+
"version": "21.2.1",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"author": "Pradeep Terli (Original), Alexandro Paixao Marques (Maintainer)",
|
|
7
7
|
"description": "Angular multiselect dropdown for Angular 21 with maintained release lines, accessibility-focused and keyboard/ARIA tested interactions, dialog-safe body overlays, Stackline skins, search, grouping, templates, headless helpers, and forms support.",
|