1.0.0 • Published 6 years ago

st-gravatar-img v1.0.0

Weekly downloads
5
License
MIT
Repository
github
Last release
6 years ago

npm version Build Status Dependency Status semantic-release Built With Stencil

A simple web component to display gravatar images based on stencil

Install this component

By cdn (cdn hosted)

<script src="https://unpkg.com/st-gravatar-img@latest/dist/st-gravatar-img.js"></script>

By npm (self hosted)

npm install st-gravatar-img --save
<script src="node_modules/st-gravatar-img/dist/st-gravatar-img.js"></script>

Use this component

<!-- by md5 hash of your email -->
<st-gravatar-img hash="322b70sg015ith31u69b49cc1c81315f"></st-gravatar-img>
<!-- or by email -->
<st-gravatar-img email="my@email.com"></st-gravatar-img>

Attributes

AttributeTypeDefaultDescription
hashstring322b70sg015ith31u69b49cc1c81315fMD5 hash of your email (avoid to expose your email)
emailstringmy@email.comGravatar account email (warning email will be exposed)
sizenumber120Size (px) of the image

CSS Variables

CSS Variables can be used to style the web component:

Available variables

AttributeDefaultDescription
--gravatar-img-bordernoneDefines border property of the img element
--gravatar-img-border-radiusnoneDefines border-radiues property of the img element
--gravatar-img-backgroundnoneDefines background property of the img element

Example usage

st-gravatar-img {
  --gravatar-img-border: 10px solid #a52525;
  --gravatar-img-border-radius: 100%;
  --gravatar-img-background: #a52525;
}

How to create a hash

Images on Gravatar can be accessed by a MD5 hash of your email address.

How to use createHash method

This web component offers the possibility to create a hash based on your email address by the exposed createHash method.

let gravatarImg = document.querySelector('st-gravatar-img');

// method is available when component is ready
gravatarImg.componentOnReady().then(() => {
  // create hash
  const hash = gravatarImg.createHash('my@email.ccom');
  // now you can apply the hash on the web component
  gravatarImg.setAttribute('hash', hash);
});