## Overview

The Horizontal Divider widget is a horizontal divider that renders a horizontal line (`<hr>` HTML element) to create visual separation between groups of attributes or form sections. It is designed exclusively for use within Attributes Group widgets as part of the Forms Wizard plugin.

This widget has no configurable properties - it provides pure presentational functionality with zero configuration overhead. The divider uses standard HTML and inherits styling from the application theme.

## Use Cases

### Sectioning Forms Wizard Steps
When configuring Forms Wizard steps, the horizontal divider helps organize attributes into logical sections. For example, separating general step information (name, title, description) from navigation settings (step type, next step, skip options).

### Visual Grouping in Complex Forms
In type definitions or page layouts with many attributes, the horizontal divider creates visual breaks to improve form readability and user comprehension without requiring separate widget sections.

### Logical Separation in Configuration Pages
For administrative or configuration interfaces where different categories of settings need to be distinguished visually (e.g., required settings vs. optional settings).

### When NOT to Use
- For functional separation requiring different widgets (use multiple Attributes Group widgets instead)
- For interactive or collapsible sections (use appropriate container widgets)
- When you need styled or customizable dividers (this renders a plain HTML `<hr>`)
- Outside of Attributes Group widgets (the widget is restricted to this context)

## Design Considerations

The Horizontal Divider widget is intentionally minimal:
- **No configurable attributes** - immediate usability with zero learning curve
- **No styling options** - consistent appearance across all forms
- **No interactive behavior** - pure presentation without complexity
- **Embedding restriction** - must be placed inside an Attributes Group widget

**Best Practices:**
- Use sparingly to avoid interface clutter
- Group 3-7 related attributes before adding a divider
- Combine with descriptive attribute labels for section clarity
- Consider using multiple Attributes Group widgets for major section breaks

## Alternatives

| Widget | When to Use Instead |
|--------|---------------------|
| Multiple Attributes Group widgets | For major section breaks requiring distinct visual containers |
| Rich String widget | When section headers with text labels are needed |
| Collapsible containers | For sections that users may want to expand/collapse |