# 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.](http://135.181.40.67/wc-arrow/)
## Including the component to an HTML file
1. Import polyfill, this is not needed for modern browsers:
```html
```
2. Import custom element:
```html
```
3. Start using it!
```html
```
## 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:
```console
npm i @vanillawc/wc-arrow
```
3. Import custom element:
```javascript
import '@vanillawc/wc-arrow'
```
4. Start using it:
```javascript
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:
```html
```
### w
Defines arrow width in pixels.
HTML example:
```html
```
### 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:
```html
```
### 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:
```html
```
### peak-l
Length of arrow peak in pixels.
If this attribute is defined, tail-l attribute has no effect.
HTML example:
```html
```
### 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:
```html
```
### 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:
```html
```
### 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:
```html
```
### 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:
```html
```
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:
```html
```
## 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](http://135.181.40.67/wc-arrow/) 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
