# @react-md/portal

The Portal component is a simple wrapper with React's createPortal API that will automatically generate portal nodes behind the scenes as needed. Unlike the majority of react-md packages, this package does not export any styles.

# Installation

npm install --save @react-md/portal

# Usage

The main purpose of the Portal is to be able to fix overflow issues for fixed elements within the page. If you have overflow set to anything other than the default value, fixed elements might not appear correctly. To work around this, you can portal that fixed element to a different part of the page and it'll fix the problem. If none of this makes sense to you at a first glance, you probably don't need this package.

The example below will just show the API for the portal and not a real world example.

1234567891011121314151617181920212223242526272829import React, { useState } from "react";
import { render } from "react-dom";
import { Portal } from "@react-md/portal";

const App = () => {
  const [visible, setVisible] = useState(false);

  return (
    <>
      <button
        id="example-button"
        type="button"
        onClick={() => setVisible((prevVisible) => !prevVisible)}
      >
        Show Portal
      </button>
      <Portal>
        {visible && (
          <h3>
            This is some portalled text that will only appear when{" "}
            <code>visible</code>
          </h3>
        )}
      </Portal>
    </>
  );
};

render(<App />, document.getElementById("root"));