WML Options
The wml-options library is an Angular-based toolkit designed to enhance the selection and management of options within applications. Its primary objective is to provide a streamlined and efficient way for developers to integrate and manage multiple choice selections, toggles, and option-related actions in their Angular projects. The library offers a set of components and services that enable the display and interaction with various types of options, supporting both default and custom components for dynamic and interactive content.
Key features of the wml-options library include:
- Customizable option items with dynamic content.
- Support for reactive forms, allowing easy integration with Angular’s form system.
- Ability to handle a large number of options efficiently.
- Customizable appearance through CSS and SCSS.
- Modular and flexible design, facilitating independent or combined usage of components.
Installation
Section titled “Installation”npm install --verbose @windmillcode/angular-wml-optionsWMLOptionsZero
Section titled “WMLOptionsZero”Getting Started
Section titled “Getting Started”Displaying a List of Options
Section titled “Displaying a List of Options”Custom Option Content
Section titled “Custom Option Content”Handling Option Selection
Section titled “Handling Option Selection”Default Values
Section titled “Default Values”IMPORTANT WMLOptionZeroItemProps.isChosen is the only way to set default values on options!!!
Reference
Section titled “Reference”WMLOptionsZeroProps Properties
Section titled “WMLOptionsZeroProps Properties”| Property | Type | Description |
|---|---|---|
hasBeenInitalized | boolean | Indicates if the component has been initialized. |
chosen | WMLOptionsZeroProps["options"][] | The list of chosen options. |
options | WMLOptionZeroItemProps[] | The list of available options. |
limit | number | Maximum number of selectable options. |
wmlField | WMLFieldZeroProps | The associated WML field for reactive form integration. |
formArray | FormArray | The form array for managing selected options. |
listenForClearedFormIsEnabled | boolean | Enables listening for form clear events. |
updateFormArrayPredicate | (val: any) => any | Predicate function to update the form array. |
restoreInitalValuesInFormArray | () => void | Function to restore initial values in the form array. |
WMLOptionZeroItemProps Properties
Section titled “WMLOptionZeroItemProps Properties”| Property | Type | Description |
|---|---|---|
isChosen | boolean | Indicates if the option is chosen. |
text | string | The display text for the option. |
toggleClass | string | CSS class to toggle for the option. |
clickPredicate | Function | Predicate function to handle option click events. |
wmlOptions | WMLOptionsZeroProps | The parent options configuration. |
customCpnt | WMLCustomComponent | Custom component for the option content. |
WMLOptionsZeroComponent Methods
Section titled “WMLOptionsZeroComponent Methods”| Method | Parameters | Description |
|---|---|---|
listenForClearedForm | None | Listens for form clear events and updates option states. |
populateFields | init: boolean | Populates fields based on the selected options. |
updateFormArray | None | Updates the form array with the selected options. |
toggleChosen | btn: WMLOptionZeroItemProps, init: boolean | Toggles the chosen state of an option. |
ngAfterViewInit | None | Lifecycle hook for after view initialization. |
ngOnDestroy | None | Lifecycle hook for component destruction. |
Changelog
Section titled “Changelog”v18.1.3000-beta1 [8/1/24]
Section titled “v18.1.3000-beta1 [8/1/24]”- updated package to conform with @windmillcode/angular-wml-components-base ,
v18.1.3000-beta2 [8/1/24]
Section titled “v18.1.3000-beta2 [8/1/24]”- updated package to conform with @windmillcode/angular-wml-components-base ,
v18.1.3000-beta3 [8/1/24]
Section titled “v18.1.3000-beta3 [8/1/24]”- updated package to conform with @windmillcode/angular-wml-components-base ,
v18.1.3000-beta4 [8/1/24]
Section titled “v18.1.3000-beta4 [8/1/24]”- updated package to conform with @windmillcode/angular-wml-components-base
v18.1.3000
Section titled “v18.1.3000”- fixed a bug with default options
v18.1.3001 [8/4/24]
Section titled “v18.1.3001 [8/4/24]”- updated package to conform with @windmillcode/angular-wml-components-base
v18.1.3002 [8/4/24]
Section titled “v18.1.3002 [8/4/24]”- updated package to conform with @windmillcode/angular-wml-components-base
v18.1.3002 [8/5/24]
Section titled “v18.1.3002 [8/5/24]”- updated package to conform with @windmillcode/angular-wml-components-base
v18.1.3003 [8/5/24]
Section titled “v18.1.3003 [8/5/24]”- updated package to conform with @windmillcode/angular-wml-components-base
v18.1.3004 [8/5/24]
Section titled “v18.1.3004 [8/5/24]”- updated package to conform with @windmillcode/angular-wml-components-base
v18.1.3005 [8/5/24]
Section titled “v18.1.3005 [8/5/24]”- updated package to conform with @windmillcode/angular-wml-components-base
v18.1.3006 [8/5/24]
Section titled “v18.1.3006 [8/5/24]”- updated package to conform with @windmillcode/angular-wml-components-base
v18.1.3007 [8/5/24]
Section titled “v18.1.3007 [8/5/24]”- updated package to conform with @windmillcode/angular-wml-components-base
v18.1.4000 [8/14/24]
Section titled “v18.1.4000 [8/14/24]”- updated package to conform with @windmillcode/angular-wml-components-base
v18.1.4001 [8/14/24]
Section titled “v18.1.4001 [8/14/24]”- updated package to conform with @windmillcode/angular-wml-components-base
v18.2.0 [8/15/24]
Section titled “v18.2.0 [8/15/24]”- updated package to conform with @windmillcode/angular-wml-components-base
v18.2.1 [8/20/24]
Section titled “v18.2.1 [8/20/24]”- updated package to conform with @windmillcode/angular-wml-components-base
v18.2.1000 [8/22/24]
Section titled “v18.2.1000 [8/22/24]”- updated package to reflect the version 18.2.1 of @angular/core package
v18.2.2000 [8/30/24]
Section titled “v18.2.2000 [8/30/24]”- updated package to reflect the version 18.2.2 of @angular/core package
v18.2.2100 [9/1/24]
Section titled “v18.2.2100 [9/1/24]”- updated package to conform with @windmillcode/angular-wml-components-base
v18.2.2101 [9/1/24]
Section titled “v18.2.2101 [9/1/24]”- updated package to conform with @windmillcode/angular-wml-components-base
v18.2.2200 [9/3/24]
Section titled “v18.2.2200 [9/3/24]”- updated package to conform with @windmillcode/angular-wml-components-base
v18.2.3000 [9/4/24]
Section titled “v18.2.3000 [9/4/24]”- updated package to reflect the version 18.2.3 of @angular/core package
v18.2.3100 [9/8/24]
Section titled “v18.2.3100 [9/8/24]”- updated package to reflect the version 18.2.3 of @angular/core package
v18.2.3110 [9/10/24]
Section titled “v18.2.3110 [9/10/24]”- updated package to conform with @windmillcode/angular-wml-components-base
v18.2.3112 [9/10/24]
Section titled “v18.2.3112 [9/10/24]”- updated package to conform with @windmillcode/angular-wml-components-base
v18.2.4000 [9/16/24]
Section titled “v18.2.4000 [9/16/24]”- updated package to reflect the version 18.2.4 of @angular/core package
v18.2.4100 [9/19/24]
Section titled “v18.2.4100 [9/19/24]”- updated package to conform with @windmillcode/wml-components-base
v18.2.4200 [9/21/24]
Section titled “v18.2.4200 [9/21/24]”- updated package to conform with @windmillcode/wml-components-base
v18.2.5001 [9/22/24]
Section titled “v18.2.5001 [9/22/24]”- updated package to reflect the version 18.2.5 of @angular/core package
v18.2.6000 [10/1/24]
Section titled “v18.2.6000 [10/1/24]”- updated package to reflect the version 18.2.6 of @angular/core package
v18.2.7000 [10/2/24]
Section titled “v18.2.7000 [10/2/24]”- updated package to reflect the version 18.2.7 of @angular/core package
v18.2.7001 [10/5/24]
Section titled “v18.2.7001 [10/5/24]”- updated package to conform with @windmillcode/wml-components-base
v18.2.7010 [10/9/24]
Section titled “v18.2.7010 [10/9/24]”- updated package to conform with @windmillcode/wml-components-base
v18.2.7020 [10/10/24]
Section titled “v18.2.7020 [10/10/24]”- updated package to conform with @windmillcode/wml-components-base
v18.2.8000 [10/10/24]
Section titled “v18.2.8000 [10/10/24]”- updated package to reflect the version 18.2.8 of @angular/core package
v18.2.8000 [10/11/24]
Section titled “v18.2.8000 [10/11/24]”- updated package to reflect the version 18.2.8 of @angular/core package
v18.2.8001 [10/11/24]
Section titled “v18.2.8001 [10/11/24]”- updated package to conform with @windmillcode/wml-components-base
v18.2.9000 [10/23/24]
Section titled “v18.2.9000 [10/23/24]”- updated package to conform with @windmillcode/wml-components-base
v18.2.10000 [10/31/24]
Section titled “v18.2.10000 [10/31/24]”- updated package to conform with @windmillcode/wml-components-base
v18.2.11000 [11/7/24]
Section titled “v18.2.11000 [11/7/24]”- updated package to conform with @windmillcode/wml-components-base
v18.2.12000 [11/15/24]
Section titled “v18.2.12000 [11/15/24]”- updated package to conform with @windmillcode/wml-components-base
v18.2.12001 [11/17/24]
Section titled “v18.2.12001 [11/17/24]”- updated package to conform with @windmillcode/wml-components-base
v19.0.0 [11/19/24]
Section titled “v19.0.0 [11/19/24]”- updated package to conform with @windmillcode/wml-components-base
v19.0.3 [11/20/24]
Section titled “v19.0.3 [11/20/24]”- updated package to conform with @windmillcode/wml-components-base
v19.0.4 [11/26/24]
Section titled “v19.0.4 [11/26/24]”- updated package to conform with @windmillcode/wml-components-base
v19.0.1000 [11/26/24]
Section titled “v19.0.1000 [11/26/24]”- updated package to conform with @windmillcode/wml-components-base
v19.0.2000 [12/4/24]
Section titled “v19.0.2000 [12/4/24]”- updated package to reflect the version 19.0.2 of @angular/core package
v19.0.3000 [12/6/24]
Section titled “v19.0.3000 [12/6/24]”- updated package to reflect the version 19.0.3 of @angular/core package
v19.0.4000 [12/12/24]
Section titled “v19.0.4000 [12/12/24]”- updated package to reflect the version 19.0.4 of @angular/core package
v19.0.5000 [12/19/24]
Section titled “v19.0.5000 [12/19/24]”- updated package to reflect the version 19.0.5 of @angular/core package
v19.0.5100 [12/29/24]
Section titled “v19.0.5100 [12/29/24]”- updated package to conform with @windmillcode/wml-components-base
v19.0.6000 [1/12/25]
Section titled “v19.0.6000 [1/12/25]”- updated package to reflect the version 19.0.6 of @angular/core package
v19.0.7000 [1/16/25]
Section titled “v19.0.7000 [1/16/25]”- updated package to reflect the version 19.0.7 of @angular/core package
v19.1.0 [1/17/25]
Section titled “v19.1.0 [1/17/25]”- updated package to reflect the version 19.1.0 of @angular/core package
v19.1.1000 [1/17/25]
Section titled “v19.1.1000 [1/17/25]”- updated package to reflect the version 19.1.1 of @angular/core package
v19.1.2000 [1/23/25]
Section titled “v19.1.2000 [1/23/25]”- updated package to reflect the version 19.1.2 of @angular/core package
v19.1.3000 [1/23/25]
Section titled “v19.1.3000 [1/23/25]”- updated package to reflect the version 19.1.3 of @angular/core package
v19.1.3100 [1/23/25]
Section titled “v19.1.3100 [1/23/25]”- update package to support the react native ecosystem
v19.1.3111 [1/27/25]
Section titled “v19.1.3111 [1/27/25]”- updated package to conform with @windmillcode/wml-components-base
v19.1.3112 [1/28/25]
Section titled “v19.1.3112 [1/28/25]”- updated package to conform with @windmillcode/wml-components-base
v19.1.4000 [1/31/25]
Section titled “v19.1.4000 [1/31/25]”- updated package to reflect the version 19.1.4 of @angular/core package
v19.1.5000 [2/8/25]
Section titled “v19.1.5000 [2/8/25]”- updated package to reflect the version 19.1.5 of @angular/core package
v19.1.6000 [2/13/25]
Section titled “v19.1.6000 [2/13/25]”- updated package to reflect the version 19.1.6 of @angular/core package
v19.1.7000 [2/21/25]
Section titled “v19.1.7000 [2/21/25]”- updated package to reflect the version 19.1.7 of @angular/core package
v19.1.8000 [3/4/25]
Section titled “v19.1.8000 [3/4/25]”- updated package to reflect the version 19.1.8 of @angular/core package
v19.2.0 [3/4/25]
Section titled “v19.2.0 [3/4/25]”- updated package to reflect the version 19.2.0 of @angular/core package
v19.2.1000 [3/9/25]
Section titled “v19.2.1000 [3/9/25]”- updated package to reflect the version 19.2.1 of @angular/core package
v19.2.2000 [3/15/25]
Section titled “v19.2.2000 [3/15/25]”- updated package to reflect the version 19.2.2 of @angular/core package
v19.2.3000 [3/21/25]
Section titled “v19.2.3000 [3/21/25]”- updated package to reflect the version 19.2.3 of @angular/core package
v19.2.4000 [3/27/25]
Section titled “v19.2.4000 [3/27/25]”- updated package to reflect the version 19.2.4 of @angular/core package
v19.2.5000 [4/3/25]
Section titled “v19.2.5000 [4/3/25]”- updated package to reflect the version 19.2.5 of @angular/core package
v19.2.5001 [4/6/25]
Section titled “v19.2.5001 [4/6/25]”- updated package to conform with @windmillcode/wml-components-base
v19.2.5100 [4/10/25]
Section titled “v19.2.5100 [4/10/25]”- updated package to conform with @windmillcode/wml-components-base
v19.2.6000 [4/10/25]
Section titled “v19.2.6000 [4/10/25]”- updated package to conform with @windmillcode/wml-components-base
v19.2.7000 [4/21/25]
Section titled “v19.2.7000 [4/21/25]”- updated package to conform with @windmillcode/wml-components-base
v19.2.8000 [4/24/25]
Section titled “v19.2.8000 [4/24/25]”- updated package to reflect the version 19.2.8 of @angular/core package
v19.2.9000 [5/1/25]
Section titled “v19.2.9000 [5/1/25]”- updated package to reflect the version 19.2.9 of @angular/core package
v19.2.10000 [5/8/25]
Section titled “v19.2.10000 [5/8/25]”- updated package to reflect the version 19.2.10 of @angular/core package