@commudle/ng-image-container
v2.0.1
Published
Angular component to display image of any dimension in a container of any aspect ratio to have standard looking images across your web page. Completely flexible.
Downloads
43
Readme
ng-image-container
Angular component to display image of any dimension in a container of any aspect ratio to have standard looking images across your web page. Completely flexible.
The ng-image-container is an Angular component that enhances image presentation in web applications. It allows users to specify image sources, set custom aspect ratios for containers, and provide accessibility with alternative text. It automatically handles background blur when the aspect ratio doesn't match the image's aspect ratio, ensuring a visually pleasing and accessible image display. This component is easy to install and use in Angular projects, contributing to a more engaging user experience.
Demo: Preview
Table of Contents
Usage
Here's a brief overview of the available options and features of ng-image-container:
- [src]: Specifies the source URL of the image to be displayed.
- [aspectRatio]: Allows you to set the aspect ratio of the image container, e.g., 16/9 for a widescreen aspect ratio.
- [alt]: Provides alternative text for the image for accessibility purposes.
Installation
To use ng-image-container
in your Angular project, follow these steps:
- Install the library using npm or yarn:
npm install @commudle/ng-image-container
# or
yarn add @commudle/ng-image-container
- Import the NgImageContainerModule into your Angular module (e.g., app.module.ts):
import { NgModule } from "@angular/core";
import { BrowserModule } from "@angular/platform-browser";
import { NgImageContainerModule } from "@commudle/ng-image-container";
@NgModule({
declarations: [
// ...
],
imports: [
BrowserModule,
NgImageContainerModule, // Import the NgImageContainerModule here
],
bootstrap: [AppComponent],
})
export class AppModule {}
- Start using the ng-image-container component in your templates:
<ng-image-container [src]="'your-image-url.jpg'" [aspectRatio]="16/9" [alt]="'Image Alt Text'"></ng-image-container>
License
This project is licensed under the MIT License - see the LICENSE file for details.
Issues and Feedback
If you encounter any issues or have suggestions for improvements, please feel free to open an issue on the GitHub repository. https://github.com/commudle/ng-image-container/issues
We welcome contributions from the community, so if you'd like to contribute, please read our contribution guidelines.