import { Canvas, Controls, Meta, Title } from '@storybook/addon-docs/blocks';
import * as AgenticSplitButtonStories from './AgenticSplitButton.stories';
<Meta of={AgenticSplitButtonStories} name='Usage' />
<Title />
## Purpose
A split button for actions the agent does: a primary action grouped with a menu of more actions. It is the PDS Split Button with the AI gradient as the border around the whole control, to match the Agentic Button and Agentic Menu Button.
## Usage
- It is a separate component, not an option of the Split Button. `actionItems` is an array: the first item is the primary action and the rest fill the menu. Every other Split Button prop is the same, except `variant`: there is one look, the secondary treatment, as on the Agentic Button.
- The gradient is one border around the primary action and the caret together, not on each half. The control keeps the height of a standalone Agentic Button.
- `isAnimated` shimmers the border. It stops for reduced motion.
- Use it where the main action is something the agent does, with the other ways to run it in the menu.
## Implementation
See the table below for the available props.
<hr />
<Canvas of={AgenticSplitButtonStories.Default} />
<Controls of={AgenticSplitButtonStories.Default} />
Agentic Split Button
A separate component, `AgenticSplitButton`, a copy of the PDS v2 Split Button, so the engineer's port is mostly a copy:
Net-new componentOpen in Storybook