shineout 3.7.8 → 3.7.9-beta.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -2,11 +2,15 @@ import { FormFieldProps as UiFormFieldProps, FormFieldSetProps as UiFormFieldSet
2
2
  /**
3
3
  * @title FormRef
4
4
  * @sort 6
5
+ * @en Form reference object that provides a series of methods to operate the form. After obtaining the instance through ref or useForm, you can actively control the form's validation, submission, reset and other behaviors
6
+ * @cn 表单引用对象,提供了一系列操作表单的方法。通过 ref 或 useForm 获取实例后,可以主动控制表单的校验、提交、重置等行为
5
7
  */
6
8
  export type FormRef<T> = UiFormRef<T>;
7
9
  /**
8
10
  * @title FormDatum
9
11
  * @sort 7
12
+ * @en Form data management object, used to manage the internal data state and validation logic of the form
13
+ * @cn 表单数据管理对象,用于管理表单内部的数据状态和校验逻辑
10
14
  */
11
15
  export type FormDatum = UiFormDatum;
12
16
  /**
@@ -15,34 +19,42 @@ export type FormDatum = UiFormDatum;
15
19
  */
16
20
  export interface FormProps<T extends ObjectType> extends Omit<UiFormProps<T>, 'jssStyle'> {
17
21
  /**
18
- * @en Form value
19
- * @cn 表单数据
22
+ * @en When set, the form becomes a controlled component and needs to be used with onChange. Suitable for scenarios where external management of form state is required, such as sharing form data across components, real-time synchronization of form data to state managers, etc.
23
+ * @cn 设置后表单变为受控组件,需要配合 onChange 使用。适用于需要外部管理表单状态的场景,如跨组件共享表单数据、实时同步表单数据到状态管理器等
20
24
  * @override object
21
25
  */
22
26
  value?: T;
23
27
  /**
24
- * @en callback function, executed when the value is changing
25
- * @cn 表单内组件值变化函数
28
+ * @en Must be set in controlled mode to update external state. Triggered whenever any field value in the form changes, with the parameter being the latest data of the entire form
29
+ * @cn 在受控模式下必须设置此函数来更新外部状态。每当表单内任意字段值改变时都会触发,参数为整个表单的最新数据
26
30
  */
27
31
  onChange?: (value: T) => void;
28
32
  }
29
33
  /**
30
34
  * @title Form.Item
31
35
  * @sort 2
36
+ * @en Form item component, used to wrap form controls and provide label, error tips and other functions. Each form control should be wrapped with Form.Item to properly display labels and validation information
37
+ * @cn 表单项组件,用于包装表单控件并提供标签、错误提示等功能。每个表单控件都应该被 Form.Item 包裹,以便正确显示标签和校验信息
32
38
  */
33
39
  export type FormItemProps = Omit<UiFormItemProps, 'jssStyle'>;
34
40
  /**
35
41
  * @title Form.Field
36
42
  * @sort 3
43
+ * @en Form field component for creating custom form controls. Provides form data binding, validation and other functions, suitable for encapsulating complex custom form components
44
+ * @cn 表单字段组件,用于创建自定义的表单控件。提供了表单数据绑定、校验等功能,适用于封装复杂的自定义表单组件
37
45
  */
38
46
  export type FormFieldProps<T> = UiFormFieldProps<T>;
39
47
  /**
40
48
  * @title Form.FieldSet
41
49
  * @sort 4
50
+ * @en Form field set component for managing a group of related form fields. Suitable for handling object or array type form data, such as dynamic form lists, nested objects and other complex scenarios
51
+ * @cn 表单字段集组件,用于管理一组相关的表单字段。适用于处理对象或数组类型的表单数据,如动态表单列表、嵌套对象等复杂场景
42
52
  */
43
53
  export type FormFieldSetProps<T> = UiFormFieldSetProps<T>;
44
54
  /**
45
55
  * @title Form.Flow
46
56
  * @sort 5
57
+ * @en Form flow component for listening to form data changes and executing corresponding side effects. Suitable for implementing form linkage, conditional rendering and other scenarios
58
+ * @cn 表单流程组件,用于监听表单数据变化并执行相应的副作用。适用于实现表单联动、条件渲染等场景
47
59
  */
48
60
  export type FormFlowProps = UiFormFlowProps;
package/cjs/index.js CHANGED
@@ -522,5 +522,5 @@ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { de
522
522
  // 此文件由脚本自动生成,请勿直接修改。
523
523
  // This file was generated automatically by a script. Please do not modify it directly.
524
524
  var _default = exports.default = {
525
- version: '3.7.8'
525
+ version: '3.7.9-beta.2'
526
526
  };
package/dist/shineout.js CHANGED
@@ -12234,7 +12234,7 @@ var handleStyle = function handleStyle(style) {
12234
12234
  };
12235
12235
  /* harmony default export */ var jss_style_handleStyle = (handleStyle);
12236
12236
  ;// CONCATENATED MODULE: ../shineout-style/src/version.ts
12237
- /* harmony default export */ var version = ('3.7.8');
12237
+ /* harmony default export */ var version = ('3.7.9-beta.2');
12238
12238
  ;// CONCATENATED MODULE: ../shineout-style/src/jss-style/index.tsx
12239
12239
 
12240
12240
 
@@ -27671,7 +27671,6 @@ var textarea_input = objectSpread2_default()(objectSpread2_default()(objectSprea
27671
27671
  color: src.textareaPlaceholderColor
27672
27672
  },
27673
27673
  width: '100%',
27674
- height: '100%',
27675
27674
  background: 'transparent',
27676
27675
  border: '0',
27677
27676
  margin: '0',
@@ -27688,6 +27687,9 @@ var textarea_input = objectSpread2_default()(objectSpread2_default()(objectSprea
27688
27687
  scrollbarColor: "".concat(src.inputBorderColor, " transparent"),
27689
27688
  '&$resize': {
27690
27689
  resize: 'vertical'
27690
+ },
27691
+ '&:not($shadow)': {
27692
+ minHeight: '-webkit-fill-available'
27691
27693
  }
27692
27694
  },
27693
27695
  resize: {
@@ -64723,8 +64725,12 @@ var tfoot_isArray = isArray,
64723
64725
  }, index);
64724
64726
  };
64725
64727
  var getTrs = function getTrs() {
64726
- var _props$summary = props.summary,
64727
- summary = _props$summary === void 0 ? [] : _props$summary;
64728
+ var _props$summary, _props$data;
64729
+ if (props !== null && props !== void 0 && (_props$summary = props.summary) !== null && _props$summary !== void 0 && _props$summary.length && (props === null || props === void 0 || (_props$data = props.data) === null || _props$data === void 0 ? void 0 : _props$data.length) === 0) {
64730
+ return [];
64731
+ }
64732
+ var _props$summary2 = props.summary,
64733
+ summary = _props$summary2 === void 0 ? [] : _props$summary2;
64728
64734
  if (!tfoot_isArray(summary[0])) {
64729
64735
  summary = [summary];
64730
64736
  }
@@ -65173,7 +65179,8 @@ var emptyRef = {
65173
65179
  summary: props.summary,
65174
65180
  columns: columns,
65175
65181
  jssStyle: props.jssStyle,
65176
- colgroup: colgroup
65182
+ colgroup: colgroup,
65183
+ data: props.data
65177
65184
  };
65178
65185
  var StickyWrapper = props.sticky ? src_sticky_sticky : (external_root_React_commonjs2_react_commonjs_react_amd_react_default()).Fragment;
65179
65186
  var sticky = typeof_default()(props.sticky) === 'object' ? props.sticky : {
@@ -71881,7 +71888,7 @@ var upload_interface = __webpack_require__(8821);
71881
71888
 
71882
71889
 
71883
71890
  /* harmony default export */ var src_0 = ({
71884
- version: '3.7.8'
71891
+ version: '3.7.9-beta.2'
71885
71892
  });
71886
71893
  }();
71887
71894
  /******/ return __webpack_exports__;