@hbdlzy/ui-core 0.1.1 → 0.1.3

package/src/components/OutlinedDateTimePicker/OutlinedDateTimePicker.vue

@@ -0,0 +1,421 @@
+<template>
+  <div
+    class="outlined-date-time-picker"
+    :class="[rootClass]"
+    :style="rootStyle"
+  >
+    <div
+      class="outlined-date-time-picker__field"
+      :class="fieldClasses"
+      :style="fieldStyle"
+    >
+      <el-date-picker
+        ref="datePickerRef"
+        class="outlined-date-time-picker__control"
+        :model-value="dateValue"
+        type="date"
+        format="YYYY-MM-DD"
+        value-format="YYYY-MM-DD"
+        :placeholder="placeholder"
+        :clearable="clearable"
+        :disabled-date="resolvedDisabledDate"
+        :style="controlStyle"
+        @update:model-value="handleDateUpdate"
+        @focus="handleFocus('date')"
+        @blur="handleBlur('date', $event)"
+        @change="handleDateChange"
+        @visible-change="handleVisibleChange('date', $event)"
+      />
+
+      <div
+        v-if="floatingLabel"
+        class="outlined-date-time-picker__label"
+        :class="dateLabelClasses"
+      >
+        {{ floatingLabel }}
+      </div>
+    </div>
+
+    <span class="outlined-date-time-picker__separator">{{ separatorText }}</span>
+
+    <div
+      class="outlined-date-time-picker__field"
+      :class="fieldClasses"
+      :style="fieldStyle"
+    >
+      <el-time-picker
+        ref="timePickerRef"
+        class="outlined-date-time-picker__control"
+        :model-value="timeValue"
+        format="HH:mm"
+        value-format="HH:mm"
+        :placeholder="timePlaceholder"
+        :clearable="clearable"
+        :disabled="!dateValue"
+        :disabled-hours="resolvedDisabledHours"
+        :disabled-minutes="resolvedDisabledMinutes"
+        :style="controlStyle"
+        @update:model-value="handleTimeUpdate"
+        @focus="handleFocus('time')"
+        @blur="handleBlur('time', $event)"
+        @change="handleTimeChange"
+        @visible-change="handleVisibleChange('time', $event)"
+      />
+
+      <div
+        class="outlined-date-time-picker__label"
+        :class="timeLabelClasses"
+      >
+        {{ timePlaceholder }}
+      </div>
+    </div>
+  </div>
+</template>
+
+<script setup lang="ts">
+import { computed, ref, useAttrs, watch } from 'vue'
+import dayjs from 'dayjs'
+import type {
+  OutlinedDateTimePickerCssValue,
+  OutlinedDateTimePickerDisabledDate,
+  OutlinedDateTimePickerExpose,
+  OutlinedDateTimePickerProps,
+  OutlinedDateTimePickerValue
+} from './OutlinedDateTimePicker.types'
+
+defineOptions({
+  name: 'OutlinedDateTimePicker',
+  inheritAttrs: false
+})
+
+const props = withDefaults(defineProps<OutlinedDateTimePickerProps>(), {
+  value: '',
+  placeholder: '',
+  label: '',
+  inputHeight: 40,
+  isBorder: false,
+  disabledDate: undefined,
+  separatorText: '-',
+  timePlaceholder: '时间',
+  clearable: false,
+  marginBottom: 20,
+  paddingTop: 20
+})
+
+const emit = defineEmits<{
+  (event: 'input', value: OutlinedDateTimePickerValue): void
+  (event: 'update:value', value: OutlinedDateTimePickerValue): void
+  (event: 'change', value: OutlinedDateTimePickerValue): void
+  (event: 'focus', payload: { field: 'date' | 'time'; event: FocusEvent }): void
+  (event: 'blur', payload: { field: 'date' | 'time'; event: FocusEvent }): void
+  (event: 'visible-change', payload: { field: 'date' | 'time'; visible: boolean }): void
+}>()
+
+const attrs = useAttrs()
+const datePickerRef = ref<any>(null)
+const timePickerRef = ref<any>(null)
+const dateValue = ref<string | null>(null)
+const timeValue = ref<string | null>(null)
+const dateFocused = ref(false)
+const timeFocused = ref(false)
+const dateBlurred = ref(false)
+const timeBlurred = ref(false)
+const dateVisible = ref(false)
+const timeVisible = ref(false)
+
+watch(
+  () => props.value,
+  (value) => {
+    syncFromValue(value)
+  },
+  { immediate: true }
+)
+
+const rootClass = computed(() => attrs.class)
+const rootStyle = computed(() => attrs.style)
+const floatingLabel = computed(() => props.label || props.placeholder || '')
+
+const fieldClasses = computed(() => ({
+  'outlined-date-time-picker__field--bordered': props.isBorder
+}))
+
+const fieldStyle = computed(() => ({
+  marginBottom: toCssValue(props.marginBottom),
+  paddingTop: toCssValue(props.paddingTop)
+}))
+
+const controlStyle = computed(() => ({
+  height: `${props.inputHeight}px`
+}))
+
+const resolvedDisabledDate = computed(() => createDisabledDateHandler(props.disabledDate))
+
+const resolvedDisabledHours = computed(() => {
+  if (!shouldLimitCurrentTime()) {
+    return undefined
+  }
+
+  return () => {
+    const hours = new Date().getHours()
+    return Array.from({ length: hours }, (_, index) => index)
+  }
+})
+
+const resolvedDisabledMinutes = computed(() => {
+  if (!shouldLimitCurrentTime()) {
+    return undefined
+  }
+
+  return () => {
+    const minutes = new Date().getMinutes()
+    return Array.from({ length: minutes }, (_, index) => index)
+  }
+})
+
+const dateLabelClasses = computed(() => ({
+  'outlined-date-time-picker__label--floating': dateFocused.value || Boolean(dateValue.value),
+  'outlined-date-time-picker__label--placeholder': !dateFocused.value && !dateValue.value,
+  'outlined-date-time-picker__label--filled': Boolean(dateValue.value) && !dateFocused.value
+}))
+
+const timeLabelClasses = computed(() => ({
+  'outlined-date-time-picker__label--floating': timeFocused.value || Boolean(timeValue.value),
+  'outlined-date-time-picker__label--placeholder': !timeFocused.value && !timeValue.value,
+  'outlined-date-time-picker__label--filled': Boolean(timeValue.value) && !timeFocused.value
+}))
+
+function syncFromValue(value: OutlinedDateTimePickerValue) {
+  if (!value) {
+    dateValue.value = null
+    timeValue.value = null
+    return
+  }
+
+  const [datePart, timePart] = value.split(' ')
+  dateValue.value = datePart || null
+  timeValue.value = timePart || null
+}
+
+function handleDateUpdate(value: string | null) {
+  dateValue.value = value || null
+}
+
+function handleTimeUpdate(value: string | null) {
+  timeValue.value = value || null
+}
+
+function handleDateChange() {
+  if (dateValue.value && !timeValue.value) {
+    timeValue.value = dayjs().format('HH:mm')
+  }
+
+  emitCombinedValue()
+}
+
+function handleTimeChange() {
+  emitCombinedValue()
+}
+
+function handleFocus(field: 'date' | 'time') {
+  return (event: FocusEvent) => {
+    if (field === 'date') {
+      dateBlurred.value = false
+      dateFocused.value = true
+    } else {
+      timeBlurred.value = false
+      timeFocused.value = true
+    }
+
+    emit('focus', { field, event })
+  }
+}
+
+function handleBlur(field: 'date' | 'time', event: FocusEvent) {
+  if (field === 'date') {
+    dateBlurred.value = true
+
+    if (!dateVisible.value) {
+      dateFocused.value = false
+      emitCombinedValue()
+    }
+  } else {
+    timeBlurred.value = true
+
+    if (!timeVisible.value) {
+      timeFocused.value = false
+      emitCombinedValue()
+    }
+  }
+
+  emit('blur', { field, event })
+}
+
+function handleVisibleChange(field: 'date' | 'time', visible: boolean) {
+  if (field === 'date') {
+    dateVisible.value = visible
+
+    if (!visible && dateBlurred.value) {
+      dateFocused.value = false
+    }
+  } else {
+    timeVisible.value = visible
+
+    if (!visible && timeBlurred.value) {
+      timeFocused.value = false
+    }
+  }
+
+  emit('visible-change', { field, visible })
+}
+
+function emitCombinedValue() {
+  const value = dateValue.value && timeValue.value ? `${dateValue.value} ${timeValue.value}` : ''
+  emit('input', value)
+  emit('update:value', value)
+  emit('change', value)
+}
+
+function createDisabledDateHandler(disabledDate: OutlinedDateTimePickerDisabledDate | undefined) {
+  if (!disabledDate) {
+    return undefined
+  }
+
+  if (typeof disabledDate === 'function') {
+    return disabledDate
+  }
+
+  const boundary = normalizeBoundary(disabledDate)
+  return (value: Date) => value.getTime() < boundary - 86400000
+}
+
+function normalizeBoundary(value: Exclude<OutlinedDateTimePickerDisabledDate, (date: Date) => boolean>) {
+  if (value === 'nowDate') {
+    return Date.now()
+  }
+
+  if (value instanceof Date) {
+    return value.getTime()
+  }
+
+  if (typeof value === 'number') {
+    return value
+  }
+
+  return new Date(value).getTime()
+}
+
+function shouldLimitCurrentTime() {
+  return Boolean(props.disabledDate) && dateValue.value === dayjs().format('YYYY-MM-DD')
+}
+
+function toCssValue(value: OutlinedDateTimePickerCssValue | undefined) {
+  if (typeof value === 'number') {
+    return `${value}px`
+  }
+
+  return value
+}
+
+defineExpose<OutlinedDateTimePickerExpose>({
+  focusDate: () => {
+    datePickerRef.value?.focus?.()
+  },
+  focusTime: () => {
+    timePickerRef.value?.focus?.()
+  },
+  blurDate: () => {
+    datePickerRef.value?.blur?.()
+  },
+  blurTime: () => {
+    timePickerRef.value?.blur?.()
+  },
+  openDatePanel: () => {
+    datePickerRef.value?.handleOpen?.()
+  },
+  openTimePanel: () => {
+    timePickerRef.value?.handleOpen?.()
+  },
+  getDatePickerRef: () => datePickerRef.value,
+  getTimePickerRef: () => timePickerRef.value
+})
+</script>
+
+<style scoped>
+.outlined-date-time-picker {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+}
+
+.outlined-date-time-picker__field {
+  position: relative;
+  flex: 1;
+}
+
+.outlined-date-time-picker__separator {
+  flex: 0 0 auto;
+  color: var(--el-text-color-regular);
+}
+
+.outlined-date-time-picker__label {
+  position: absolute;
+  left: -2px;
+  padding: 2px 5px;
+  border-radius: 2px;
+  background-color: #ffffff;
+  font-size: 12px;
+  line-height: 1;
+  transition: color 200ms cubic-bezier(0, 0, 0.2, 1), transform 200ms cubic-bezier(0, 0, 0.2, 1);
+  pointer-events: none;
+}
+
+.outlined-date-time-picker__label--floating {
+  top: 18px;
+  z-index: 1;
+  opacity: 1;
+  transform: translate(14px, -6px) scale(1);
+  color: var(--el-color-primary);
+}
+
+.outlined-date-time-picker__label--placeholder {
+  top: 50%;
+  left: 1px;
+  z-index: -1;
+  opacity: 0;
+  transform: translate(14px, 6px) scale(1);
+}
+
+.outlined-date-time-picker__label--filled {
+  color: var(--el-text-color-regular);
+}
+
+:deep(.outlined-date-time-picker__control.el-date-editor) {
+  width: 100%;
+}
+
+:deep(.outlined-date-time-picker__control .el-input__wrapper) {
+  position: relative;
+  min-height: inherit;
+  height: inherit;
+}
+
+:deep(.outlined-date-time-picker__control .el-input__prefix) {
+  position: absolute;
+  right: 0;
+}
+
+:deep(.outlined-date-time-picker__control .el-input__suffix) {
+  position: absolute;
+  right: 30px;
+}
+
+:deep(.outlined-date-time-picker__field--bordered .el-input__wrapper) {
+  box-shadow: none;
+  border-radius: 0;
+  border-bottom: 1px solid #cccccc;
+}
+
+:deep(.outlined-date-time-picker__field--bordered .el-input__wrapper.is-focus) {
+  border-bottom-color: var(--el-color-primary);
+}
+</style>

