Editable

Editable Text is used for inline renaming of some text. It appears as normal UI text but transforms into a text input field when the user clicks on or focuses it.

The text input inherits all font styling from its parent in order to make the edit and read view transition seamless.

Import#

Chakra UI exports 3 components to handle this functionality.

  • Editable: The wrapper component that provides context value.
  • EditableInput: The edit view of the component. It shows when you click or focus on the text.
  • EditablePreview: The read-only view of the component.
import { Editable, EditableInput, EditablePreview } from "@chakra-ui/react"

Usage#

Take some chakra
Editable Example

With custom controls#

In some cases, you might need to use custom controls to toggle the edit and read mode. We use the render prop pattern to provide access to the internal state of the component.

Ensure you set isPreviewFocusable and submitOnBlur to false for this to work.

Rasengan ⚡️
Editable Example

Props#

Editable Props#

NameTypeDescriptionDefault
colorSchemestring-
defaultValuestringThe initial value of the Editable in both edit & preview mode-
isDisabledbooleanIf `true`, the Editable will be disabled.-
isPreviewFocusablebooleanIf `true`, the read only view, has a `tabIndex` set to `0` so it can recieve focus via the keyboard or click.true
onCancel((previousValue: string) => void)Callback invoked when user cancels input with the `Esc` key. It provides the last confirmed value as argument.-
onChange((nextValue: string) => void)Callback invoked when user changes input.-
onEdit(() => void)Callback invoked once the user enters edit mode.-
onSubmit((nextValue: string) => void)Callback invoked when user confirms value with `enter` key or by blurring input.-
placeholderstringThe placeholder text when the value is empty.-
selectAllOnFocusbooleanIf `true`, the input's text will be highlighted on focus.true
sizestring-
startWithEditViewbooleanIf `true`, the Editable will start with edit mode by default.-
submitOnBlurbooleanIf `true`, it'll update the value onBlur and turn off the edit mode.true
valuestringThe value of the Editable in both edit & preview mode-
variantstring-
Edit this page