选择
一个"选择"(Select)旨在通过从预定义的选择列表中提供一个选择来收集用户的输入,允许单项选择和多项选择.
图片参考
选择使用
import { Select } from '@dt-dds/react-select';
const items = [
{ value: 'value1', label: 'Value 1' },
{ value: 'value2', label: 'Value 2' },
{ value: 'value3', label: 'Value 3', disabled: true },
];
export const App = () => {
const [value, setValue] = useState < string > '';
return (
<Select
label='Choose a value'
helperText='you need to make a selection'
isMulti={false}
value={value}
onChange={setValue}
variant='outlined'
fill='default'
>
{items.map((item, index) => (
<Select.Option
key={item.value}
index={index}
value={item.value}
disabled={item.disabled}
>
{item.label}
</Select.Option>
))}
</Select>
);
};
选择
| 财产 | 类型 | 默认 | 说明 |
|---|---|---|---|
label | string | —— 说 | 一个帮助用户理解所选字段范围的标签. |
placeholder | string | —— 说 | 用于帮助用户理解所选字段范围的占位符. |
value | string | string[] | 受控值. 用于单选的字符串;用于多选取的字符串数组. |
onChange | (value: string) => void | (value: string[]) => void | 选择更改时调用( 字符串为单模式; 数组为多模式) . |
isMulti | boolean | false | 在单选和多选之间切换. |
helperText | ReactNode | - 说吧 | 字段下方显示的帮助文本; 链接通过 aria-describedby。 。 。 . |
hasError | boolean | false | 错误状态( 应用) aria-invalid 和错误样式. |
isDisabled | boolean | false | 禁用用户交互 . |
isRequired | boolean | —— 说 | 按需要标记字段. |
isFloatingLabel | boolean | true | 控制“浮动标签”行为. |
scale | LabelFieldProps['scale'] | 'standard' | 标签/字段的可视尺度/大小. |
labelIcon | ReactNode | —— 说 | 标签旁边的可选图标 . |
variant | SelectVariant | 'outlined' | 边线/线域变种. |
fill | SelectFill | 'default' | 背景填充字段样式 . |
style | React.CSSProperties | —— 说 | 适用于“选择包装”的内置样式. |
dataTestId | string | 'select' | 适用于组件容器的测试标识符. |
children | ReactNode | —— 说 | 通常列出 Select.Option。 。 。 . |
...rest | HTMLAttributes | —— 说 | 标准 HTML 属性. |
选择 选项
| 财产 | 类型 | 默认 | 说明 |
|---|---|---|---|
children | ReactNode | —— 说 | 选项的可见内容(向用户显示的标签). |
value | string | —— 说 | 选项值. |
valueLabel | ReactNode | —— 说 | 这是输入上的自定义选项标签 . |
index | number | —— 说 | 列表中的选项索引(由Downshit内部使用). |
isDisabled | boolean | false | 禁用选项. |
style | React.CSSProperties | —— 说 | 选项的内置样式. |
dataTestId | string | —— 说 | 测试选项的标识符 . |
堆栈
- 类型脚本 用于静态类型检查
- 反应 — JavaScript 用户界面库
- 情感 用于使用 JavaScript 写入 Css 样式
- 故事书 ——由Vite供电的UI组件环境
- 欢乐 - JavaScript 测试框架
- 反应测试库 - 以用户为中心测试用户界面组件
- ESLint 语录 代码林入
- 高级 用于代码格式
- 苏普 - 由Esbuild供电的脚本捆绑机
- 雅伦 从管理软件包
- 下调 管理无障碍
图标
yarn build- 制作软件包yarn dev- 在当地运行软件包yarn lint- 将所有文件输入此软件包yarn test- 测试所有单位yarn test:report- 打开测试覆盖报告yarn test:update:snapshot- 进行所有单元测试并更新快照
汇编
运行 yarn build 从软件包的根部 齐声 将原始的 TypeScript 和 React 代码编译为普通 JavaScript .
这个 /dist 文件夹包含编译输出.
select
└── dist
├── index.d.ts <-- Types
├── index.js <-- CommonJS version
└── index.mjs <-- ES Modules version
...
版本
跟着 语义版本
许可证
许可证根据 MIT 许可证