-
Notifications
You must be signed in to change notification settings - Fork 32
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Outline RFC for single-block rich text fields
- Loading branch information
Showing
1 changed file
with
24 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,24 @@ | ||
# Outline RFC : Rich text segment blocks | ||
|
||
* RFC: | ||
* Authors: Karl Hobley | ||
* Created: 2019-11-18 | ||
* Last Modified: 2019-11-18 | ||
|
||
## Abstract | ||
|
||
This is an outline proposal for a new field and block type in Wagtail. This field/block type would behave like a ``RichTextField``/``RichTextBlock`` but only allows a single segment of text. | ||
|
||
Inline elements such as formatting and hyperlinks may be allowed. But block elements like paragraphs, images and bullet points will not. The HTML segment in the database will not be enclosed in a `<div class="rich-text">` or even a `<p>` tag giving developers more flexibility in how it is used. | ||
|
||
I think this will be very useful for: | ||
- Introductions/summaries which can usually only be one paragraph but use rich text fields as they may need inline formatting. For example, the sentence above "Tom Dyson" in: https://wagtail.io/blog/wagtail-2-7/. | ||
- Image captions | ||
- Inline styling in titles. For example: https://torchbox.com/digital-products/ | ||
- Forcing editors to use separate rich text blocks in streamfields | ||
|
||
I think it would also be very useful to have an internal ``RichTextSegment`` type to represent the values of these fields. Having a separate type would be useful separate type because some logic, such as diffing and translating, would be different to ``RichText`` values. | ||
|
||
## Specification | ||
|
||
I don't think this would be a very technically challenging change to make, but I'm leaving this bit out since I'm only looking to get feedback on the general idea for now. |