Leszek Wiesner 7886c8d5bd Upgrade apps to @polkadot/api 4.2.1 (unfinished) 3 år sedan
..
src 7886c8d5bd Upgrade apps to @polkadot/api 4.2.1 (unfinished) 3 år sedan
.skip-build 4fb6768f3f Move to subfolder 4 år sedan
.skip-npm 4fb6768f3f Move to subfolder 4 år sedan
LICENSE ac5952ef16 Move to subfolder 4 år sedan
README.md ac5952ef16 Move to subfolder 4 år sedan
index.html ac5952ef16 Move to subfolder 4 år sedan
package.json 4fb6768f3f Move to subfolder 4 år sedan
webpack.config.js 4fb6768f3f Move to subfolder 4 år sedan

README.md

@polkadot/react-query

WARNING: This is an internal package to polkadot-js/apps so is not inteded (yet) for broad use. Since these are generic components, they will move to the polkadot-js/ui repo once deemed stable and usable.

For the existing sharable components usable in external React-based projects, take a look at the polkadot-js/ui documentation

Overview

A collection of RxJS enabled React components that operate with the @polkadot/api-rx library. It automatically manages subscriptions on behalf of the developer, providing a number of unstyled components that can be used to construct UIs.

Usage

Basic usage entails creating a ContextProvider and just using the components. For instance, to display the current node time,

import React from 'react';
import ReactDOM from 'react-dom';

import { Api, NodeTime } from '@polkadot/react-query';

...
ReactDOM.render(
  <Api>
    <NodeTime />
  </Api>,
  document.querySelector('#container')
);
...

All components are provided unstyled making no assumptions on the actual use, however they all support (optionally) the label, className and style attributes, that can be used to style to component.

...
ReactDOM.render(
  <Api>
    <NodeTime className='rx-time' label='current node time:' />
  </Api>,
  document.querySelector('#container')
);
...