1.0.5-rc2 • Published 3 years ago

polkadot-web-identicon v1.0.5-rc2

Weekly downloads
-
License
Apache-2.0
Repository
github
Last release
3 years ago

Polkadot Web Identicon

A generic identity icon that renders Substrate based chains identicons for html/javascript frontend applications.

This project is based on the polkadod-angular-identicon

Usage

The simplest way to use the component is to download it from npm

We assume you have npm and node.js installed in your environment.

1) create a folder with a name of your choice for example : pwi (like polkadot-web-identicon 😎)

cd into the pwi (or the one you created) folder.

Type npm init to create the package.json file that will allow us to download packages from npm.

For simplicity sake, type enter for each question and at the end the package.json file should be created.

Create an index.html file that will contain the html and javascript code and past the following html snippet.

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Testing polkadot-web-identicon</title>
</head>
<body>

</body>
</html>

Now we can install the polkadot-web-identicon package from npm with :

npm i polkadot-web-identicon After the installation completed we are ready to use the package we just need to do two things:

  • import the component library code files
  • call the component and use it with our parameters

These are the attributes that we can pass to the polkadot-web-identicon tag

address : the Substrate blockhain based address to pass as parameter

theme : the theme we want to display ( polkadot, beachball, jdenticon)

size : the size we want our identicon to be.

Our final structure in the index.html file will look like this:

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Testing polkadot-web-identicon</title>
</head>
<body>


    <h3>Polkadot icon theme  with default size</h3>
    <polkadot-web-identicon address="5FHneW46xGXgs5mUiveU4sbTyGBzmstUspZC92UhjJM694ty" theme="polkadot"></polkadot-web-identicon>
    <br>
    <h3>beachball icon theme  with size of 80 </h3>
    <polkadot-web-identicon address="5FHneW46xGXgs5mUiveU4sbTyGBzmstUspZC92UhjJM694ty" theme="beachball" size="80"></polkadot-web-identicon>
    <br>
    <h3>jdenticon icon theme  with size of 120</h3>
    <polkadot-web-identicon address="5FHneW46xGXgs5mUiveU4sbTyGBzmstUspZC92UhjJM694ty" theme="jdenticon" size="120"></polkadot-web-identicon>

<script type="text/javascript" src="node_modules/polkadot-web-identicon/main.js"></script>
<script type="text/javascript" src="node_modules/polkadot-web-identicon/polyfills.js"></script>
<script type="text/javascript" src="node_modules/polkadot-web-identicon/runtime.js"></script>

</body>
</html>

Run

you can run npx live-server under the pwi or your project to see the render icons or open the index.html file on browser

Usage of built example

See inside pwi folder to see a ready to use example. on the terminal type npm i and npx live-serverto run the example.

Hackers Guide

For those who wants to build or tweak the library see BUILD.md file under documentation.

Improvements are on the way !!! Happy coding 😎!!!

1.0.5-rc1

3 years ago

1.0.5-rc2

3 years ago

1.0.4-rc1

3 years ago

1.0.3-rc2

3 years ago

1.0.2

3 years ago

1.0.1

3 years ago

1.0.0

3 years ago

1.0.3

3 years ago

0.0.1-security

3 years ago

0.0.1

3 years ago

0.1.0

3 years ago

0.0.0

3 years ago