Vue3解决definedProps无法引入外部Typescript类型定义
2023-01-21 1392 vue typescript
之前项目中使用到Typescript+Vue3,封装组件过程中发现definedProps无法使用外部引入的类型定义,因为时间关系当时没有仔细研究。
今天再次遇到此问题,于是花了些时间研究了一番:
下面这种情况可以成功编译的。
<script setup lang="ts"> interface IProps {/* 一些类型定义*/} const props = defineProps<IProps>(); </script>
但如果将类型定义抽取出来则会报错编译失败。
<script setup lang="ts"> import {IProps} from './types' const props = defineProps<IProps>(); </script>
因为Vue SFC组件仅编译组件所在文件,无法分析到外部引入的类型定义。
关于该问题的讨论可以参考:issue
之后找到一个vite库可以解决该问题:详情
本人测试不知道什么原因没有成功,于是另寻出路,终于在element plus源码中找到一个不错的解决方案。
element plus没有使用类型声明的方式定义props,而是使用传统的运行时声明方式定义props:
import type { PropType, ExtractPropTypes } from 'vue'; export const fooProps = { status: { type: String as PropType<'on' | 'off'>, required: true, }, }; export type FooProps = ExtractPropTypes<typeof fooProps >;
说明:
status是字面量类型,需要使用vue提供的PropType支持
ExtractPropTypes作用是将props的类型定义抽取出来供外部使用
<script setup lang="ts"> import {fooProps} from './common' const props = defineProps(fooProps); </script>
至此成功地将props的类型抽取出来了,但仍有一个小问题。
status的类型推导成可选的了,而我们需要是必选的,下面我们再修改一下:
// ... export const fooProps = { status: { type: String as PropType<'on' | 'off'>, required: true, default: null, }, }; // ...
至此status的类型推导变成必选的了。
总结
类型声明方式定义defineProps目前仅支持将props类型定义到组件所在文件中
运行时声明方式定义defineProps体验较好些,但需要配合PropType和ExtractPropTypes使用’
如果不需要将props类型抽取出来,则两种方式都可以。