hy-app 0.6.9 → 0.7.1

package/components/hy-folding-panel/typing.d.ts

@@ -17,3 +17,26 @@ export interface IFoldingPanelGroupEmits {
      */
     (e: 'close', index: number | string): void
 }
+
+/** HyFoldingPanel 组件实例暴露的方法 */
+export interface IFoldingPanelExpose {
+    /**
+     * 打开指定索引的面板
+     * @param index 面板索引
+     */
+    open: (index: number | string) => void
+    /**
+     * 关闭所有面板
+     */
+    closeAll: () => void
+    /**
+     * 切换指定索引面板的状态
+     * @param index 面板索引
+     */
+    toggle: (index: number | string) => void
+    /**
+     * 关闭指定索引的面板
+     * @param index 面板索引
+     */
+    close: (index: number | string) => void
+}

package/components/hy-folding-panel-item/hy-folding-panel-item.vue

@@ -67,7 +67,7 @@ export default {
 
 <script setup lang="ts">
 import { ref, computed, inject, onMounted } from 'vue'
-import type { IFoldingPanelConfig, IFoldingPanelItemEmits } from './typing'
+import type { IFoldingPanelConfig, IFoldingPanelItemEmits, IFoldingPanelItemExpose } from './typing'
 import { addUnit, IconConfig } from '../../libs'
 import foldingPanelItemProps from './props'
 // 组件
@@ -124,7 +124,7 @@ const handleClick = () => {
 }
 
 // 对外暴露的方法
-defineExpose({
+defineExpose<IFoldingPanelItemExpose>({
     /**
      * 打开面板
      */

package/components/hy-folding-panel-item/typing.d.ts

@@ -35,3 +35,24 @@ export interface IFoldingPanelItemEmits {
      */
     (e: 'child-click', index: number | string): void
 }
+
+/** HyFoldingPanelItem 组件实例暴露的方法 */
+export interface IFoldingPanelItemExpose {
+    /**
+     * 打开面板
+     */
+    open: () => void
+    /**
+     * 关闭面板
+     */
+    close: () => void
+    /**
+     * 切换面板状态
+     */
+    toggle: () => void
+    /**
+     * 获取当前展开状态
+     * @returns 当前展开状态
+     */
+    getExpanded: () => boolean
+}

package/components/hy-form/hy-form.vue

@@ -19,7 +19,7 @@ export default {
 import { provide, reactive, ref, toRefs } from 'vue'
 import { clearVal, isArray } from '../../libs'
 import formProps from './props'
-import type { IFormEmits } from './typing'
+import type { IFormEmits, IFormExpose } from './typing'
 
 /**
  * 表单组件父组件，需要搭配hy-form-item
@@ -203,7 +203,7 @@ const submit = async () => {
     return false
 }
 
-defineExpose({
+defineExpose<IFormExpose>({
     validate,
     resetFields,
     clearValidate,

package/components/hy-form/typing.d.ts

@@ -1,3 +1,9 @@
+import type { ExtractPropTypes } from 'vue'
+import type formProps from './props'
+
+export interface HyFormProps extends ExtractPropTypes<typeof formProps> {}
+export type HyFormSimpleProps = HyFormProps
+
 export interface FormRule {
     /**
      * 是否必填
@@ -39,3 +45,34 @@ export interface IFormEmits {
     /** 表单校验 */
     (e: 'validate', valid: boolean, errors: AnyObject): void
 }
+
+/** HyForm 组件实例暴露的方法和属性 */
+export interface IFormExpose {
+    /**
+     * 验证所有表单字段
+     * @returns Promise，验证成功时 resolve，失败时 reject 并返回错误信息
+     */
+    validate: () => Promise<unknown>
+    /**
+     * 重置表单所有字段到初始值
+     */
+    resetFields: () => void
+    /**
+     * 清除表单验证错误
+     * @param fields 可选，指定要清除的字段名数组，不传则清除所有
+     */
+    clearValidate: (fields?: string[]) => void
+    /**
+     * 提交表单（会先执行验证）
+     * @returns Promise，验证成功时返回表单数据，失败时返回 false
+     */
+    submit: () => Promise<AnyObject | false>
+    /**
+     * 表单数据对象
+     */
+    formData: AnyObject
+    /**
+     * 表单错误信息
+     */
+    errors: Record<string, string>
+}

package/components/hy-form-item/typing.d.ts

@@ -1,4 +1,4 @@
-import HyFormSimpleProps, { type FormRule } from '../hy-form/typing'
+import type { HyFormSimpleProps, FormRule } from '../../index'
 import type { ToRefs } from 'vue'
 
 export interface IFormContext extends ToRefs<HyFormSimpleProps> {

package/components/hy-grid/hy-grid.vue

@@ -14,18 +14,18 @@
                     :name="item[customKeys?.icon]"
                     label-pos="bottom"
                     :label="item[customKeys?.name]"
-                    :space="item?.iconConfig?.space || iconConfig?.space || 8"
-                    :color="item?.iconConfig?.color || iconConfig?.color"
-                    :size="item?.iconConfig?.size || iconConfig?.size || 30"
-                    :bold="item?.iconConfig?.bold || iconConfig?.bold"
-                    :customPrefix="item?.iconConfig?.customPrefix"
-                    :imgMode="item?.iconConfig?.imgMode || iconConfig?.imgMode"
-                    :width="item?.iconConfig?.width || iconConfig?.width"
-                    :height="item?.iconConfig?.height || iconConfig?.height"
-                    :top="item?.iconConfig?.top || iconConfig?.top"
-                    :stop="item?.iconConfig?.stop || iconConfig?.stop"
-                    :round="item?.iconConfig?.round || iconConfig?.round || 6"
-                    :customStyle="item?.iconConfig?.customStyle || iconConfig?.customStyle"
+                    :space="item?.iconProps?.space || iconProps?.space || 8"
+                    :color="item?.iconProps?.color || iconProps?.color"
+                    :size="item?.iconProps?.size || iconProps?.size || size"
+                    :bold="item?.iconProps?.bold || iconProps?.bold"
+                    :customPrefix="item?.iconProps?.customPrefix"
+                    :imgMode="item?.iconProps?.imgMode || iconProps?.imgMode"
+                    :width="item?.iconProps?.width || iconProps?.width"
+                    :height="item?.iconProps?.height || iconProps?.height"
+                    :top="item?.iconProps?.top || iconProps?.top"
+                    :stop="item?.iconProps?.stop || iconProps?.stop"
+                    :round="item?.iconProps?.round || iconProps?.round || 6"
+                    :customStyle="item?.iconProps?.customStyle || iconProps?.customStyle"
                 ></hy-icon>
             </view>
         </template>

package/components/hy-grid/index.scss

@@ -13,7 +13,6 @@
   /* #endif */
 
   @include e(item) {
-    align-items: center;
     justify-content: center;
     position: relative;
     flex-direction: column;
@@ -24,9 +23,9 @@
     /* #endif */
 
     /* #ifdef MP */
-    position: relative;
     float: left;
     /* #endif */
+    padding: $hy-border-margin-padding-base 0;
 
     // 只有当有 border 类时才显示边框
     @include m(border) {

package/components/hy-grid/props.ts

@@ -21,6 +21,11 @@ const gridProps = {
         type: Number,
         default: 5
     },
+    /** 图标大小 */
+    size: {
+        type: [Number, String],
+        default: 44
+    },
     /** 是否显示宫格的边框 */
     border: {
         type: Boolean,
@@ -29,7 +34,7 @@ const gridProps = {
     /** 单个宫格高度 */
     itemHeight: {
         type: [Number, String],
-        default: '80px'
+        default: '100%'
     },
     /**
      * 宫格对齐方式，表现为数量少的时候，靠左，居中，还是靠右
@@ -50,7 +55,7 @@ const gridProps = {
         default: 'transparent'
     },
     /** 图标属性api配置集合 */
-    iconConfig: Object as PropType<HyIconProps>,
+    iconProps: Object as PropType<HyIconProps>,
     /** 定义需要用到的外部样式 */
     customStyle: Object as PropType<CSSProperties>,
     /** 自定义外部类名 */

package/components/hy-grid/typing.d.ts

@@ -12,7 +12,7 @@ export interface GridItemVo {
     /**
      * 图标属性api配置
      * */
-    iconConfig?: Partial<HyIconProps>
+    iconProps?: Partial<HyIconProps>
     /**
      * 自定义内容键值对
      * */

package/components/hy-icon/typing.d.ts

@@ -1,9 +1,52 @@
-import type { ExtractPropTypes } from 'vue'
-import iconProps from './props'
-
-export interface HyIconProps extends ExtractPropTypes<typeof iconProps> {}
-
-export interface IIconEmits {
-    /** 点击图标触发 */
-    (e: 'click', index: string, e: Event): void
-}
+import type { CSSProperties } from 'vue'
+
+export interface HyIconProps {
+    /** 图标名称 */
+    name?: string
+    /** 图标颜色 */
+    color?: string
+    /** 图标字体大小，单位px */
+    size?: number | string
+    /** 是否显示粗体 */
+    bold?: boolean
+    /** 点击图标的时候传递事件出去的index（用于区分点击了哪一个） */
+    index?: string
+    /** 自定义扩展前缀，方便用户扩展自己的图标库 */
+    customPrefix?: string
+    /** 图标右侧的label文字 */
+    label?: string
+    /**
+     * label相对于图标的位置，只能right或bottom
+     * @values right,bottom
+     * */
+    labelPos?: string
+    /** label字体大小，单位px */
+    labelSize?: string
+    /** 图标右侧的label文字颜色 */
+    labelColor?: string
+    /** label与图标的距离，单位px */
+    space?: number | string
+    /** 图片的mode */
+    imgMode?: string
+    /** 显示图片小图标时的宽度 */
+    width?: string | number
+    /** 显示图片小图标时的高度 */
+    height?: string | number
+    /** 图标在垂直方向上的定位 用于解决某些情况下，让图标垂直居中的用途 */
+    top?: string | number
+    /** 是否阻止事件传播 */
+    stop?: boolean
+    /** 是否旋转 */
+    isRotate?: boolean
+    /** 图标圆角 */
+    round?: string | number
+    /** 定义需要用到的外部样式 */
+    customStyle?: CSSProperties
+    /** 自定义外部类名 */
+    customClass?: string
+}
+
+export interface IIconEmits {
+    /** 点击图标触发 */
+    (e: 'click', index: string, e: Event): void
+}

package/components/hy-keyboard/constants.ts

@@ -0,0 +1,83 @@
+/**
+ * 车牌号键盘-省份简称
+ */
+export const CAR_KEYBOARD_AREAS = [
+  '京',
+  '沪',
+  '粤',
+  '津',
+  '冀',
+  '豫',
+  '云',
+  '辽',
+  '黑',
+  '湘',
+  '皖',
+  '鲁',
+  '苏',
+  '浙',
+  '赣',
+  '鄂',
+  '桂',
+  '甘',
+  '晋',
+  '陕',
+  '蒙',
+  '吉',
+  '闽',
+  '贵',
+  '渝',
+  '川',
+  '青',
+  '琼',
+  '宁',
+  '挂',
+  '藏',
+  '港',
+  '澳',
+  '新',
+  '使',
+  '学'
+]
+
+/**
+ * 车牌号键盘-数字和字母（不包含I和O，因为车牌号规则中不使用这两个字母）
+ */
+export const CAR_KEYBOARD_KEYS = [
+    1,
+    2,
+    3,
+    4,
+    5,
+    6,
+    7,
+    8,
+    9,
+    0,
+    'Q',
+    'W',
+    'E',
+    'R',
+    'T',
+    'Y',
+    'U',
+    'I',
+    'O',
+    'P',
+    'A',
+    'S',
+    'D',
+    'F',
+    'G',
+    'H',
+    'J',
+    'K',
+    'L',
+    'Z',
+    'X',
+    'C',
+    'V',
+    'B',
+    'N',
+    'M'
+]