Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

@directus/format-title

directus56.8kMIT12.0.1TypeScript support: included

Custom formatter that converts any string into Title Case

title-case, title, case, directus, format, string, articles, conjunctions, prepositions

readme

@directus/format-title

Custom formatter that converts any string into Title Case.

Capital letters are used for principal words. Articles, conjunctions, and prepositions do not get capital letters unless they start or end the title.

Input Output
snowWhiteAndTheSevenDwarfs Snow White and the Seven Dwarfs
NewcastleUponTyne Newcastle Upon Tyne
brighton_on_sea Brighton on Sea
apple_releases_new_ipad Apple Releases New iPad
7-food-trends 7 Food Trends

The package contains a list of words that use some sort of special casing, for example: McDonalds, iPhone, and YouTube.

Installation

npm install @directus/format-title

Usage

The package by default converts camelCase, PascalCase, underscore, and "regular" sentences to Title Case.

formatTitle(string, [separator]);

formatTitle('snowWhiteAndTheSevenDwarfs');
// => Snow White and the Seven Dwarfs

You can provide an optional separator regex as a second parameter to support splitting the string on different characters. By default, this regex is set to /\s|-|_/g.

License

This package is licensed under the MIT License. See the LICENSE file for more information.

Additional Resources