1.1.1 • Published 12 months ago

@asutrick/react-new-window v1.1.1

Weekly downloads
-
License
MIT
Repository
github
Last release
12 months ago

Original Repository

This Fork

  • Removes center prop so window features (top, left, width, height) work as intended.

Features

  • Only 3.68KB (gzipped!).
  • Support the full window.open api.
  • Built for React 16 & React 18 (uses ReactDOM.createPortal).
  • Handler for blocked popups (via onBlock prop).

Installation

npm i @asutrick/react-new-window --save

Usage

import React from 'react'
import NewWindow from '@asutrick/react-new-window'

const Demo = () => (
  <NewWindow>
    <h1>Hi 👋</h1>
  </NewWindow>
)

When <NewWindow /> is mounted a popup window will be opened. When unmounted then the popup will be closed.

The children contents is what will be rendered into the new popup window. In that case Hi 👋 will be the content. The content can include any react-stateful code.

Documentation

PropertiesTypeDefaultDescription
urlStringThe URL to open, if specified any children will be overriden (more details on url).
nameStringThe name of the window (more details on windowName).
titleStringThe title of the new window document.
featuresObject{}The set of window features (more details on windowFeatures).
onUnloadFunctionundefinedA function to be triggered before the new window unload.
onBlockFunctionundefinedA function to be triggered when the new window could not be opened.
onOpenFunction(w: Window)undefinedA function to be triggered when window open by library.
closeOnUnmountBooleantrueIf specified, close the new window on unmount.
1.1.1

12 months ago

1.1.0

12 months ago