徐勤民 ebb40b70f4 feat(basic): 新增日期选择工具 PickerDateTimeHelper

- 添加 PickerDateTimeHelper 类，提供日期选择功能
- 在 CHANGELOG.md 和 README.md 中更新相关文档
-定义 DateDialogOptions 接口，支持自定义日期选择器的配置
- 实现 showDateDialog 静态方法，用于显示日期选择器

2024-11-06 20:19:55 +08:00

9.3 KiB

原始文件 Blame 文件历史

基础开发工具包

ohpm install @szyx/sdk_base

0.初始化

在UIAbility的onWindowStageCreate方法中初始化该方法

// 初始化
import { WindowHelper } from '@szyx/sdk_base';
export default class AppAbility extends UIAbility {
    onWindowStageCreate(windowStage: window.WindowStage): void {

        windowStage.loadContent('pages/Index', (err) => {
            if (err.code) {
                hilog.error(0x0000, 'testTag', 'Failed to load the content. Cause: %{public}s', JSON.stringify(err) ?? '');
                return;
            }
        });
        // 这行代码
        GlobalContext.setContext(this.context)
    }
}

1.utils

1.1.AppStorageHelper

缓存工具类，运行时存储，应用停止运行后清空

import { AppStorageHelper } from '@szyx/sdk_base/Index'

// 存储string数据
AppStorageHelper.save(StorageKeys.CLIENT_ID, d)

// 获取存储的strign数据
let d = AppStorageHelper.get(StorageKeys.CLIENT_ID)
// 删除指定存储
AppStorageHelper.delete(StorageKeys.CLIENT_ID)

1.2.PreferencesHelper

永久存储类，应用停止后也不会清空需要验证，更新应用会不会被清理可存储类型 number | string | boolean | Array<number> | Array<string> | Array<boolean> | Uint8Array

import { PreferencesHelper } from '@szyx/sdk_base/Index'

// 存储数据
PreferencesHelper.put(StorageKeys.CLIENT_ID, value)

// 获取存储的数据
PreferencesHelper.get(StorageKeys.CLIENT_ID).then(res => {
    console.log('>>>>>', res)
})
// 删除存储的数据
PreferencesHelper.delete(StorageKeys.CLIENT_ID).then(() => {
    console.log('>>>>>')
})

1.3.ToolsHelper

常用方法工具栏基础方法

1.3.1.弹出Toast提示

import { ToolsHelper } from '@szyx/sdk_base';

ToolsHelper.showMessage('Hello Word!')

1.3.2.打印日志

打印格式：========>${顶层调用栈}::

import { ToolsHelper } from '@szyx/sdk_base';

ToolsHelper.log('Hello Word!')

1.3.3.获取调用栈第一个

import { ToolsHelper } from '@szyx/sdk_base';

ToolsHelper.getStackKey()

1.3.4.获取设备信息

import { ToolsHelper } from '@szyx/sdk_base';

ToolsHelper.getDeviceInfo()

1.4.ValidatorHelper

常用正则

1.4.1.验证手机号

import { ValidatorHelper } from '@szyx/sdk_base';

ValidatorHelper.isPhone('13800000000')

1.5.AlgorithmHelper

计算相关

1.5.1.计算两点间距离

import { AlgorithmHelper } from '@szyx/sdk_base';

AlgorithmHelper.calculateDistance(x1, y1, x2, y2)

1.6.XWebHelper

打开webview页面

import { XWebHelper } from '@szyx/sdk_base';

// 必须先引入，否则无法跳转
const XWebview = import('../pages/XWebview');

XWebHelper.openWeb({
    url: 'https://www.baidu.com',
    title: '百度一下',
})

1.7.PickerDateTimeHelper

时间日期选择弹窗相关

1.7.1 选择日期

import { PickerDateTimeHelper } from '@szyx/sdk_base'

PickerDateTimeHelper.showDateDialog({
  onConfirm: (date) => {
    ToolsHelper.log(date)
  }
}, this)

2.Dialog

2.1.弹出list选中弹窗

import { XDialogController } from '../dialog/XDialogController';
import { XDialogList } from '../dialog/XDialogList';

@
Component
struct
MyView
{
    // 控制器，控制开关
    dialogController: XDialogController = {} as XDialogController

    build()
    {
        Column()
        {
            Button
            ({ buttonStyle: ButtonStyleMode.TEXTUAL })
            {
                Image($r('sys.media.ohos_ic_public_more'))
                    .width(26).height(26)
            }
            .
            width(65)
                .onClick(() => {
                if (this.dialogController != null) {
                    this.dialogController.open()
                }
            })

            XDialogList({
                // 控制器
                controller: this.dialogController,
                // 标题(可选)
                title: '选择您的操作',
                // 选择内容列表
                values: ['刷新', '浏览器打开', '分享', '复制地址'],
                // 用户选择事件
                onSelected: (index: number, value: string) => {
                    ToolsHelper.showMessage(`用户选择了第${index}个，内容为：${value}`)
                },
                // 用户取消事件
                onCancel: () => {
                    ToolsHelper.showMessage('用户取消操作')
                },
                // 是否可取消(点击空白处，或者物理返回键)
                autoCancel: true
            })

        }
        .
        width('100%').height('100%')
    }
}

