perf(CompanyOverview): hooks 支持 enabled 延迟加载和刷新

- 所有 hooks 参数改为 options 对象形式
- 新增 enabled 参数支持延迟加载
- 新增 refreshKey 参数支持手动刷新
- 智能初始化 loading 状态,避免首次渲染闪现空状态

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
zdl
2025-12-19 18:53:30 +08:00
parent 672e746a26
commit 298ac5a335
6 changed files with 132 additions and 38 deletions

View File

@@ -11,6 +11,13 @@ interface ApiResponse<T> {
data: T;
}
// 支持延迟加载的配置选项
interface UseShareholderDataOptions {
stockCode?: string;
/** 是否启用数据加载,默认 true */
enabled?: boolean;
}
interface UseShareholderDataResult {
actualControl: ActualControl[];
concentration: Concentration[];
@@ -21,19 +28,25 @@ interface UseShareholderDataResult {
}
/**
* 股权结构数据 Hook
* @param stockCode - 股票代码
* 股权结构数据 Hook(支持延迟加载)
* @param options - 配置选项
* @param options.stockCode - 股票代码
* @param options.enabled - 是否启用数据加载,默认 true
*/
export const useShareholderData = (stockCode?: string): UseShareholderDataResult => {
export const useShareholderData = (options: UseShareholderDataOptions): UseShareholderDataResult => {
const { stockCode, enabled = true } = options;
const [actualControl, setActualControl] = useState<ActualControl[]>([]);
const [concentration, setConcentration] = useState<Concentration[]>([]);
const [topShareholders, setTopShareholders] = useState<Shareholder[]>([]);
const [topCirculationShareholders, setTopCirculationShareholders] = useState<Shareholder[]>([]);
const [loading, setLoading] = useState(false);
// 智能初始化 loading当需要加载数据时初始值为 true避免首次渲染闪现空状态
const [loading, setLoading] = useState(() => enabled && !!stockCode);
const [error, setError] = useState<string | null>(null);
useEffect(() => {
if (!stockCode) return;
// 只有 enabled 且有 stockCode 时才请求
if (!enabled || !stockCode) return;
const controller = new AbortController();
@@ -69,7 +82,7 @@ export const useShareholderData = (stockCode?: string): UseShareholderDataResult
loadData();
return () => controller.abort();
}, [stockCode]);
}, [stockCode, enabled]);
return {
actualControl,