@wot-ui/ui 1.0.0 → 2.0.0-alpha.4

package/components/wd-keyboard/key/index.scss

@@ -0,0 +1,103 @@
+@use '../../../styles/mixin/mixin.scss' as *;
+@use '../../../styles/variable.scss' as *;
+
+// 按键高度
+$keyboard-key-height: var(--wot-keyboard-key-height, $n-48) !default;
+// 按键间距
+$keyboard-key-padding: var(--wot-keyboard-key-padding, $padding-tight) !default;
+// 按键字号
+$keyboard-key-font-size: var(--wot-keyboard-key-font-size, $typography-title-size-extra-large) !default;
+// 按键行高
+$keyboard-key-line-height: var(--wot-keyboard-key-line-height, $typography-title-line--height-size-extra-large) !default;
+// 车牌按键字号
+$keyboard-key-car-font-size: var(--wot-keyboard-key-car-font-size, $typography-title-size-main) !default;
+// 车牌按键行高
+$keyboard-key-car-line-height: var(--wot-keyboard-key-car-line-height, $typography-title-line--height-size-main) !default;
+// 按键字重
+$keyboard-key-font-weight: var(--wot-keyboard-key-font-weight, $font-weight-medium) !default;
+// 按键背景色
+$keyboard-key-bg: var(--wot-keyboard-key-bg, $filled-oppo) !default;
+// 按键圆角
+$keyboard-key-radius: var(--wot-keyboard-key-radius, $radius-main) !default;
+// 按键激活背景色
+$keyboard-key-bg-active: var(--wot-keyboard-key-bg-active, $filled-strong) !default;
+// 删除键字号
+$keyboard-key-delete-font-size: var(--wot-keyboard-key-delete-font-size, $typography-title-size-main) !default;
+// 删除键行高
+$keyboard-key-delete-line-height: var(--wot-keyboard-key-delete-line-height, $typography-title-line--height-size-main) !default;
+// 删除键字重
+$keyboard-key-delete-font-weight: var(--wot-keyboard-key-delete-font-weight, $font-weight-medium) !default;
+// 主按钮文字颜色
+$keyboard-key-primary-color: var(--wot-keyboard-key-primary-color, $base-white) !default;
+// 主按钮背景色
+$keyboard-key-primary-bg: var(--wot-keyboard-key-primary-bg, $primary-6) !default;
+// 主按钮激活背景色
+$keyboard-key-primary-bg-active: var(--wot-keyboard-key-primary-bg-active, $primary-7) !default;
+// 按键图标尺寸
+$keyboard-key-icon-size: var(--wot-keyboard-key-icon-size, $n-22) !default;
+
+.wd-key-wrapper {
+  position: relative;
+  flex: 1;
+  flex-basis: 33%;
+  box-sizing: border-box;
+  padding: 0 $keyboard-key-padding $keyboard-key-padding 0;
+
+  @include m(wider) {
+    flex-basis: 66%;
+  }
+}
+
+@include b(key) {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  height: $keyboard-key-height;
+  font-size: $keyboard-key-font-size;
+  line-height: $keyboard-key-line-height;
+  font-weight: $keyboard-key-font-weight;
+  background: $keyboard-key-bg;
+  border-radius: $keyboard-key-radius;
+
+  @include m(active) {
+    background: $keyboard-key-bg-active;
+  }
+
+  @include when(car) {
+    font-size: $keyboard-key-car-font-size;
+    line-height: $keyboard-key-car-line-height;
+  }
+
+  @include m(large) {
+    position: absolute;
+    top: 0;
+    right: $keyboard-key-padding;
+    bottom: $keyboard-key-padding;
+    left: 0;
+    height: auto;
+  }
+
+  @include m(delete, close) {
+    font-size: $keyboard-key-delete-font-size;
+    line-height: $keyboard-key-delete-line-height;
+    font-weight: $keyboard-key-delete-font-weight;
+  }
+
+
+  @include m(close) {
+    color: $keyboard-key-primary-color;
+    background: $keyboard-key-primary-bg;
+
+    &.wd-key--active {
+      background: $keyboard-key-primary-bg-active;
+    }
+  }
+
+  @include edeep(loading-icon) {
+    color: $keyboard-key-primary-color;
+  }
+
+  @include edeep(icon) {
+    font-size: $keyboard-key-icon-size;
+  }
+}

package/components/wd-keyboard/key/index.vue

@@ -0,0 +1,84 @@
+<template>
+  <view :class="`wd-key-wrapper ${wider ? 'wd-key-wrapper--wider' : ''}`" @touchstart="onTouchStart" @touchmove="onTouchMove" @touchend="onTouchEnd">
+    <view :class="keyClass">
+      <wd-loading custom-class="wd-key__loading-icon" v-if="props.loading" />
+      <template v-if="type === 'delete'">
+        <template v-if="text">
+          {{ text }}
+        </template>
+        <wd-icon v-else custom-class="wd-key__icon" name="del" size="22px"></wd-icon>
+      </template>
+      <template v-else-if="type === 'extra'">
+        <template v-if="text">
+          {{ text }}
+        </template>
+        <wd-icon v-else custom-class="wd-key__icon" name="keyboard" size="22px"></wd-icon>
+      </template>
+      <template v-else>{{ text }}</template>
+    </view>
+  </view>
+</template>
+<script lang="ts">
+export default {
+  name: 'wd-key',
+  options: {
+    // #ifndef MP-TOUTIAO
+    virtualHost: true,
+    // #endif
+    addGlobalClass: true,
+    styleIsolation: 'shared'
+  }
+}
+</script>
+
+<script lang="ts" setup>
+import { computed, ref } from 'vue'
+import { useTouch } from '../../../composables/useTouch'
+import { keyProps } from './types'
+
+const props = defineProps(keyProps)
+const emit = defineEmits(['press'])
+
+const touch = useTouch()
+const active = ref<boolean>(false)
+
+const keyClass = computed(() => {
+  return `wd-key ${props.large ? 'wd-key--large' : ''} ${props.type === 'delete' ? 'wd-key--delete' : ''} ${
+    props.type === 'close' ? 'wd-key--close' : ''
+  } ${props.isCar ? 'is-car' : ''} ${active.value ? 'wd-key--active' : ''}`
+})
+
+/**
+ * 触摸开始事件处理
+ * @param {TouchEvent} event 触摸事件对象
+ */
+function onTouchStart(event: TouchEvent) {
+  touch.touchStart(event)
+  active.value = true
+}
+
+/**
+ * 触摸移动事件处理
+ * @param {TouchEvent} event 触摸事件对象
+ */
+function onTouchMove(event: TouchEvent) {
+  touch.touchMove(event)
+  if (touch.direction.value) {
+    active.value = false
+  }
+}
+
+/**
+ * 触摸结束事件处理
+ */
+function onTouchEnd() {
+  if (active.value) {
+    active.value = false
+    emit('press', props.text, props.type)
+  }
+}
+</script>
+
+<style lang="scss">
+@use './index.scss';
+</style>

package/components/wd-keyboard/key/types.ts

@@ -0,0 +1,44 @@
+import type { ExtractPropTypes } from 'vue'
+import { makeBooleanProp, makeNumericProp, makeStringProp } from '../../../common/props'
+
+export type NumberKeyType = '' | 'delete' | 'extra' | 'close'
+
+export const keyProps = {
+  /**
+   * 键盘按键类型
+   * 类型：string
+   * 可选值：'' | 'delete' | 'extra' | 'close'
+   */
+  type: makeStringProp<NumberKeyType>(''),
+  /**
+   * 按键文本
+   * 类型：string | number
+   */
+  text: makeNumericProp(''),
+  /**
+   * 是否占据更宽的空间
+   * 类型：boolean
+   * 默认值：false
+   */
+  wider: makeBooleanProp(false),
+  /**
+   * 是否是大按键
+   * 类型：boolean
+   * 默认值：false
+   */
+  large: makeBooleanProp(false),
+  /**
+   * 是否正在加载中
+   * 类型：boolean
+   * 默认值：false
+   */
+  loading: makeBooleanProp(false),
+  /**
+   * 是否为车牌键盘模式
+   * 类型：boolean
+   * 默认值：false
+   */
+  isCar: makeBooleanProp(false)
+}
+
+export type KeyProps = ExtractPropTypes<typeof keyProps>

package/components/wd-keyboard/types.ts

