Bug: Cannot update slate state externally #4612
Comments
|
Ouch, we got bitten hard by this. Downgraded for now. |
|
@Ghost---Shadow if you look at what was changed (https://github.com/ianstormtaylor/slate/pull/4540/files), you can easily get the same behaviour by setting a key property on the Slate element and incrementing whenever your state changes. |
Can you elaborate a little bit more with the key hook code sample. Wouldn't it cause some re-render issues of entire slate component while changing the I am very aware of any slate "breaking" change but it's a still a powerful blackbox machine to me, still on basic/user level and try to understand the internal logic. |
|
A temporary solution: update editor.children instead of value, as specified in [email protected] release notes. |
|
This is a hack, not a solution. If this is the official way of updating the state, then the documentation should be updated as well. |
|
It works, but I agree, it's a hack. Setting editor.children directly also requires manual fixing of selection, because selected range remains the same even if some new nodes are added above the selection. |
It does not seem like a hack based on the PR discussion. It's just not a React way, and not necessary to be a React way. |
|
It took me several days to find out that changes in #3216 were silently reversed in #4540. It would be great to reflect the changes not only in docs as others say above, but also in API (eg revert It‘s possible that out there are many others struggling to find out what went wrong (in our case it wasn’t an upgrade going bad — that would make me go for changelists sooner, but documentation being out of date and API pretending that everything is okay). |
|
(Hence, I’d propose relabeling this as an improvement and changing the name of the prop — such change would highlight its breaking nature, as the difference between un- and controlled components is night and day.) |
It's really not a react way. |
Of course it's not. I hope somebody will make a refactoring. |
Now the problem is that if this PR #4540 is merged intentionally, does it mean the
Strictly speaking: |
Yes, slate core doesn't rely on react by design. slate-react modifies editor.children in react hooks.
Would be nice if you did it! |
|
@aboveyunhai slate was redesigned at some point so that the Note that an |
|
Changing content via @bryanph What to do in this case? |
|
@mlajtos use |
|
We are building a collaborative editing tool and this change is pretty much a killed when it comes to reconciling state from the server. Using a key to fully re-render is destructive and pretty much kills the UX as all selection state is lost. |
|
@bryanph do you have an code snippet to explain how to do this ? the documentation for operations is laconic |
|
This just caused me to blow about 3 million brain cells. We use Slate extensively in Payload and also need to programmatically handle incoming values. For now, I've done as described above in this thread and added a Here is the commit for anyone interested. Obviously Payload's implementation is quite complex but the actual changes here are fairly simple. This works for now but man that threw me for a loop. |
|
For those who just need a quick workaround, here's how I fixed it in my code: Custom useForceUpdate hook defined elsewhere: const useForceUpdate = () => {
const [, setState] = useState<number>(0);
const forceUpdate = useCallback(() => {
setState(n => n + 1);
}, []);
return forceUpdate;
};Code inside my component that renders const forceUpdate = useForceUpdate();
useEffect(() => {
editor.children = value;
forceUpdate();
}, [editor, value, forceUpdate]); |
|
I stumbled upon this issue when connecting the Slate value to a form (using Formik), and trying to reset it on submit. Here's my "hack", which updates the key only when the value changes to the default. It's not a fully-controlled solution, but it did the trick: const defaultRichTextValue: Descendant[] = [
{
type: 'paragraph',
children: [{ text: '' }],
},
]
function useResetKey(value: Descendant[]) {
const [key, setKey] = React.useState(0)
React.useEffect(() => {
if (JSON.stringify(value) === JSON.stringify(defaultRichTextValue)) {
setKey(n => n + 1)
}
}, [value])
return key
}
const RichTextEditor = ({
value,
onChange,
...props
}) => {
const resetKey = useResetKey(value)
const editor = React.useRef(withHistory(withReact(createEditor())))
return (
<Slate
editor={editor.current}
value={value}
onChange={onChange}
key={resetKey}
>
<Editable {...props} />
</Slate>
)
} |
|
thx! @franky47 Hope this bug will be ruled out as soon as possible！ |
|
We are also seeing this as a major blocker to using Slate. We have multiple ways to display comment threads (sidebar and a floating comment overlay), and sometimes both are visible when typing a new comment, meaning they share state. It's pretty fundamental to have the ability to control an input's value externally, and in fact, one way data flow is one of the core pillars of React. This is a bug, and the key hack is just that, a hack. |
|
this is also a dealbreaker to adoption for me. |
|
Really loved using Slate until I faced this problem and read this thread. I have been stuck on this for a while, and the solutions mentioned here are way below the standard set by how the rest of Slate works. |
|
The solution I used doesn't need any useEffects or extra states I stringify the value and use that as the key, so that when the value changes, the key changes and the component is rerendered |
|
I've been finding various options to resolve this issue, and it appears that your solution is the simplest and most efficient method. This should be on the documentation. |
|
Using keys and forcing the component to re-render is a no go: major performance hog and prone to errors with caret position and selection. |
|
I am maintainin https://github.com/react-page/react-page which uses slate for its rich-text editor. Since the infamous change to an uncontrolled component, we suffer from bugs and inconsistencies. Setting the value from outside is important for us, because we have our own undo/redo mechanism. Uncontrolled components are in my opinion an antipattern in most cases and the amount of headache it created alone in this thread here shows why. I recently created another issue here #5281 but i think it a duplicate of this here. I tried different workarounds, but I found none that works consistently. Slate really has to revert this decision, I don't think there is another way. |
|
What we ended up doing to dynamically modify the state of slate, is passing the |
|
@hypeJunction Do you have any examples of how you did that that you can share by any chance? I'm trying to control undo and redo from outside of Slate and am running into issues. |
|
@ggrantrowberry Here are some snippets: Context and utility components defined as such: import React, { PropsWithChildren, useContext, useEffect, useRef } from 'react'
import { useSlate } from 'slate-react'
import { Editor } from 'slate'
type TemplatedFormContextValue = {
editors: Map<string, Editor>
}
const TemplatedFormContext = React.createContext<TemplatedFormContextValue | null>(null)
export const TemplatedForm = ({ children }: PropsWithChildren<any>) => {
const ref = useRef<Map<string, Editor>>()
if (!ref.current) {
ref.current = new Map()
}
return (
<TemplatedFormContext.Provider
value={{
editors: ref.current
}}
>
{children}
</TemplatedFormContext.Provider>
)
}
export const TemplatedFormEditorReference = ({ name }: { name: string }) => {
const editor = useSlate()
const ctx = useTemplatedForm()
useEffect(() => {
if (ctx?.editors) {
ctx.editors.set(name, editor)
}
}, [editor, name])
return null
}
export const useTemplatedForm = () => {
return useContext(TemplatedFormContext)
}You then add the reference to the context when rendering export const RichEditor = forwardRef(
(
{ value, onChange, before, toolbar, after, name, ...rest }: RichEditorProps,
ref: ForwardedRef<HTMLDivElement>
) => {
const { editor } = useSlateEditor()
const defaultValue = Array.isArray(value) && value.length > 0 ? value : defaultEditorValue
return (
<InputBox
variant='outlined'
color='neutral'
control={
<Slate value={defaultValue} editor={editor} onChange={onChange}>
{before}
<div className={b()}>
{toolbar}
{name ? <TemplatedFormEditorReference name={name} /> : null}
<EditableArea ref={ref} {...rest} />
</div>
{after}
</Slate>
}
/>
)
}
)And to modify the contents of the editor, you would use slate apis: import { Transforms } from 'slate'
import { cloneDeep } from 'lodash'
export const TemplatePicker = ({ templates }: InsertTemplateProps) => {
const ctx = useTemplatedForm()
const appendTemplate = (fields: { name: string; text: StructuredText[] }[]) => {
fields.forEach((field) => {
const editor = ctx?.editors.get(field.name)
if (editor) {
editor.children.map((item) => {
Transforms.delete(editor, { at: [0] })
})
field.text.map((node) => {
Transforms.insertNodes(editor, cloneDeep(node))
})
}
})
}
// template selector with callback
}This could probably be optimized. The code was written by our junior with some initial input from me, and I haven't seen the latest version. |
|
I just wanted to chime in, I really wanted to use slate for my project but it became unusable to me because of the lack of a simple way to update the state externally. If I had the time I'd try to come up with a pull request and change it myself, but I don't have the knowledge to do it in a reasonable time frame. |
|
Just to add in, I have to make my editor controllable as well, so I did something like this, using the "use client";
import { useMemo, useState } from "react";
import { Descendant, createEditor } from "slate";
import { Editable, Slate, withReact } from "slate-react";
const initialValue: Descendant[] = [
{ type: "paragraph", properties: {}, children: [{ text: "Hello World!" }] },
];
function Editor({
value,
onChange,
}: {
value: Descendant[];
onChange: (value: Descendant[]) => void;
}) {
const editor = useMemo(() => withReact(createEditor()), []);
return (
<Slate editor={editor} initialValue={value} onChange={onChange}>
<Editable />
</Slate>
);
}
export default function Page() {
const [value, setValueRaw] = useState(initialValue);
const [key, setKey] = useState(0);
function setValue(value: Descendant[]) {
setValueRaw(value);
setKey(key + 1);
}
return (
<div>
<button type="button" onClick={() => setValue(initialValue)}>
Reset
</button>
<Editor key={key} value={value} onChange={setValueRaw} />
</div>
);
}and I just use Can't say rerendering the entire editor is good for performance, but this is the only solution applicable to our app; assigning to |
|
@joulev as I came through a lot of uncontrolled components (canvas, dnd, table editing, occasionally input), I hit the limitation of To be more aggressive, doing the React way here is not the correct way of doing React way. 😂
|
|
Same problem here, we tried to update from an old version of Slate so we could benefit from the use of plain objects instead on Inmutable but this is preventing us from completing the migration. We might need to look for alternatives if Slate doesn't provide a non-hacky way to control the component value. The solutions above break the editor selection when externally changing the value. |
|
the fix is in documentation, I found it after few hours ... |
|
@seyhak Cannot thank you enough! It's so obvious and simple, yet I was overcomplicating it. It's clear in the docs, but it's also apparently really easy to miss! In my use case, replacing the values and triggering a re-render was two lines and perfect for what I needed. |
works perfectly fine |
and others
Description
The PR #4540 removed the ability to update the slate state using the
valueprop. As a result, we cannot inject externally changed state anymore.If there is another way to update the state externally, then the documentation should be updated as well.
https://docs.slatejs.org/walkthroughs/06-saving-to-a-database
Environment
The text was updated successfully, but these errors were encountered: