# form-item-text LLMs.txt

> 供 LLM 快速理解 `@flatbiz/antd/form-item-text` 的使用方式。

## 模块定位

FormItem 文本显示，默认不换行，超出省略（鼠标悬浮可显示）

## 导入方式

```ts
import { FormItemText } from '@flatbiz/antd/form-item-text';
// 也可以从主入口导入：import { ... } from '@flatbiz/antd';
```

## 公开导出

- `FormItemTextContent`
- `FormItemText` - FormItem 文本显示，默认不换行，超出省略（鼠标悬浮可显示）
- `* from ./form-item-text.jsx`
- `RequestText` - FormItem 文本显示，默认不换行，超出省略（鼠标悬浮可显示）
- `FormItemTextServiceConfig`
- `FormItemTextProps`
- `useRequestFormItemText`

## 依赖的 antd 能力

`Form`、`Spin`、`Tooltip`

## Props / 配置要点

### FormItemTextServiceConfig

- `onRequest`（可选）：: (params?: TAny) => Promise<TAny>
- `params`（可选）：: TPlainObject；接口参数，当params发生变化后，会主动发送查询请求
- `invalidParamKey`（可选）：: string[]；标记serviceConfig.params中无效参数，被设置的params key 不传入服务接口入参
- `onResponseAdapter`（可选）：: (respData?: TAny, value?: TAny) => TAny；如果没有配置 render，返回结果会直接进行dom渲染，如果非string类型会进行JSON.stringify处理
- `requiredParamsKeys`（可选）：: string[]；必须参数key列表，与params配合使用

### FormItemTextProps

- `wrap`（可选）：: boolean；是否换行，默认不换行，超出省略（鼠标悬浮可显示）
- `render`（可选）：: (value?: TAny) => ReactNode；自定义数据显示
- `placeholderValue`（可选）：: string；占位值，当 value 为 ''、undefined、null时显示
- `serviceConfig`（可选）：: FormItemTextServiceConfig；发起服务调用显示数据，例如：数据为key，通过key查询text显示

## 使用规则与行为

- FormItem 文本显示，默认不换行，超出省略（鼠标悬浮可显示）
- FormItem 文本显示，默认不换行，超出省略（鼠标悬浮可显示） @param props @returns
- 接口参数，当params发生变化后，会主动发送查询请求
- 标记serviceConfig.params中无效参数，被设置的params key 不传入服务接口入参
- 如果没有配置 render，返回结果会直接进行dom渲染，如果非string类型会进行JSON.stringify处理
- 必须参数key列表，与params配合使用
- 是否换行，默认不换行，超出省略（鼠标悬浮可显示）
- 自定义数据显示
- 占位值，当 value 为 ''、undefined、null时显示
- 发起服务调用显示数据，例如：数据为key，通过key查询text显示

## 基础示例

```tsx
import { FormItemText, type FormItemTextProps } from '@flatbiz/antd/form-item-text';

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

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

## 源码索引

- `src/form-item-text/content.tsx`
- `src/form-item-text/form-item-text.tsx`
- `src/form-item-text/index.ts`
- `src/form-item-text/request-text.tsx`
- `src/form-item-text/types.ts`
- `src/form-item-text/use-request.tsx`

## 给 LLM 的注意事项

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