npm 包 @elaura/react-remarkable 使用教程

阅读时长 4 分钟读完

介绍

@elaura/react-remarkable 是一个基于 Remarkable 的 React 组件,用于在 React 应用中渲染 Markdown。它提供了丰富的选项和配置,可以让开发者在自己的应用中更加灵活、自由地使用 Markdown。

安装

可以通过 npm 来安装该组件:

使用

在你的 React 应用中引入 @elaura/react-remarkable

-- -------------------- ---- -------
------ ----- ---- --------
------ ---------- ---- ---------------------------

-------- ----- -
  ------ -
    ---- ----------------
      ----------- --------- ------ ----- ------------ --
    ------
  --
-

以上代码会显示出一段 Markdown 格式的文字。

Props

@elaura/react-remarkable 组件提供了若干个常用的 Props 属性,以实现更加定制化的需求:

source

  • Type: string
  • Required: true
  • Default: ''

传入 Markdown 文本。

options

  • Type: Object
  • Required: false
  • Default: {}

传入 Remarkable 的配置选项。具体可选项请见 Remarkable 官方文档

container

  • Type: string | React.Component | React.FunctionComponent
  • Required: false
  • Default: 'div'

渲染出的 HTML 元素标签名或 React 组件。

containerProps

  • Type: Object
  • Required: false
  • Default: {}

传入渲染容器的属性。

示例

下面列举几个示例,以供参考:

渲染 GitHub 风格的 Markdown

-- -------------------- ---- -------
------ ----- ---- --------
------ ---------- ---- ---------------------------

-------- ----- -
  ------ -
    ---- ----------------
      -----------
        --------- ------ ------ ----------
        ----------
          ------- -----
          ----- -----
          -------- -----
          ------------ -----
        --
        -------------------  -- -- --------- ---- -----
        ----------------- ---------- --------------- --  -- -- ------ --- --- --
      --
    ------
  --
-

渲染动态生成的 Markdown

-- -------------------- ---- -------
------ ------ - -------- - ---- --------
------ ---------- ---- ---------------------------

-------- ----- -
  ----- ---------- ------------ - -------------

  ------ -
    ---- ----------------
      --------- ---------------- ----------- -- ---------------------------- --
      ----------- ----------------- --
    ------
  --
-

以上示例会在页面上渲染一个文本域和一个 Markdown 预览框。当你在文本域中输入 Markdown 时,预览框会自动更新。

总结

通过学习本文,你可以了解到如何使用 @elaura/react-remarkable 渲染 Markdown,并且能够自定义组件的一些常用属性,以适应不同的需求和场景。希望能对你的前端开发工作有所帮助。

来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/60055fd981e8991b448dd689

纠错
反馈