coze-studio/frontend/packages/arch/bot-hooks-base/src/use-page-state.ts

69 lines
1.8 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

/*
* Copyright 2025 coze-dev Authors
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this 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 { useEffect, useRef, useState } from 'react';
export interface PageStateUpdateFunc<State extends object = object> {
(freshState: State, replace: true): void;
(freshState: Partial<State>): void;
}
/**
* 对state一层封装包含更新state、重置state
*
* @deprecated 请使用 bot-hooks 的 useComponentStates
*/
export function usePageState<State extends object = object>(
initState: State,
autoResetWhenDestroy = false,
) {
const [state, customSetState] = useState(initState);
const destroyRef = useRef(false);
function setState(freshState: State, replace: true): void;
function setState(freshState: Partial<State>): void;
function setState(freshState: Partial<State> | State, replace?: true) {
if (replace) {
customSetState(freshState as State);
}
customSetState(prev => ({ ...prev, ...freshState }));
}
const resetState = () => {
customSetState(initState);
};
useEffect(() => {
destroyRef.current = autoResetWhenDestroy;
}, [autoResetWhenDestroy]);
useEffect(
() => () => {
// 自动重置状态
if (destroyRef.current) {
resetState();
}
},
[],
);
return {
state,
resetState,
setState: setState as PageStateUpdateFunc<State>,
};
}