{"id":19326340,"url":"https://github.com/thisissoon/angular-image-loader","last_synced_at":"2025-04-22T20:32:44.264Z","repository":{"id":57166316,"uuid":"100516782","full_name":"thisissoon/angular-image-loader","owner":"thisissoon","description":"A simple progressive, responsive, lazy  image and video loading library for Angular that detects browser size and loads the appropriate image or video only when the element is in viewport. This package requires @thisissoon/angular-inviewport","archived":false,"fork":false,"pushed_at":"2019-02-05T14:57:57.000Z","size":862,"stargazers_count":21,"open_issues_count":2,"forks_count":1,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-08-09T03:51:59.623Z","etag":null,"topics":["angular","component","image-loader","lazy-image-loading","lazy-loading","ngx","ngx-image-loader","ngx-image-loading","ngx-lazy-loading","ngx-library","ngx-video-loader","progressive-image-loader","responsive","responsive-images","responsive-video","retina-images","video","video-loader"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/thisissoon.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-08-16T17:47:27.000Z","updated_at":"2021-11-21T20:04:09.000Z","dependencies_parsed_at":"2022-08-30T13:10:11.320Z","dependency_job_id":null,"html_url":"https://github.com/thisissoon/angular-image-loader","commit_stats":null,"previous_names":[],"tags_count":25,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thisissoon%2Fangular-image-loader","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thisissoon%2Fangular-image-loader/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thisissoon%2Fangular-image-loader/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thisissoon%2Fangular-image-loader/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/thisissoon","download_url":"https://codeload.github.com/thisissoon/angular-image-loader/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223903480,"owners_count":17222551,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["angular","component","image-loader","lazy-image-loading","lazy-loading","ngx","ngx-image-loader","ngx-image-loading","ngx-lazy-loading","ngx-library","ngx-video-loader","progressive-image-loader","responsive","responsive-images","responsive-video","retina-images","video","video-loader"],"created_at":"2024-11-10T02:13:07.009Z","updated_at":"2024-11-10T02:13:07.640Z","avatar_url":"https://github.com/thisissoon.png","language":"TypeScript","readme":"# Angular Image Loader\n\n[![Build Status][circle-badge]][circle-badge-url]\n[![Coverage Status][coveralls-badge]][coveralls-badge-url]\n[![Commitizen friendly][commitizen-badge]][commitizen]\n[![code style: prettier][prettier-badge]][prettier-badge-url]\n\nA simple progressive/responsive/lazy loading image library for [Angular][angular] that detects browser size and loads the appropriate image only when the element is in view. Classes are attributed and events emited on image loads. This package requires [@thisissoon/angular-inviewport][angular-inviewport].\n\n\u003cimg src=\"https://raw.githubusercontent.com/thisissoon/angular-image-loader/master/src/assets/example.gif\" alt=\"example\"\u003e\n\nThis is a simple library for [Angular][angular], implemented in the [Angular Package Format v5.0][apfv5].\n\n## Install\n\n### via NPM\n\n`npm i @thisissoon/{angular-image-loader,angular-inviewport} --save`\n\n### via Yarn\n\n`yarn add @thisissoon/angular-image-loader @thisissoon/angular-inviewport`\n\n`app.module.ts`\n\n```ts\nimport {\n  ImageLoaderModule,\n  VideoLoaderModule,\n} from '@thisissoon/angular-image-loader';\nimport { InViewportModule } from '@thisissoon/angular-inviewport';\n\n@NgModule({\n  imports: [\n    InViewportModule,\n    ImageLoaderModule, // Only this import required if using just the image loader\n    VideoLoaderModule, // Only this import required if using just the video loader\n  ],\n})\nexport class AppModule {}\n```\n\n`app.server.module.ts` (Only needed if using Angular Universal)\n\n```ts\nimport { ImageLoaderModule } from '@thisissoon/angular-image-loader';\nimport { InViewportModule, WindowRef } from '@thisissoon/angular-inviewport';\n\n@NgModule({\n  imports: [InViewportModule.forServer(), ImageLoaderModule, VideoLoaderModule],\n})\nexport class AppModule {}\n```\n\n## Image Loader Example\n\nA working example can be found inside [/src](https://github.com/thisissoon/angular-image-loader/tree/master/src) folder.\n\n### `app.component.html`\n\n```html\n\u003csn-image-loader\n  [image]=\"image\"\n  [sizes]=\"sizes\"\n  imgClass=\"img\"\n  alt=\"lorem ipsum\"\n  (placeholderLoaded)=\"onPlaceholderLoad($event)\"\n  (imageLoaded)=\"onImageLoad($event)\"\n\u003e\n\u003c/sn-image-loader\u003e\n```\n\n### `app.component.ts`\n\n```ts\nexport class AppComponent {\n  sizes: Breakpoint[] = [\n    { size: 'xs', width: 0 },\n    { size: 'md', width: 768 },\n    { size: 'lg', width: 992 },\n  ];\n\n  image: ResponsiveImage = {\n    placeholder: 'http://via.placeholder.com/35x15?text=placeholder',\n    fallback: 'http://via.placeholder.com/350x150?text=fallback',\n    images: [\n      {\n        size: 'xs',\n        x1: 'http://via.placeholder.com/150x350?text=xs+1x',\n        x2: 'http://via.placeholder.com/300x700?text=xs+2x',\n      },\n      {\n        size: 'md',\n        x1: 'http://via.placeholder.com/350x250?text=md+1x',\n        x2: 'http://via.placeholder.com/700x500?text=md+2x',\n      },\n      {\n        size: 'lg',\n        x1: 'http://via.placeholder.com/700x400?text=lg+1x',\n        x2: 'http://via.placeholder.com/1400x800?text=lg+2x',\n      },\n    ],\n  };\n\n  public onPlaceholderLoad(imageLoadedEvent: ImageLoadedEvent) {\n    // Do something\n  }\n\n  public onImageLoad(imageLoadedEvent: ImageLoadedEvent) {\n    // Do something\n  }\n}\n```\n\n### `app.component.css`\n\n```css\n.foo {\n  transition: all 0.35s ease-in-out;\n}\n\n.sn-image-not-loaded ::ng-deep .img {\n  filter: blur(20px);\n}\n\n.sn-image-loaded ::ng-deep .img {\n  filter: blur(0);\n}\n```\n\n## Video Loader Example\n\n### `app.component.html`\n\n```html\n\u003csn-video-loader\n  [sizes]=\"sizes\"\n  [video]=\"video\"\n  [loop]=\"true\"\n  [muted]=\"true\"\n  [autoplay]=\"true\"\n  [controls]=\"true\"\n  [playsInline]=\"true\"\n  type=\"video/mp4\"\n  videoClass=\"video\"\n  posterClass=\"img\"\n\u003e\n\u003c/sn-video-loader\u003e\n```\n\n### `app.component.ts`\n\n```ts\nexport class AppComponent {\n  sizes: Breakpoint[] = [\n    { size: 'xs', width: 0 },\n    { size: 'md', width: 768 },\n    { size: 'lg', width: 992 },\n  ];\n\n  video: ResponsiveVideo = {\n    videos: [\n      {\n        size: 'xs',\n        url:\n          'http://res.cloudinary.com/thisissoon/video/upload/ac_none,c_fill,h_568,q_80,w_320/v1517616795/demos/jellyfish-25-mbps-hd-hevc.mp4',\n      },\n      {\n        size: 'md',\n        url:\n          'http://res.cloudinary.com/thisissoon/video/upload/ac_none,c_fill,h_1024,q_80,w_768/v1517616795/demos/jellyfish-25-mbps-hd-hevc.mp4',\n      },\n      {\n        size: 'lg',\n        url:\n          'http://res.cloudinary.com/thisissoon/video/upload/ac_none,c_fill,h_720,q_80,w_1280/v1517616795/demos/jellyfish-25-mbps-hd-hevc.mp4',\n      },\n    ],\n    poster: {\n      // Responsive image, the same object as used for the image loader\n    },\n  };\n}\n```\n\n## Development server\n\nRun `ng serve` for a dev server. Navigate to `http://localhost:4200/`. The app will automatically reload if you change any of the source files.\n\n## Code scaffolding\n\nRun `ng generate component component-name` to generate a new component. You can also use `ng generate directive|pipe|service|class|guard|interface|enum|module`.\n\n## Build\n\nRun `ng build` to build the project. The build artifacts will be stored in the `dist/` directory. Use the `-prod` flag for a production build.\n\n## Running unit tests\n\nRun `ng test` to execute the unit tests via [Karma][karma].\n\n## Running end-to-end tests\n\nRun `ng e2e` to execute the end-to-end tests via [Protractor][protractor].\n\n## Making Commits\n\nThis repo uses [Commitizen CLI][commitizen] and [Conventional Changelog][conventional-changelog] to create commits and generate changelogs. Instead of running `git commit` run `git cz` and follow the prompts. Changelogs will then be generated when creating new releases by running `npm run release`.\n\n## Making Releases\n\nRun `npm run release` to create a new release. This will use [Standard Version][standard-version] to create a new release. [Standard Version][standard-version] will generate / update the changelog based on commits generated using [Commitizen CLI][commitizen], update the version number following semantic versioning rules and then commit and tag the commit for the release. Simply run `git push --follow-tags origin master`.\n\n## Further help\n\nTo get more help on the Angular CLI use `ng help` or go check out the [Angular CLI README][angular-cli-readme].\n\n[circle-badge]: https://circleci.com/gh/thisissoon/angular-image-loader.svg?style=shield\n[circle-badge-url]: https://circleci.com/gh/thisissoon/angular-image-loader\n[coveralls-badge]: https://coveralls.io/repos/github/thisissoon/angular-image-loader/badge.svg?branch=master\n[coveralls-badge-url]: https://coveralls.io/github/thisissoon/angular-image-loader?branch=master\n[prettier-badge]: https://img.shields.io/badge/code_style-prettier-ff69b4.svg?style=shield\n[prettier-badge-url]: https://github.com/prettier/prettier\n[angular]: https://angular.io/\n[angular-inviewport]: https://github.com/thisissoon/angular-inviewport\n[commitizen]: http://commitizen.github.io/cz-cli/\n[commitizen-badge]: https://img.shields.io/badge/commitizen-friendly-brightgreen.svg\n[conventional-changelog]: https://github.com/conventional-changelog/conventional-changelog\n[standard-version]: https://github.com/conventional-changelog/standard-version\n[karma]: https://karma-runner.github.io\n[protractor]: http://www.protractortest.org/\n[angular-cli]: https://github.com/angular/angular-cli\n[angular-cli-readme]: https://github.com/angular/angular-cli/blob/master/README.md\n[apfv5]: (https://docs.google.com/document/d/1CZC2rcpxffTDfRDs6p1cfbmKNLA6x5O-NtkJglDaBVs/edit#heading=h.k0mh3o8u5hx)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthisissoon%2Fangular-image-loader","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthisissoon%2Fangular-image-loader","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthisissoon%2Fangular-image-loader/lists"}