An Angular directive that automatically adjusts the width of an input element to its content. Unlike other auto-grow directives, it is unique because it both shrinks and increases the width based on the content.
npm install ngx-autosize-inputAn Angular directive that automatically adjusts the width of an input element to its content. Unlike other auto-grow directives, it is unique because it both shrinks and increases the width based on the content.
The major version will match the Angular major version going forward (Angular 10+). For example version 10, will work for Angular 10.
https://stackblitz.com/edit/angular-ivy-dtjmsk?file=src/app/hello.component.ts
``bash`
npm install ngx-autosize-input
Add AutoSizeInputDirective to your @NgModule imports:
`typescript
import {AutoSizeInputDirective} from "ngx-autosize-input";
@NgModule({
imports: [
AutoSizeInputDirective
]
})
`
The input options can be set from a provider (see below), or from the template (skip to the next section).
`typescript
import {AUTO_SIZE_INPUT_OPTIONS, AutoSizeInputDirective, AutoSizeInputOptions} from 'ngx-autosize-input';
const CUSTOM_AUTO_SIZE_INPUT_OPTIONS: AutoSizeInputOptions = {
extraWidth: 0,
includeBorders: false,
includePadding: true,
includePlaceholder: true,
maxWidth: -1,
minWidth: -1,
setParentWidth: false,
usePlaceHolderWhenEmpty: false,
}
@NgModule({
imports: [
AutoSizeInputDirective
],
providers: [
{ provide: AUTO_SIZE_INPUT_OPTIONS, useValue: CUSTOM_AUTO_SIZE_INPUT_OPTIONS }
]
})
`
Use directly in your HTML templates on an input element:
`
If using Bootstrap, set the directive to include borders so that the text is not cut off.
`
The following parameters customize the directive.
Add extra width, in units of pixels.
Default Value: 0px
Example (add 10px):
`
Set placeholder text width as minimum width;
Note that [minimumWidth] will override this property.
Default Value: true
Example (turn off placeholder):
`
Includes border width, so that text is not cut off.
Note only even left and right borders are supported at this time.
Default Value: false
Example (turn on include borders):
`
Includes padding width, so that text is not cut off.
Default Value: true
Example (turn off include padding):
`
Sets minimum width, in units of pixels.
Default Value: 0
Example (50px minimum width):
`
Sets maximum width, in units of pixels.
Default Value: 0
Example (100px maximum width):
`
Sets parent width automatically, instead of input width. Useful when you need to update a parent's width.
Default Value: false
Example (input wrapped in an Angular Material form field component):
`
Sets width to placeholder width, only when value is empty.
Default Value: false
Example (turn on placeholder when empty):
`
If the value of the form control is an object but the input value is formatted setting this
value to true will use the value property of the input instead of retreiving the value from
the form control or model. This option is not globally configurable and must be set on each input.
Default Value: false
Example (ngbTypeahead with inputFormatter):
search$ returns an array of objects { firstName: string; lastName: string; }[] and formatInput transforms the selected object to ${firstName} ${lastName} . The value applied to the form control will be the object
selected so in-order to get the actual string value in the input we need to look at the value property.
`
Joshua Wright
This project is licensed under the MIT license. See the License file for more info.