# val

**Repository Path**: mirrors_regular/val

## Basic Information

- **Project Name**: val
- **Description**: get/set element value - inspired by jQuery .val()
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-09-25
- **Last Updated**: 2026-01-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# val

  get/set element value and more

## Installation

    $ component install nickjackson/val

## Example
```js
var val = require('val');

var el = document.querySelector('#textbox');

val(el).value('foo bar baz')
// set value to 'foo bar baz'

val(el).value()
//= 'foo bar baz'
```

## API
### input/text
* `.value()` - get value 
* `.value(str)` - set value 

### input/checkbox
* `.value()` - get value
    * returns value or true if checked
    * returns undefined if not checked.
* `.value(str)` - sets value
* `.checked()` - gets checked state
* `.checked(boolean)` - sets checked state
* `.checkedValue()` - gets value irrelevant of checked

### textarea
* `.value()` - get value 
* `.value(str)` - set value 

### select
* `.value()` - get value of selection option
* `.value(str)` - set selected option by `.value`
* `.text()` - get innerText of selected option 
* `.text(str)` - set selected option by `.innerText`

## Todo
* multiple support from select node
* Allow select-options to be added with object/array.

## License

  MIT