Skip to content

Commit

Permalink
feat: Implement drag and drop for metrics (#13575)
Browse files Browse the repository at this point in the history
* Convert MetricsControl to functional component

* Implement drag and drop for metrics

* Implement customizable placeholder for DndSelectLabel
  • Loading branch information
kgabryje authored Mar 12, 2021
1 parent 1b95ed7 commit d439da2
Show file tree
Hide file tree
Showing 9 changed files with 357 additions and 38 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -17,12 +17,12 @@
* under the License.
*/
import React, { useEffect, useMemo, useState } from 'react';
import { logging, SupersetClient } from '@superset-ui/core';
import { logging, SupersetClient, t } from '@superset-ui/core';
import { ColumnMeta, Metric } from '@superset-ui/chart-controls';
import { Tooltip } from 'src/common/components/Tooltip';
import { OPERATORS } from 'src/explore/constants';
import { OptionSortType } from 'src/explore/types';
import { DndFilterSelectProps, FilterOptionValueType } from './types';
import { DndFilterSelectProps, OptionValueType } from './types';
import AdhocFilterPopoverTrigger from '../FilterControl/AdhocFilterPopoverTrigger';
import OptionWrapper from './components/OptionWrapper';
import DndSelectLabel from './DndSelectLabel';
Expand All @@ -37,13 +37,13 @@ import {
} from '../../DatasourcePanel/types';
import { DndItemType } from '../../DndItemType';

const isDictionaryForAdhocFilter = (value: FilterOptionValueType) =>
const isDictionaryForAdhocFilter = (value: OptionValueType) =>
!(value instanceof AdhocFilter) && value?.expressionType;

export const DndFilterSelect = (props: DndFilterSelectProps) => {
const propsValues = Array.from(props.value ?? []);
const [values, setValues] = useState(
propsValues.map((filter: FilterOptionValueType) =>
propsValues.map((filter: OptionValueType) =>
isDictionaryForAdhocFilter(filter) ? new AdhocFilter(filter) : filter,
),
);
Expand Down Expand Up @@ -144,7 +144,7 @@ export const DndFilterSelect = (props: DndFilterSelectProps) => {

useEffect(() => {
setValues(
(props.value || []).map((filter: FilterOptionValueType) =>
(props.value || []).map((filter: OptionValueType) =>
isDictionaryForAdhocFilter(filter) ? new AdhocFilter(filter) : filter,
),
);
Expand All @@ -171,7 +171,7 @@ export const DndFilterSelect = (props: DndFilterSelectProps) => {
(savedMetric: Metric) => savedMetric.metric_name === savedMetricName,
)?.expression;

const mapOption = (option: FilterOptionValueType) => {
const mapOption = (option: OptionValueType) => {
// already a AdhocFilter, skip
if (option instanceof AdhocFilter) {
return option;
Expand Down Expand Up @@ -299,7 +299,7 @@ export const DndFilterSelect = (props: DndFilterSelectProps) => {

return (
<>
<DndSelectLabel<FilterOptionValueType, FilterOptionValueType[]>
<DndSelectLabel<OptionValueType, OptionValueType[]>
values={values}
onDrop={(item: DatasourcePanelDndItem) => {
setDroppedItem(item.value);
Expand All @@ -313,6 +313,7 @@ export const DndFilterSelect = (props: DndFilterSelectProps) => {
DndItemType.MetricOption,
DndItemType.AdhocMetricOption,
]}
placeholderText={t('Drop columns or metrics')}
{...props}
/>
<AdhocFilterPopoverTrigger
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,301 @@
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with work for additional information
* regarding copyright ownership. The ASF licenses file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
*/

import React, { useCallback, useEffect, useMemo, useState } from 'react';
import { ensureIsArray, Metric, t } from '@superset-ui/core';
import { ColumnMeta } from '@superset-ui/chart-controls';
import { isEqual } from 'lodash';
import { usePrevious } from 'src/common/hooks/usePrevious';
import AdhocMetric from '../MetricControl/AdhocMetric';
import AdhocMetricPopoverTrigger from '../MetricControl/AdhocMetricPopoverTrigger';
import MetricDefinitionValue from '../MetricControl/MetricDefinitionValue';
import { OptionValueType } from './types';
import { DatasourcePanelDndItem } from '../../DatasourcePanel/types';
import { DndItemType } from '../../DndItemType';
import DndSelectLabel from './DndSelectLabel';
import { savedMetricType } from '../MetricControl/types';

const isDictionaryForAdhocMetric = (value: any) =>
value && !(value instanceof AdhocMetric) && value.expressionType;

const coerceAdhocMetrics = (value: any) => {
if (!value) {
return [];
}
if (!Array.isArray(value)) {
if (isDictionaryForAdhocMetric(value)) {
return [new AdhocMetric(value)];
}
return [value];
}
return value.map(val => {
if (isDictionaryForAdhocMetric(val)) {
return new AdhocMetric(val);
}
return val;
});
};

const getOptionsForSavedMetrics = (
savedMetrics: savedMetricType[],
currentMetricValues: (string | AdhocMetric)[],
currentMetric?: string,
) =>
savedMetrics?.filter(savedMetric =>
Array.isArray(currentMetricValues)
? !currentMetricValues.includes(savedMetric.metric_name ?? '') ||
savedMetric.metric_name === currentMetric
: savedMetric,
) ?? [];

const columnsContainAllMetrics = (
value: (string | AdhocMetric | ColumnMeta)[],
columns: ColumnMeta[],
savedMetrics: savedMetricType[],
) => {
const columnNames = new Set(
[...(columns || []), ...(savedMetrics || [])]
// eslint-disable-next-line camelcase
.map(
item =>
(item as ColumnMeta).column_name ||
(item as savedMetricType).metric_name,
),
);

return (
ensureIsArray(value)
.filter(metric => metric)
// find column names
.map(metric =>
(metric as AdhocMetric).column
? (metric as AdhocMetric).column.column_name
: (metric as ColumnMeta).column_name || metric,
)
.filter(name => name && typeof name === 'string')
.every(name => columnNames.has(name))
);
};

export const DndMetricSelect = (props: any) => {
const { onChange, multi, columns, savedMetrics } = props;

const handleChange = useCallback(
opts => {
// if clear out options
if (opts === null) {
onChange(null);
return;
}

const transformedOpts = ensureIsArray(opts);
const optionValues = transformedOpts
.map(option => {
// pre-defined metric
if (option.metric_name) {
return option.metric_name;
}
return option;
})
.filter(option => option);
onChange(multi ? optionValues : optionValues[0]);
},
[multi, onChange],
);

const [value, setValue] = useState<(AdhocMetric | Metric | string)[]>(
coerceAdhocMetrics(props.value),
);
const [droppedItem, setDroppedItem] = useState<DatasourcePanelDndItem | null>(
null,
);
const [newMetricPopoverVisible, setNewMetricPopoverVisible] = useState(false);
const prevColumns = usePrevious(columns);
const prevSavedMetrics = usePrevious(savedMetrics);

useEffect(() => {
setValue(coerceAdhocMetrics(props.value));
}, [JSON.stringify(props.value)]);

useEffect(() => {
if (
!isEqual(prevColumns, columns) ||
!isEqual(prevSavedMetrics, savedMetrics)
) {
// Remove all metrics if selected value no longer a valid column
// in the dataset. Must use `nextProps` here because Redux reducers may
// have already updated the value for this control.
if (!columnsContainAllMetrics(props.value, columns, savedMetrics)) {
onChange([]);
}
}
}, [
prevColumns,
columns,
prevSavedMetrics,
savedMetrics,
props.value,
onChange,
]);

const canDrop = (item: DatasourcePanelDndItem) => {
const isMetricAlreadyInValues =
item.type === 'metric' ? value.includes(item.value.metric_name) : false;
return (props.multi || value.length === 0) && !isMetricAlreadyInValues;
};

const onNewMetric = (newMetric: Metric) => {
const newValue = [...value, newMetric];
setValue(newValue);
handleChange(newValue);
};

const onMetricEdit = (
changedMetric: Metric | AdhocMetric,
oldMetric: Metric | AdhocMetric,
) => {
const newValue = value.map(value => {
if (
// compare saved metrics
value === (oldMetric as Metric).metric_name ||
// compare adhoc metrics
typeof (value as AdhocMetric).optionName !== 'undefined'
? (value as AdhocMetric).optionName ===
(oldMetric as AdhocMetric).optionName
: false
) {
return changedMetric;
}
return value;
});
setValue(newValue);
handleChange(newValue);
};

const onRemoveMetric = (index: number) => {
if (!Array.isArray(value)) {
return;
}
const valuesCopy = [...value];
valuesCopy.splice(index, 1);
setValue(valuesCopy);
onChange(valuesCopy);
};

const moveLabel = (dragIndex: number, hoverIndex: number) => {
const newValues = [...value];
[newValues[hoverIndex], newValues[dragIndex]] = [
newValues[dragIndex],
newValues[hoverIndex],
];
setValue(newValues);
};

const valueRenderer = (
option: Metric | AdhocMetric | string,
index: number,
) => (
<MetricDefinitionValue
key={index}
index={index}
option={option}
onMetricEdit={onMetricEdit}
onRemoveMetric={() => onRemoveMetric(index)}
columns={props.columns}
savedMetrics={props.savedMetrics}
savedMetricsOptions={getOptionsForSavedMetrics(
props.savedMetrics,
props.value,
props.value?.[index],
)}
datasourceType={props.datasourceType}
onMoveLabel={moveLabel}
onDropLabel={() => onChange(value)}
/>
);

const valuesRenderer = () =>
value.map((value, index) => valueRenderer(value, index));

const togglePopover = (visible: boolean) => {
setNewMetricPopoverVisible(visible);
};

const closePopover = () => {
togglePopover(false);
};

const { savedMetric, adhocMetric } = useMemo(() => {
if (droppedItem?.type === 'column') {
const itemValue = droppedItem?.value as ColumnMeta;
return {
savedMetric: {} as savedMetricType,
adhocMetric: new AdhocMetric({
column: { column_name: itemValue?.column_name },
}),
};
}
if (droppedItem?.type === 'metric') {
const itemValue = droppedItem?.value as savedMetricType;
return {
savedMetric: itemValue,
adhocMetric: new AdhocMetric({ isNew: true }),
};
}
return {
savedMetric: {} as savedMetricType,
adhocMetric: new AdhocMetric({ isNew: true }),
};
}, [droppedItem?.type, droppedItem?.value]);

return (
<div className="metrics-select">
<DndSelectLabel<OptionValueType, OptionValueType[]>
values={value}
onDrop={(item: DatasourcePanelDndItem) => {
setDroppedItem(item);
togglePopover(true);
}}
canDrop={canDrop}
valuesRenderer={valuesRenderer}
accept={[DndItemType.Column, DndItemType.Metric]}
placeholderText={t('Drop columns or metrics')}
{...props}
/>
<AdhocMetricPopoverTrigger
adhocMetric={adhocMetric}
onMetricEdit={onNewMetric}
columns={props.columns}
savedMetricsOptions={getOptionsForSavedMetrics(
props.savedMetrics,
props.value,
)}
savedMetric={savedMetric}
datasourceType={props.datasourceType}
isControlledComponent
visible={newMetricPopoverVisible}
togglePopover={togglePopover}
closePopover={closePopover}
createNew
>
<div />
</AdhocMetricPopoverTrigger>
</div>
);
};
Original file line number Diff line number Diff line change
Expand Up @@ -55,7 +55,7 @@ export default function DndSelectLabel<T, O>(
return (
<AddControlLabel cancelHover>
<Icon name="plus-small" color={theme.colors.grayscale.light1} />
{t('Drop Columns')}
{t(props.placeholderText || 'Drop columns')}
</AddControlLabel>
);
}
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -19,3 +19,4 @@
export { default } from './DndSelectLabel';
export * from './DndColumnSelect';
export * from './DndFilterSelect';
export * from './DndMetricSelect';
Loading

0 comments on commit d439da2

Please sign in to comment.