height="256px" width="256px" style="text-align: center;"
src="https://cdn.jsdelivr.net/gh/angular-material-extensions/link-preview/assets/angular-material-extensions-logo.png">

@angular-material-extensions/link-preview - Angular open source UI library to preview web links powered by ngx-linkifyjs and material design


src="https://cdn.jsdelivr.net/gh/angular-material-extensions/link-preview/assets/demo1.gif">

multiple link preview

src="https://cdn.jsdelivr.net/gh/angular-material-extensions/link-preview/assets/demo.png">

Built by and for developers :heart:

Do you have any question or suggestion ? Please do not hesitate to contact us!
Alternatively, provide a PR | open an appropriate issue here

If did you like this project, support angular-material-extensions
by starring :star: and sharing it :loudspeaker:

Table of Contents

- Demo
- Dependencies
- Peer Dependencies
- Additional Requirements - material (Include a theme)
- Installation
- Usage
- Documentation
- Run Demo App Locally
- Development
- Other Angular Libraries
- Support
- License

Demo

View all the directives and components in action at https://angular-material-extensions.github.io/link-preview

Dependencies

Angular (requires* Angular 2 or higher, tested with V7)

Requirements (peer dependencies):

- angular animations v7.x
- angular http v7.x
- angular cdk v7.x
- angular material v7.x

- angular material theme

``bash
npm i @angular/cdk @angular/material @angular/animations @angular/http
`

or use angular schematics like e.g:

`bash
ng add @angular/material
`

---

$3

- angular material theme

Installation

Install above dependencies via npm.

Now install @angular-material-extensions/link-preview via:
`shell
npm install --save @angular-material-extensions/link-preview
`

---
##### SystemJS
>Note:If you are using SystemJS, you should adjust your configuration to point to the UMD bundle.
In your systemjs config file, map needs to tell the System loader where to look for @angular-material-extensions/link-preview:
`js
map: {
'@angular-material-extensions/link-preview': 'node_modules/@angular-material-extensions/link-preview/bundles/link-preview.umd.js',
}
`
---

Once installed you need to import the main module:
`js
import { MatLinkPreviewModule } from '@angular-material-extensions/link-preview';
`
The only remaining part is to list the imported module in your application module. The exact method will be slightly
different for the root (top-level) module for which you should end up with the code similar to (notice MatLinkPreviewModule .forRoot()):
`js
import { MatLinkPreviewModule } from '@angular-material-extensions/link-preview';

@NgModule({
declarations: [AppComponent, ...],
imports: [MatLinkPreviewModule.forRoot(), ...],
bootstrap: [AppComponent]
})
export class AppModule {
}
`

Other modules in your application can simply import MatLinkPreviewModule :

`js
import { MatLinkPreviewModule } from '@angular-material-extensions/link-preview';

@NgModule({
declarations: [OtherComponent, ...],
imports: [MatLinkPreviewModule, ...],
})
export class OtherModule {
}
`

Usage

$3

#### matLinkPreview used to find and parse links from any text input - should be used in combination with to render and preview the found links

e.g:

`html

Enter here your text here with few links to preview ;)


`

$3

#### the container that hold the links to preview

| option | bind | type | default | description |
|:-------------------|:--------:|:------:|:------------:|:-------------------------------------------------------------------------------------------------|
| color | Input() | string | primary | the color to use for the button of the url - options --> primary | accent | warn
| multiple | Input() | boolean | false | whether to find, parse and render one single or multiple links
| showLoadingsProgress| Input() | boolean | true | whether to show and render a loading spinner while fetching the link to preview

e.g:

`html

`

#### Full example code

`html



`

---

Documentation

Please checkout the full documentation here

Run Demo App Locally

- clone this repo by running
`bash
$ git clone https://github.com/angular-material-extensions/link-preview.git
`

- setup the @angular-material-extensions/link-preview package

`bash
$ gulp setup
`

- navigate to the demo app directory
`bash
$ cd demo
`

- install the dependencies and run the app
`bash
$ npm i && npm start
`

- the app is now hosted by http://localhost:4200/




Development

1. clone this repo
2. Install the dependencies by running npm i
3. setup the library gulp setup
4. Navigate to the demo app's directory
- cd demo
_ npm i && npm start`

---

Other Angular Libraries

- ngx-auth-firebaseui
- @firebaseui/ng-bootstrap
- ngx-linkifyjs
- @angular-material-extensions/password-strength
- @angular-material-extensions/google-maps-autocomplete
- @angular-material-extensions/pages
- @angular-material-extensions/contacts
- @angular-material-extensions/faq
- @angular-material-extensions/combination-generator

---

Support

+ Drop an email to: Anthony Nahas
+ or open an appropriate issue
+ let us chat on Gitter

Built by and for developers :heart: we will help you :punch:

---

License

Copyright (c) 2018 Anthony Nahas. Licensed under the MIT License (MIT)