@arco-design/mobile-react 2.24.2 → 2.25.0

package/umd/form/style/css/index.css

@@ -0,0 +1,92 @@
+.arco-form-item {
+  display: -webkit-box;
+  display: -webkit-flex;
+  display: flex;
+  -webkit-box-align: start;
+  -webkit-align-items: flex-start;
+          align-items: flex-start;
+  border-top: 1px solid var(--form-item-border-divider-color);
+}
+.arco-form-item:first-child {
+  border: none;
+}
+.arco-form-label-item {
+  display: -webkit-box;
+  display: -webkit-flex;
+  display: flex;
+  position: relative;
+  -webkit-box-align: center;
+  -webkit-align-items: center;
+          align-items: center;
+  -webkit-box-pack: start;
+  -webkit-justify-content: flex-start;
+          justify-content: flex-start;
+  font-size:  0.32rem ;
+  line-height:  1.08rem ;
+  color:  #1d2129 ;
+  padding-right:  0.32rem ;
+  width:  1.92rem ;
+}
+.arco-form-label-item-required-asterisk {
+  position: absolute;
+  left: -0.6em;
+  top: 0;
+  font-size:  0.32rem ;
+  line-height:  1.08rem ;
+  color:  #f53f3f ;
+}
+.disabled .arco-form-label-item {
+  color:  #c9cdd4 ;
+}
+.arco-form-item-control {
+  padding: 16px 0;
+}
+.arco-form-item-control .arco-input-wrap,
+.arco-form-item-control .arco-input {
+  padding: 0;
+}
+.arco-form-item-control-wrapper {
+  width: 100%;
+  -webkit-box-flex: 1;
+  -webkit-flex: 1;
+          flex: 1;
+  position: relative;
+}
+.arco-form-item-control-wrapper .arco-input-wrap {
+  height:  0.44rem ;
+}
+.arco-form-item-message {
+  font-size: 0.24rem;
+  color:  #f53f3f ;
+  margin-top: -0.1rem;
+  margin-bottom: 16px;
+}
+.arco-form-item-message svg,
+.arco-form-item-message span {
+  vertical-align: middle;
+}
+.arco-form-item-message svg {
+  margin-right: 0.08rem;
+}
+.arco-form-item-error-message {
+  color:  #f53f3f ;
+}
+.arco-form-item-warning-message {
+  color:  #ff7d00 ;
+}
+.arco-form-item.arco-form-item-vertical {
+  display: block;
+}
+.arco-form-item.arco-form-item-vertical .arco-input-wrap {
+  padding-left: 0;
+}
+.arco-form-item.arco-form-item-vertical .arco-form-label-item {
+  width: auto;
+  margin-top: 16px;
+  height:  0.32rem ;
+  line-height:  0.32rem ;
+}
+.arco-form-item.arco-form-item-vertical .arco-form-label-item-required-asterisk {
+  height:  0.32rem ;
+  line-height:  0.32rem ;
+}

package/umd/form/style/css/index.d.ts

@@ -0,0 +1,2 @@
+import '../../../../style/css/public.css';
+import './index.css';

package/umd/form/style/css/index.js

@@ -0,0 +1,15 @@
+(function (global, factory) {
+  if (typeof define === "function" && define.amd) {
+    define(["../../../../style/css/public.css", "./index.css"], factory);
+  } else if (typeof exports !== "undefined") {
+    factory(require("../../../../style/css/public.css"), require("./index.css"));
+  } else {
+    var mod = {
+      exports: {}
+    };
+    factory(global._public, global.index);
+    global.index = mod.exports;
+  }
+})(typeof globalThis !== "undefined" ? globalThis : typeof self !== "undefined" ? self : this, function (_public, _index) {
+  "use strict";
+});

package/umd/form/style/index.d.ts

@@ -0,0 +1,2 @@
+import '../../../style/public.less';
+import './index.less';

package/umd/form/style/index.js

