## Overview

Widget for entering formatted text with a title. The Rich String widget provides a way to add formatted HTML content to pages within a titled frame. Unlike attribute-based widgets that display data from entities, this widget stores its content directly in the widget configuration, making it ideal for static informational content that doesn't need to update dynamically with data changes.

The widget supports the full range of HTML formatting options including headings, lists, links, tables, and embedded images, while ensuring security through automatic content sanitization.

## Use Cases

- **Documentation and Instructions**: Add formatted help sections, step-by-step guides, or explanatory content with headings and lists
- **Announcements and Notices**: Display important messages with highlighted text, bold formatting, or colored content
- **Rich Content Pages**: Build knowledge base articles, landing pages, or onboarding pages with structured content
- **Meeting Notes and Summaries**: Capture formatted minutes with bullet points, action items, and decisions
- **Embedded Links and References**: Create navigation sections or resource lists with hyperlinks to internal pages or external URLs
- **Formatted Reports**: Present status summaries or executive overviews with rich formatting for clarity

## Design Considerations

### When to Use This Widget

Use the Rich String widget when you need:
- Static text content that doesn't change based on data
- Formatted content with titles in a consistent framed presentation
- Content that should be searchable via fulltext search
- Multi-language title support (content itself is not localized)

### When to Use Alternative Widgets

- **Displaying entity attribute values**: Use `cf.platform.customRichStringAttribute` instead, which binds to a rich string attribute on an entity
- **Frameless presentation**: Consider other approaches if you don't want the widget frame
- **Dynamic content**: For content that should update when data changes, use attribute-display widgets

### Content Limitations

- All content is automatically sanitized for security (XSS protection)
- Custom scripts and some HTML elements/attributes are stripped
- Very large content may impact page load performance
- Content is not versioned - no built-in history of changes

## Related Patterns

- **cf.platform.customRichStringAttribute** - Displays a rich string attribute from an entity (data-bound content)
- **cf.platform.singleAttribute** - Displays any single attribute value from the current page
- **cf.cplace.pageViewHeadline.widget** - Alternative for simple titled text sections