@resourge/react-search-params v1.13.0

@resourge/react-search-params

@resourge/react-search-params is a simple hook to control current url. Also provides some methods that extend URLSearchParams.

Features

• Add's beforeURLChange and URLChange event to native javascript.
• Has no dependencies.
• It uses javascript URLSearchParams to parse search.
• Decodes search params into primitive values. (ex: "?productId=10&productName=Apple" will become { product: 10, productName: "Apple" }).

Installation

Install using Yarn:

yarn add @resourge/react-search-params

or NPM:

npm install @resourge/react-search-params --save

Basic usage

import React from 'react';
import { useSearchParams } from '@resourge/react-search-params';

export default function Form() {
  const [params, setParams] = useSearchParams(
    ({ url }) => window.history.replaceState(null, '', url.href)
  )

  return (
    <div> 
	  App
      <button onClick={() => setParams({ productId: Math.random() })}>
        Set new params
      </button>
	</div>
  );
}

Documentation

useSearchParams

const [params, setParams] = useSearchParams(
  // Method to control navigation
  ({ url }) => window.history.replaceState(null, '', url.href),
  // Ex: react-router ({ url }) => history.replace(url.href),
  { }, // default params
  { } // config
)

Config

useUrl

Returns the current URL object.

const url = useUrl();

License

MIT Licensed.