react-prop-renderer

0.1.0 • Public • Published

React Prop Renderer 🧪

Render your props on the fly.

Synopsis

Perhaps, your code is always perfect. Perhaps, your props types and api endpoint shapes are always exactly as designed. Perhaps your calculations are always what you expect after various transformations. If so, React Prop Renderer is not for you!

React Prop Renderer makes it easy to print out props so that they can be tested or reviewed easily.

In slightly more detail, React Prop Renderer is a React portal that prints a tree data structure of components expressing props and their values. From there, you can do what you'd like!

Install

npm install react-prop-renderer -S

Usage

After installing React Prop Renderer, import it and use it to your liking.

It can be imported as a default or as the named component itself.

import PropsRenderer from 'react-prop-renderer'
// or
import { PropsRenderer } from 'react-prop-renderer'

Because it renders in a React Portal, you can use (reference) it anywhere in your React app!

import React, { useEffect, useState } from 'react';
import { PropsRenderer } from 'react-prop-renderer'
import { SomeComponent } from './components/SomeComponent'

export const SomeParentComponent = () => {
  return (
    <SomeComponent>
      {/*
        * You can use the PropsRenderer within a component (like below)
        * You can use variables to only render (show) the endpoint when you want
      */}
      {isWhiteListedHost && isRenderingEndpoint && Object.keys(data).length > 0 && <PropsRenderer endpoint={data} />}
    </SomeComponent>
  )
}

export default SomeParentComponent

Here's a quick pseudo code example/idea

import React, { useEffect, useState } from 'react';
import { PropsRenderer } from 'react-prop-renderer'

export function SomeAwesomeEndpointSubmission({ isWhiteListedHost }) {
  const isRenderingEndpoint = new URLSearchParams(search).get("isRenderingEndpoint")
  const [data, setData] = useState({});

  function handleSubmit async (endpoint) {
    const updatedData = await endpoind();
    setData(updatedData);
  }

  return (
    <div>
      <button type='submit' onClick={handClick}>Submit Endpoint</button>
      {isWhiteListedHost && isRenderingEndpoint && Object.keys(data).length > 0 && <PropsRenderer endpoint={data} />}
    </div>
  )
}

And yes, you can use the PropsRenderer to render data besides endpoints!

import React, { useEffect, useState } from 'react';
import { PropsRenderer } from 'react-prop-renderer'
import { SomeComponent } from './components/SomeComponent'

export const SomeParentComponent = () => {
  return (
    <SomeComponent>
      {whatDataIsThis && Object.keys(whatDataIsThis).length > 0 && <PropsRenderer endpoint={whatDataIsThis} />}
    </SomeComponent>
  )
}

export default SomeParentComponent

Hope to provide better documentation soon(ish)!

/react-prop-renderer/

    Package Sidebar

    Install

    npm i react-prop-renderer

    Weekly Downloads

    1

    Version

    0.1.0

    License

    ISC

    Unpacked Size

    25.6 kB

    Total Files

    23

    Last publish

    Collaborators

    • yowainwright