📅 You're Invited: Meet the Socket team at RSAC (April 28 – May 1).RSVP
Socket
Sign inDemoInstall
Socket

angular-tabler-icons

Package Overview
Dependencies
Maintainers
1
Versions
141
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

angular-tabler-icons

Tabler Icons components library for your Angular applications

3.26.0
latest
Source
npm
Version published
Weekly downloads
7.5K
11.03%
Maintainers
1
Weekly downloads
 
Created
Source

angular-tabler-icons

tabler-icons-version license downloads

Description

This package allows you to use the Tabler Icons in your angular applications. Tabler Icons is a set of free MIT-licensed high-quality SVG icons for you to use in your web projects. Each icon is designed on a 24x24 grid and a 2px stroke.

✨ Many thanks to Arjen and janschab for their contribution on this project!

Install

1. Install the package

npm install angular-tabler-icons
# or
yarn add angular-tabler-icons

Usage

Standalone

If you are using Standalone Components, use the provideTablerIcons()

Component

import { Component } from '@angular/core';
import { TablerIconComponent, provideTablerIcons } from 'angular-tabler-icons';
import {
  IconNumber123,
  IconAdOff,
  IconHeartFilled,
} from 'angular-tabler-icons/icons';

@Component({
  selector: 'app-standalone',
  imports: [TablerIconComponent],
  /**
   * Provide the icons which you want to use in this component.
   */
  providers: [
    provideTablerIcons({
      IconNumber123,
      IconAdOff,
      IconHeartFilled,
    }),
  ],
,
})
export class StandaloneComponent {}

HTML

<fieldset>
  <legend>123</legend>
  <i-tabler name="number-123"></i-tabler>
</fieldset>

<fieldset>
  <legend>123 (style, big)</legend>
  <i-tabler name="number-123" style="height: 60px; width: 60px;"></i-tabler>
</fieldset>

<fieldset>
  <legend>ad-off (style, red)</legend>
  <i-tabler name="ad-off" style="color: red;"></i-tabler>
</fieldset>

<fieldset>
  <legend>heart-filled (style, red)</legend>
  <i-tabler name="heart-filled" style="color: red;"></i-tabler>
</fieldset>

Available icons

List of available icons: https://tabler.io/icons

This version includes Tabler Icons v3.26.0, see changelog to know which icons are available.

Styling icons

Each icon can be styled separately with CSS:

<i-tabler name="camera" class="big fill-red stroke-blue thin"></i-tabler>
.big {
  height: 50px;
  width: 50px;
}

.fill-red {
  fill: red;
}

.stroke-blue {
  color: blue;
}

.thin {
  stroke-width: 1px;
}

Options

Some options are available to configure the module:

import { environment } from "../environments/environment";
import { TablerIconsModule } from "angular-tabler-icons";
import * as TablerIcons from "angular-tabler-icons/icons";

@NgModule({
  imports: [
    TablerIconsModule.pick(TablerIcons, {
      // Ignore warnings, such as "Tabler Icon not found", for example:
      //   ignoreWarnings: environment.production,
      ignoreWarnings: true,
    }),
  ],
  exports: [TablerIconsModule],
})
export class IconsModule {}

Pick all icons

You can import all icons at once by doing the following. However, keep in mind that by doing this, all icons will end up in your application bundle. While this may not be much of an issue for prototyping, it is not recommended for any application that you plan to release.

import { TablerIconsModule } from "angular-tabler-icons";
import * as TablerIcons from "angular-tabler-icons/icons";

@NgModule({
  imports: [TablerIconsModule.pick(TablerIcons)],
  exports: [TablerIconsModule],
})
export class IconsModule {}

NgModule (Legacy)

1. Generate a module to host the icons you'll import

ng generate module icons

2. Import assets

You need to import:

  • TablerIconsModule, as it contains the <i-tabler> component
  • The icons that you need

We put this in IconsModule for modularity. See example below:

file: icon.module.ts

import { NgModule } from "@angular/core";

import { TablerIconsModule } from "angular-tabler-icons";
import { IconCamera, IconHeart, IconBrandGithub } from "angular-tabler-icons/icons";

// Select some icons (use an object, not an array)
const icons = {
  IconCamera,
  IconHeart,
  IconBrandGithub,
};

@NgModule({
  imports: [TablerIconsModule.pick(icons)],
  exports: [TablerIconsModule],
})
export class IconsModule {}

// NOTES:
// 1. We add TablerIconsModule to the 'exports', since the <i-tabler> component will be used in templates of parent module
// 2. Don't forget to pick some icons using TablerIconsModule.pick({ ... })

3. Import IconsModule

If you are using NgModules, import it this way:

import { NgModule } from "@angular/core";
import { MyComponent } from "./my/my.component";
import { IconsModule } from "./icons.module";

@NgModule({
  declarations: [MyComponent],
  imports: [
    IconsModule, // <--- Here
  ],
})
export class MyModule {}

4. Use it in template

After importing the IconsModule in your feature or shared module, use the icons as follows:

<i-tabler name="camera"></i-tabler>
<i-tabler name="heart" style="color: red;"></i-tabler>
<i-tabler name="heart-filled" style="color: red;"></i-tabler>
<i-tabler name="brand-github" class="someclass"></i-tabler>

Angular version compatibility

Angularangular-tabler-icons
18 & 193.22.0+
172.40.1+
162.21.1+
151.117.1+
141.72.1+
131.53.1+
121.41.3+
111.41.0+

Contributing

Feel free to report issues or to contribute to this project! Here are few tips to start:

yarn lib:generate  # generate components from Tabler Icons
yarn lib:build  # build angular library

How to rebuild for newer tabler icons version

  • Run GitHub actions workflow Automatic PR on Tabler Icons Release, with new Tabler Icons version (e.g. 2.40.0). This workflow will create automatically a new Pull Request.
  • Approve and Merge the generated Pull Request.
  • Create a release/tag with the new Tabler Icons version.

Package is automatically rebuilt and published, with the GitHub actions workflow Build and Publish package.

Keywords

angular

FAQs

Package last updated on 18 Dec 2024

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts