# ace-editor-xml LLMs.txt

> 供 LLM 快速理解 `@flatbiz/antd/ace-editor-xml` 的使用方式。

## 模块定位

xml编辑器

## 导入方式

```ts
import { AceEditorXml } from '@flatbiz/antd/ace-editor-xml';
// 也可以从主入口导入：import { ... } from '@flatbiz/antd';
```

## 公开导出

- `AceEditorXml` - xml编辑器
- `AceEditorXmlProps`
- `* from ./editor.jsx`
- `validateXML` - 验证xml格式的正确性

## 依赖的 antd 能力

`Space`

## Props / 配置要点

### AceEditorXmlProps

- `height`（可选）：: string；编辑器高度，默认值：100%，可输入值例如 300px、100%
- `value`（可选）：: string | TPlainObject | TPlainObject[]
- `onChange`（可选）：: (value?: string | TPlainObject | TPlainObject[]) => void
- `autoCompleterList`（可选）：: { name: string; desc?: string }[]；配置输入自动提示关键字
- `hiddenVerifyBtn`（可选）：: boolean；隐藏【验证数据】按钮
- `hiddenErrorMsg`（可选）：: boolean；是否隐藏内部验证异常文案
- `hiddenFormatterBtn`（可选）：: boolean；隐藏【美化】按钮
- `theme`（可选）：: string；编辑器主题配置，例如：github、terminal、xcode
- `footerExtraRender`（可选）：: (children: ReactElement) => ReactElement；底部额外布局
- `footerStyle`（可选）：: CSSProperties

## 使用规则与行为

- 编辑器高度，默认值：100%，可输入值例如 300px、100%
- 配置输入自动提示关键字
- 隐藏【验证数据】按钮
- 是否隐藏内部验证异常文案
- 隐藏【美化】按钮
- 编辑器主题配置，例如：github、terminal、xcode
- 底部额外布局
- xml编辑器
- 向编辑器中添加自动补全列表
- 验证xml格式的正确性

## 默认值线索

- `height => '100%'`

## 基础示例

```tsx
import { AceEditorXml, type AceEditorXmlProps } from '@flatbiz/antd/ace-editor-xml';

const props: AceEditorXmlProps = {
  // 按业务传入必要参数
};

<AceEditorXml {...props} />;
```

## 源码索引

- `src/ace-editor-xml/editor.tsx`
- `src/ace-editor-xml/index.ts`
- `src/ace-editor-xml/validate-xml.ts`

## 给 LLM 的注意事项

- 优先使用 `@flatbiz/antd/ace-editor-xml` 或主入口 `@flatbiz/antd` 的公开导出，不要引用内部实现文件。
- 当 Props 与 antd 原组件同名能力冲突时，以本模块导出的 Props 类型为准。
- 若文档未覆盖某个边缘参数，请读取上方源码索引中的类型定义和 JSDoc。