基础
在 Qingkuai 中,组件是构建用户界面的基本单位。每个组件都代表一个独立、可复用的界面片段,既可以是简单的按钮,也可以是复杂的页面。组件天然具有封装性和组合性,使界面开发更加清晰、高效。
定义及使用
Qingkuai 的组件定义采取了与 Vue 和 Svelte 相同的方式,即文件级组件定义。每个组件都定义在一个扩展名为 .qk 的文件中,经编译器处理后,该文件会被转换为一个具有 默认导出的 JavaScript 模块。
假设我们已经通过 Component.qk 文件定义了一个组件,在其他组件文件中,可以通过 import 语法 导入,并在模板部分添加与导入标识符名称相同的标签来重复使用它:
qk
<lang-js>
import Component from "./path/to/Component.qk"
</lang-js>
<Component />
<Component />
之后我们都用
组件文件 这一术语指代扩展名为 .qk 的文件。组件名称支持使用串型(kebab)格式,下面的写法是等效的:
qk
<MyComponent />
<my-component />
默认情况下,格式化组件文件时会将所有组件名称整理为驼峰格式,但你可以在组件文件所在目录或其上级目录中添加 .prettierrc 文件,并输入以下内容将组件名称偏好修改为 kebab 格式:
json
{
"qingkuai": {
"componentTagFormatPreference": "kebab"
}
}
使用此配置时,Qingkuai 语言服务器在提供组件标签补全建议时,也会优先提示串型组件标签。