@42shadow42/react-editable-title 中文文档教程

发布于 5年前 浏览 19 项目主页 更新于 3年前

React 的可编辑标题实现。

Installation

npm install react-editable-title

Usage

import React, { useState } from 'react'
import Editable from 'react-editable-title'

const App = () => {
  const [text, setText] = useState('')

  const handleTextUpdate = (current: string) => {
    setText(current)
  }

  return (
        <Editable 
          text={text} 
          placeholder="Type here"
          cb={handleTextUpdate}
         />
  )
}

API

AttributeTypeDescriptionRequired
textstringText to be displayedYes
cbfunctionInvoked when the text has been editedYes
onEditCancelfunctionInvoked when the edit has been canceledNo
onValidationFailfunctionInvoked when the text hasn't matched the regexNo
placeholderstringPlaceholder text of the input elementNo
saveOnBlurbooleanAttempts to save text input on unfocus. Default is trueNo
seamlessInputbooleanPresents text-editor alike experience. Default is falseNo
inputPatternstringRegex pattern of desired inputNo
inputErrorMessagestringInfo message about mismatch of inputNo
inputMinLengthnumberMin length accepted as an inputNo
inputMaxLengthnumberMax length accepted as an inputNo

Features

该组件可以通过键盘按键进行控制。 按 Enter 保存或按 Esc 取消编辑。 如果文本没有更改,则EnterEdit 按钮都不起作用。

您还可以使用您提供的 regex 控制输入的有效性。 如果正则表达式与用户输入不匹配 然后您想要的错误消息将显示在输入字段的下方。

Contributing

欢迎请求请求。 对于重大更改,请先打开一个问题来讨论您想要更改的内容。

请确保适当地更新测试。 谢谢 :raised_hands:

License

GPL

An editable title implementation for react.

Installation

npm install react-editable-title

Usage

import React, { useState } from 'react'
import Editable from 'react-editable-title'

const App = () => {
  const [text, setText] = useState('')

  const handleTextUpdate = (current: string) => {
    setText(current)
  }

  return (
        <Editable 
          text={text} 
          placeholder="Type here"
          cb={handleTextUpdate}
         />
  )
}

API

AttributeTypeDescriptionRequired
textstringText to be displayedYes
cbfunctionInvoked when the text has been editedYes
onEditCancelfunctionInvoked when the edit has been canceledNo
onValidationFailfunctionInvoked when the text hasn't matched the regexNo
placeholderstringPlaceholder text of the input elementNo
saveOnBlurbooleanAttempts to save text input on unfocus. Default is trueNo
seamlessInputbooleanPresents text-editor alike experience. Default is falseNo
inputPatternstringRegex pattern of desired inputNo
inputErrorMessagestringInfo message about mismatch of inputNo
inputMinLengthnumberMin length accepted as an inputNo
inputMaxLengthnumberMax length accepted as an inputNo

Features

The component can be controlled by keyboard keys. Hit Enter to save or Esc to cancel your edit. If there is no change in the text, neither Enter nor the Edit button would work.

You also can control the validity of inputs with the regex you would provide. If the regex won't match the user input then your desired error message will be shown below of the input field.

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate. Thanks :raised_hands:

License

GPL

    我们使用 Cookies 和其他技术来定制您的体验包括您的登录状态等。通过阅读我们的 隐私政策 了解更多相关信息。 单击 接受 或继续使用网站,即表示您同意使用 Cookies 和您的相关数据。
    原文