package/src/components/OutlinedDateTimePicker/OutlinedDateTimePicker.vue.d.ts

@@ -0,0 +1,97 @@
+import type { OutlinedDateTimePickerCssValue, OutlinedDateTimePickerDisabledDate, OutlinedDateTimePickerProps } from './OutlinedDateTimePicker.types';
+declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<OutlinedDateTimePickerProps>, {
+    value: string;
+    placeholder: string;
+    label: string;
+    inputHeight: number;
+    isBorder: boolean;
+    disabledDate: undefined;
+    separatorText: string;
+    timePlaceholder: string;
+    clearable: boolean;
+    marginBottom: number;
+    paddingTop: number;
+}>>, {
+    focusDate: () => void;
+    focusTime: () => void;
+    blurDate: () => void;
+    blurTime: () => void;
+    openDatePanel: () => void;
+    openTimePanel: () => void;
+    getDatePickerRef: () => unknown;
+    getTimePickerRef: () => unknown;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    input: (value: string) => void;
+    "update:value": (value: string) => void;
+    change: (value: string) => void;
+    focus: (payload: {
+        field: "time" | "date";
+        event: FocusEvent;
+    }) => void;
+    blur: (payload: {
+        field: "time" | "date";
+        event: FocusEvent;
+    }) => void;
+    "visible-change": (payload: {
+        field: "time" | "date";
+        visible: boolean;
+    }) => void;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<OutlinedDateTimePickerProps>, {
+    value: string;
+    placeholder: string;
+    label: string;
+    inputHeight: number;
+    isBorder: boolean;
+    disabledDate: undefined;
+    separatorText: string;
+    timePlaceholder: string;
+    clearable: boolean;
+    marginBottom: number;
+    paddingTop: number;
+}>>> & Readonly<{
+    onBlur?: ((payload: {
+        field: "time" | "date";
+        event: FocusEvent;
+    }) => any) | undefined;
+    onChange?: ((value: string) => any) | undefined;
+    onFocus?: ((payload: {
+        field: "time" | "date";
+        event: FocusEvent;
+    }) => any) | undefined;
+    onInput?: ((value: string) => any) | undefined;
+    "onUpdate:value"?: ((value: string) => any) | undefined;
+    "onVisible-change"?: ((payload: {
+        field: "time" | "date";
+        visible: boolean;
+    }) => any) | undefined;
+}>, {
+    label: string;
+    value: string;
+    placeholder: string;
+    clearable: boolean;
+    inputHeight: number;
+    isBorder: boolean;
+    marginBottom: OutlinedDateTimePickerCssValue;
+    paddingTop: OutlinedDateTimePickerCssValue;
+    disabledDate: OutlinedDateTimePickerDisabledDate;
+    separatorText: string;
+    timePlaceholder: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToRuntimeProps<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};
+type __VLS_WithDefaults<P, D> = {
+    [K in keyof Pick<P, keyof P>]: K extends keyof D ? __VLS_Prettify<P[K] & {
+        default: D[K];
+    }> : P[K];
+};
+type __VLS_Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};

