# @anjuna/angular-core

Latest version **1.2.19** (published 2021-10-29) · MIT license · 0 weekly downloads

## Install

```sh
npm install @anjuna/angular-core
pnpm add @anjuna/angular-core
yarn add @anjuna/angular-core
bun add @anjuna/angular-core
```

## Health

**Score 25/100 (F)** — status: abandoned.

Positive: has types; esm support; no vulnerabilities.

Warnings: low downloads.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.2.19 |
| Published | 2021-10-29 |
| First published | 2019-01-11 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 1 |
| Unpacked size | 1.1 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | Zuora UI Foundation Team |
| Maintainers | rdesisto, z-cduflo, gmazerogers, twotonebytes |

## Links

- npm: https://www.npmjs.com/package/@anjuna/angular-core
- Repository: https://git.zias.io/ui-foundation/anjuna
- Homepage: https://git.zias.io/pages/ui-foundation/anjuna/
- Issues: https://git.zias.io/ui-foundation/anjuna
- npm.io page: https://npm.io/package/@anjuna/angular-core

## Dependencies (1)

- [tslib](https://npm.io/package/tslib.md) ^1.10.0

## Recent versions

- 1.2.19 (latest) — 2021-10-29
- 1.2.18 — 2021-06-14
- 1.2.17 — 2021-01-06
- 1.2.16 — 2021-01-05
- 1.2.15 — 2020-11-20
- 1.2.14 — 2020-06-04
- 1.2.13 — 2020-06-02
- 1.2.12 — 2020-05-12
- 1.2.7 — 2020-04-15
- 1.2.6 — 2020-03-17
- 1.2.5 — 2020-03-11
- 1.2.4 — 2020-03-06
- 1.2.3 — 2020-03-05
- 1.2.2 — 2020-03-05
- 1.2.1 — 2020-03-03
- … 180 more at https://npm.io/package/@anjuna/angular-core/versions

## README

<p align="center">
<img src="//cdn.zuora.com/theme/0.6.0/assets/anjuna/anjuna-logo.svg"/>
<br/><br/>
</p>

# @anjuna/angular-core

The @anjuna/angular-core module is a set of Angular-specific wrappers and helpers to plug the core component library into Angular's APIs and patterns.

## Getting Started

```bash
npm install @anjuna/core @anjuna/angular-core
```

### Include the Theme
The best way to add the theme is by including the `theme.css` files from `@anjuna/theme` in your `styles.scss`. Icons are best added by CDN url in your `styles.scss`.

```css
@import '~@anjuna/theme/dist/css/theme.css';
```

**Note**: the polyfill for CSS variables does not work with dynamically loaded imports. For CSS variables to work in IE, the theme needs to be
part of your application's compiled style.

### Include the Web Components
To use the web components in your application, you first need to include them. Depending on your integration, there are a couple ways to do this.
The preferred way to add web component libraries to Angular applications is to do so when bootstrapping the app. Update your application's
`main.ts` to add the following functionality:

```typescript
import {enableProdMode} from '@angular/core';
import {platformBrowserDynamic} from '@angular/platform-browser-dynamic';
// import the loader and alias it so it won't conflict with other libraries
import {applyPolyfills, defineCustomElements as defineAnjunaElements} from '@anjuna/core/loader';

import {AppModule} from '@app/app.module';
import {environment} from '@env/environment';

if (environment.production) {
    enableProdMode();
}

platformBrowserDynamic().bootstrapModule(AppModule)
    .catch(err => console.log(err));

applyPolyfills().then(() => {
    defineAnjunaElements(window);
    // define any other web components within this block also
});
```

##### Custom Elements Schema
By default, Angular does not like it when it doesn't recognize a component tag and will throw an error. To configure Angular modules to tell them
we're using custom elements, we need to add the CUSTOM_ELEMENT_SCHEMA schema to modules that will be making use of them.

```typescript
import {NgModule, CUSTOM_ELEMENTS_SCHEMA} from '@angular/core';

@NgModule({
    declarations: [
        // removed for brevity
    ],
    imports: [
        // removed for brevity
    ],
    schemas: [
        // the important part
        CUSTOM_ELEMENTS_SCHEMA
    ],
    bootstrap: [AppComponent]
})
export class AppModule {}
```

### Include the Module
Once installed, you can import the module into any Angular module you need it.

```typescript
import {NgModule, CUSTOM_ELEMENTS_SCHEMA} from '@angular/core';
import {AnjunaCoreModule} from '@anjuna/angular-core';

@NgModule({
    imports: [
        // Other imports
        AnjunaCoreModule
    ],
    declarations: [
        // application components
    ],
    schemas: [
        CUSTOM_ELEMENTS_SCHEMA
    ]
})
export class MyModule {}
```

---
_Source: https://npm.io/package/@anjuna/angular-core · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
