ebi-webcomponents / protvista-uniprot

The ProtVista tool for the UniProt website
MIT License
12 stars 6 forks source link

protvista-uniprot

A Web Component which uses Nightingale components to display protein sequence information.

Image of protvista-uniprot

Usage

Importing as a module

import ProtvistaUniprot from 'protvista-uniprot';
...
window.customElements.define('protvista-uniprot', ProtvistaUniprot);

You can then use it like this:

<protvista-uniprot accession="P05067" />

Dependencies

The component relies on d3 which is set as a global variable and needs to be added to your project.

<script src="https://d3js.org/d3.v4.min.js" charset="utf-8" defer></script>

or via CDN

See here

API

Development

Run yarn install to install dependencies and yarn start to start the local server.

Configuration

You can pass your own configuration to the component using the config attribute/property.

{
  "categories": [
    {
      "name": string,
      "label": string,
      "trackType": protvista-track|protvista-variation-graph|protvista-variation,
      "adapter": protvista-feature-adapter|protvista-structure-adapter|protvista-proteomics-adapter|protvista-variation-adapter,
      "url": string,
      "tracks": [
        {
          "name": string,
          "label": string,
          "filter": string,
          "trackType": "protvista-track|protvista-variation-graph|protvista-variation",
          "tooltip": string
        }
      ]
    }
  ]
}

Events

Custom protvista-event are emitted:

detail: {
    hasData: true
}