2.7.1 • Published 3 months ago

@maggioli-design-system/mds-img v2.7.1

Weekly downloads
-
License
MIT
Repository
-
Last release
3 months ago

mds-img

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

Properties

PropertyAttributeDescriptionTypeDefault
altaltSpecifies an alternate text for an imagestring''
aspectRatioaspect-ratioSpecifies the aspect ratio of the image, useful to render all images of a list with the same proportions. When defined, mds-img will render the Host element with background-image instead of wrapping ad img element. This will drop all atributes useful for img elements only: alt, crossorigin, height, loading, referrerpolicy, sizes, src, srcset, widthstring''
crossorigincrossoriginAllow images from third-party sites that allow cross-origin access to be used with canvas"anonymous" \| "use-credentials" \| undefined'use-credentials'
heightheightThe height attribute specifies the height of an image, in pixels.string \| undefinedundefined
loadingloadingSpecifies whether a browser should load an image immediately or to defer loading of images until some conditions are met."eager" \| "lazy" \| undefined'lazy'
referrerpolicyreferrerpolicySpecifies 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'
sizessizesOne 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-882a2eadb6dbstring \| undefinedundefined
srcsrcSpecifies the path to the imagestringundefined
srcsetsrcsetSpecifies 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 \| undefinedundefined
widthwidthThe width attribute specifies the width of an image, in pixels.string \| undefinedundefined

Events

EventDescriptionType
mdsImgLoadErrorEmits when the image is not loadedCustomEvent<MdsImgEventDetail>
mdsImgLoadSuccessEmits when the image is successfully loadedCustomEvent<MdsImgEventDetail>

Shadow Parts

PartDescription
"media"

Dependencies

Used by

Graph

graph TD;
  mds-avatar --> mds-img
  mds-file-preview --> mds-img
  mds-push-notification --> mds-img
  style mds-img fill:#f9f,stroke:#333,stroke-width:4px

Built with love @ Gruppo Maggioli from R&D Department