mirror of
https://github.com/apache/superset.git
synced 2026-04-25 19:14:27 +00:00
[SIP-5] Refactor Time Series Table (#5775)
* Break TimeTable into smaller pieces * extract function to compute color * Handle height and scrollbar * sort out isGroupBy * Set default values * Specify proptypes for data * rename fields and update proptypes * Add default props * remove commented line * swap import
This commit is contained in:
committed by
Chris Williams
parent
057c749471
commit
7098ada8c5
327
superset/assets/src/visualizations/TimeTable/TimeTable.jsx
Normal file
327
superset/assets/src/visualizations/TimeTable/TimeTable.jsx
Normal file
@@ -0,0 +1,327 @@
|
||||
import ReactDOM from 'react-dom';
|
||||
import React from 'react';
|
||||
import PropTypes from 'prop-types';
|
||||
import d3 from 'd3';
|
||||
import Mustache from 'mustache';
|
||||
import { Table, Thead, Th, Tr, Td } from 'reactable';
|
||||
|
||||
import MetricOption from '../../components/MetricOption';
|
||||
import { formatDateThunk } from '../../modules/dates';
|
||||
import { d3format } from '../../modules/utils';
|
||||
import InfoTooltipWithTrigger from '../../components/InfoTooltipWithTrigger';
|
||||
import FormattedNumber from './FormattedNumber';
|
||||
import SparklineCell from './SparklineCell';
|
||||
import './TimeTable.css';
|
||||
|
||||
const ACCESSIBLE_COLOR_BOUNDS = ['#ca0020', '#0571b0'];
|
||||
|
||||
function colorFromBounds(value, bounds, colorBounds = ACCESSIBLE_COLOR_BOUNDS) {
|
||||
if (bounds) {
|
||||
const [min, max] = bounds;
|
||||
const [minColor, maxColor] = colorBounds;
|
||||
if (min !== null && max !== null) {
|
||||
const colorScale = d3.scale.linear()
|
||||
.domain([min, (max + min) / 2, max])
|
||||
.range([minColor, 'grey', maxColor]);
|
||||
return colorScale(value);
|
||||
} else if (min !== null) {
|
||||
return value >= min ? maxColor : minColor;
|
||||
} else if (max !== null) {
|
||||
return value < max ? maxColor : minColor;
|
||||
}
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
const propTypes = {
|
||||
className: PropTypes.string,
|
||||
height: PropTypes.number,
|
||||
// Example
|
||||
// {'2018-04-14 00:00:00': { 'SUM(metric_value)': 80031779.40047 }}
|
||||
data: PropTypes.objectOf(PropTypes.objectOf(PropTypes.number)).isRequired,
|
||||
columnConfigs: PropTypes.arrayOf(PropTypes.shape({
|
||||
colType: PropTypes.string,
|
||||
comparisonType: PropTypes.string,
|
||||
d3format: PropTypes.string,
|
||||
key: PropTypes.string,
|
||||
label: PropTypes.string,
|
||||
timeLag: PropTypes.number,
|
||||
})).isRequired,
|
||||
rows: PropTypes.arrayOf(PropTypes.oneOfType([
|
||||
PropTypes.shape({
|
||||
label: PropTypes.string,
|
||||
}),
|
||||
PropTypes.shape({
|
||||
metric_name: PropTypes.string,
|
||||
}),
|
||||
])).isRequired,
|
||||
rowType: PropTypes.oneOf(['column', 'metric']).isRequired,
|
||||
url: PropTypes.string,
|
||||
};
|
||||
const defaultProps = {
|
||||
className: '',
|
||||
height: undefined,
|
||||
url: '',
|
||||
};
|
||||
|
||||
class TimeTable extends React.PureComponent {
|
||||
renderLeftCell(row) {
|
||||
const { rowType, url } = this.props;
|
||||
const context = { metric: row };
|
||||
const fullUrl = url ? Mustache.render(url, context) : null;
|
||||
|
||||
if (rowType === 'column') {
|
||||
const column = row;
|
||||
if (fullUrl) {
|
||||
return (
|
||||
<a
|
||||
href={fullUrl}
|
||||
rel="noopener noreferrer"
|
||||
target="_blank"
|
||||
>
|
||||
{column.label}
|
||||
</a>
|
||||
);
|
||||
}
|
||||
return column.label;
|
||||
}
|
||||
|
||||
const metric = row;
|
||||
return (
|
||||
<MetricOption
|
||||
metric={metric}
|
||||
url={fullUrl}
|
||||
showFormula={false}
|
||||
openInNewWindow
|
||||
/>
|
||||
);
|
||||
}
|
||||
|
||||
renderSparklineCell(valueField, column, entries) {
|
||||
let sparkData;
|
||||
if (column.timeRatio) {
|
||||
// Period ratio sparkline
|
||||
sparkData = [];
|
||||
for (let i = column.timeRatio; i < entries.length; i++) {
|
||||
const prevData = entries[i - column.timeRatio][valueField];
|
||||
if (prevData && prevData !== 0) {
|
||||
sparkData.push(entries[i][valueField] / prevData);
|
||||
} else {
|
||||
sparkData.push(null);
|
||||
}
|
||||
}
|
||||
} else {
|
||||
sparkData = entries.map(d => d[valueField]);
|
||||
}
|
||||
|
||||
const formatDate = formatDateThunk(column.dateFormat);
|
||||
|
||||
return (
|
||||
<Td
|
||||
column={column.key}
|
||||
key={column.key}
|
||||
value={sparkData[sparkData.length - 1]}
|
||||
>
|
||||
<SparklineCell
|
||||
width={parseInt(column.width, 10) || 300}
|
||||
height={parseInt(column.height, 10) || 50}
|
||||
data={sparkData}
|
||||
ariaLabel={`spark-${valueField}`}
|
||||
numberFormat={column.d3format}
|
||||
yAxisBounds={column.yAxisBounds}
|
||||
showYAxis={column.showYAxis}
|
||||
renderTooltip={({ index }) => (
|
||||
<div>
|
||||
<strong>{d3format(column.d3Format, sparkData[index])}</strong>
|
||||
<div>{formatDate(entries[index].time)}</div>
|
||||
</div>
|
||||
)}
|
||||
/>
|
||||
</Td>
|
||||
);
|
||||
}
|
||||
|
||||
renderValueCell(valueField, column, reversedEntries) {
|
||||
const recent = reversedEntries[0][valueField];
|
||||
let v;
|
||||
let errorMsg;
|
||||
if (column.colType === 'time') {
|
||||
// Time lag ratio
|
||||
const { timeLag } = column;
|
||||
const totalLag = Object.keys(reversedEntries).length;
|
||||
if (timeLag > totalLag) {
|
||||
errorMsg = `The time lag set at ${timeLag} exceeds the length of data at ${reversedData.length}. No data available.`;
|
||||
} else {
|
||||
v = reversedEntries[timeLag][valueField];
|
||||
}
|
||||
if (column.comparisonType === 'diff') {
|
||||
v = recent - v;
|
||||
} else if (column.comparisonType === 'perc') {
|
||||
v = recent / v;
|
||||
} else if (column.comparisonType === 'perc_change') {
|
||||
v = (recent / v) - 1;
|
||||
}
|
||||
v = v || 0;
|
||||
} else if (column.colType === 'contrib') {
|
||||
// contribution to column total
|
||||
v = recent / Object.keys(reversedEntries[0])
|
||||
.map(k => k !== 'time' ? reversedEntries[0][k] : null)
|
||||
.reduce((a, b) => a + b);
|
||||
} else if (column.colType === 'avg') {
|
||||
// Average over the last {timeLag}
|
||||
v = reversedEntries
|
||||
.map((k, i) => i < column.timeLag ? k[valueField] : 0)
|
||||
.reduce((a, b) => a + b) / column.timeLag;
|
||||
}
|
||||
|
||||
const color = colorFromBounds(v, column.bounds);
|
||||
|
||||
return (
|
||||
<Td
|
||||
column={column.key}
|
||||
key={column.key}
|
||||
value={v}
|
||||
style={color && {
|
||||
boxShadow: `inset 0px -2.5px 0px 0px ${color}`,
|
||||
borderRight: '2px solid #fff',
|
||||
}}
|
||||
>
|
||||
{errorMsg
|
||||
? (<div>{errorMsg}</div>)
|
||||
: (<div style={{ color }}>
|
||||
<FormattedNumber num={v} format={column.d3format} />
|
||||
</div>)}
|
||||
</Td>
|
||||
);
|
||||
}
|
||||
|
||||
renderRow(row, entries, reversedEntries) {
|
||||
const { columnConfigs } = this.props;
|
||||
const valueField = row.label || row.metric_name;
|
||||
const leftCell = this.renderLeftCell(row);
|
||||
|
||||
return (
|
||||
<Tr key={leftCell}>
|
||||
<Td column="metric" data={leftCell}>
|
||||
{leftCell}
|
||||
</Td>
|
||||
{columnConfigs.map(c => c.colType === 'spark'
|
||||
? this.renderSparklineCell(valueField, c, entries)
|
||||
: this.renderValueCell(valueField, c, reversedEntries))}
|
||||
</Tr>
|
||||
);
|
||||
}
|
||||
|
||||
render() {
|
||||
const {
|
||||
className,
|
||||
height,
|
||||
data,
|
||||
columnConfigs,
|
||||
rowType,
|
||||
rows,
|
||||
} = this.props;
|
||||
|
||||
const entries = Object.keys(data)
|
||||
.sort()
|
||||
.map(time => ({ ...data[time], time }));
|
||||
const reversedEntries = entries.concat().reverse();
|
||||
|
||||
const defaultSort = rowType === 'column' ? {
|
||||
column: columnConfigs[0].key,
|
||||
direction: 'desc',
|
||||
} : false;
|
||||
|
||||
return (
|
||||
<div
|
||||
className={`time-table ${className}`}
|
||||
style={{ height }}
|
||||
>
|
||||
<Table
|
||||
className="table table-no-hover"
|
||||
defaultSort={defaultSort}
|
||||
sortBy={defaultSort}
|
||||
sortable={columnConfigs.map(c => c.key)}
|
||||
>
|
||||
<Thead>
|
||||
<Th column="metric">Metric</Th>
|
||||
{columnConfigs.map((c, i) => (
|
||||
<Th
|
||||
key={c.key}
|
||||
column={c.key}
|
||||
width={c.colType === 'spark' ? '1%' : null}
|
||||
>
|
||||
{c.label} {c.tooltip && (
|
||||
<InfoTooltipWithTrigger
|
||||
tooltip={c.tooltip}
|
||||
label={`tt-col-${i}`}
|
||||
placement="top"
|
||||
/>
|
||||
)}
|
||||
</Th>))}
|
||||
</Thead>
|
||||
{rows.map(row => this.renderRow(row, entries, reversedEntries))}
|
||||
</Table>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
TimeTable.propTypes = propTypes;
|
||||
TimeTable.defaultProps = defaultProps;
|
||||
|
||||
function adaptor(slice, payload) {
|
||||
const { containerId, formData, datasource } = slice;
|
||||
const {
|
||||
column_collection: columnConfigs,
|
||||
groupby,
|
||||
metrics,
|
||||
url,
|
||||
} = formData;
|
||||
const { records, columns } = payload.data;
|
||||
const isGroupBy = groupby.length > 0;
|
||||
|
||||
// When there is a "group by",
|
||||
// each row in the table is a database column
|
||||
// Otherwise,
|
||||
// each row in the table is a metric
|
||||
let rows;
|
||||
if (isGroupBy) {
|
||||
rows = columns.map(column => (typeof column === 'object')
|
||||
? column
|
||||
: { label: column });
|
||||
} else {
|
||||
const metricMap = datasource.metrics
|
||||
.reduce((acc, current) => {
|
||||
const map = acc;
|
||||
map[current.metric_name] = current;
|
||||
return map;
|
||||
}, {});
|
||||
|
||||
rows = metrics.map(metric => (typeof metric === 'object')
|
||||
? metric
|
||||
: metricMap[metric]);
|
||||
}
|
||||
|
||||
// TODO: Better parse this from controls instead of mutative value here.
|
||||
columnConfigs.forEach((column) => {
|
||||
const c = column;
|
||||
if (c.timeLag !== undefined && c.timeLag !== null && c.timeLag !== '') {
|
||||
c.timeLag = parseInt(c.timeLag, 10);
|
||||
}
|
||||
});
|
||||
|
||||
ReactDOM.render(
|
||||
<TimeTable
|
||||
height={slice.height()}
|
||||
data={records}
|
||||
columnConfigs={columnConfigs}
|
||||
rows={rows}
|
||||
rowType={isGroupBy ? 'column' : 'metric'}
|
||||
url={url}
|
||||
/>,
|
||||
document.getElementById(containerId),
|
||||
);
|
||||
}
|
||||
|
||||
export default adaptor;
|
||||
Reference in New Issue
Block a user