package/src/components/OutlinedDateTimePicker/README.md

@@ -0,0 +1,88 @@
+# OutlinedDateTimePicker
+
+`OutlinedDateTimePicker` 是 `OutlinedForm` 系列里的日期时间组合控件，用来统一封装“先选日期，再补时间”的输入壳子、浮动标签、禁用日期规则和实例方法暴露。
+
+## 适用场景
+
+- 页面里经常出现“日期 + 时间”成对输入，但不想每次都重复写两个控件的布局和状态联动
+- 需要统一日期时间输入框的浮动标签风格
+- 需要基于当前日期限制时间可选范围
+- 需要在页面层直接调用日期面板或时间面板的打开方法
+
+## 基本用法
+
+```vue
+<script setup lang="ts">
+import { ref } from 'vue'
+import { OutlinedDateTimePicker, type OutlinedDateTimePickerExpose } from '@hbdlzy/ui'
+
+const pickerRef = ref<OutlinedDateTimePickerExpose | null>(null)
+const executeAt = ref('')
+
+const openDatePanel = () => {
+  pickerRef.value?.openDatePanel()
+}
+</script>
+
+<template>
+  <OutlinedDateTimePicker
+    ref="pickerRef"
+    v-model:value="executeAt"
+    placeholder="执行日期"
+    time-placeholder="执行时间"
+    :is-border="true"
+    :disabled-date="'nowDate'"
+    clearable
+  />
+
+  <el-button @click="openDatePanel">
+    打开日期面板
+  </el-button>
+</template>
+```
+
+## Props
+
+| 属性 | 类型 | 默认值 | 说明 |
+| --- | --- | --- | --- |
+| `value` | `string` | `''` | `v-model:value` 绑定值，格式为 `YYYY-MM-DD HH:mm` |
+| `placeholder` | `string` | `''` | 日期部分占位文案，也会作为浮动标签主文案 |
+| `label` | `string` | `''` | 自定义浮动标签文案，优先级高于 `placeholder` |
+| `inputHeight` | `number` | `40` | 输入框高度 |
+| `isBorder` | `boolean` | `false` | 是否启用下边框风格 |
+| `disabledDate` | `string \| number \| Date \| ((date: Date) => boolean)` | `undefined` | 日期禁用规则，支持 `nowDate` |
+| `separatorText` | `string` | `'-'` | 日期和时间之间的分隔文案 |
+| `timePlaceholder` | `string` | `'时间'` | 时间部分占位文案 |
+| `clearable` | `boolean` | `false` | 是否允许清空 |
+| `marginBottom` | `string \| number` | `20` | 外层下边距 |
+| `paddingTop` | `string \| number` | `20` | 外层上内边距，用于浮动标签留白 |
+
+## Emits
+
+| 事件 | 参数 | 说明 |
+| --- | --- | --- |
+| `input` | `string` | 输入值变化时触发 |
+| `update:value` | `string` | `v-model:value` 同步事件 |
+| `change` | `string` | 日期或时间确认变化后触发 |
+| `focus` | `{ field: 'date' \| 'time'; event: FocusEvent }` | 某一侧输入聚焦时触发 |
+| `blur` | `{ field: 'date' \| 'time'; event: FocusEvent }` | 某一侧输入失焦时触发 |
+| `visible-change` | `{ field: 'date' \| 'time'; visible: boolean }` | 日期面板或时间面板开关变化时触发 |
+
+## Expose
+
+| 方法 | 说明 |
+| --- | --- |
+| `focusDate()` | 聚焦日期输入 |
+| `focusTime()` | 聚焦时间输入 |
+| `blurDate()` | 取消日期输入聚焦 |
+| `blurTime()` | 取消时间输入聚焦 |
+| `openDatePanel()` | 打开日期面板 |
+| `openTimePanel()` | 打开时间面板 |
+| `getDatePickerRef()` | 获取内部 `el-date-picker` 实例 |
+| `getTimePickerRef()` | 获取内部 `el-time-picker` 实例 |
+
+## 设计约束
+
+- 组件内部只处理输入壳子、标签浮层、日期禁用和时间联动，不直接耦合接口、表单校验器或业务规则
+- 如果只选了日期但没有选时间，组件会在日期确认时自动补一个当前 `HH:mm`
+- 页面层如果需要更复杂的日期时间协议，建议继续在外层包业务组件，不要把业务判断塞回 `ui-core`

