An Angular2+ directive that autoscale the font size of an element until it fit the upper level container dimension.
Find a file
Lorenzo Iovino dcca18224b Merge pull request #31 from giacomoferlaino/master
Prettier code formatter integration
2020-03-12 12:41:00 +01:00
.idea Update version 1.2.10 2020-02-12 15:27:47 +01:00
.vscode feat: Added Prettier code formatter to standardize code formatting 2020-03-11 23:51:35 +01:00
examples/dev Fix: publish script in package.json 2020-02-12 15:26:32 +01:00
src ref: Formatted code using Prettier rules 2020-03-12 00:00:35 +01:00
.gitignore Added angular-librarian for manage library 2017-11-14 11:07:08 +01:00
.npmignore Added angular-librarian for manage library 2017-11-14 11:07:08 +01:00
index.ts Added angular-librarian for manage library 2017-11-14 11:07:08 +01:00
LICENSE Create LICENSE 2019-05-09 11:58:13 +02:00
package-lock.json ref: Formatted code using Prettier rules 2020-03-12 00:00:35 +01:00
package.json Update version 1.2.10 2020-02-12 15:27:47 +01:00
README.md Fix typo in README.md 2019-11-05 10:24:19 +01:00
tsconfig.json Feat: removed custom packaging script in favour of ng-packger; Feat: update with angular9 dependencies 2020-02-12 11:40:50 +01:00
tslint.json Added angular-librarian for manage library 2017-11-14 11:07:08 +01:00

ng2-fittext

An Angular2 directive written in pure typescript (and without jquery!), for autoscale the font size of an element to fit an upper level container.

How many times your font doesn't scale automatically to fit the size of the container? Always, if you don't say it to do that! How you can say it? ng2-fittext!

Demo

http://plnkr.co/edit/v0TQaYepV4E2Heur02j5?p=preview

Installation

Install the library

$ npm install --save ng2-fittext

Usage

Import it in your Angular2 project like a module

  1. Declare it in your module

    import {Ng2FittextModule} from "ng2-fittext";
    @NgModule({
      imports: [
        Ng2FittextModule
      ]
    })
    
    
  2. Use it in your components

    Fit with specified container (can be the parent or a deeper ancestor)

    import {Component} from '@angular/core';
    
    @Component({
      selector: 'label',
      template: `<div #container>
                    <div [fittext]="true" [activateOnResize]="true" [container]="container">Bla bla bla...</div>
                </div>`
    })
    
    export class LabelComponent {}
    

    Fit with the parent element (this works if you have a variable number of element between element and parent)

    import {Component} from '@angular/core';
    
    @Component({
      selector: 'label',
      template: `<div>
                    <div [fittext]="true" [activateOnResize]="true">Bla bla bla...</div>
                </div>`
    })
    
    export class LabelComponent {}
    

    NEW! Support for autoresize input box!

    import {Component} from '@angular/core';
    
    @Component({
      selector: 'inputbox',
      template: `<div #container>
                    <input [fittext]="true" [activateOnResize]="true" [container]="container" [activateOnInputEvents]="true">`,
                </div>`
    })
    
    export class InputBoxComponent {}
    

    NEW! Support for maxFontSize!

    import {Component} from '@angular/core';
    
    @Component({
      selector: 'inputbox',
      template: `<div>
                    <input [fittext]="true" [activateOnResize]="true" [activateOnInputEvents]="true" [minFontSize]="40" [maxFontSize]="100">`,
                </div>`
    })
    
    export class InputBoxComponent {}
    

    Input Parameters:

Parameter Description Values
fittext is the selector of the directive true/false
container the container to fit (if not present it fit default to parent container) ElementRef
activateOnResize enable/disable the autofit in case of window resize true or false (default false)
activateOnInputEvents enbale/disable the autofit in case of input box events (keydown, keyup etc..) true or false (default false)
maxFontSize maximal font size number, default is 1000
!deprecated! useMaxFontSize use max font size if is true deprecated!
minFontSize minimal font size number, default is 7
modelToWatch pass model to watch, when this model changes -> font size is automatically recalculated any type of model

Output Parameters:

Parameter Description Values
fontSizeChanged current font size string

Development

Want to contribute? Great! Simply, clone the repository!

I created this library because I always spended too much time for solve this problem and because i didn't find nothing on the web (13/03/2017) that do this without jquery and easily integrable in angular2. For sure is not a good implementation, maybe is not the best way to do it, but, it do the job.

Todos

  • Write tests
  • Find a better algorithm to find the font-size who fits better the container

License

MIT

Lorenzo I.