@fundamental-ngx/cdk

@Fundamental-NGX/CDK

Content

• 1. Description
• 2. Requirements
• 3. Versioning
• 4. Getting Started
• 5. Known Issues
• 6. Support
• 7. Contributing
• 8. License
• 9. Similar Projects

1. Description

The @fundamental-ngx/cdk library is a set of utilities and Angular directives aimed to help developers build custom UI components with common interaction patterns.

It includes common behaviour for working with DataSources and ControlValueAccessors. Additionally, it contains injectable helpers to easily control the rxjs subscriptions in your components, focusable/selectable list helpers and many more.

See Component Documentation for examples and API details.

2. Requirements

To download and use Fundamental Library for Angular, you will first need to install the node package manager.

Fundamental Library for Angular is intended for use with Angular 15 or newer.

Prior knowledge of Angular is recommended, to use the fundamental-ngx library.

3. Versioning

Check the Breaking Changes for the latest patches changes.

4. Getting Started

For an existing Angular CLI application,

1. Video tutorial How to use the Fundamental Core Library

2. Install Fundamental-NGX CDK. ng add @fundamental-ngx/cdk For versions prior to 0.10 use fundamental-ngx

   If you do not use the Angular CLI or if this command does not work for you, please see the full installation guide.

3. Import the modules you want to use.

   To add the entire library, add the following import to your main application module.

   import { FundamentalNgxCDKModule } from '@fundamental-ngx/cdk';
   
   @NgModule({
       ...
       imports: [FundamentalNgxCDKModule],
   })
   export class DemoModule { }
   

   To include an individual Angular Fundamental component in your application, you only need to import the relevant module.

   For example, to use Drag&Drop directive, add the following import to your main application module.

   import { DragAndDropModule } from '@fundamental-ngx/cdk/utils';
   

5. Known Issues

Please see Issues.

6. Support

If you encounter an issue, you can create a ticket.

7. Contributing

If you want to contribute, please check the CONTRIBUTING.md documentation for contribution guidelines. Please follow the Angular commit message guidelines.

Check out the NEW_COMPONENT.md guide on building a new component for the library and creating the necessary documentation for your new component.