# Editor Plugin Selection Toolbar

Selection toolbar plugin for @atlaskit/editor-core

**Note:** This component is designed for internal Atlassian development.
External contributors will be able to use this component but will not be able to submit issues.

## Overview

The Selection Toolbar plugin provides a floating toolbar that appears when text is selected in the editor. It enables users to perform formatting actions and access contextual controls based on the current selection within the editor.

## Key features

- **Floating toolbar on selection** - Displays contextual formatting options when text is selected
- **Toolbar positioning** - Supports multiple toolbar docking positions (top, bottom, none) with user preferences
- **Configurable toolbar placement** - Option to prefer toolbar above or below the selection
- **Toolbar state management** - Manages visibility and stability of the toolbar during editing
- **Analytics integration** - Tracks toolbar interactions and user preferences through analytics events
- **User preferences** - Respects user's toolbar docking preferences across sessions

## Install
---
- **Install** - *yarn add @atlaskit/editor-plugin-selection-toolbar*
- **npm** - [@atlaskit/editor-plugin-selection-toolbar](https://www.npmjs.com/package/@atlaskit/editor-plugin-selection-toolbar)
- **Source** - [Bitbucket](https://bitbucket.org/atlassian/atlassian-frontend/src/master/packages/editor/editor-plugin-selection-toolbar)
- **Bundle** - [unpkg.com](https://unpkg.com/@atlaskit/editor-plugin-selection-toolbar/dist/)

## Usage
---
**Internal use only**

@atlaskit/editor-plugin-selection-toolbar is intended for internal use by the @atlaskit/editor-core and as a plugin dependency of the Editor within your product.

Direct use of this component is not supported.

Please see [Atlaskit - Editor plugin selection toolbar](https://atlaskit.atlassian.com/packages/editor/editor-plugin-selection-toolbar) for documentation and examples for this package.

## Support
---
For internal Atlassian, visit the slack channel [#help-editor](https://atlassian.slack.com/archives/CFG3PSQ9E) for support or visit [go/editor-help](https://go/editor-help) to submit a bug.

## License
---
Please see [Atlassian Frontend - License](https://hello.atlassian.net/wiki/spaces/AF/pages/2589099144/Documentation#Platform-License) for more licensing information.
