* core: enhance LazyContent component with detailed JSDoc comments for improved documentation and maintainability

Author: catouse

lib/core/src/react/components/lazy-content.tsx

@@ -6,26 +6,42 @@ import {HtmlContent} from './html-content';
 import {CustomContent} from './custom-content';
 import {classes} from '../../helpers';
 
+/**
+ * 懒加载内容组件的状态
+ */
 export type LazyContentState = {
+    /** 是否正在加载 */
     loading?: boolean;
+    /** 加载出错时的错误对象 */
     error?: Error;
+    /** 加载到的内容 */
     content?: CustomContentType;
 };
 
+/**
+ * 懒加载内容组件
+ * 用于异步加载并展示内容，支持 HTML、文本或自定义组件渲染
+ */
 export class LazyContent extends Component<LazyContentProps, LazyContentState> {
+    /** 默认属性 */
     static defaultProps: Partial<LazyContentProps> = {
         type: 'html',
         loadingIndicator: true,
         loadingClass: 'loading',
         clearBeforeLoad: true,
     };
 
+    /** 组件内部状态 */
     state: LazyContentState = {};
 
     protected _ref = createRef<HTMLDivElement>();
 
     protected _ajax?: Ajax;
 
+    /**
+     * 加载内容
+     * @param newFetcher 可选的新的获取器设置，如果提供将使用此设置进行加载，否则使用 props 中的 fetcher
+     */
     async load(newFetcher?: FetcherSetting) {
         const {props} = this;
         const {fetcher, type, fetcherArgs, fetcherThis = this, clearBeforeLoad} = props;
@@ -41,6 +57,9 @@ export class LazyContent extends Component<LazyContentProps, LazyContentState> {
         this._ajax = undefined;
     }
 
+    /**
+     * 组件挂载后触发加载，并监听 `loadContent.zui` 事件
+     */
     componentDidMount(): void {
         this.load();
         $(this._ref.current).on('loadContent.zui', (event: Event, fetcher?: FetcherSetting) => {
@@ -49,12 +68,19 @@ export class LazyContent extends Component<LazyContentProps, LazyContentState> {
         });
     }
 
+    /**
+     * 组件更新时检查 fetcher 相关属性是否变化，若变化则重新加载
+     * @param previousProps 上一次渲染的属性
+     */
     componentDidUpdate(previousProps: Readonly<LazyContentProps>): void {
         if (this.props.fetcher !== previousProps.fetcher || this.props.fetcherArgs !== previousProps.fetcherArgs || this.props.fetcherThis !== previousProps.fetcherThis) {
             this.load();
         }
     }
 
+    /**
+     * 组件卸载时中止未完成的请求并移除事件监听
+     */
     componentWillUnmount(): void {
         this._ajax?.abort();
         $(this._ref.current).off('.zui');
@@ -78,6 +104,10 @@ export class LazyContent extends Component<LazyContentProps, LazyContentState> {
         return <CustomContent content={content} {...otherProps} />;
     }
 
+    /**
+     * 渲染组件结构
+     * @param props 组件属性
+     */
     render(props: LazyContentProps) {
         const {loading} = this.state;
         const {id, loadingClass, loadingIndicator, className, style, attrs, loadingText, ...others} = props;