# selection-update

**Repository Path**: mirrors_nikku/selection-update

## Basic Information

- **Project Name**: selection-update
- **Description**: Computing selection updates on external INPUT value changes, browser style.
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-09-25
- **Last Updated**: 2026-03-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# selection-update

[![CI](https://github.com/nikku/selection-update/actions/workflows/CI.yml/badge.svg)](https://github.com/nikku/selection-update/actions/workflows/CI.yml)

Computing input selection updates on external content changes, as if we used browser managed _undo_ and _redo_.


## API

```javascript
/**
 * Calculate the selection update for the given
 * current and new input values.
 *
 * @param {Object} currentSelection as {start, end}
 * @param {String} currentValue
 * @param {String} newValue
 *
 * @return {Object} newSelection as {start, end}
 */
calculateUpdate(currentSelection, currentValue, newValue);
```


## Usage

```javascript
import { calculateUpdate } from 'selection-update';

/**
 * Update input with new value.

 * @param {Node} $input
 * @param {String} newValue
 */
function updateInput($input, newValue) {

  var newSelection;

  // only retrieve and restore input, if the element
  // is currently active
  if (document.activeElement === $input) {

    // get the current selection and pass it in as {start, end}
    newSelection = selectionUpdate(getSelection($input), $input.value, newValue);
  }

  // apply new value, will naturally send selection to input end
  $input.value = value;

  if (newSelection) {
    // set new {start, end} selection on input
    setSelection($input, selection);
  }
}
```


## Related

* [selection-ranges](https://github.com/nikku/selection-ranges) - manipulate selection ranges on contenteditable elements


## License

MIT