Molstar React

A react component for adding the Molstar Macromolecular Visualiser to your app.

Installation

With npm:

npm install molstar-react

Basic Use

To use:

import Molstar from "molstar-react";

export const App = () => {

  return (
    <div>
      <Molstar pdbId="1LOL" />
    </div>
  );
}

export default App;

This will render a full page Molstar plugin, with the structure 1LOL loaded.

Props

`pdbId`

You can pre-load an official PDB structure by supplying its 4 letter ID as a prop.

`url`

You can also pre-load a structure by passing in the URL of the file - as long as it is a file type that Molstar supports.

`file`

Thirdly, you can provide a file object, which should have a filestring property and a type property ("pdb", "mmcif" etc. - anything that molstar itself natively supports).

`dimensions`

By default the molstar plugin will take up the full screen. If you want it to act as just a normal div, you can provide a [width, height] array instead.

`className`

A class name to apply to the outer parent element.

`useInterface`

If true, the full Molstar interface will be used around the core canvas.

`showControls`

If true and useInterface is true, the controls will be shown around the sides of the interface. Only recommended for large sizes.

`showAxes`

If true, axes will appear in the bottom left corner.

Changelog

Release 0.5.2

13 May 2023

Fixed 'Invalid data cell' issue.
Fixed duplicate-fetch issue.

Release 0.5.1

26 April 2022

Fixed issue where ?key=value params in URLs would break extension parsing.

Release 0.5.0

4 March 2022

Added option to provide filestring directly.
Added option to toggle axes in bottom left corner.

Release 0.4.0

29 January 2022

Now uses Plugin and PluginUI directly instead of Viewer.
Class name prop.
Plugin now clears first when pdbID/URL prop changes.

Release 0.3.0

3 August 2021

Added ability to control dimensions rather than always being full-screen.
Removed distinction between viewer and non-viewer.

Release 0.2.1

16 July 2021

Fixed re-render initialising.
Component now disposes of viewer when removed.

Release 0.2.0

13 July 2021

Made distinction between Molstar Viewer and Molstar Core.
Enabled custom viewer options.
Added option to load structure from URL.
Made pre-loading structure optional.

Release 0.1.0

3 July 2021

Basic full screen Molstar.
Added fetching by PDB ID.

samirelanduk/molstar-react