README.md

wc-arrow

A web component for creating custom arrow HTML elements.

Component custom attributes and CSS style together enable forming of various arrow figures.

Wc-arrow is a standalone vanilla JS web component that does not use shadow DOM.

Live demo available here.

Including the component to an HTML file

1. Import polyfill, this is not needed for modern browsers:

   <script src="https://cdnjs.cloudflare.com/ajax/libs/custom-elements/1.4.1/custom-elements.min.js"></script>

2. Import custom element:

   <script defer src='wc-arrow.min.js'></script>

3. Start using it!

      <wc-arrow
        l=150 w=150 tail-w=40 peak-coll=50>
      </wc-arrow>  

Including the component from NPM

1. Install and import polyfill, this is not needed for modern browsers:

   See https://www.npmjs.com/package/@webcomponents/custom-elements

2. Install wc-arrow NPM package:

   npm i @vanillawc/wc-arrow

3. Import custom element:

   import '@vanillawc/wc-arrow'

4. Start using it:

   var arrow = document.createElement('wc-arrow')
   arrow.setAttribute("l", "150")
   arrow.setAttribute("w", "150")
   arrow.setAttribute("tail-w", "40")
   arrow.setAttribute("peak-coll", "50")
   document.body.appendChild(menu)

Display style

Element display style can be set to flex, inline-flex or none.

When the element renders itself, it sets its display style to flex, if the style is not flex, inline-flex or none.

Attributes

l

Defines arrow length in pixels.

HTML example:

<wc-arrow l=100 w=100> </wc-arrow>

w

Defines arrow width in pixels.

HTML example:

<wc-arrow l=100 w=100> </wc-arrow>

tail-l

Percentage value that defines arrow tail length in relation to arrow length.

Value must be a number between 0 and 100.

Default value is 50.

HTML example:

<wc-arrow l=100 w=100 tail-l=20> </wc-arrow>

tail-w

Percentage value that defines arrow tail width in relation to arrow width.

Value must be a number between 0 and 100.

Default value is 50.

HTML example:

<wc-arrow l=100 w=100 tail-w=20> </wc-arrow>

peak-l

Length of arrow peak in pixels.

If this attribute is defined, tail-l attribute has no effect.

HTML example:

<wc-arrow l=100 w=100 peak-l=20> </wc-arrow>

rot

Arrow rotation in degrees.

This attribute rotates only the arrow within the custom element.

To rotate both the arrow and the element, transform style definition must be applied to the custom element.

Value must be a number between -360 and 360.

Default value is 0.

HTML example:

<wc-arrow l=100 w=100 rot=-90> </wc-arrow>

tail-cont

Defines tail contraction with a proportional value from 0 to 100.

0 = no contraction at all

100 = complete contraction

Default value is 0.

HTML example:

<wc-arrow l=100 w=100 tail-cont=20> </wc-arrow>

peak-coll

Defines peak collapse with a proportional value from 0 to 100.

0 = no collapse at all

100 = complete collapse

Default value is 0.

HTML example:

<wc-arrow l=100 w=100 peak-coll=20> </wc-arrow>

unclosed

Defines whether the arrow rear stroke is visible or not.

By default the rear stroke is visible.

HTML example for setting the stroke invisible:

<wc-arrow l=100 w=100 unclosed> </wc-arrow>

Attribute can be disabled by assigning a string "false" as its value.

scale

Defines the arrow scale.

Default value is 1.

Scaling is applied only to the arrow.

To scale both the arrow and the element, transform style definition must be applied to the custom element.

HTML example:

<wc-arrow l=100 w=100 scale=0.5> </wc-arrow>

Essential CSS properties

stroke-width

stroke

fill

background-color

stroke-linejoin

border-radius

transform: rotate

transform: scale

height

width

Take a look at live demo to see how custom attributes and CSS properties are used together.

Usage example

Take a look at file arrow.html in examples folder

License

Copyright (c) 2020 Jussi Utunen

Licensed under the MIT License