Data Subsetter History
<terra-data-subsetter-history> | TerraDataSubsetterHistory
Shows a floating panel with a user’s recent data subset requests and their status, with quick access to results and re-submission.
Overview
The <terra-data-subsetter-history> component displays a floating panel showing a user’s
recent data subset requests, their status, and quick access to results. It integrates with
<terra-data-subsetter> for viewing and re-running jobs. The panel is typically shown in
the lower right of the screen and is intended for authenticated users.
Please login to see your history
<terra-login style="width: 100%"> <span slot="loading">Loading...</span> <terra-alert open variant="success" slot="logged-in"> <terra-icon slot="icon" name="outline-check-circle" library="heroicons"></terra-icon> The history panel is at the bottom right of your screen </terra-alert> <p slot="logged-out">Please login to see your history</p> </terra-login> <terra-data-subsetter-history></terra-data-subsetter-history>
Properties
| Property | Type | Default | Description |
|---|---|---|---|
label |
string | “History” | The label shown at the top of the history panel. |
bearer-token |
string | — | NASA Earthdata bearer token for fetching user-specific job history. |
always-show |
boolean | false | If true, always show the panel even if the user has no jobs. |
Best Practices
- Use
always-showif you want to encourage new users to create their first request. - Place the component once per page, typically at the root level, to avoid duplicate panels.
- Clicking a job opens the full job details in a dialog for review or re-download.
Accessibility
- The panel and dialog are keyboard accessible.
- All interactive elements have clear focus indicators.
- Uses ARIA roles and labels for screen readers.
[component-metadata:terra-data-subsetter-history]
Importing
If you’re using the autoloader or the traditional loader, you can ignore this section. Otherwise, feel free to use any of the following snippets to cherry pick this component.
To import this component from the CDN using a script tag:
<script type="module" src="https://cdn.jsdelivr.net/npm/@nasa-terra/components@0.0.138/cdn/components/data-subsetter-history/data-subsetter-history.js"></script>
To import this component from the CDN using a JavaScript import:
import 'https://cdn.jsdelivr.net/npm/@nasa-terra/components@0.0.138/cdn/components/data-subsetter-history/data-subsetter-history.js';
To import this component using a bundler:
import '@nasa-terra/components/dist/components/data-subsetter-history/data-subsetter-history.js';
To import this component as a React component:
import TerraDataSubsetterHistory from '@nasa-terra/components/dist/react/data-subsetter-history';
Properties
| Name | Description | Reflects | Type | Default |
|---|---|---|---|---|
alwaysShow
always-show
|
if a user has never done a subset request, by default they don’t see the history panel at all this prop allows you to override that behavior and always show the history panel |
boolean
|
true
|
|
updateComplete
|
A read-only promise that resolves when the component has finished updating. |
Learn more about attributes and properties.
Dependencies
This component automatically imports the following dependencies.
-
<terra-accordion> -
<terra-button> -
<terra-data-subsetter> -
<terra-date-picker> -
<terra-dialog> -
<terra-dropdown> -
<terra-icon> -
<terra-input> -
<terra-popup> -
<terra-spatial-picker>