[![npm](https://img.shields.io/npm/v/capsize.svg?style=for-the-badge)](https://www.npmjs.com/package/capsize)
Capsize

> Capsize makes the sizing and layout of text as predictable as every other element on the screen. > > Using font metadata, text can now be sized according to the height of its capital letters while trimming the space above capital letters and below the baseline.

```bash $ npm i --save capsize ``` ```js import capsize from 'capsize'; const styles = capsize({ capHeight: 16, lineGap: 8, fontMetrics: { capHeight: 700, ascent: 1058, descent: -291, lineGap: 0, unitsPerEm: 1000, }, }); ```
# Options ## Text size Capsize supports two methods of defining the size of text, `capHeight` and `fontSize`. **NOTE: You should only ever pass one or the other, not both.** ### `capHeight: ` Sets the height of the capital letters to the defined value. Defining typography in this way makes aligning to a grid or with other elements, e.g. icons, a breeze. Highlighting the cap height

### `fontSize: ` Setting the font size allows you to get all the benefits of the white space trimming, while still specifying an explicit `font-size` for your text. This can be useful when needed to match a concrete design spec or fitting into an existing product. Highlighting the font size

## Line height Capsize supports two mental models for specifying line height, `lineGap` and `leading`. If you pass neither the text will follow the default spacing of the specified font, e.g. `line-height: normal`. **NOTE: You should only ever pass one or the other, not both.** ### `lineGap: ` Sets the number of pixels between lines, as measured between the baseline and cap height of the next line. Highlighting the line gap

### `leading: ` Sets the line height to the provided value as measured from the baseline of the text. This aligns the web with how typography is treated in design tools. Highlighting the leading

## Font Metrics This metadata is extracted from the metrics tables inside the font itself. You can use [the Capsize website](https://seek-oss.github.io/capsize/) to find these by selecting a font and referencing `JavaScript` tab in step 3.
# Utilities ### getCapHeight Returns the actual rendered cap height for a specific font size given the provided font metrics. ```ts import { getCapHeight } from 'capsize'; const actualCapHeight = getCapHeight({ fontSize: 24, fontMetrics: { ... } }) ```

# License MIT.

	Stars	Issues	Version	Updated	Created
@vanilla-extract/sprinkles	9,287	64	1.6.1	a year ago	3 years ago
capsize			2.0.0	3 years ago	4 years ago
linaria	11,213	146	6.2.0	24 days ago	7 years ago
playroom	4,422	42	0.37.1	2 months ago	6 years ago

@vanilla-extract/sprinkles vs capsize vs linaria vs playroom

Downloads in past1 Month3 Months6 Months1 Year2 Years5 YearsAll time

Stats

Popular Searches

Sick of boring JavaScript newsletters?

Downloads in past