docs: add comments to the src/components directory
This commit is contained in:
@@ -1,17 +1,36 @@
|
||||
import { Switch, Form, ConfigProvider } from "antd";
|
||||
import useSize from 'antd/lib/config-provider/hooks/useSize'
|
||||
/*
|
||||
* @Author: ZhaoYing
|
||||
* @Date: 2026-02-02 15:06:24
|
||||
* @Last Modified by: ZhaoYing
|
||||
* @Last Modified time: 2026-02-02 15:50:49
|
||||
*/
|
||||
/**
|
||||
* SwitchFormItem Component
|
||||
*
|
||||
* A form item component that combines a switch control with a label and optional description.
|
||||
* Provides a consistent layout for switch-based form fields.
|
||||
*
|
||||
* @component
|
||||
*/
|
||||
|
||||
import { Switch, Form } from "antd";
|
||||
import type { FC, ReactNode } from "react";
|
||||
import { useContext } from "react";
|
||||
|
||||
import LabelWrapper from './LabelWrapper'
|
||||
import DescWrapper from './DescWrapper'
|
||||
|
||||
interface SwitchFormItemProps {
|
||||
/** Label text or React node */
|
||||
title: string | ReactNode;
|
||||
/** Optional description text or React node */
|
||||
desc?: string | ReactNode;
|
||||
/** Form field name (string or nested path array) */
|
||||
name: string | string[];
|
||||
/** Switch size */
|
||||
size?: 'small' | 'default'
|
||||
/** Additional CSS classes */
|
||||
className?: string;
|
||||
/** Whether the switch is disabled */
|
||||
disabled?: boolean;
|
||||
}
|
||||
|
||||
@@ -23,14 +42,13 @@ const SwitchFormItem: FC<SwitchFormItemProps> = ({
|
||||
className,
|
||||
disabled
|
||||
}) => {
|
||||
const componentSize = useSize()
|
||||
console.log('componentSize', componentSize)
|
||||
|
||||
return (
|
||||
<div className={`${className} rb:flex rb:items-center rb:justify-between`}>
|
||||
{/* Label and description section */}
|
||||
<LabelWrapper title={title}>
|
||||
{desc && <DescWrapper desc={desc} className="rb:mt-2" />}
|
||||
</LabelWrapper>
|
||||
{/* Switch control */}
|
||||
<Form.Item
|
||||
name={name}
|
||||
valuePropName="checked"
|
||||
|
||||
Reference in New Issue
Block a user