Required statement

[stephenwf]

As canvas panel only renders a canvas, it does not always have information about the manifest that contains it. However, if people are using manifests from collections they should be aware of required statements containing rights and usage information that they may need to display.

Canvas panel won't display the required statement for the user (at the moment). However it could help users identify the required statement.

In the simplest case:

<canvas-panel manifest-id="https://example.org/manifest" canvas-id="..." />

The Vault will know the manifest, can be able to resolve the required statement.

Even in a case where the resource is loaded in a vault, but the manifest id is not given.

<canvas-panel id="cp" />
<script>
  const cp = document.getElementById('cp');
  const manifest = cp.vault.loadManifest('https://example.org/manifest');
  
  // cp.setManifest(manifest.id);
  cp.setCanvas(manifest.items[0].id);
</script>

There is a (slowish) route to resolving where the canvas came from, and grabbing the required statement.

A Vault API like:

vault.getRequiredStatement(anything); // manifest, canvas, range etc..

Could be a Canvas Panel API that is:

cp.getRequiredStatement();

And make it easier for developers to get this information.

If only a canvas is imported into a vault, without a manifest, then it's up to the containing application to know or get the required statement.