mirador/src/components/ManifestRelatedLinks.jsx

An open-source, web-based 'multi-up' viewer that supports zoom-pan-rotate functionality, ability to display/compare simple images, and images with annotations.

import { useId } from 'react';
import PropTypes from 'prop-types';
import { styled } from '@mui/material/styles';
import Typography from '@mui/material/Typography';
import Link from '@mui/material/Link';
import classNames from 'classnames';
import { useTranslation } from 'react-i18next';
import CollapsibleSection from '../containers/CollapsibleSection';
import ns from '../config/css-ns';
import { PluginHook } from './PluginHook';

const StyledDl = styled('dl')(({ theme }) => ({
  '& dd': {
    marginBottom: '.5em',
    marginLeft: '0',
  },
}));

/**
 * ManifestRelatedLinks
 */
export function ManifestRelatedLinks({
  homepage = null,
  manifestUrl = null,
  related = null,
  renderings = null,
  seeAlso = null,
  ...rest
}) {
  const { t } = useTranslation();
  const id = useId();
  const titleId = useId();

  const pluginProps = {
    homepage,
    manifestUrl,
    related,
    renderings,
    seeAlso,
    t,
    ...rest,
  };

  return (
    <CollapsibleSection aria-labelledby={titleId} id={id} label={t('related')}>
      <Typography aria-labelledby={`${id} ${titleId}`} id={titleId} variant="h4" component="h5">
        {t('links')}
      </Typography>
      <StyledDl className={classNames(ns('label-value-metadata'))}>
        {homepage && (
          <>
            <Typography variant="subtitle2" component="dt">
              {t('iiif_homepage')}
            </Typography>
            {homepage.map((page) => (
              <Typography key={page.value} variant="body1" component="dd">
                <Link target="_blank" rel="noopener noreferrer" href={page.value}>
                  {page.label || page.value}
                </Link>
              </Typography>
            ))}
          </>
        )}
        {renderings && renderings.length > 0 && (
          <>
            <Typography variant="subtitle2" component="dt">
              {t('iiif_renderings')}
            </Typography>
            {renderings.map((rendering) => (
              <Typography key={rendering.value} variant="body1" component="dd">
                <Link target="_blank" rel="noopener noreferrer" href={rendering.value}>
                  {rendering.label || rendering.value}
                </Link>
              </Typography>
            ))}
          </>
        )}
        {related && (
          <>
            <Typography variant="subtitle2" component="dt">
              {t('iiif_related')}
            </Typography>
            {related.map((relatedItem) => (
              <Typography key={relatedItem.value} variant="body1" component="dd">
                <Link target="_blank" rel="noopener noreferrer" href={relatedItem.value}>
                  {relatedItem.label || relatedItem.value}
                </Link>
                {relatedItem.format && <Typography component="span">{` (${relatedItem.format})`}</Typography>}
              </Typography>
            ))}
          </>
        )}
        {seeAlso && (
          <>
            <Typography variant="subtitle2" component="dt">
              {t('iiif_seeAlso')}
            </Typography>
            {seeAlso.map((seeAlsoItem) => (
              <Typography key={seeAlsoItem.value} variant="body1" component="dd">
                <Link target="_blank" rel="noopener noreferrer" href={seeAlsoItem.value}>
                  {seeAlsoItem.label || seeAlsoItem.value}
                </Link>
                {seeAlsoItem.format && <Typography component="span">{` (${seeAlsoItem.format})`}</Typography>}
              </Typography>
            ))}
          </>
        )}
        {manifestUrl && (
          <>
            <Typography variant="subtitle2" component="dt">
              {t('iiif_manifest')}
            </Typography>
            <Typography variant="body1" component="dd">
              <Link target="_blank" rel="noopener noreferrer" href={manifestUrl}>
                {manifestUrl}
              </Link>
            </Typography>
          </>
        )}
      </StyledDl>
      <PluginHook targetName="ManifestRelatedLinks" {...pluginProps} />
    </CollapsibleSection>
  );
}

ManifestRelatedLinks.propTypes = {
  homepage: PropTypes.arrayOf(
    PropTypes.shape({
      label: PropTypes.string,
      value: PropTypes.string,
    }),
  ),
  manifestUrl: PropTypes.string,
  related: PropTypes.arrayOf(
    PropTypes.shape({
      format: PropTypes.string,
      label: PropTypes.string,
      value: PropTypes.string,
    }),
  ),
  renderings: PropTypes.arrayOf(
    PropTypes.shape({
      label: PropTypes.string,
      value: PropTypes.string,
    }),
  ),
  seeAlso: PropTypes.arrayOf(
    PropTypes.shape({
      format: PropTypes.string,
      label: PropTypes.string,
      value: PropTypes.string,
    }),
  ),
};