# Link
Create an HTML link.

**Selector:**
og-link

**Use:**
`<og-link></og-link>`

## Module
```javascript
import { LinkModule } from '@opensesame/opensesameui';
```

## Types
```javascript
import { LinkProps } from '@opensesame/opensesameui';
import { LinkClasses } from '@opensesame/opensesameui';
```

## Props
Name | Type | Default | Description
---- | ---- | ------- | -----------
classes | object | | Override or extend the styles applied to the component.
className | string | | Class(es) applied to the component.
color | 'error' &#124; 'inherit' &#124; 'primary' &#124; 'secondary' &#124; 'textPrimary' &#124; 'textSecondary' | 'primary' | The link color
display | 'initial' &#124; 'block' &#124; 'inline' | 'inline' | The CSS display property for the link.
link | string | | The link destination (href).
newTab | boolean &#124; string | false | If `true`, link will open in a new tab.
typographyClasses | { [k in keyof TypographyClasses]?: string } | | Classes passed to the underlying typography component.
underline | 'always' &#124; 'hover' &#124; 'none' | 'hover' | The link's text decoration.
variant | TypographyVariants | 'inherit' | The variant of the underlying typography component.

## Classes
Rule name | Class | Description
--------- | ----- | -----------
root | .og-link-root | Styles applied to the root element.
underlineAlways | .og-link-underline-always | Styles applied when `underline="always"`.
underlineHover | .og-link-underline-hover | Styles applied when `underline="hover"`.
underlineNone | .og-link-underline-none | Styles applied when `underline="none"`.
