# LargeListToggle - 大型列表开关

## 说明

大型列表开关控件，用于首页等需要突出展示的场景，右侧带开关控件，左侧支持图标和副标题（支持副标题组）。

## 属性

> 以 `LargeListToggleProps`（`interface.ts`）为准。
>
> 说明：组件通过 `onPress` 是否传入来决定是否展示右侧箭头。

| 属性 | 说明 | 类型（TS） | 默认值 | 必填 |
|------|------|-----------|--------|------|
| **title** | 主标题 | `string` | - | 是 |
| **subtitle** | 副标题：字符串或 `SubtitleGroup` 组件 | `string \| React.ReactElement<SubtitleGroupProps>` | - | 否 |
| **checked** | 开关状态 | `boolean` | `false` | 否 |
| **disabled** | 是否禁用（同时会禁用标题点击与开关切换） | `boolean` | `false` | 否 |
| **onPress** | 点击整行事件；传入后会显示右侧箭头 | `() => void` | - | 否 |
| **onChange** | 开关切换回调 | `(val: boolean) => void` | - | 是 |
| **colorType** | 开关打开时颜色类型 | `ColorType` | - | 否 |
| **switchOption** | 传给内部 `Switch` 的额外配置 | `SwitchProps` | - | 否 |
| **leadingIcon** | 左侧图标（SVG ReactElement） | `React.ReactElement<SvgProps>` | - | 否 |
| **accessibilityTitle** | 主标题无障碍配置 | `AccessibilityPropsType` | - | 否 |
| **accessibilitySubtitle** | 副标题无障碍配置 | `AccessibilityPropsType` | - | 否 |

## 使用示例

```tsx
import React, { useState } from 'react';
import { LargeListToggle } from '@hyperOS/IotComponents/IotToggle';
import { SubtitleGroup } from '@hyperOS/components/subtitleGroup';
import { ColorType } from '@hyperOS/styles/Styles';

function DemoBasic() {
  const [v, setV] = useState(false);
  return <LargeListToggle title="主标题" subtitle="副标题描述" checked={v} onChange={setV} />;
}

// 带整行点击（会显示右侧箭头） + 副标题组
function DemoWithArrowAndGroup() {
  const [v, setV] = useState(true);
  return (
    <LargeListToggle
      title="场景控制"
      subtitle={<SubtitleGroup subtitles={['选项1', '选项2']} />}
      checked={v}
      onChange={setV}
      onPress={() => console.log('row pressed')}
      colorType={ColorType.Blue}
    />
  );
}
```