autocapitalize

1.0.2 • Public • Published

autocapitalize

npm npm bundle size (minified + gzip) Travis branch Codecov branch storybook

A small string manipulation library to capitalize letters based on rules

Table of Contents

Why?

I needed a fast and simple way to autocapitalize the first letter of a sentece. This library orients on the autocapitalize feature although this is not for inputs on mobile devices per se. This library just borrows the implementation to bring it to strings.

This can come in handy if you have user based content and want to manipulate the string so that it is correctly displayed on a website. Or if you write long texts your self and want to auto capitalize the beginning of every sentence. You could also implement it to autocapitalize the input value on input fields, altough this is not recommended, because it breaks the natural user expiriance, but rules exist to break them, right? 😝

Installation

$ npm i autocapitalize -S

or

$ yarn add autocapitalize

Functions

For more detailed information you can take a look at the documentation.

autocapitalize function

The function that manipulates a string.

Syntax

Returns a string.

const capitalizedText = autocapitalize(value, rule);

Parameters

Parameter Type Required Default Description
value string true The string you want to manipulate
rule string false off, none, on, sentences, words, characters
rule
Type Description
off, none autcapitalize returns the value (not manipulated)
on, sentences autcapitalize returns the value where the first letter of each sentence defaults to a capital letter
words autocapitalize returns the value where the first letter of each word defaults to a capital letter
characters autocapitalize returns the value where all letters defaults to a capital letter

Basic Usage

For more detailed information you can take a look at the documentation.

const { autocapitalize } = require('autocapitalize');
 
const value = 'this is an example text. this is an example text? this is an example text!'
 
// => "this is an example text. this is an example text? this is an example text!"
autocapitalize(value);
 
// => "this is an example text. this is an example text? this is an example text!"
autocapitalize(value, 'off');
 
// => "this is an example text. this is an example text? this is an example text!"
autocapitalize(value, 'none');
 
 
// => "This is an example text. This is an example text? This is an example text!"
autocapitalize(value, 'on');
 
// => "This is an example text. This is an example text? This is an example text!"
autocapitalize(value, 'sentences');
 
 
// => "This Is An Example Text. This Is An Example Text? This Is An Example Text!"
autocapitalize(value, 'words');
 
 
// => "THIS IS AN EXAMPLE TEXT. THIS IS AN EXAMPLE TEXT? THIS IS AN EXAMPLE TEXT!"
autocapitalize(value, 'characters');

License

MIT © Lukas Aichbauer

Versions

Current Tags

  • Version
    Downloads (Last 7 Days)
    • Tag
  • 1.0.2
    1
    • latest

Version History

  • Version
    Downloads (Last 7 Days)
    • Published
  • 1.0.2
    1
  • 1.0.1
    1
  • 1.0.0
    0

Package Sidebar

Install

npm i autocapitalize

Weekly Downloads

2

Version

1.0.2

License

MIT

Unpacked Size

8.32 kB

Total Files

5

Last publish

Collaborators

  • aichbauer