package/src/components/OutlinedDateTimePicker/index.d.ts

@@ -0,0 +1,3 @@
+import OutlinedDateTimePicker from './OutlinedDateTimePicker.vue';
+export default OutlinedDateTimePicker;
+export type { OutlinedDateTimePickerCssValue, OutlinedDateTimePickerDisabledDate, OutlinedDateTimePickerExpose, OutlinedDateTimePickerProps, OutlinedDateTimePickerValue } from './OutlinedDateTimePicker.types';

package/src/components/OutlinedDateTimePicker/index.ts

@@ -0,0 +1,11 @@
+import OutlinedDateTimePicker from './OutlinedDateTimePicker.vue'
+
+export default OutlinedDateTimePicker
+
+export type {
+  OutlinedDateTimePickerCssValue,
+  OutlinedDateTimePickerDisabledDate,
+  OutlinedDateTimePickerExpose,
+  OutlinedDateTimePickerProps,
+  OutlinedDateTimePickerValue
+} from './OutlinedDateTimePicker.types'

package/src/components/OutlinedInput/OutlinedInput.types.d.ts

@@ -0,0 +1,29 @@
+export type OutlinedInputValue = string | number;
+export type OutlinedInputCssValue = string | number;
+export interface OutlinedInputProps {
+    value?: OutlinedInputValue;
+    disabled?: boolean;
+    regex?: RegExp;
+    placeholder?: string;
+    label?: string;
+    maxlength?: string | number;
+    max?: string | number;
+    min?: string | number;
+    typeInput?: string;
+    showPassword?: boolean;
+    isNumber?: boolean;
+    inputHeight?: number;
+    isBorder?: boolean;
+    suffixText?: string;
+    clearable?: boolean;
+    showWordLimit?: boolean;
+    marginBottom?: OutlinedInputCssValue;
+    paddingTop?: OutlinedInputCssValue;
+}
+export interface OutlinedInputExpose {
+    focus: () => void;
+    blur: () => void;
+    clear: () => void;
+    select: () => void;
+    getInputRef: () => unknown | null;
+}

package/src/components/OutlinedInput/OutlinedInput.types.ts

@@ -0,0 +1,32 @@
+export type OutlinedInputValue = string | number
+
+export type OutlinedInputCssValue = string | number
+
+export interface OutlinedInputProps {
+  value?: OutlinedInputValue
+  disabled?: boolean
+  regex?: RegExp
+  placeholder?: string
+  label?: string
+  maxlength?: string | number
+  max?: string | number
+  min?: string | number
+  typeInput?: string
+  showPassword?: boolean
+  isNumber?: boolean
+  inputHeight?: number
+  isBorder?: boolean
+  suffixText?: string
+  clearable?: boolean
+  showWordLimit?: boolean
+  marginBottom?: OutlinedInputCssValue
+  paddingTop?: OutlinedInputCssValue
+}
+
+export interface OutlinedInputExpose {
+  focus: () => void
+  blur: () => void
+  clear: () => void
+  select: () => void
+  getInputRef: () => unknown | null
+}