Vue 中组件命名与引用

Vue 中组件命名与引用

前言

在 vue 项目中,我们会发现在代码中,import 组件 和 components 组件注册中得命名方式与组件引用时的命名方式不一样,这种现象是由组件名的大小写转换规则造成的。如下示例:

组件引入与注册:

javascript 复制代码
// 导入组件(使用大驼峰命名)
import UserChoose from "../components/user";

export default {
  components: {
    UserChoose // 注册组件(大驼峰命名)
  }
}

组件引用:

html 复制代码
<!-- 在模板中使用组件(短横线命名) -->
<user-choose></user-choose>

Vue 支持两种组件命名方式

1、PascalCase(大驼峰命名)

像 UserChoose 这样,每个单词首字母大写。在 JavaScript 里定义组件或者导入组件时,通常会采用这种命名方式。

2、kebab-case(短横线分隔命名)

例如 user-choose,单词之间用短横线分隔。在 Vue 模板的 HTML 标签里引用组件时,需要使用这种命名方式。

Vue 之所以要进行这种转换,是为了适配 HTML 对大小写不敏感的特性。当你在模板里使用短横线命名的组件时,Vue 会自动将其映射为对应的大驼峰命名的组件。

也可以选择在模板中直接使用大驼峰命名,但必须保证处于原生 HTML 支持大写标签的环境中,比如单文件组件(SFC)。不过,为了保证代码风格的一致性,建议统一使用短横线命名。

javascript 复制代码
<!-- 这种写法仅在SFC中有效 -->
<UserChoose></UserChoose>

推荐写法

html 复制代码
<!-- 推荐:统一使用 kebab-case -->
<template>
  <div>
    <occupation-choose />
  </div>
</template>

<script>
import UserChoose from './components/user.vue'

export default {
  components: {
    'user-choose': UserChoose // 与模板一致
  }
}
</script>

单文件组件(SFC)

1、什么是单文件组件(SFC)

单文件组件(Single-File Component,SFC)是 Vue.js 特有的一种文件格式,也被称为.vue文件。它把一个 Vue 组件的模板(template)、 逻辑(script)和样式(style) 封装在同一个文件里,形成一个独立的组件单元。这种设计让组件具有很强的内聚性和可维护性,是 Vue 项目的核心组织方式。

2、单文件组件(.vue)的结构

html 复制代码
<template>
  <!-- 组件的HTML结构 -->
  <div class="hello-world">
    <h1>{{ message }}</h1>
    <button @click="greet">Say Hello</button>
  </div>
</template>

<script>
// 组件的JavaScript逻辑
export default {
  data() {
    return {
      message: 'Hello, Vue!'
    }
  },
  methods: {
    greet() {
      this.message = 'Hello from Vue SFC!'
    }
  }
}
</script>

<style scoped>
/* 组件的CSS样式,scoped表示样式只作用于当前组件 */
.hello-world {
  padding: 20px;
  text-align: center;
}
button {
  background-color: #42b983;
  color: white;
  border: none;
  padding: 8px 16px;
  cursor: pointer;
}
</style>
相关推荐
北城笑笑1 小时前
Vue 110 ,若依SSE流式接口限次空500排查与解决
前端·javascript·vue.js·后端·vue
Patrick_Wilson2 小时前
构建通过了,为什么有些浏览器还会白屏?
前端·javascript·浏览器
cpolar技术支持2 小时前
把 agent-autoloop 装在 Mac 上:用本机 Node 实跑一次「接活—提问—拍板—接着干」,再用 cpolar 把它的状态页开给不在工位的自己
node.js·内网穿透·cpolar·ai agent·agent-autoloop
AI前端工程狮4 小时前
我把 MCP 长任务拆成三个工具,token 账单涨了 7 倍
javascript·人工智能·程序员
mONESY4 小时前
DeepAgents 从零上手:别再手搓 Harness,用中间件拼出一个调研团队
javascript
吴长建先生重名了5 小时前
一次线上MySQL慢查询Bug的复现与调优全过程
javascript
LVZ6 小时前
AI Agent 缺的不是更强的模型,而是一个运行时
前端·javascript·后端
1-1=07 小时前
Vue 中 Class 与 Style 绑定
前端·javascript·vue.js
闲来没事抠鼻屎7 小时前
Web打印批量出单:vue-print-designer 千页实测
vue.js
用户83134859306987 小时前
Vue3的v-if /v-show/v-else /v-else-if:区别、渲染原理、坑点与性能选型
前端·javascript·vue.js