import { Meta, Story, ArgsTable, Canvas } from '@storybook/addon-docs/blocks';
import { Head1 } from './head.component';
import { FlowPropsTable, ExternalReferenceLink } from '../../../utils';

<Meta title="2 - System/Typography/Headings/Head" component={Head1} />

# Head

Headings `h1` - `h5` with safe defaults.

## Accessibility Requirements

Prefer the heading that makes semantic sense for the page on which it's used. Control the font size with the `fontSize` prop.

## Variations

### Default

| H Tag | Pixel Value |
| ----- | ----------- |
| h5    | 16px        |
| h4    | 18px        |
| h3    | 20px        |
| h2    | 27px        |
| h1    | 34px        |

<Canvas withToolbar>
  <Story id="2-system-typography-headings-head--default" />
</Canvas>

### Font Sizes

| Size | Pixel Value |
| ---- | ----------- |
| f1   | 16px        |
| f2   | 18px        |
| f3   | 20px        |
| f4   | 27px        |
| f5   | 34px        |
| f6   | 41px        |
| f7   | 48px        |

<Canvas withToolbar>
  <Story id="2-system-typography-headings-head--font-sizes" />
</Canvas>

## Supported Layout Props

### Spacing

<Preview withToolbar>
  <Story id="2-system-typography-headings-head--mixins-spacing" />
</Preview>

### Stackee

<Preview withToolbar>
  <Story id="2-system-typography-headings-head--mixins-stackee" />
</Preview>

## Props

<FlowPropsTable ofComponent={Head1} />

## External Reference

<ExternalReferenceLink src="" type="figma" />
<ExternalReferenceLink
  src="https://github.com/wealthsimple/patchwork/tree/master/core/typography/head"
  type="github"
/>
