CoreUI Icons Angular

July 13, 2022 · View on GitHub

Code moved to:
https://github.com/coreui/coreui-angular/tree/main/projects/coreui-icons-angular


CoreUI logo

CoreUI Icons for Angular


Explore CoreUI for Angular docs »

CoreUI Icons »

Report a bug · Request a feature · Blog

CoreUI Icons Angular

angular angular npm-coreui-angular-next
NPM
Downloads License

cIcon directive

Angular directive for CoreUI Icons SVG set.

Features

  • Load icons:
    • stored in Angular root service,
    • directly passed SVG content,
  • Reduce icons bundle size when imported as single icons,
  • Full functionality of <svg> tag,
  • Clean API

For directive description visit https://coreui.io/angular/docs/4.0/

Installation

npm install @coreui/icons
npm install @coreui/icons-angular

Usage

// app NgModule

import { IconModule, IconSetService } from '@coreui/icons-angular';

@NgModule({
  imports: [
    IconModule,
...
  providers: [IconSetService],
...
// app component

import { cilEnvelopeOpen, flagSet } from '@coreui/icons';
import { IconSetService } from '@coreui/icons-angular';

@Component({
  ...
})
export class AppComponent implements OnInit {
  constructor(public iconSet: IconSetService) {
    // iconSet singleton
    iconSet.icons = { cilEnvelopeOpen, ...flagSet };
  }
...
<svg cIcon name="cil-envelope-open" size="lg"></svg>
<svg cIcon name="cifAu"></svg>

API

Icon directive

Use one of name or content prop as it defines the way of icon import

Inputs
proprertytypedefaultdescription
namestringundefinedname of SVG icon stored in IconSetService
contentstring, string[]undefinedSVG content
sizecustom, custom-size, sm, lg, xl, xxl, 3xl, 4xl, 5xl, 6xl, 7xl, 8xl, 9xl''Size of icon
titlestringundefined
customClassesstringundefinedOverwrites default .icon classes
viewBoxstringundefinedSVG viewbox
widthstringundefinedSVG width
heightstringundefinedSVG height

IconSet service

Props
proprertytypedefaultdescription
getIcon()(string): any[] returns an icon
iconsIIconSetundefinedIconSet object
iconNames[key: string]: stringundefinedreturns icon name from key

License

CoreUI Icons Free are free, open source, and GPL friendly. You can use it for commercial projects, open source projects, or really almost whatever you want.

  • Icons — CC BY 4.0 License
    • In the CoreUI Icons Free download, the CC BY 4.0 license applies to all icons packaged as .svg and .js files types.
  • Fonts — SIL OFL 1.1 License
    • In the CoreUI Icons Free download, the SIL OLF license applies to all icons packaged as web and desktop font files.
  • Code — MIT License
    • In the CoreUI Icons Free download, the MIT license applies to all non-font and non-icon files.