@@ -0,0 +1,15 @@
+(function (global, factory) {
+  if (typeof define === "function" && define.amd) {
+    define(["../../../style/public.less", "./index.less"], factory);
+  } else if (typeof exports !== "undefined") {
+    factory(require("../../../style/public.less"), require("./index.less"));
+  } else {
+    var mod = {
+      exports: {}
+    };
+    factory(global._public, global.index);
+    global.index = mod.exports;
+  }
+})(typeof globalThis !== "undefined" ? globalThis : typeof self !== "undefined" ? self : this, function (_public, _index) {
+  "use strict";
+});

package/umd/form/style/index.less

@@ -0,0 +1,91 @@
+@import '../../../style/mixin.less';
+
+.@{prefix}-form {
+    &-item {
+        display: flex;
+        align-items: flex-start;
+        border-top: 1px solid var(--form-item-border-divider-color);
+        // padding: 16px 0;
+        &:first-child {
+            border: none;
+        }
+
+    }
+
+    &-label-item {
+        display: flex;
+        position: relative;
+        align-items: center;
+        justify-content: flex-start;
+        .use-var(font-size, form-item-label-item-font-size);
+        .use-var(line-height, form-item-label-item-line-height);
+        .use-var(color, form-item-label-item-color);
+        .use-var(padding-right, form-item-label-item-gutter);
+        .use-var(width, form-item-label-item-width);
+
+        &-required-asterisk {
+            position: absolute;
+            left: -0.6em;
+            top: 0;
+
+            .use-var(font-size, form-item-label-item-font-size);
+            .use-var(line-height, form-item-label-item-line-height);
+            .use-var(color, form-item-label-item-required-asterisk-color);
+        }
+        .disabled & {
+            .use-var(color, input-disabled-color);
+        }
+    }
+    &-item-control {
+        padding: 16px 0;
+        .arco-input-wrap, .arco-input {
+            padding: 0;
+        }
+        &-wrapper {
+            width: 100%;
+            flex: 1;
+            position: relative;
+            .arco-input-wrap {
+                .use-var(height, input-text-line-height);
+            }
+        }
+    }
+    &-item-message {
+        .rem(font-size, 12);
+        .use-var(color, form-item-label-item-required-asterisk-color);
+        .rem(margin-top, -5);
+        svg,
+        span {
+            vertical-align: middle;
+        }
+
+        svg {
+            .rem(margin-right, 4);
+        }
+        margin-bottom: 16px;
+    }
+    &-item-error-message {
+        .use-var(color, form-item-error-message-color);
+    }
+
+    &-item-warning-message {
+        .use-var(color, form-item-warning-message-color);
+    }
+
+    &-item.@{prefix}-form-item-vertical {
+        display: block;
+        .arco-input-wrap {
+            padding-left: 0;
+        }
+        .@{prefix}-form-label-item {
+            width: auto;
+            margin-top: 16px;
+            .use-var(height, form-item-label-item-font-size);
+            .use-var( line-height, form-item-label-item-font-size);
+            &-required-asterisk {
+                .use-var(height, form-item-label-item-font-size);
+                .use-var( line-height, form-item-label-item-font-size);
+            }
+        }
+    }
+}

package/umd/form/type.d.ts

@@ -0,0 +1,371 @@
+import { IRules } from '@arco-design/mobile-utils';
+import { ReactNode } from 'react';
+export declare type FieldValue = any;
+export declare type FieldItem = Record<string, any>;
+export declare type ILayout = 'horizontal' | 'vertical' | 'inline';
+export declare enum FormInternalComponentType {
+    Input = "Input",
+    Textarea = "Textarea",
+    Checkbox = "Checkbox",
+    CheckboxGroup = "CheckboxGroup",
+    DatePicker = "DatePicker",
+    Picker = "Picker",
+    Radio = "Radio",
+    RadioGroup = "RadioGroup",
+    Slider = "Slider",
+    Switch = "Switch",
+    ImagePicker = "ImagePicker",
+    Rate = "Rate",
+    Stepper = "Stepper"
+}
+export interface FormProps {
+    /**
+     * 自定义类名
+     * @en Custom classname
+     */
+    className?: string;
+    /**
+     * 自定义样式
+     * @en Custom stylesheet
+     */
+    style?: React.CSSProperties;
+    /**
+     * 表单项布局
+     * @en Form item layout
+     * @default "horizontal"
+     */
+    layout?: 'horizontal' | 'vertical' | 'inline';
+    /**
+     * 表单实例
+     * @en Form instance
+     */
+    form?: IFormInstance;
+    /**
+     * 表单初始数据
+     * @en Form initial value
+     */
+    initialValues?: FieldItem;
+    children: React.ReactNodeArray | ReactNode;
+    /**
+     * 表单项数据变化时的回调
+     * @en Callback when the form item value changes
+     */
+    onValuesChange?: Callbacks['onValuesChange'];
+    /**
+     * 表单项数据变化时的回调
+     * @en Callback when the form is submitted
+     */
+    onSubmit?: Callbacks['onSubmit'];
+    /**
+     * 表单项数据变化时的回调
+     * @en Callback when the form is submitted failed
+     */
+    onSubmitFailed?: Callbacks['onSubmitFailed'];
+    /**
+     * 表单禁止输入
+     * @en disable all form items
+     */
+    disabled?: boolean;
+}
+export interface IFieldError {
+    value?: FieldValue;
+    errors?: ReactNode[];
+    warnings?: ReactNode[];
+    field?: string;
+    dom?: HTMLDivElement | null;
+}
+export interface IFormDataMethods {
+    /**
+     * 设置多个表单项值
+     * @en Set multiple field value
+     */
+    setFieldsValue: (values: FieldItem) => boolean;
+    /**
+     * 设置单个表单项值
+     * @en Set field value
+     */
+    setFieldValue: (name: string, value: FieldValue) => boolean;
+    /**
+     * 获取多个表单项值
+     * @en Get multiple field value
+     */
+    getFieldsValue: (names?: string[]) => FieldItem;
+    /**
+     * 获取单个表单项值
+     * @en Get field value
+     */
+    getFieldValue: (name: string) => FieldValue;
+    /**
+     * 注册表单项
+     * @en Register field
+     */
+    registerField: (name: string, self: ReactNode) => () => void;
+}
+export declare enum ValidateStatus {
+    Init = "init",
+    Error = "error",
+    Warning = "warning",
+    Validating = "validating",
+    Success = "success"
+}
+export interface Callbacks {
+    /**
+     * 表单项数据变化时的回调
+     * @en Callback when the form item value changes
+     */
+    onValuesChange?: (changedValues: FieldValue, values: FieldValue) => void;
+    /**
+     * 表单项数据变化时的回调
+     * @en Callback when the form is submitted
+     */
+    onSubmit?: (values: FieldValue, otherInfo?: IFieldError[]) => void;
+    /**
+     * 表单项数据变化时的回调
+     * @en Callback when the form is submitted failed
+     */
+    onSubmitFailed?: (values: FieldValue, errorInfo: IFieldError[] | Error) => void;
+}
+export interface InternalHooks {
+    /**
+     * 注册表单项
+     * @en Register field
+     */
+    registerField: (name: string, self: ReactNode) => () => void;
+    setInitialValues: (values: FieldItem) => void;
+    setCallbacks: (callbacks: Callbacks) => void;
+}
+export interface IFormInstance {
+    /**
+     * 获取单个表单项值
+     * @en Get field value
+     */
+    getFieldValue: (name: string) => FieldValue;
+    /**
+     * 获取多个表单项值
+     * @en Get multiple field value
+     */
+    getFieldsValue(name?: string[]): FieldItem;
+    /**
+     * 获取单个表单项的错误
+     * @en Get field errors
+     */
+    getFieldError(name: string): ReactNode[];
+    /**
+     * 重置表单项
+     * @en Reset fields
+     */
+    resetFields: () => void;
+    /**
+     * 设置多个表单项值
+     * @en Set multiple field value
+     */
+    setFieldsValue: (value: FieldItem) => void;
+    /**
+     * 校验所有表单项
+     * @en Validate all fields
+     */
+    validateFields: () => Promise<FieldItem>;
+    /**
+     * 提交表单
+     * @en Submit all fields
+     */
+    submit: () => void;
+}
+export declare type InternalFormInstance = Omit<IFormInstance, 'validateFields'> & {
+    /**
+     * 校验所有表单项
+     * @en Validate all fields
+     */
+    validateFields: () => Promise<FieldItem>;
+    /**
+     * 获取内部方法
+     * @en Get internal methods
+     */
+    getInternalHooks: () => InternalHooks;
+};
+export interface FormRef {
+    /**
+     * 最外层元素 DOM
+     * @en The outermost element DOM
+     */
+    dom: HTMLFormElement | null;
+    /**
+     * Form对象实例
+     * @en Form object instance
+     */
+    form: IFormInstance;
+}
+export interface IFormItemContext {
+    /**
+     * Form对象实例
+     * @en Form object instance
+     */
+    form: InternalFormInstance;
+    /**
+     * 表单布局方式
+     * @en Form layout
+     */
+    layout: 'horizontal' | 'vertical' | 'inline';
+    /**
+     * 表单是否禁用
+     * @en Whether form is disabled
+     */
+    disabled?: boolean;
+    /**
+     * 表单校验项定义
+     * @en Validating message of form
+     */
+    validateMessages?: Record<string, unknown>;
+}
+export declare type IShouldUpdateFunc = (data: {
+    preStore: FieldItem;
+    curStore: FieldItem;
+}) => boolean;
+export interface FormItemProps {
+    /**
+     * 表单项名
+     * @en The form item name
+     */
+    label: ReactNode;
+    /**
+     * 表单项Stylesheet
+     * @en The form item stylesheet
+     */
+    style?: React.CSSProperties;
+    /**
+     * 表单项样式
+     * @en The form item class name
+     */
+    className?: string;
+    /**
+     * 表单项字段
+     * @en Form item field
+     */
+    field: string;
+    /**
+     * 表单项是否必填
+     * @en Whether Form item is required
+     */
+    required?: boolean;
+    /**
+     * 表单项是否禁用
+     * @en Whether Form item is disabled
+     */
+    disabled?: boolean;
+    /**
+     * 表单项布局
+     * @en Form item layout
+     * @default "horizontal"
+     */
+    layout?: 'horizontal' | 'vertical' | 'inline';
+    /**
+     * 表单项子节点
+     * @en Form item children
+     */
+    children: JSX.Element;
+    /**
+     * 表单项是否刷新
+     * @en Form item is updated
+     */
+    shouldUpdate?: boolean | IShouldUpdateFunc;
+    /**
+     * 表单项规则
+     * @en Form item rules
+     */
+    rules?: IRules[];
+    /**
+     * 表单项下方节点
+     * @en Form item extra node
+     */
+    extra?: JSX.Element;
+    /**
+     * 触发事件更新事件名称
+     * @en The function name when updating data
+     * @default "onChange"
+     */
+    trigger?: string;
+    /**
+     * 自定义必填标识
+     * @en The required icon node
+     */
+    requiredIcon?: ReactNode;
+    /**
+     * 表单项初始数据
+     * @en The initial value of form item
+     */
+    initialValue?: FieldValue;
+    /**
+     * 手动指定为内置组件的类型
+     * @en Manually specified as the type of internal component
+     */
+    displayType?: FormInternalComponentType;
+}
+export interface FormItemRef {
+    /**
+     * 最外层元素 DOM
+     * @en The outermost element DOM
+     */
+    dom: HTMLDivElement | null;
+}
+export interface IFormItemInnerProps {
+    /**
+     * 表单项字段
+     * @en Form item field
+     */
+    field: string;
+    /**
+     * 表单项子节点
+     * @en Form item children
+     */
+    children: JSX.Element;
+    /**
+     * 表单项是否刷新
+     * @en Form item is updated
+     */
+    shouldUpdate?: boolean | IShouldUpdateFunc;
+    /**
+     * 表单项下方节点
+     * @en Form item extra node
+     */
+    rules?: IRules[];
+    /**
+     * 触发事件更新事件名称
+     * @en The function name when updating data
+     * @default "onChange"
+     */
+    trigger?: string;
+    /**
+     * 校验状态变化回调
+     * @en The callback when validating status changes
+     */
+    onValidateStatusChange: (data: {
+        errors: any;
+        warnings: any;
+    }) => void;
+    /**
+     * 获取内部表单项的dom
+     * @en The dom of inner form item
+     */
+    getFormItemRef: () => HTMLDivElement | null;
+    /**
+     * 自定义表单项存储值的字段名
+     * @en The field name for custom form item
+     * @default "value"
+     */
+    triggerPropsField?: string;
+    /**
+     * 表单项是否禁用
+     * @en Whether Form item is disabled
+     */
+    disabled?: boolean;
+    /**
+     * 表单项初始数据
+     * @en The initial value of form item
+     */
+    initialValue?: FieldValue;
+    /**
+     * 手动指定为内置组件的类型
+     * @en Manually specified as the type of internal component
+     */
+    displayType?: FormInternalComponentType;
+}

package/umd/form/type.js

@@ -0,0 +1,44 @@
+(function (global, factory) {
+  if (typeof define === "function" && define.amd) {
+    define(["exports"], factory);
+  } else if (typeof exports !== "undefined") {
+    factory(exports);
+  } else {
+    var mod = {
+      exports: {}
+    };
+    factory(mod.exports);
+    global.type = mod.exports;
+  }
+})(typeof globalThis !== "undefined" ? globalThis : typeof self !== "undefined" ? self : this, function (_exports) {
+  "use strict";
+
+  _exports.__esModule = true;
+  _exports.ValidateStatus = _exports.FormInternalComponentType = void 0;
+  var FormInternalComponentType;
+  _exports.FormInternalComponentType = FormInternalComponentType;
+  (function (FormInternalComponentType) {
+    FormInternalComponentType["Input"] = "Input";
+    FormInternalComponentType["Textarea"] = "Textarea";
+    FormInternalComponentType["Checkbox"] = "Checkbox";
+    FormInternalComponentType["CheckboxGroup"] = "CheckboxGroup";
+    FormInternalComponentType["DatePicker"] = "DatePicker";
+    FormInternalComponentType["Picker"] = "Picker";
+    FormInternalComponentType["Radio"] = "Radio";
+    FormInternalComponentType["RadioGroup"] = "RadioGroup";
+    FormInternalComponentType["Slider"] = "Slider";
+    FormInternalComponentType["Switch"] = "Switch";
+    FormInternalComponentType["ImagePicker"] = "ImagePicker";
+    FormInternalComponentType["Rate"] = "Rate";
+    FormInternalComponentType["Stepper"] = "Stepper";
+  })(FormInternalComponentType || (_exports.FormInternalComponentType = FormInternalComponentType = {}));
+  var ValidateStatus;
+  _exports.ValidateStatus = ValidateStatus;
+  (function (ValidateStatus) {
+    ValidateStatus["Init"] = "init";
+    ValidateStatus["Error"] = "error";
+    ValidateStatus["Warning"] = "warning";
+    ValidateStatus["Validating"] = "validating";
+    ValidateStatus["Success"] = "success";
+  })(ValidateStatus || (_exports.ValidateStatus = ValidateStatus = {}));
+});

package/umd/form/useForm.d.ts

@@ -0,0 +1,18 @@
+import { IFormInstance } from './type';
+export declare const defaultFormDataMethods: {
+    getFieldValue: (name: any) => any;
+    getFieldsValue: (_names: any) => {};
+    getFieldError: (_name: any) => never[];
+    setFieldValue: (_name: any, _value: any) => boolean;
+    setFieldsValue: (_values: any) => boolean;
+    registerField: (_name: any, _self: any) => () => void;
+    resetFields: any;
+    validateFields: any;
+    submit: any;
+    getInternalHooks: () => {
+        registerField: any;
+        setInitialValues: any;
+        setCallbacks: any;
+    };
+};
+export default function useForm(form?: IFormInstance): IFormInstance[];