Files
growstuff/app/javascript/components/PostEditor.jsx
T
Brenda Wallace b6006df384 feat: Implement draft autosave and preview functionality in PostEditor
- Added useDraftAutosave hook to handle automatic saving of post drafts.
- Enhanced PostEditor component to include a preview tab that fetches and displays rendered markdown.
- Updated Post model to manage draft state and associated published_at timestamp.
- Introduced card_photo association to Post for representing a primary image.
- Modified post form to support draft saving and publishing actions.
- Updated navigation to include links to drafts.
- Added tests for draft saving, preview functionality, and card photo validation.
- Created migrations for new database fields related to drafts and card photos.
2026-10-28 21:50:26 +13:00

180 lines
6.1 KiB
React

import React, {useState} from 'react';
import {EditorContent, useEditor, useEditorState} from '@tiptap/react';
import StarterKit from '@tiptap/starter-kit';
import {Markdown} from '@tiptap/markdown';
import {csrfToken} from '../api';
import useDraftAutosave from './useDraftAutosave';
const BLOCKS = [
{value: 'paragraph', label: 'Paragraph'},
{value: 'h2', label: 'Heading'},
{value: 'h3', label: 'Subheading'},
];
function ToolButton({label, active, onClick, children, ...rest}) {
return (
<button
type="button"
className={`btn btn-sm btn-outline-secondary post-editor-tool${active ? ' active' : ''}`}
aria-label={label}
aria-pressed={active}
onClick={onClick}
{...rest}
>
{children}
</button>
);
}
function Toolbar({editor}) {
const state = useEditorState({
editor,
selector: ({editor: e}) => ({
block: e.isActive('heading', {level: 2}) ? 'h2' : e.isActive('heading', {level: 3}) ? 'h3' : 'paragraph',
bold: e.isActive('bold'),
italic: e.isActive('italic'),
link: e.isActive('link'),
bulletList: e.isActive('bulletList'),
blockquote: e.isActive('blockquote'),
}),
});
const setBlock = (value) => {
const chain = editor.chain().focus();
if (value === 'paragraph') chain.setParagraph().run();
else chain.toggleHeading({level: Number(value[1])}).run();
};
const setLink = () => {
const previous = editor.getAttributes('link').href || '';
const url = window.prompt('Link address', previous);
if (url === null) return;
if (url === '') editor.chain().focus().extendMarkRange('link').unsetLink().run();
else editor.chain().focus().extendMarkRange('link').setLink({href: url}).run();
};
return (
<div className="post-editor-toolbar" role="toolbar" aria-label="Formatting">
<select
className="form-select form-select-sm post-editor-block"
aria-label="Text style"
value={state.block}
onChange={(e) => setBlock(e.target.value)}
>
{BLOCKS.map((b) => <option key={b.value} value={b.value}>{b.label}</option>)}
</select>
<ToolButton label="Bold" active={state.bold} onClick={() => editor.chain().focus().toggleBold().run()}>
<strong>B</strong>
</ToolButton>
<ToolButton label="Italic" active={state.italic} onClick={() => editor.chain().focus().toggleItalic().run()}>
<em>I</em>
</ToolButton>
<ToolButton label="Link" active={state.link} onClick={setLink}>Link</ToolButton>
<ToolButton
label="Bulleted list"
active={state.bulletList}
onClick={() => editor.chain().focus().toggleBulletList().run()}
>
• List
</ToolButton>
<ToolButton
label="Quote"
active={state.blockquote}
onClick={() => editor.chain().focus().toggleBlockquote().run()}
>
❝ Quote
</ToolButton>
</div>
);
}
// A rich text editor for a post body that stores markdown, so people can
// format without knowing it. The Markdown tab shows and edits the raw text.
// The markdown goes in a hidden field called `name`, so the surrounding form
// submits it as it would a textarea.
//
// With `autosave` (see useDraftAutosave) the post is saved as a draft as it is
// written. With `previewUrl` a Preview tab shows the body as the site will
// render it.
export default function PostEditor({name, value = '', id = 'post_body', autosave = null, previewUrl = null}) {
const [markdown, setMarkdown] = useState(value);
const [tab, setTab] = useState('write');
const [previewHtml, setPreviewHtml] = useState('');
const status = useDraftAutosave(markdown, autosave);
const tabs = [['write', 'Write'], previewUrl && ['preview', 'Preview'], ['markdown', 'Markdown']].filter(Boolean);
async function loadPreview() {
setPreviewHtml('');
const response = await fetch(previewUrl, {
method: 'POST',
credentials: 'same-origin',
headers: {'Content-Type': 'application/json', 'X-CSRF-Token': csrfToken()},
body: JSON.stringify({body: markdown}),
});
setPreviewHtml(response.ok ? await response.text() : '<p>The preview could not be loaded.</p>');
}
const editor = useEditor({
extensions: [StarterKit, Markdown],
content: value,
contentType: 'markdown',
onUpdate: ({editor: e}) => setMarkdown(e.getMarkdown().trim()),
editorProps: {attributes: {class: 'post-editor-content', 'aria-label': 'Post body', role: 'textbox', 'aria-multiline': 'true'}},
});
const showTab = (next) => {
if (next === 'write' && editor) {
editor.commands.setContent(markdown, {contentType: 'markdown'});
}
if (next === 'preview') loadPreview();
setTab(next);
};
return (
<div className="post-editor">
<input type="hidden" name={name} value={markdown} />
<div className="post-editor-tabs" role="tablist">
{tabs.map(([key, label]) => (
<button
key={key}
type="button"
role="tab"
aria-selected={tab === key}
className={`post-editor-tab${tab === key ? ' active' : ''}`}
onClick={() => showTab(key)}
>
{label}
</button>
))}
<span className="post-editor-status text-muted small ms-auto align-self-end" role="status" aria-live="polite">
{status}
</span>
</div>
<div className="post-editor-panel">
{tab === 'write' && editor && (
<>
<Toolbar editor={editor} />
<EditorContent editor={editor} id={id} />
</>
)}
{tab === 'preview' && (
// The server renders (and sanitises) the markdown, as it does for a posted post.
<div className="post-editor-preview post-content" dangerouslySetInnerHTML={{__html: previewHtml}} />
)}
{tab === 'markdown' && (
<textarea
id={id}
className="form-control post-editor-raw"
rows={14}
aria-label="Post body as markdown"
value={markdown}
onChange={(e) => setMarkdown(e.target.value)}
/>
)}
</div>
</div>
);
}