**[ This description is mirrored from README.md at [github.com/BrightspaceUI/text-input](https://github.com//BrightspaceUI/text-input/blob/v0.6.0/README.md) on 2019-05-10 ]**
# d2l-text-input
[![Published on webcomponents.org](https://img.shields.io/badge/webcomponents.org-published-blue.svg)](https://www.webcomponents.org/element/BrightspaceUI/text-input)
[![Bower version][bower-image]][bower-url]
[![Build status][ci-image]][ci-url]
[Polymer](https://www.polymer-project.org)-based web component for D2L text inputs.
![screenshot of text input component](/text-input.gif?raw=true)
For further information on this and other Brightspace UI components, see the docs at [ui.developers.brightspace.com](http://ui.developers.brightspace.com/).
## Installation
`d2l-text-input` can be installed from [Bower][bower-url]:
```shell
bower install d2l-text-input
```
## Usage
Include the [webcomponents.js](http://webcomponents.org/polyfills/) "lite" polyfill (for browsers who don't natively support web components), then import the component as needed:
```html
```
Then use the `` custom element in your application.
```html
```
Many of the same attributes from native [`` are available](https://developer.mozilla.org/en/docs/Web/HTML/Element/input):
```html
```
## Developing, Testing and Contributing
After cloning the repo, run `npm install` to install dependencies.
If you don't have it already, install the [Polymer CLI](https://www.polymer-project.org/2.0/docs/tools/polymer-cli) globally:
```shell
npm install -g polymer-cli
```
To start a [local web server](https://www.polymer-project.org/2.0/docs/tools/polymer-cli-commands#serve) that hosts the demo page and tests:
```shell
polymer serve
```
To lint ([eslint](http://eslint.org/) and [Polymer lint](https://www.polymer-project.org/2.0/docs/tools/polymer-cli-commands#lint)):
```shell
npm run test:lint
```
To run unit tests locally using [Polymer test](https://www.polymer-project.org/2.0/docs/tools/polymer-cli-commands#tests):
```shell
npm run test:polymer:local
```
To lint AND run local unit tests:
```shell
npm test
```
[bower-url]: http://bower.io/search/?q=d2l-text-input
[bower-image]: https://badge.fury.io/bo/d2l-text-input.svg
[ci-url]: https://travis-ci.org/BrightspaceUI/text-input
[ci-image]: https://travis-ci.org/BrightspaceUI/text-input.svg?branch=master