3.网络请求

使用时建议二次封装

参数定义

/**
* 
* @param url url地址
* @param data 请求参数
* @param headers 请求头
* @param apiNo 请求标识，取消请求或者去重使用|考虑做自动重试使用
* @returns
  */

3.1.get请求


HttpHelper.get()
    .get<HttpResult<T>>(url.url.startsWith('http') ? url.url : GlobalValue.getInstance().envUrl + url.url,
                        data ? JSON.stringify(data) : undefined, {
    userId: GlobalValue.getInstance().userIds,
    clientId: GlobalValue.getInstance().getClientIds(),
    version: ConstantValue.VERSION,
    deviceType: '01',
    timeStamp: timeStamp + '',
    sign: sign,
    phoneModel: 'sign',
    phoneVersion: 'sign',
    phoneBrand: 'HarmonyOS'
}, url.apiNo)
    .then((res: HttpResult<T>) => {
    if (res.status === '0') {
        resolve(res.data as T)
    } else {
        reject(new Error(res.message))
    }

})
    .catch((error: Error) => {
    reject(error)
})

3.2.postJson


HttpHelper.get()
    .post<HttpResult<T>>(url.url.startsWith('http') ? url.url : GlobalValue.getInstance().envUrl + url.url,
                         data ? JSON.stringify(data) : undefined, {
    userId: GlobalValue.getInstance().userIds,
    clientId: GlobalValue.getInstance().getClientIds(),
    version: ConstantValue.VERSION,
    deviceType: '01',
    timeStamp: timeStamp + '',
    sign: sign,
    phoneModel: 'sign',
    phoneVersion: 'sign',
    phoneBrand: 'HarmonyOS'
}, url.apiNo)
    .then((res: HttpResult<T>) => {
    if (res.status === '0') {
        resolve(res.data as T)
    } else {
        reject(new Error(res.message))
    }

})
    .catch((error: Error) => {
    reject(error)
})

4.自定义view

4.1.LoadingView

封装了loading的根布局

import { LoadingView } from '@szyx/sdk_base'

@State isLoading: boolean = false

build() {
    Stack() {
        LoadingView({ isLoading: this.isLoading }) {
            Column() {
                Text('正常布局')
            }
            .width('100%')
                .height('100%')
        }
    }
}

4.2.SafeView

基础布局

import { SafeView } from '@szyx/sdk_base'

@State isLoading: boolean = false

build() {
    SafeView({
        isLoading: this.isLoading,
        titleText: '注册',
        onClickLeft:{img:$r("app.media.base_back"),
                     onClick:()=>{}
                    },
        onClickRight:{
            text:'添加',
            color:'#ff1d9999',
            onClick:()=>{}
        }
    }){
        // 自己的布局
    }
}

4.3.RefreshView

下拉刷新，上拉加载更多

import { RefreshView } from '@szyx/sdk_base'

@State isLoading: boolean = false


@Builder
buildItem(item: Item, index: number) {
    Column() {
    }
    .width('100%')
}

build() {
    // ......
    RefreshView({
        isLoading: this.isLoading,
        keyGenerator: (item: Item) => {
            return item.id
        },
        pageSize: 10,
        data: this.list ?? [],
        // 这里要用箭头函数，否则buildItem里面的this指向不对
        customBuilderParam: (item: Item, index: number) => {
          this.buildItem(item, index)
        },
        onRefresh: () => {
            this.refresh()
        },
        onLoadMore: (pageNum) => {
            this.refresh(pageNum)
        }
    })
    // ......

}

5.Windows

5.1.弹出自定义窗口

弹出自定义窗口

import { WindowHelper } from '@szyx/sdk_base'

WindowHelper.open({
    name: '登录弹窗',
    router:'login'
})

WindowHelper.close()

5.2.设置沉浸式相关

// 需要的界面
// 设置是否全屏
WindowHelper.setWindowLayoutFullScreen(true)

// 隐藏状态栏
WindowHelper.hideStatusBar()

// 显示状态栏
WindowHelper.showStatusBar()

// 顶部安全区高度
WindowHelper.topRectHeight()

// 底部安全区高度
WindowHelper.bottomRectHeight()

9.3 KiB 原始文件 Blame 文件历史

基础开发工具包

0.初始化

1.utils

1.1.AppStorageHelper

1.2.PreferencesHelper

1.3.ToolsHelper

1.3.1.弹出Toast提示

1.3.2.打印日志

1.3.3.获取调用栈第一个

1.3.4.获取设备信息

1.4.ValidatorHelper

1.4.1.验证手机号

1.5.AlgorithmHelper

1.5.1.计算两点间距离

1.6.XWebHelper

1.7.PickerDateTimeHelper

1.7.1 选择日期

2.Dialog

2.1.弹出list选中弹窗

3.网络请求

3.1.get请求

3.2.postJson

4.自定义view

4.1.LoadingView

4.2.SafeView

4.3.RefreshView

5.Windows

5.1.弹出自定义窗口

5.2.设置沉浸式相关

**** 常见问题

9.3 KiB

原始文件 Blame 文件历史