/react-copy-code

A React component to add copy to clipboard funcitonality to 'pre code' blocks

Primary LanguageTypeScriptMIT LicenseMIT

react-copy-code

react-copy-code is a component that will add a "copy to clipboard" button to 'pre code' blocks that are rendered as it's children. Children can be jsx, other components, or an html string by setting the innerHtml prop. If the highlight prop is set, it also uses highlight.js to add the proper classes needed for highlighting code.

Installation

npm install react-copy-code

Usage

import CodeBlock from 'react-copy-code';

const App = () => (
   <CodeBlock>
      {write the rest of your component here}
      {using as many pre code blocks you want}
   </CodeBlock>
);

or

import CodeBlock from 'react-copy-code';

const App = () => (
   <CodeBlock innerHtml>
      {html string is passed in as the only child}
   </CodeBlock>
);

Props

name type default description
element JSX intrinsic Element "div" Allows you to specify which element the component renders as
innerHtml bool false If this is set to true, it is expecting the html string to be passed as the only child. Warning: uses dangerouslySetInnerHTML so be sure you trust the source
highlight bool false If this is set to true, It will use highlight.js to add classes that correspond to highlight.js css theme. Checkout documentation for highlight.js for more details
svg ReactComponent null Allows you to pass in any SVG based React Component as the button icon
onCopy function no-op Allows you to pass in a function to run when the copy button is clicked

Contributing

In lieu of a formal styleguide, please format your code using 'prettier' prior to commit.

Release History

  • 2.1.2 Bug fix for innerHtml, update types and documentation
  • 2.1.1 Bug fixes
  • 2.1.0 Changed to TypeScript
  • 2.0.5 Fixed issue that broke gatsby html build
  • 2.0.2 - 2.0.4 Fixed Webpack bug that was bundling React with component and other bug fixes
  • 2.0.1 Make safer for SSR
  • 2.0.0 Update to react 16.6
  • 1.2.2 Remove react and react-dom as dependancy and put it as a peer-dependancy
  • 1.2.1 Remove webpack as dependancy and put it as a dev dependancy like it was always supposed to be
  • 1.2.0 onCopy prop that allows you to pass a function to run when the copy button is clicked
  • 1.1.1 Update capabilities for older browsers(PR from absoludity)
  • 1.1.0 Custom SVG Icon can be passed as the button icon
  • 1.0.6 Reduce Button Real estate
  • 1.0.5 Icon style fits on to one line
  • 1.0.4 Update to be compatable with react 15.6
  • 1.0.1 - 1.0.3 Updated Documentation
  • 1.0.0 Initial Stable Release