1 В избранное 0 Ответвления 0

OSCHINA-MIRROR/open-hand-choerodon-ui

Присоединиться к Gitlife
Откройте для себя и примите участие в публичных проектах с открытым исходным кодом с участием более 10 миллионов разработчиков. Приватные репозитории также полностью бесплатны :)
Присоединиться бесплатно
Клонировать/Скачать
index.en-US.md 6.3 КБ
Копировать Редактировать Web IDE Исходные данные Просмотреть построчно История
heqiwei Отправлено 2 лет назад d284f13
category cols subtitle type title
Pro Components
1
表单
Data Entry
Form

表单。

何时使用

API

Form

参数 说明 类型 默认值
action 表单提交请求地址,当设置了 dataSet 时,该属性无作用 string
method 表单提交的 HTTP Method, 可选值 GET POST string POST
target 表单提交的目标,当表单设置了设置 target 且没有 dataSet 时作浏览器默认提交,否则作 Ajax 提交 string
layout 布局, 可选值: table none string table
processParams Ajax 提交时的参数回调 (event) => object
useColon 是否使用冒号当开启时会在所有的label后面加上冒号, 在没有label时不显示。 boolean false
requiredMarkAlign 控制必输星号位置 left | right left
labelWidth 内部控件的标签宽度。如果为数组则分别对应每列的标签宽度。数组长度不够列数,以默认值补全, 响应式参考[Responsive](#Form Responsive), 如果为auto,则根据内部label最大长度来对齐所有label number| 'auto' | ('auto' | number)[] | object 100
labelAlign 标签文字对齐方式, 只在 labelLayout 为horizontal时起作用,可选值: left center right, 响应式参考[Responsive](#Form Responsive) string | object right
labelLayout 标签位置, 可选值 horizontal vertical placeholder float none, 响应式参考[Responsive](#Form Responsive) string | object horizontal
labelTooltip 用 Tooltip 显示标签内容。可选值 none always overflow string 'none'
dataIndex 对照 record 在 DataSet 中的 index number ds.currentIndex
record 对照 record, 优先级高于 dataSet 和 dataIndex Record
columns 列数, 响应式参考[Responsive](#Form Responsive) number | object 1
pristine 显示原始值 boolean false
onSubmit 提交回调 Function
onReset 重置回调 Function
onSuccess 提交成功回调 Function
onError 提交失败回调 Function
separateSpacing 切分单元格间隔,当label布局为默认值 horizontal 时候使用 padding 修改单元格横向间距可能需要结合labelwidth效果会更好 number | [number, number ] | {width:number,height:number} -
spacingType 间隔类型, 可选值 between aroung evenly SpacingType | [SpacingType, SpacingType] | {width:SpacingType,height:SpacingType} 'between'
fieldHighlightRenderer 高亮渲染器 ({ title, content, dataSet, record, name, className, style }, element) => ReactNode
showValidation 校验信息提示方式 tooltip | newLine
autoValidationLocate 校验失败自动定位。如果多个组件的定位有冲突, 可以关闭自动定位, 通过手动调用 focus 方法来定位 boolean true

更多属性请参考 DataSetComponent

Form Layout

Form 子元素属性

参数 说明 类型 默认值
rowSpan 表单下控件跨越的行数 number 1
colSpan 表单下控件跨越的列数 number 1
newLine 另起新行 boolean
label 标签 string | ReactNode
name 字段名。可获取 DataSet 的字段属性,如 label,require 等,一般用于控件外需要嵌套其他元素时使用。 string
labelWidth 标签宽度。同列控件中标签宽度取最大设定值。子元素的 labelWidth 无法响应式。 number
useColon 是否使用冒号,当开启时会在所有的label后面加上冒号, 在没有label时不显示。未设置时沿用Form的useColon属性 boolean
requiredMarkAlign 控制必输星号位置 left | right left
hidden 是否隐藏字段(依然会校验字段) boolean

Form.Item

参数 说明 类型 默认值
label 标签 string | ReactNode
name 字段名。可获取 DataSet 的字段属性,如 label,require 等,一般用于控件外需要嵌套其他元素时使用。 string
labelWidth 标签宽度。同列控件中标签宽度取最大设定值。子元素的 labelWidth 无法响应式。 number
useColon 是否使用冒号,当开启时会在所有的label后面加上冒号, 在没有label时不显示。未设置时沿用Form的useColon属性 boolean
requiredMarkAlign 控制必输星号位置 left | right left
hidden 是否隐藏字段(依然会校验字段) boolean

Form.FormVirtualGroup

当需要对Form的一些表单控件进行分组控制的时候可以使用,例如统一控制某些表单控件的显隐,此外,使用FormVirtualGroup可以统一对表单控件进行属性注入,例如统一的className等.注意,FormVirtualGroup组件本身不会产生实际的dom结果,其结果与去掉FormVirtualGroup然后将显隐控制等逐一写入表单控件中的写法完全一致,

Form.ItemGroup

参数 说明 类型 默认值
className 自定义类名 string
style 自定义样式 React.CSSProperties
label 标签 string | ReactNode
labelWidth 标签宽度。同列控件中标签宽度取最大设定值。 number
labelTooltip 用 Tooltip 显示标签内容。可选值 none | always | overflow string
help 帮助信息(显示在label旁) ReactNode
required 是否显示必填样式 boolean
useColon 是否使用冒号,当开启时会在所有的label后面加上冒号, 在没有label时不显示。未设置时沿用Form的useColon属性 boolean
requiredMarkAlign 控制必输星号位置 left | right left
compact 是否用紧凑模式 boolean
hidden 是否隐藏字段(依然会校验字段) boolean
rowSpan 表单下控件跨越的行数 number 1
colSpan 表单下控件跨越的列数 number 1
newLine 另起新行 boolean

Form Responsive

响应式可设置参数columns labelWidth labelAlign labelLayout 为一个键值对。

键值可参考 Responsive BreakPoints

Опубликовать ( 0 )

Вы можете оставить комментарий после Вход в систему

1
https://gitlife.ru/oschina-mirror/open-hand-choerodon-ui.git
git@gitlife.ru:oschina-mirror/open-hand-choerodon-ui.git
oschina-mirror
open-hand-choerodon-ui
open-hand-choerodon-ui
master