# @valle/valle-input

> Awesome valle-input - web component using Polymer 3x

Latest version **2.9.0** (published 2021-07-01) · MIT license · 0 weekly downloads

## Install

```sh
npm install @valle/valle-input
pnpm add @valle/valle-input
yarn add @valle/valle-input
bun add @valle/valle-input
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 2.9.0 |
| Published | 2021-07-01 |
| First published | 2020-02-20 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 1 |
| Unpacked size | 53.4 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Maintainers | vallesistemas, afonsopacifer |
| Keywords | polymer, polymer-3, web-components, valle-input |

## Links

- npm: https://www.npmjs.com/package/@valle/valle-input
- Repository: https://github.com/valleweb/valle-input
- Issues: https://github.com/valleweb/valle-input/issues
- npm.io page: https://npm.io/package/@valle/valle-input

## Dependencies (1)

- [@polymer/polymer](https://npm.io/package/@polymer/polymer.md) ^3.0.0

## Recent versions

- 2.9.0 (latest) — 2021-07-01
- 2.8.0 — 2021-07-01
- 2.7.0 — 2021-06-10
- 2.6.2 — 2021-06-10
- 2.6.1 — 2021-06-09
- 2.5.11 — 2021-06-08
- 2.5.10 — 2021-06-08
- 2.5.9 — 2021-06-07
- 2.5.8 — 2021-06-07
- 2.5.7 — 2021-04-16
- 2.5.6 — 2020-11-09
- 2.5.5 — 2020-11-05
- 2.5.4 — 2020-11-04
- 2.5.3 — 2020-11-04
- 2.5.2 — 2020-11-04
- … 14 more at https://npm.io/package/@valle/valle-input/versions

## README

# valle-input

> Awesome valle input element - web component using Polymer 3x

[![Published on webcomponents.org](https://img.shields.io/badge/webcomponents.org-published-blue.svg)](https://www.webcomponents.org/element/valleweb/valle-input)

## How to install and use:

1 - Install the element using [Yarn](http://yarn.io/):

```sh
$ yarn add @valle/valle-input
```

2 -  Import the element:

```html
<script type="module" src="./node_modules/@valle/valle-input/valle-input.js"></script>
```

or in your javascript file

```js
import '@valle/valle-input/valle-input.js';
```

3 - Start using it!

<!--
```
<custom-element-demo>
  <template>
    <link rel="import" href="./demo/index.html">
    <next-code-block></next-code-block>
  </template>
</custom-element-demo>
```
-->

```html
<valle-input label="Name" placeholder="Adam Sandler" helpertext="Full name"></valle-input>
```

## Properties

Property        | Type        | Default   | Description
:---            |:---         |:---       |:---
`label`         | *String*    | `""`      | Default label
`type`          | *String*    | `text`    | Input type
`validateby`    | *String*    | `""`      | Type for validate (available: `name`)
`placeholder`   | *String*    | `""`      | Default placeholder
`helpertext`    | *String*    | `""`      | Description text for help
`errortext`     | *Srting*    | `""`      | Error message
`pattern`       | *String*    | `""`      | RegExp for validate
`value`         | *String*    | `""`      | Input value
`error`         | *Boolean*   | `false`   | Error state
`required`      | *Boolean*   | `false`   | Required validate
`disabled`      | *Boolean*   | `false`   | Disabled state
`autofocus`     | *Boolean*   | `false`   | Default autofocus
`step`          | *Number*    | `0`       | Custom step for number inputs
`tooltip`       | *String*    | `""`      | A tooltip for inputs
`tooltippos`    | *String*    | `""`      | Tooltip position (available: `top-right`)
`tooltiplength` | *String*    | `""`      | Tooltip length (available: `small`, `medium` and `large`)

## Styling

The following custom properties and mixins are available for styling:

Custom property           | Default                   | Description
:---                      |:---                       |:---
--valle-input-color       | `rgba(5, 159, 183, .87)`  | Primary color
--valle-input-width       | `100%`                    | Input Width
--icon-tooltip-color      | `#000`                    | Icon tooltip color

## Browser Support

Using the [webcomponents.js](https://github.com/WebComponents/webcomponentsjs):

 ![Chrome](https://cdnjs.cloudflare.com/ajax/libs/browser-logos/39.2.2/chrome/chrome_48x48.png) | ![Opera](https://cdnjs.cloudflare.com/ajax/libs/browser-logos/39.2.2/opera/opera_48x48.png) | ![Firefox](https://cdnjs.cloudflare.com/ajax/libs/browser-logos/39.2.2/firefox/firefox_48x48.png) | ![Safari](https://cdnjs.cloudflare.com/ajax/libs/browser-logos/39.2.2/safari/safari_48x48.png) |![IE](https://cdnjs.cloudflare.com/ajax/libs/browser-logos/39.2.2/archive/internet-explorer_9-11/internet-explorer_9-11_48x48.png) |  ![Edge](https://cdnjs.cloudflare.com/ajax/libs/browser-logos/39.2.2/edge/edge_48x48.png) |
:---: | :---: | :---: | :---: | :---: | :---: |
Latest ✔ | Latest ✔ | Latest ✔ | Latest ✔ | 11+ | Latest ✔

## Development

1 - Install [Yarn](https://yarnpkg.com/) & [Polymer-CLI](https://polymer-library.polymer-project.org/3.0/docs/install-3-0):

```sh
$ [sudo] yarn global add polymer-cli
```

2 - Install local dependencies:

```sh
$ yarn
```

3 - Start the development server:

```sh
$ yarn start
```

Go to [localhost:8080/components/valle-input/](http://localhost:8080/components/valle-input/)


## Tests

#### Unit tests

Run tests:

```sh
$ yarn test
```

## Versioning

To keep better organization of releases we follow the [Semantic Versioning 2.0.0](http://semver.org/) guidelines.

## Contributing

Find on our [issues](https://github.com/valleweb/valle-input/issues/) the next steps of the project ;)
<br>
Want to contribute? [Follow these recommendations](https://github.com/valleweb/valle-input/blob/master/CONTRIBUTING.md).

## History

See [Releases](https://github.com/valleweb/valle-input/releases) for detailed changelog.

## License

[MIT License](https://github.com/valleweb/valle-input/blob/master/LICENSE.md) © [valleweb](https://github.com/orgs/valleweb/people)

---
_Source: https://npm.io/package/@valle/valle-input · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