@@ -0,0 +1,138 @@
+import type { PropType, ExtractPropTypes } from 'vue'
+import { baseProps, makeBooleanProp, makeNumberProp, makeStringProp } from '../../common/props'
+
+export type KeyboardMode = 'default' | 'custom' | 'car'
+export type KeyType = '' | 'delete' | 'extra' | 'close'
+export type CarKeyboardLang = 'zh' | 'en'
+
+export interface Key {
+  /**
+   * key文本
+   */
+  text?: number | string
+  /**
+   * key的类型
+   */
+  type?: KeyType
+  /**
+   * 是否占2个key的宽度
+   */
+  wider?: boolean
+}
+
+export const keyboardProps = {
+  ...baseProps,
+  /**
+   * 是否可见
+   * 类型：boolean
+   * 默认值：false
+   */
+  visible: makeBooleanProp(false),
+  /**
+   * 绑定的值
+   * 类型：string
+   * 默认值：''
+   */
+  modelValue: makeStringProp(''),
+  /**
+   * 标题
+   * 类型：string
+   */
+  title: String,
+  /**
+   * 键盘模式
+   * 类型：string
+   * 可选值：'default' | 'custom' | 'car'
+   * 默认值：'default'
+   */
+  mode: makeStringProp<KeyboardMode>('default'),
+  /**
+   * 层级
+   * 类型：number
+   * 默认值：100
+   */
+  zIndex: makeNumberProp(100),
+  /**
+   * 最大长度
+   * 类型：number
+   * 默认值：Infinity
+   */
+  maxlength: makeNumberProp(Infinity),
+  /**
+   * 是否显示删除键
+   * 类型：boolean
+   * 默认值：true
+   */
+  showDeleteKey: makeBooleanProp(true),
+  /**
+   * 是否随机键盘按键顺序
+   * 类型：boolean
+   * 默认值：false
+   */
+  randomKeyOrder: makeBooleanProp(false),
+  /**
+   * 确认按钮文本
+   * 类型：string
+   */
+  closeText: String,
+  /**
+   * 删除按钮文本
+   * 类型：string
+   */
+  deleteText: String,
+  /**
+   * 关闭按钮是否显示加载状态
+   * 类型：boolean
+   * 默认值：false
+   */
+  closeButtonLoading: makeBooleanProp(false),
+  /**
+   * 是否显示蒙层
+   * 类型：boolean
+   * 默认值：false
+   */
+  modal: makeBooleanProp(false),
+  /**
+   * 是否在点击外部时收起键盘
+   * 类型：boolean
+   * 默认值：true
+   */
+  hideOnClickOutside: makeBooleanProp(true),
+  /**
+   * 是否锁定滚动
+   * 类型：boolean
+   * 默认值：true
+   */
+  lockScroll: makeBooleanProp(true),
+  /**
+   * 是否在底部安全区域内
+   * 类型：boolean
+   * 默认值：true
+   */
+  safeAreaInsetBottom: makeBooleanProp(true),
+  /**
+   * 额外按键
+   * 类型：string | string[]
+   */
+  extraKey: [String, Array] as PropType<string | Array<string>>,
+  /**
+   * 是否从页面中脱离出来，用于解决各种 fixed 失效问题 (H5: teleport, APP: renderjs, 小程序: root-portal)
+   * 类型：boolean
+   * 默认值：false
+   */
+  rootPortal: makeBooleanProp(false),
+  /**
+   * 车牌键盘语言模式 当mode=car时生效
+   * 类型：string
+   * 可选值：'zh' | 'en'
+   */
+  carLang: String as PropType<CarKeyboardLang>,
+  /**
+   * 是否自动切换车牌键盘语言 当mode=car且carLang是非受控状态时生效
+   * 类型：boolean
+   * 默认值：false
+   */
+  autoSwitchLang: makeBooleanProp(false)
+}
+
+export type KeyboardProps = ExtractPropTypes<typeof keyboardProps>

package/components/wd-keyboard/wd-keyboard.vue

