# Specification

## Overview

Icons are symbols used to represent features, functionality, or content.

This specification is an extension of [SDS Icon Specification &rarr;](https://github.com/salesforce-ux/salesforce-design-system/blob/main/packages/sds-components/src/icon/icon.spec.md)
## Use Cases

Use an icon to provide additional context or enhanced usability to a UI element.

## Non-goals

[SDS Icon - Non Goals &rarr;](https://github.com/salesforce-ux/salesforce-design-system/blob/main/packages/sds-components/src/icon/icon.spec.md#non-goals)

## Features

[SDS Icon - Features &rarr;](https://github.com/salesforce-ux/salesforce-design-system/blob/main/packages/sds-components/src/icon/icon.spec.md#features)

## Prior Art/Examples

[SDS Icon - Prior Art/Examples &rarr;](https://github.com/salesforce-ux/salesforce-design-system/blob/main/packages/sds-components/src/icon/icon.spec.md#prior-artexamples)

## API

## Anatomy and Appearance

### DOM Structure

[SDS Icon - DOM Structure &rarr;](https://github.com/salesforce-ux/salesforce-design-system/blob/main/packages/sds-components/src/icon/icon.spec.md#dom-structure)

### Slots

[SDS Icon - Slots &rarr;](https://github.com/salesforce-ux/salesforce-design-system/blob/main/packages/sds-components/src/icon/icon.spec.md#slots)

### Parts

[SDS Icon - Parts &rarr;](https://github.com/salesforce-ux/salesforce-design-system/blob/main/packages/sds-components/src/icon/icon.spec.md#parts)

### Properties & Attributes

[SDS Icon - Properties & Attributes &rarr;](https://github.com/salesforce-ux/salesforce-design-system/blob/main/packages/sds-components/src/icon/icon.spec.md#properties--attributes)

### Methods

[SDS Icon - Methods &rarr;](https://github.com/salesforce-ux/salesforce-design-system/blob/main/packages/sds-components/src/icon/icon.spec.md#methods)

### Events

N/A

### Styling Hooks

[SDS Icon - Styling Hooks &rarr;](https://github.com/salesforce-ux/salesforce-design-system/blob/main/packages/sds-components/src/icon/icon.spec.md#styling-hooks)

## Behavior

### States & Interactions

[SDS Icon - States & Interactions &rarr;](https://github.com/salesforce-ux/salesforce-design-system/blob/main/packages/sds-components/src/icon/icon.spec.md#states--interactions)

## Accessibility

[SDS Icon - Accessibility &rarr;](https://github.com/salesforce-ux/salesforce-design-system/blob/main/packages/sds-components/src/icon/icon.spec.md#accessibility)

## Internationalization

[SDS Icon - Internationalization &rarr;](https://github.com/salesforce-ux/salesforce-design-system/blob/main/packages/sds-components/src/icon/icon.spec.md#internationalization)

## Test Plan

[SDS Icon - Test Plan &rarr;](https://github.com/salesforce-ux/salesforce-design-system/blob/main/packages/sds-components/src/icon/icon.spec.md#test-plan)