# @maggioli-design-system/mds-img

> mds-img is a web-component from Magma Design System, built with StencilJS, TypeScript, Storybook. It's based on the web-component standard and it's designed to be agnostic from the JavaScript framework you are using.

Latest version **4.3.7** (published 2026-02-19) · MIT license · 0 weekly downloads

## Install

```sh
npm install @maggioli-design-system/mds-img
pnpm add @maggioli-design-system/mds-img
yarn add @maggioli-design-system/mds-img
bun add @maggioli-design-system/mds-img
```

## Health

**Score 55/100 (C)** — status: stable.

Positive: has types; esm support; no vulnerabilities.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 4.3.7 |
| Published | 2026-02-19 |
| First published | 2021-11-10 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 3 |
| Unpacked size | 1.2 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | Vittorio Vittori |
| Maintainers | vitto, moodysmiles, nicola.tamburini.maggioli |

## Links

- npm: https://www.npmjs.com/package/@maggioli-design-system/mds-img
- npm.io page: https://npm.io/package/@maggioli-design-system/mds-img

## Dependencies (3)

- [@stencil/core](https://npm.io/package/@stencil/core.md) 4.27.2
- [@maggioli-design-system/mds-icon](https://npm.io/package/@maggioli-design-system/mds-icon.md) 2.13.3
- [@maggioli-design-system/mds-text](https://npm.io/package/@maggioli-design-system/mds-text.md) 4.7.6

## Recent versions

- 4.3.7 (latest) — 2026-02-19
- 4.3.6 — 2026-01-16
- 4.3.5 — 2025-06-03
- 4.3.4 — 2025-05-14
- 4.3.2 — 2025-04-02
- 4.3.1 — 2025-03-10
- 4.3.0 — 2025-03-05
- 4.2.0 — 2025-02-25
- 4.1.1 — 2025-02-06
- 4.1.0 — 2024-12-04
- 4.0.0 — 2024-11-25
- 3.0.4 — 2024-10-10
- 3.0.3 — 2024-09-26
- 3.0.2 — 2024-09-17
- 3.0.1 — 2024-09-13
- … 21 more at https://npm.io/package/@maggioli-design-system/mds-img/versions

## README

# mds-img



This is a web-component from Maggioli Design System [Magma](https://magma.maggiolicloud.it), built with StencilJS, TypeScript, Storybook. It's based on the web-component standard and it's designed to be agnostic from the JavaScript framework you are using.

<!-- Auto Generated Below -->


## Properties

| Property            | Attribute            | Description                                                                                                                                                                                                                                                                                                                       | Type                                                                                                                   | Default                        |
| ------------------- | -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- | ------------------------------ |
| `alt`               | `alt`                | Specifies an alternate text for an image                                                                                                                                                                                                                                                                                          | `string`                                                                                                               | `''`                           |
| `crossorigin`       | `crossorigin`        | Allow images from third-party sites that allow cross-origin access to be used with canvas                                                                                                                                                                                                                                         | `"anonymous" \| "use-credentials" \| undefined`                                                                        | `'use-credentials'`            |
| `height`            | `height`             | The height attribute specifies the height of an image, in pixels.                                                                                                                                                                                                                                                                 | `string \| undefined`                                                                                                  | `undefined`                    |
| `loading`           | `loading`            | Specifies whether a browser should load an image immediately or to defer loading of images until some conditions are met.                                                                                                                                                                                                         | `"eager" \| "lazy" \| undefined`                                                                                       | `'lazy'`                       |
| `referrerpolicy`    | `referrerpolicy`     | Specifies which referrer information to use when fetching an image.                                                                                                                                                                                                                                                               | `"no-referrer" \| "no-referrer-when-downgrade" \| "origin" \| "origin-when-cross-origin" \| "unsafe-url" \| undefined` | `'no-referrer-when-downgrade'` |
| `sizes`             | `sizes`              | One or more strings separated by commas, indicating a set of source sizes. https://medium.com/@MRWwebDesign/responsive-images-the-sizes-attribute-and-unexpected-image-sizes-882a2eadb6db                                                                                                                                         | `string \| undefined`                                                                                                  | `undefined`                    |
| `src`               | `src`                | Specifies the path to the image                                                                                                                                                                                                                                                                                                   | `string`                                                                                                               | `undefined`                    |
| `srcset`            | `srcset`             | Specifies a list of image files to use in different situations. Defines multiple sizes of the same image, allowing the browser to select the appropriate image source.                                                                                                                                                            | `string \| undefined`                                                                                                  | `undefined`                    |
| `srcsetConsumption` | `srcset-consumption` | Specifies a list of image files to use in different situations. Defines multiple sizes of the same image, allowing the browser to select the appropriate image source based on consumption configuration. ``` <mds-img srcset-consumption="image-black-n-white-1x.jpg low, image-1x.jpg medium, image-2x.jpg high"></mds-img> ``` | `string \| undefined`                                                                                                  | `undefined`                    |
| `width`             | `width`              | The width attribute specifies the width of an image, in pixels.                                                                                                                                                                                                                                                                   | `string \| undefined`                                                                                                  | `undefined`                    |


## Events

| Event               | Description                                 | Type                             |
| ------------------- | ------------------------------------------- | -------------------------------- |
| `mdsImgLoadError`   | Emits when the image is not loaded          | `CustomEvent<MdsImgEventDetail>` |
| `mdsImgLoadSuccess` | Emits when the image is successfully loaded | `CustomEvent<MdsImgEventDetail>` |


## Methods

### `updateLang() => Promise<void>`



#### Returns

Type: `Promise<void>`




## Shadow Parts

| Part      | Description |
| --------- | ----------- |
| `"media"` |             |


## Dependencies

### Used by

 - [mds-avatar](../mds-avatar)
 - [mds-file-preview](../mds-file-preview)
 - [mds-push-notification-item](../mds-push-notification-item)

### Depends on

- [mds-icon](../mds-icon)
- [mds-text](../mds-text)
- [mds-button](../mds-button)

### Graph
```mermaid
graph TD;
  mds-img --> mds-icon
  mds-img --> mds-text
  mds-img --> mds-button
  mds-button --> mds-spinner
  mds-button --> mds-icon
  mds-button --> mds-text
  mds-avatar --> mds-img
  mds-file-preview --> mds-img
  mds-push-notification-item --> mds-img
  style mds-img fill:#f9f,stroke:#333,stroke-width:4px
```

----------------------------------------------

Built with love @ [Gruppo Maggioli](https://www.maggioli.com) from [R&D Department](https://www.maggioli.com/it-it/chi-siamo/ricerca-sviluppo)

---
_Source: https://npm.io/package/@maggioli-design-system/mds-img · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