@@ -0,0 +1,236 @@
+<template>
+  <wd-popup
+    v-model="show"
+    position="bottom"
+    :z-index="zIndex"
+    :safe-area-inset-bottom="safeAreaInsetBottom"
+    :modal-style="modal ? '' : 'opacity: 0;'"
+    :modal="hideOnClickOutside"
+    :lockScroll="lockScroll"
+    :root-portal="rootPortal"
+    @click-modal="handleClose"
+  >
+    <view :class="`wd-keyboard ${customClass}`" :style="customStyle">
+      <view class="wd-keyboard__header" v-if="showHeader">
+        <slot name="title" v-if="showTitle">
+          <text class="wd-keyboard__title">{{ title }}</text>
+        </slot>
+        <view class="wd-keyboard__close" hover-class="wd-keyboard__close--hover" v-if="showClose" @click="handleClose">
+          <text>{{ closeText }}</text>
+        </view>
+      </view>
+      <template v-if="mode !== 'car'">
+        <view class="wd-keyboard__body">
+          <view class="wd-keyboard__keys">
+            <wd-key v-for="key in keys" :key="key.text" :text="key.text" :type="key.type" :wider="key.wider" @press="handlePress"></wd-key>
+          </view>
+          <view class="wd-keyboard__sidebar" v-if="mode === 'custom'">
+            <wd-key v-if="showDeleteKey" large :text="deleteText" type="delete" @press="handlePress"></wd-key>
+            <wd-key large :text="closeText" type="close" :loading="closeButtonLoading" @press="handlePress"></wd-key>
+          </view>
+        </view>
+      </template>
+      <template v-if="mode === 'car'">
+        <view class="wd-keyboard__body">
+          <view class="wd-keyboard__car-keys">
+            <wd-key v-for="key in keys" :key="key.text" :text="key.text" :type="key.type" :wider="key.wider" is-car @press="handlePress"></wd-key>
+          </view>
+        </view>
+      </template>
+    </view>
+  </wd-popup>
+</template>
+<script lang="ts">
+export default {
+  name: 'wd-keyboard',
+  options: {
+    // #ifndef MP-TOUTIAO
+    virtualHost: true,
+    // #endif
+    addGlobalClass: true,
+    styleIsolation: 'shared'
+  }
+}
+</script>
+
+<script lang="ts" setup>
+import { computed, ref, watch, useSlots } from 'vue'
+import wdPopup from '../wd-popup/wd-popup.vue'
+import WdKey from './key/index.vue'
+import { keyboardProps, type Key, type CarKeyboardLang } from './types'
+import type { NumberKeyType } from './key/types'
+import { CAR_KEYBOARD_AREAS, CAR_KEYBOARD_KEYS } from './constants'
+
+const props = defineProps(keyboardProps)
+const emit = defineEmits(['update:visible', 'input', 'close', 'delete', 'update:modelValue', 'update:carLang'])
+const slots = useSlots()
+
+const show = ref(props.visible)
+watch(
+  () => props.visible,
+  (newValue) => {
+    show.value = newValue
+  }
+)
+
+const carLang = ref<CarKeyboardLang>('zh')
+const carKeyboardLang = computed({
+  get: () => (props.carLang ? props.carLang : carLang.value),
+  set: (value: CarKeyboardLang) => {
+    carLang.value = value
+  }
+})
+
+const keys = computed(() => (props.mode !== 'car' ? (props.mode === 'custom' ? genCustomKeys() : genDefaultKeys()) : genCarKeys()))
+
+const showClose = computed(() => {
+  return props.closeText && (props.mode === 'default' || props.mode === 'car')
+})
+
+const showTitle = computed(() => {
+  return !!props.title || !!slots.title
+})
+
+const showHeader = computed(() => {
+  return showTitle.value || showClose.value
+})
+
+/**
+ * 随机打乱数组的顺序
+ * @param {T[]} arr 要打乱顺序的数组
+ * @returns {T[]} 打乱顺序后的数组
+ */
+function shuffleArray<T>(arr: T[]): T[] {
+  const newArr = [...arr]
+  for (let i = newArr.length - 1; i > 0; i--) {
+    // 生成一个随机索引 j，范围是 [0, i]
+    const j = Math.floor(Math.random() * (i + 1))
+
+    // 交换索引 i 和 j 处的元素
+    ;[newArr[i], newArr[j]] = [newArr[j], newArr[i]]
+  }
+  return newArr
+}
+
+/**
+ * 生成基础按键（1-9）
+ * @returns {Key[]} 基础按键数组
+ */
+function genBasicKeys(): Key[] {
+  const keys = Array.from({ length: 9 }, (_, i) => ({ text: i + 1 }))
+
+  // 如果需要随机顺序，则调用 shuffleArray 方法打乱数组顺序
+  return props.randomKeyOrder ? shuffleArray(keys) : keys
+}
+
+/**
+ * 生成默认键盘按键
+ * @returns {Key[]} 默认键盘按键数组
+ */
+function genDefaultKeys(): Key[] {
+  return [
+    ...genBasicKeys(),
+    { text: props.extraKey as string, type: 'extra' },
+    { text: 0 },
+    {
+      // 根据条件是否显示删除键的文本和类型
+      text: props.showDeleteKey ? props.deleteText : '',
+      type: props.showDeleteKey ? 'delete' : ''
+    }
+  ]
+}
+
+/**
+ * 生成自定义键盘按键
+ * @returns {Key[]} 自定义键盘按键数组
+ */
+function genCustomKeys(): Key[] {
+  const keys = genBasicKeys()
+  const extraKeys = Array.isArray(props.extraKey) ? props.extraKey : [props.extraKey]
+  if (extraKeys.length === 1) {
+    // 如果只有一个额外按键，则添加一个宽度较大的数字0和一个额外按键
+    keys.push({ text: 0, wider: true }, { text: extraKeys[0], type: 'extra' })
+  } else if (extraKeys.length === 2) {
+    // 如果有两个额外按键，则添加两个额外按键和一个数字0
+    keys.push({ text: extraKeys[0], type: 'extra' }, { text: 0 }, { text: extraKeys[1], type: 'extra' })
+  }
+
+  return keys
+}
+
+/**
+ * 生成车牌键盘按键
+ * @returns {Key[]} 车牌键盘按键数组
+ */
+function genCarKeys(): Array<Key> {
+  const [keys, remainKeys] = splitCarKeys()
+  return [
+    ...keys,
+    { text: carKeyboardLang.value === 'zh' ? 'ABC' : '省份', type: 'extra', wider: true },
+    ...remainKeys,
+    { text: props.deleteText, type: 'delete', wider: true }
+  ]
+}
+
+/**
+ * 分割车牌键盘按键
+ * @returns {Array<Array<Key>>} 分割后的按键数组
+ */
+function splitCarKeys(): Array<Array<Key>> {
+  const keys = carKeyboardLang.value === 'zh' ? CAR_KEYBOARD_AREAS.map((key) => ({ text: key })) : CAR_KEYBOARD_KEYS.map((key) => ({ text: key }))
+  return [keys.slice(0, 30), keys.slice(30)]
+}
+
+/**
+ * 处理关闭事件
+ */
+const handleClose = () => {
+  emit('close')
+  emit('update:visible', false)
+}
+
+/**
+ * 处理按键点击事件
+ * @param {string} text 按键文本
+ * @param {NumberKeyType} type 按键类型
+ */
+const handlePress = (text: string, type: NumberKeyType) => {
+  if (type === 'extra') {
+    if (text === '') {
+      return handleClose()
+    } else if (text === 'ABC' || text === '省份') {
+      const newLang = carKeyboardLang.value === 'zh' ? 'en' : 'zh'
+      if (props.carLang) {
+        emit('update:carLang', newLang)
+      } else {
+        carKeyboardLang.value = newLang
+      }
+      return
+    }
+  }
+
+  const value = props.modelValue
+  if (type === 'delete') {
+    emit('delete')
+    const newValue = value.slice(0, value.length - 1)
+    emit('update:modelValue', newValue)
+    if (props.mode === 'car' && newValue.length === 0 && props.autoSwitchLang) {
+      carKeyboardLang.value = 'zh'
+    }
+  } else if (type === 'close') {
+    handleClose()
+  } else if (value.length < +props.maxlength) {
+    emit('input', text)
+    const newValue = value + text
+    emit('update:modelValue', newValue)
+    if (props.mode === 'car' && newValue.length === 1 && props.autoSwitchLang) {
+      // 输入第一位（省份）后，自动切换到英文
+      carKeyboardLang.value = 'en'
+    }
+  }
+}
+</script>
+
+<style lang="scss">
+@use './index.scss';
+</style>