nutui-uniapp/components/cascader/cascader.ts

京东风格的轻量级移动端 Uniapp、Vue3 组件库（支持小程序开发）

import type { ExtractPropTypes, PropType, StyleValue } from 'vue'
import {
  CHANGE_EVENT,
  CLOSE_EVENT,
  CLOSED_EVENT,
  OPEN_EVENT,
  OPENED_EVENT,
  UPDATE_MODEL_EVENT,
  UPDATE_VISIBLE_EVENT,
} from '../_constants'
import { commonProps, makeArrayProp, makeNumericProp, makeStringProp, truthProp } from '../_utils'
import { popupProps } from '../popup/popup'
import type { CascaderOption, CascaderValue } from './types'

export const cascaderProps = {
  ...popupProps,
  ...commonProps,
  /**
   * @description 选中值，双向绑定
   */
  modelValue: Array,
  /**
   * @description 显示选择层
   */
  visible: Boolean,
  /**
   * @description 级联数据
   */
  options: makeArrayProp<any>([]),
  /**
   * @description 是否开启动态加载
   */
  lazy: Boolean,
  /**
   * @description 动态加载回调，开启动态加载时生效
   */
  lazyLoad: Function,
  /**
   * @description 自定义 `options` 结构中 `value` 的字段
   */
  valueKey: makeStringProp('value'),
  /**
   * @description 自定义 `options` 结构中 `text` 的字段
   */
  textKey: makeStringProp('text'),
  /**
   * @description 自定义 `options` 结构中 `children` 的字段
   */
  childrenKey: makeStringProp('children'),
  /**
   * @description 当 `options` 为可转换为树形结构的扁平结构时，配置转换规则
   */
  convertConfig: Object,
  /**
   * @description 是否需要弹层展示（设置为 `false` 后，`title` 失效）
   */
  poppable: truthProp,
  /**
   * @description 标题
   */
  title: String,
  /**
   * @description 选中底部展示样式 可选值: 'line', 'smile'
   */
  titleType: makeStringProp<'line' | 'card' | 'smile'>('line'),
  /**
   * @description 标签栏字体尺寸大小 可选值: 'large', 'normal', 'small'
   */
  titleSize: makeStringProp<'large' | 'normal' | 'small'>('normal'),
  /**
   * @description 标签间隙
   */
  titleGutter: makeNumericProp(0),
  /**
   * @description 是否省略过长的标题文字
   */
  titleEllipsis: truthProp,
  /**
   * @description 自定义弹窗样式
   */
  popStyle: {
    type: [String, Object, Array] as PropType<StyleValue>,
    default: '',
  },
  /**
   * @description 遮罩显示时的背景是否锁定
   */
  lockScroll: truthProp,
}

export type CascaderProps = ExtractPropTypes<typeof cascaderProps>

/* eslint-disable unused-imports/no-unused-vars */
export const cascaderEmits = {
  [UPDATE_MODEL_EVENT]: (value: CascaderValue) => true,
  [UPDATE_VISIBLE_EVENT]: (value: boolean) => true,
  [CHANGE_EVENT]: (value: CascaderValue, nodes: CascaderOption[]) => true,
  pathChange: (nodes: CascaderOption[]) => true,
  [OPEN_EVENT]: () => true,
  [OPENED_EVENT]: () => true,
  [CLOSE_EVENT]: () => true,
  [CLOSED_EVENT]: () => true,
}
/* eslint-enable unused-imports/no-unused-vars */

export type CascaderEmits = typeof cascaderEmits