Add comprehensive loading state support with skeleton animations for the SelectableButtonGroup component, improving user experience during data loading. Key Changes: - Add loading prop to SelectableButtonGroup with minimum 500ms display duration - Implement skeleton buttons with proper Semi-UI Skeleton wrapper and active animation - Use fixed skeleton count (6 items) to prevent visual jumping during load transitions - Pass loading state through all pricing filter components hierarchy: - PricingSidebar and PricingFilterModal as container components - PricingDisplaySettings, PricingCategories, PricingGroups, PricingQuotaTypes as filter components Technical Details: - Reference CardTable.js implementation for consistent skeleton UI patterns - Add useEffect hook for 500ms minimum loading duration control - Support both checkbox and regular button skeleton modes - Maintain responsive layout compatibility (mobile/desktop) - Add proper JSDoc parameter documentation for loading prop Fixes: - Prevent skeleton count sudden changes that caused visual discontinuity - Ensure proper skeleton animation with Semi-UI active parameter - Maintain consistent loading experience across all filter components
269 lines
8.2 KiB
JavaScript
269 lines
8.2 KiB
JavaScript
/*
|
||
Copyright (C) 2025 QuantumNous
|
||
|
||
This program is free software: you can redistribute it and/or modify
|
||
it under the terms of the GNU Affero General Public License as
|
||
published by the Free Software Foundation, either version 3 of the
|
||
License, or (at your option) any later version.
|
||
|
||
This program is distributed in the hope that it will be useful,
|
||
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||
GNU Affero General Public License for more details.
|
||
|
||
You should have received a copy of the GNU Affero General Public License
|
||
along with this program. If not, see <https://www.gnu.org/licenses/>.
|
||
|
||
For commercial licensing, please contact support@quantumnous.com
|
||
*/
|
||
|
||
import React, { useState, useRef, useEffect } from 'react';
|
||
import { useIsMobile } from '../../../hooks/common/useIsMobile';
|
||
import { Divider, Button, Tag, Row, Col, Collapsible, Checkbox, Skeleton } from '@douyinfe/semi-ui';
|
||
import { IconChevronDown, IconChevronUp } from '@douyinfe/semi-icons';
|
||
|
||
/**
|
||
* 通用可选择按钮组组件
|
||
*
|
||
* @param {string} title 标题
|
||
* @param {Array<{value:any,label:string,icon?:React.ReactNode,tagCount?:number}>} items 按钮项
|
||
* @param {*|Array} activeValue 当前激活的值,可以是单个值或数组(多选)
|
||
* @param {(value:any)=>void} onChange 选择改变回调
|
||
* @param {function} t i18n
|
||
* @param {object} style 额外样式
|
||
* @param {boolean} collapsible 是否支持折叠,默认true
|
||
* @param {number} collapseHeight 折叠时的高度,默认200
|
||
* @param {boolean} withCheckbox 是否启用前缀 Checkbox 来控制激活状态
|
||
* @param {boolean} loading 是否处于加载状态
|
||
*/
|
||
const SelectableButtonGroup = ({
|
||
title,
|
||
items = [],
|
||
activeValue,
|
||
onChange,
|
||
t = (v) => v,
|
||
style = {},
|
||
collapsible = true,
|
||
collapseHeight = 200,
|
||
withCheckbox = false,
|
||
loading = false
|
||
}) => {
|
||
const [isOpen, setIsOpen] = useState(false);
|
||
const [showSkeleton, setShowSkeleton] = useState(loading);
|
||
const [skeletonCount] = useState(6);
|
||
const isMobile = useIsMobile();
|
||
const perRow = 3;
|
||
const maxVisibleRows = Math.max(1, Math.floor(collapseHeight / 32)); // Approx row height 32
|
||
const needCollapse = collapsible && items.length > perRow * maxVisibleRows;
|
||
const loadingStartRef = useRef(Date.now());
|
||
|
||
const contentRef = useRef(null);
|
||
|
||
useEffect(() => {
|
||
if (loading) {
|
||
loadingStartRef.current = Date.now();
|
||
setShowSkeleton(true);
|
||
} else {
|
||
const elapsed = Date.now() - loadingStartRef.current;
|
||
const remaining = Math.max(0, 500 - elapsed);
|
||
if (remaining === 0) {
|
||
setShowSkeleton(false);
|
||
} else {
|
||
const timer = setTimeout(() => setShowSkeleton(false), remaining);
|
||
return () => clearTimeout(timer);
|
||
}
|
||
}
|
||
}, [loading]);
|
||
|
||
const maskStyle = isOpen
|
||
? {}
|
||
: {
|
||
WebkitMaskImage:
|
||
'linear-gradient(to bottom, black 0%, rgba(0, 0, 0, 1) 60%, rgba(0, 0, 0, 0.2) 80%, transparent 100%)',
|
||
};
|
||
|
||
const toggle = () => {
|
||
setIsOpen(!isOpen);
|
||
};
|
||
|
||
const linkStyle = {
|
||
position: 'absolute',
|
||
left: 0,
|
||
right: 0,
|
||
textAlign: 'center',
|
||
bottom: -10,
|
||
fontWeight: 400,
|
||
cursor: 'pointer',
|
||
fontSize: '12px',
|
||
color: 'var(--semi-color-text-2)',
|
||
display: 'flex',
|
||
alignItems: 'center',
|
||
justifyContent: 'center',
|
||
gap: 4,
|
||
};
|
||
|
||
const renderSkeletonButtons = () => {
|
||
|
||
const placeholder = (
|
||
<Row gutter={[8, 8]} style={{ lineHeight: '32px', ...style }}>
|
||
{Array.from({ length: skeletonCount }).map((_, index) => (
|
||
<Col
|
||
{...(isMobile
|
||
? { span: 12 }
|
||
: { xs: 24, sm: 24, md: 24, lg: 12, xl: 8 }
|
||
)}
|
||
key={index}
|
||
>
|
||
<div style={{
|
||
width: '100%',
|
||
height: '32px',
|
||
display: 'flex',
|
||
alignItems: 'center',
|
||
justifyContent: 'flex-start',
|
||
border: '1px solid var(--semi-color-border)',
|
||
borderRadius: 'var(--semi-border-radius-medium)',
|
||
padding: '0 12px',
|
||
gap: '8px'
|
||
}}>
|
||
{withCheckbox && (
|
||
<Skeleton.Title active style={{ width: 14, height: 14 }} />
|
||
)}
|
||
<Skeleton.Title
|
||
active
|
||
style={{
|
||
width: `${60 + (index % 3) * 20}px`,
|
||
height: 14
|
||
}}
|
||
/>
|
||
</div>
|
||
</Col>
|
||
))}
|
||
</Row>
|
||
);
|
||
|
||
return (
|
||
<Skeleton loading={true} active placeholder={placeholder}></Skeleton>
|
||
);
|
||
};
|
||
|
||
const contentElement = showSkeleton ? renderSkeletonButtons() : (
|
||
<Row gutter={[8, 8]} style={{ lineHeight: '32px', ...style }} ref={contentRef}>
|
||
{items.map((item) => {
|
||
const isActive = Array.isArray(activeValue)
|
||
? activeValue.includes(item.value)
|
||
: activeValue === item.value;
|
||
|
||
if (withCheckbox) {
|
||
return (
|
||
<Col
|
||
{...(isMobile
|
||
? { span: 12 }
|
||
: { xs: 24, sm: 24, md: 24, lg: 12, xl: 8 }
|
||
)}
|
||
key={item.value}
|
||
>
|
||
<Button
|
||
onClick={() => { /* disabled */ }}
|
||
theme={isActive ? 'light' : 'outline'}
|
||
type={isActive ? 'primary' : 'tertiary'}
|
||
icon={
|
||
<Checkbox
|
||
checked={isActive}
|
||
onChange={() => onChange(item.value)}
|
||
style={{ pointerEvents: 'auto' }}
|
||
/>
|
||
}
|
||
style={{ width: '100%', cursor: 'default' }}
|
||
>
|
||
{item.icon && (
|
||
<span style={{ marginRight: 4 }}>{item.icon}</span>
|
||
)}
|
||
<span style={{ marginRight: item.tagCount !== undefined ? 4 : 0 }}>{item.label}</span>
|
||
{item.tagCount !== undefined && (
|
||
<Tag
|
||
color='white'
|
||
shape="circle"
|
||
size="small"
|
||
>
|
||
{item.tagCount}
|
||
</Tag>
|
||
)}
|
||
</Button>
|
||
</Col>
|
||
);
|
||
}
|
||
|
||
return (
|
||
<Col
|
||
{...(isMobile
|
||
? { span: 12 }
|
||
: { xs: 24, sm: 24, md: 24, lg: 12, xl: 8 }
|
||
)}
|
||
key={item.value}
|
||
>
|
||
<Button
|
||
onClick={() => onChange(item.value)}
|
||
theme={isActive ? 'light' : 'outline'}
|
||
type={isActive ? 'primary' : 'tertiary'}
|
||
icon={item.icon}
|
||
style={{ width: '100%' }}
|
||
>
|
||
<span style={{ marginRight: item.tagCount !== undefined ? 4 : 0 }}>{item.label}</span>
|
||
{item.tagCount !== undefined && (
|
||
<Tag
|
||
color='white'
|
||
shape="circle"
|
||
size="small"
|
||
>
|
||
{item.tagCount}
|
||
</Tag>
|
||
)}
|
||
</Button>
|
||
</Col>
|
||
);
|
||
})}
|
||
</Row>
|
||
);
|
||
|
||
return (
|
||
<div className="mb-8">
|
||
{title && (
|
||
<Divider margin="12px" align="left">
|
||
{showSkeleton ? (
|
||
<Skeleton.Title active style={{ width: 80, height: 14 }} />
|
||
) : (
|
||
title
|
||
)}
|
||
</Divider>
|
||
)}
|
||
{needCollapse && !showSkeleton ? (
|
||
<div style={{ position: 'relative' }}>
|
||
<Collapsible isOpen={isOpen} collapseHeight={collapseHeight} style={{ ...maskStyle }}>
|
||
{contentElement}
|
||
</Collapsible>
|
||
{isOpen ? null : (
|
||
<div onClick={toggle} style={{ ...linkStyle }}>
|
||
<IconChevronDown size="small" />
|
||
<span>{t('展开更多')}</span>
|
||
</div>
|
||
)}
|
||
{isOpen && (
|
||
<div onClick={toggle} style={{
|
||
...linkStyle,
|
||
position: 'static',
|
||
marginTop: 8,
|
||
bottom: 'auto'
|
||
}}>
|
||
<IconChevronUp size="small" />
|
||
<span>{t('收起')}</span>
|
||
</div>
|
||
)}
|
||
</div>
|
||
) : (
|
||
contentElement
|
||
)}
|
||
</div>
|
||
);
|
||
};
|
||
|
||
export default SelectableButtonGroup;
|