Convert a value to AP/APA title case.
- What is this?
- When should I use this?
- Install
- Use
- API
- Algorithm
- Types
- Compatibility
- Contribute
- Security
- License
This small package turns a sentence into title case.
You can use this when you have short text of unknown casing and want to display it in a heading or so.
This package is ESM only. In Node.js (version 14.14+, 16.0+), install with npm:
npm install ap-style-title-caseIn Deno with esm.sh:
import {apStyleTitleCase} from 'https://esm.sh/ap-style-title-case@2'In browsers with esm.sh:
<script type="module">
import {apStyleTitleCase} from 'https://esm.sh/ap-style-title-case@2?bundle'
</script>import {apStyleTitleCase} from 'ap-style-title-case'
console.log(apStyleTitleCase('why sunless tanning is A hot trend'))
// 'Why Sunless Tanning Is a Hot Trend'Convert a value (string) to title case (string) using AP/APA style.
Configuration (optional).
Keep superfluous whitespace (boolean, default: false).
Whitespace is turned into a space by default.
List of stopwords (Array<string>, default: see below).
When a lowercased word is included in this list, it will be used as lowercase.
Otherwise words are capitalized.
- always capitalize the first word, even if it’s a stop word
- always capitalize the last word, even if it’s a stop word
- lowercase these words:
a,an,and,at,but,by,for,in,nor,of,on,or,so,the,to,up,yet
Many writers make the error of leaving
to beverbs in lower case. Even thoughis,are,was, andbe, are all short words, they should still be capitalized in a title because they are verbs.When you write titles that contain prepositions, your word processor will likely tell you that you should leave words like
with,about, andaroundlowercase. Defiantly look past the squiggly line indicating a potential error, and remember that in AP title case, prepositions with four or more letters should be capitalized.These rules are the exact same for APA style, the only difference being that AP style does not recommend the use of title case for newspaper headlines, but rather sentence case.
- How to correctly use AP (and APA) style title case on
bkacontent.com - AP Stylebook on
wikipedia.com - APA style on
wikipedia.com - Title case and sentence case capitalization in APA style on
apastyle.org
This package is fully typed with TypeScript.
It exports the additional type Options.
This package is at least compatible with all maintained versions of Node.js. As of now, that is Node.js 14.14+ and 16.0+. It also works in Deno and modern browsers.
Yes please! See How to Contribute to Open Source.
This package is safe.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent