@arco-design/mobile-react 2.31.5 → 2.32.0

package/esnext/keyboard/style/index.less

@@ -0,0 +1,131 @@
+@import '../../../style/mixin.less';
+
+.@{prefix}-keyboard {
+    .use-var(background, keyboard-background);
+    .use-var(padding, keyboard-content-padding);
+    .noselect();
+
+    &-wrapper {
+        display: flex;
+    }
+
+    &-key-wrapper {
+        flex: 2 0 auto;
+    }
+
+    &-row {
+        display: flex;
+        &:not(&:nth-last-child(1)) {
+            .use-var(margin-bottom, keyboard-unified-margin);
+        }
+
+        .@{prefix}-keyboard-key {
+            &:not(&:nth-child(1)) {
+                .use-var(margin-left, keyboard-unified-margin);
+            }
+
+            &-special {
+                flex: 2.1 0 auto;
+            }
+        }
+    }
+
+    &-col {
+        flex: 1;
+        display: flex;
+        flex-direction: column;
+        .use-var(margin-left, keyboard-unified-margin);
+
+        .@{prefix}-keyboard-key {
+            &:not(&:nth-child(1)) {
+                .use-var(margin-top, keyboard-unified-margin);
+            }
+
+            &-confirm {
+                flex: 2.5 0 auto;
+                .use-var(background, keyboard-confirm-key-background);
+                .use-var(color, keyboard-confirm-key-color);
+                .use-var(font-size, keyboard-confirm-key-font-size);
+            }
+        }
+    }
+
+    &-key {
+        display: flex;
+        align-items: center;
+        justify-content: center;
+        flex: 1;
+
+        .use-var(font-weight, keyboard-key-font-weight);
+        .use-var(font-size, keyboard-key-font-size);
+        .use-var(line-height, keyboard-key-line-height);
+        .use-var(background, keyboard-key-background);
+        .use-var(border-radius, keyboard-key-border-radius);
+        .use-var(height, keyboard-key-height);
+        .use-var(border-radius, keyboard-key-border-radius);
+        .use-var(color, keyboard-key-color);
+
+        &:active {
+            .use-var(background, keyboard-key-active-background);
+        }
+
+        .@{prefix}-icon {
+            .use-var(font-size, keyboard-key-icon-size);
+        }
+    }
+
+    &-popup {
+      display: none;
+    }
+}
+
+/***************************************************
+ *                                                 *
+ *               Arco Theme Style                  *
+ *                                                 *
+ ***************************************************/
+& when (@use-dark-mode = 1) {
+    
+  .process-bg-color-with-config,
+  .process-custom-icon-bg-color-with-config {
+    @{arco-dark-mode-selector} & {
+      .use-var(color, dark-steps-process-with-config-item-icon-color);
+      .use-var(color, dark-steps-process-with-config-item-icon-color);
+    }
+  }
+  .wait-custom-icon-bg-color-with-config {
+    @{arco-dark-mode-selector} & {
+      .use-var(background, dark-steps-wait-icon-num-background);
+      .use-var(color, dark-sub-info-font-color);
+      .use-var(background, dark-steps-wait-icon-num-background);
+      .use-var(color, dark-sub-info-font-color);
+    }
+  }
+  .@{prefix}-keyboard {
+    @{arco-dark-mode-selector} & {
+      .use-var(background, dark-keyboard-background);
+    }
+    &-col {
+      .@{prefix}-keyboard-key {
+        &-confirm {
+          @{arco-dark-mode-selector} & {
+            .use-var(background, dark-keyboard-confirm-key-background);
+            .use-var(color, dark-keyboard-confirm-key-color);
+          }
+        }
+      }
+    }
+    &-key {
+      @{arco-dark-mode-selector} & {
+        .use-var(background, dark-keyboard-key-background);
+        .use-var(color, dark-keyboard-key-color);
+      }
+      &:active {
+        @{arco-dark-mode-selector} & {
+          .use-var(background, dark-keyboard-key-active-background);
+        }
+      }
+    }
+  }
+}
+/********************* End *************************/

package/esnext/keyboard/type.d.ts

@@ -0,0 +1,102 @@
+import { CSSProperties, ReactNode } from 'react';
+import { PopupProps, PopupRef } from '../popup';
+export declare type ColumnData = string | number | ColumnObjData;
+export declare type ColumnObjData = {
+    type: 'keyboard' | 'delete';
+} | {
+    type: 'content';
+    content: ReactNode;
+    value: string | number;
+};
+export interface KeyboardProps extends PopupProps {
+    /**
+     * 常规键位自定义类名
+     * @en Custom classname for normal keys
+     */
+    normalKeyClass?: string;
+    /**
+     * 常规键位自定义样式
+     * @en Custom style for normal keys
+     */
+    normalKeyStyle?: CSSProperties;
+    /**
+     * 自定义类名
+     * @en Custom classname
+     */
+    className?: string;
+    /**
+     * 自定义样式
+     * @en Custom stylesheet
+     */
+    style?: React.CSSProperties;
+    /**
+     * 键盘展示类型，不同类型有不同布局。number - 纯数字常规键盘，confirm - 带确认按钮的键盘，tool - 带运算符的键盘
+     * @en Keyboard display type, different types have different layouts. number - a regular keyboard with pure numbers, confirm - a keyboard with a confirm button, tool - a keyboard with operators
+     * @default "number"
+     */
+    type?: 'number' | 'confirm' | 'tool';
+    /**
+     * 是否打乱键盘中的数字展示位置
+     * @en Whether to scramble number placements in the keyboard
+     * @default false
+     */
+    randomOrder: boolean;
+    /**
+     * 键盘顶部展示标题内容，样式纯自定义
+     * @en The title content displayed on the top of the keyboard, the style is purely customized
+     */
+    title?: ReactNode;
+    /**
+     * 自定义渲染数字右侧（第四列）的内容
+     * @en Custom rendering of the content to the right of the number (fourth column)
+     */
+    rightColumns?: ReactNode;
+    /**
+     * 点击确认后是否自动关闭键盘
+     * @en Whether to automatically close the keyboard after clicking confirm button
+     * @default false
+     */
+    confirmClosable?: boolean;
+    /**
+     * 自定义渲染确认按钮内部内容
+     * @en Customize the internal content of the confirm button
+     */
+    confirmButton?: ReactNode;
+    /**
+     * 自定义渲染删除按钮内部内容
+     * @en Customize the internal content of the delete button
+     */
+    deleteButton?: ReactNode;
+    /**
+     * 自定义渲染收起键盘按钮内部内容
+     * @en Customize the internal content of the keyboard button
+     */
+    keyboardButton?: ReactNode;
+    /**
+     * 收起键盘回调
+     * @en Callback for closing the keyboard
+     */
+    close: (e?: React.MouseEvent<HTMLElement, MouseEvent>) => {};
+    /**
+     * 点击确认按钮回调
+     * @en Callback for clicking the confirm button
+     */
+    onConfirm?: () => {};
+    /**
+     * 点击删除按钮回调
+     * @en Callback for clicking the delete button
+     */
+    onDelete?: () => {};
+    /**
+     * 点击常规按钮回调
+     * @en Callback for clicking the normal button
+     */
+    onChange?: (data: string | number) => {};
+}
+export interface KeyboardRef extends PopupRef {
+    /**
+     * 最外层 DOM 元素
+     * @en The outer DOM element of the component
+     */
+    keyboard: HTMLDivElement | null;
+}

package/esnext/keyboard/type.js

@@ -0,0 +1 @@
+export {};

package/esnext/load-more/index.d.ts

@@ -0,0 +1,158 @@
+import React, { ReactNode } from 'react';
+export declare type LoadMoreStatus = 'before-ready' | 'prepare' | 'loading' | 'nomore' | 'retry';
+export interface LoadMoreProps {
+    /**
+     * 自定义样式
+     * @en Custom stylesheet
+     */
+    style?: React.CSSProperties;
+    /**
+     * 自定义类名
+     * @en Custom classname
+     */
+    className?: string;
+    /**
+     * 是否禁用加载能力
+     * @en Whether to disable the loading capability
+     */
+    disabled?: boolean;
+    /**
+     * 组件加载但尚未启用状态下的内容
+     * @en Content when the component is loaded but not yet enabled
+     * @default null
+     */
+    beforeReadyArea?: ReactNode;
+    /**
+     * 加载中状态下的内容
+     * @en Content in loading state
+     * @default "正在努力加载中..."
+     * @default_en "Trying to load..."
+     */
+    loadingArea?: ReactNode;
+    /**
+     * 无更多数据状态下的内容
+     * @en Content with no more data
+     * @default "没有更多数据了"
+     * @default_en "No more data"
+     */
+    noMoreArea?: ReactNode;
+    /**
+     * 准备加载状态下的内容
+     * @en Content in ready-to-load state
+     * @default "上拉/点击加载更多"
+     * @default_en "Pull up to load more" or "Click to load more"
+     */
+    prepareArea?: ReactNode;
+    /**
+     * 加载重试状态下的内容
+     * @en Load content in retry state
+     * @default "加载失败，点击重试"
+     * @default_en "failed to load, click to retry"
+     */
+    retryArea?: ReactNode;
+    /**
+     * 组件加载初始状态，传入 "before-ready" 则先加载组件但不请求数据
+     * @en The component is loaded in the initial state. Inputing in "before-ready" will load the component first without requesting data
+     * @default "prepare"
+     */
+    defaultStatus?: 'before-ready' | 'prepare';
+    /**
+     * 当前状态，传入则受控
+     * @en Current state, the component is controlledc  when it is input
+     */
+    status?: LoadMoreStatus;
+    /**
+     * 待计算滚动容器
+     * @en Scrolling container to be calculated
+     * @default () => window
+     */
+    getScrollContainer?: () => HTMLElement | Window | null;
+    /**
+     * 当多个 loadmore 在同一页面时，通过传入节点的 offsetHeight + offsetTop 代替 scrollHeight
+     * @en When multiple loadmores are on the same page, pass in the offsetHeight + offsetTop of the node instead of scrollHeight
+     */
+    getOffsetNode?: () => HTMLElement | Window | null;
+    /**
+     * 触发loading的时机，当为click时，点击后将触发getData
+     * @en The timing of triggering loading, when it is click, getData will be triggered after clicking
+     * @default "scroll"
+     */
+    trigger?: 'scroll' | 'click';
+    /**
+     * 滚动到离列表底部多远的位置触发getData，触发状态时机为'scroll'时有效
+     * @en Scroll to how far from the bottom of the list to trigger getData, valid when the trigger state timing is 'scroll'
+     * @default 200
+     */
+    threshold?: number;
+    /**
+     * 请求数据方法，可在异步任务结束后根据任务结果调用callback修改loadmore内部状态
+     * @en The request data method, after the asynchronous task ends, the callback can be called according to the task result to modify the internal state of loadmore
+     */
+    getData?: (callback: (status: LoadMoreStatus) => void) => void;
+    /**
+     * 节流粒度
+     * @en Throttle granularity
+     * @default 0
+     */
+    throttle?: number;
+    /**
+     * 是否在loading状态下不触发getData
+     * @en Whether to not trigger getData in the loading state
+     * @default true
+     */
+    blockWhenLoading?: boolean;
+    /**
+     * 刚加载好组件时是否自动先请求一次，trigger=scroll时有效
+     * @en Whether to automatically request once when the component is just loaded, valid when trigger=scroll
+     * @default true
+     */
+    getDataAtFirst?: boolean;
+    /**
+     * 当 getDataAtFirst 值为 false 且数据不满一屏时是否触发一次请求，trigger=scroll时有效
+     * @en Whether to trigger a request when getDataAtFirst equals false and the data is not full of one screen, valid when trigger=scroll
+     * @default false
+     */
+    getDataWhenNoScrollAtFirst?: boolean;
+    /**
+     * 状态改变时回调
+     * @en Callback when state changes
+     */
+    onStatusChange?: (status: LoadMoreStatus, scene?: string) => void;
+    /**
+     * 组件被点击时回调
+     * @en Callback when the component is clicked
+     */
+    onClick?: (e: React.MouseEvent<HTMLDivElement, MouseEvent>) => void;
+    /**
+     * 滚动到(底部 - threshold)距离时触发
+     * @en Callback when scrolling to (bottom - threshold) distance
+     */
+    onEndReached?: () => void;
+}
+export interface LoadMoreRef {
+    /**
+     * 最外层元素 DOM
+     * @en The outermost element DOM
+     */
+    dom: HTMLDivElement | null;
+    /**
+     * 手动更改组件状态
+     * @en Change component state manually
+     */
+    changeStatus: (status: LoadMoreStatus, scene?: string) => void;
+    /**
+     * 判断是否滚动到底部并手动触发数据获取
+     * @en Determine whether to scroll to the bottom and manually trigger data acquisition
+     */
+    getDataWithEndReachCheck: () => void;
+}
+/**
+ * 上拉加载组件，支持`scroll`和`click`两种触发加载方式，支持滚动监听。支持受控与不受控两种形式。<br>如果引入组件后发现仅触发了初始的`getData`，请确认是否在`getData`方法内没有调用`callback`移除 loading 状态，且未设置`blockWhenLoading`属性为 false。
+ * @en Pull-up loading component, supports `scroll` and `click` two trigger loading methods, supports scroll monitoring. Both controlled and uncontrolled forms are supported. <br>If only the initial `getData` is triggered after the component is introduced, please make sure that the `callback` is not called in the `getData` method to remove the loading state, and the `blockWhenLoading` property is not set to false.
+ * @type 反馈
+ * @type_en Feedback
+ * @name 加载更多
+ * @name_en LoadMore
+ */
+declare const LoadMore: React.ForwardRefExoticComponent<LoadMoreProps & React.RefAttributes<LoadMoreRef>>;
+export default LoadMore;

package/esnext/load-more/index.js

@@ -0,0 +1,150 @@
+import React, { useRef, forwardRef, useImperativeHandle, useEffect, useCallback, useState, } from 'react';
+import lodashThrottle from 'lodash.throttle';
+import { getScrollContainerAttribute, getValidScrollContainer, defaultLocale, cls, } from '@arco-design/mobile-utils';
+import { ContextLayout } from '../context-provider';
+import { useLatestRef, useUpdateEffect } from '../_helpers';
+/**
+ * 上拉加载组件，支持`scroll`和`click`两种触发加载方式，支持滚动监听。支持受控与不受控两种形式。<br>如果引入组件后发现仅触发了初始的`getData`，请确认是否在`getData`方法内没有调用`callback`移除 loading 状态，且未设置`blockWhenLoading`属性为 false。
+ * @en Pull-up loading component, supports `scroll` and `click` two trigger loading methods, supports scroll monitoring. Both controlled and uncontrolled forms are supported. <br>If only the initial `getData` is triggered after the component is introduced, please make sure that the `callback` is not called in the `getData` method to remove the loading state, and the `blockWhenLoading` property is not set to false.
+ * @type 反馈
+ * @type_en Feedback
+ * @name 加载更多
+ * @name_en LoadMore
+ */
+const LoadMore = forwardRef((props, ref) => {
+    const { className = '', style, disabled, beforeReadyArea, loadingArea, noMoreArea, prepareArea, retryArea, defaultStatus = 'prepare', status, getScrollContainer, getOffsetNode, trigger = 'scroll', threshold = 200, throttle = 0, getDataAtFirst = true, getData, blockWhenLoading = true, onStatusChange, onClick, onEndReached, getDataWhenNoScrollAtFirst = false, } = props;
+    const domRef = useRef(null);
+    const requestAtFirst = trigger === 'scroll' ? getDataAtFirst : false;
+    const [innerStatus, setInnerStatus] = useState(defaultStatus);
+    const lastScrollEndRef = useRef(false);
+    const nowStatus = status || innerStatus;
+    const statusRef = useRef(nowStatus);
+    const disabledRef = useLatestRef(disabled);
+    const changeStatus = useCallback((st, scene) => {
+        setInnerStatus(st);
+        onStatusChange && onStatusChange(st, scene);
+    }, [onStatusChange]);
+    const triggerGetData = useCallback((scene) => {
+        if (disabledRef.current) {
+            return;
+        }
+        if (blockWhenLoading && statusRef.current === 'loading') {
+            return;
+        }
+        changeStatus('loading', scene);
+        getData?.(st => {
+            changeStatus(st, 'manual');
+        });
+    }, [blockWhenLoading, changeStatus, getData]);
+    useEffect(() => {
+        if (!blockWhenLoading || nowStatus !== 'loading') {
+            lastScrollEndRef.current = false;
+        }
+        statusRef.current = nowStatus;
+    }, [nowStatus]);
+    useUpdateEffect(() => {
+        // 当状态被设置为 prepare ，且页面总长度不足一屏时，再触发一次 getData
+        // @en When the state is set to prepare and the total page length is less than one screen, trigger getData again
+        if (trigger === 'scroll' && nowStatus === 'prepare' && checkNeedTrigger(0, threshold)) {
+            triggerGetData('pageEnd');
+        }
+    }, [nowStatus]);
+    useEffect(() => {
+        if (requestAtFirst) {
+            if (statusRef.current === 'prepare' && !disabled) {
+                triggerGetData('requestAtFirst');
+            }
+        }
+        else {
+            if (trigger === 'scroll' &&
+                nowStatus === 'prepare' &&
+                checkNeedTrigger(0, threshold) &&
+                !disabled &&
+                getDataWhenNoScrollAtFirst) {
+                triggerGetData('pageEnd');
+            }
+        }
+    }, [trigger, disabled]);
+    const handleContainerScroll = useCallback(() => {
+        const scrollTop = getScrollContainerAttribute('scrollTop', getScrollContainer);
+        if (checkNeedTrigger(scrollTop, threshold + 1)) {
+            if (!lastScrollEndRef.current) {
+                lastScrollEndRef.current = true;
+                onEndReached && onEndReached();
+                if (!['nomore', 'retry', 'before-ready'].includes(statusRef.current)) {
+                    triggerGetData('scrollEnd');
+                }
+            }
+        }
+        else {
+            lastScrollEndRef.current = false;
+        }
+    }, [getScrollContainer, threshold, triggerGetData, onEndReached]);
+    useEffect(() => {
+        let binded = null;
+        const scrollFunc = throttle
+            ? lodashThrottle(handleContainerScroll, throttle)
+            : handleContainerScroll;
+        if (trigger === 'scroll' && !disabled) {
+            const container = getValidScrollContainer(getScrollContainer);
+            if (container) {
+                container.addEventListener('scroll', scrollFunc);
+                binded = container;
+            }
+        }
+        return () => {
+            if (binded) {
+                binded.removeEventListener('scroll', scrollFunc);
+            }
+        };
+    }, [trigger, disabled, getScrollContainer, handleContainerScroll, throttle]);
+    const getDataWithEndReachCheck = () => {
+        if (checkNeedTrigger(0, threshold)) {
+            triggerGetData('pageEnd');
+        }
+    };
+    useImperativeHandle(ref, () => ({
+        dom: domRef.current,
+        changeStatus,
+        getDataWithEndReachCheck,
+    }), [changeStatus]);
+    function checkNeedTrigger(top, ths) {
+        const scrollHeight = getOffsetNode
+            ? getScrollContainerAttribute('offsetHeight', getOffsetNode) +
+                getScrollContainerAttribute('offsetTop', getOffsetNode)
+            : getScrollContainerAttribute('scrollHeight', getScrollContainer);
+        const clientHeight = getScrollContainerAttribute('clientHeight', getScrollContainer);
+        return scrollHeight - top - clientHeight <= ths;
+    }
+    function handleClick(e) {
+        if ((trigger === 'click' && statusRef.current === 'prepare') ||
+            statusRef.current === 'retry') {
+            triggerGetData('click');
+        }
+        onClick && onClick(e);
+    }
+    function renderArea(locale) {
+        switch (nowStatus) {
+            case 'before-ready':
+                return beforeReadyArea;
+            case 'prepare':
+                return prepareArea === void 0 ? (React.createElement("div", { className: "load-more-text prepare" },
+                    trigger === 'scroll'
+                        ? locale.LoadMore.prepareScrollText
+                        : locale.LoadMore.prepareClickText,
+                    locale.LoadMore.loadMoreText)) : (prepareArea);
+            case 'loading':
+                return loadingArea === void 0 ? (React.createElement("div", { className: "load-more-text loading" }, locale.LoadMore.loadingText)) : (loadingArea);
+            case 'nomore':
+                return noMoreArea === void 0 ? (React.createElement("div", { className: "load-more-text nomore" }, locale.LoadMore.noDataText)) : (noMoreArea);
+            case 'retry':
+                return retryArea === void 0 ? (React.createElement("div", { className: "load-more-text retry" }, locale.LoadMore.failLoadText)) : (retryArea);
+            default:
+                return null;
+        }
+    }
+    return (React.createElement(ContextLayout, null, ({ prefixCls, locale = defaultLocale }) => (React.createElement("div", { className: cls(`${prefixCls}-load-more status-${nowStatus}`, className, {
+            [`${prefixCls}-load-more-disabled`]: disabled,
+        }), ref: domRef, style: style, onClick: handleClick }, renderArea(locale)))));
+});
+export default LoadMore;