From a96c6c210950062f8135fe116eed5899d1aedbd9 Mon Sep 17 00:00:00 2001
From: roger_home_pc <roger_sun@outlook.com>
Date: Sun, 17 Sep 2023 14:27:48 +0800
Subject: [PATCH] =?UTF-8?q?=E7=BB=84=E4=BB=B6=E5=AD=A6=E4=B9=A0=EF=BC=9A?=
 =?UTF-8?q?=E5=9F=BA=E6=9C=AC=E7=9F=A5=E8=AF=86=EF=BC=8C=E9=80=89=E9=A1=B9?=
 =?UTF-8?q?=E5=BC=8FAPI&=E7=BB=84=E5=90=88=E5=BC=8FAPI=EF=BC=8C=E7=BB=84?=
 =?UTF-8?q?=E4=BB=B6=E9=80=9A=E4=BF=A1=20props=EF=BC=8C=E7=BB=84=E4=BB=B6?=
 =?UTF-8?q?=E9=80=9A=E4=BF=A1=20$emit?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 demo/component-api/App.vue                    | 29 ++++++++++
 .../components/ChildComponentA.vue            | 42 ++++++++++++++
 .../components/ChildComponentB.vue            | 45 ++++++++++++++
 .../components/ChildComponentC.vue            | 36 ++++++++++++
 demo/component-emit/App.vue                   | 38 ++++++++++++
 .../components/ChildComponentA.vue            | 38 ++++++++++++
 demo/component-props/App.vue                  | 24 ++++++++
 .../components/ChildComponentA.vue            | 33 +++++++++++
 src/App-org.vue                               | 26 ---------
 src/App.vue                                   | 46 +++++++--------
 src/components/ChildComponentA.vue            | 38 ++++++++++++
 src/components/HelloWorld.vue                 | 58 -------------------
 src/main-org.js                               |  8 ---
 vue.config.js                                 |  3 +-
 14 files changed, 345 insertions(+), 119 deletions(-)
 create mode 100644 demo/component-api/App.vue
 create mode 100644 demo/component-api/components/ChildComponentA.vue
 create mode 100644 demo/component-api/components/ChildComponentB.vue
 create mode 100644 demo/component-api/components/ChildComponentC.vue
 create mode 100644 demo/component-emit/App.vue
 create mode 100644 demo/component-emit/components/ChildComponentA.vue
 create mode 100644 demo/component-props/App.vue
 create mode 100644 demo/component-props/components/ChildComponentA.vue
 delete mode 100644 src/App-org.vue
 create mode 100644 src/components/ChildComponentA.vue
 delete mode 100644 src/components/HelloWorld.vue
 delete mode 100644 src/main-org.js

diff --git a/demo/component-api/App.vue b/demo/component-api/App.vue
new file mode 100644
index 0000000..e1453b5
--- /dev/null
+++ b/demo/component-api/App.vue
@@ -0,0 +1,29 @@
+<template>
+  <!-- 第三步使用 -->
+  <ChildComponentA :name="name1"></ChildComponentA>
+  <ChildComponentB :name="name2"></ChildComponentB>
+  <ChildComponentC :name="name3"></ChildComponentC>
+</template>
+
+<script>
+// 第一步 import
+import ChildComponentA from "@/components/ChildComponentA.vue";
+import ChildComponentB from "@/components/ChildComponentB.vue";
+import ChildComponentC from "@/components/ChildComponentC.vue";
+
+export default {
+  // 第二步 注册
+  components: {ChildComponentA, ChildComponentB, ChildComponentC},
+  data() {
+    return {
+      name1: "组件A名称",
+      name2: "组件B名称",
+      name3: "组件C名称"
+    }
+  }
+}
+</script>
+
+<style scoped>
+
+</style>
diff --git a/demo/component-api/components/ChildComponentA.vue b/demo/component-api/components/ChildComponentA.vue
new file mode 100644
index 0000000..09d6acc
--- /dev/null
+++ b/demo/component-api/components/ChildComponentA.vue
@@ -0,0 +1,42 @@
+<template>
+  <div>{{ name }}: {{ counter }} {{ obj.title }}</div>
+  <div>{{ twiceTheCounter }}</div>
+  <button @click="action">点击</button>
+</template>
+
+<script>
+export default {
+  props: {
+    name: String
+  },
+  data() {
+    return {
+      counter: 0,
+      obj: {title: "组件A标题"}
+    }
+  },
+  computed: {
+    twiceTheCounter() {
+      return this.counter * 2
+    }
+  },
+  watch: {
+    counter(newValue, oldValue) {
+      console.log(newValue, oldValue);
+      this.obj.title = "组件A标题---新"
+    }
+  },
+  methods: {
+    action() {
+      this.counter = this.counter + 3;
+    }
+  },
+  mounted() {
+    console.log('mounted')
+  }
+}
+</script>
+
+<style scoped>
+
+</style>
diff --git a/demo/component-api/components/ChildComponentB.vue b/demo/component-api/components/ChildComponentB.vue
new file mode 100644
index 0000000..e4a9b2d
--- /dev/null
+++ b/demo/component-api/components/ChildComponentB.vue
@@ -0,0 +1,45 @@
+<template>
+  <div>{{ name }}: {{ counter }} {{ obj.title }}</div>
+  <div>{{ twiceTheCounter }}</div>
+  <button @click="action">点击</button>
+</template>
+
+<script>
+import {ref, reactive, onMounted, watch, computed} from "vue";
+
+export default {
+  props: {
+    name: String,
+  },
+
+  setup() {
+    // data
+    const counter = ref(0);
+    const obj = reactive({title: "组件B标题"});
+    // computed
+    const twiceTheCounter = computed(() => counter.value * 2);
+    // watch
+    watch(counter, (newValue, oldValue) => {
+      console.log(newValue, oldValue);
+      obj.title = "组件B标题---新"
+    });
+    // methods
+    const action = () => {
+      counter.value = counter.value + 3;
+    };
+    // hook
+    onMounted(() => console.log("onMounted"));
+
+    return {
+      counter,
+      obj,
+      twiceTheCounter,
+      action
+    };
+  }
+};
+</script>
+
+<style scoped>
+
+</style>
diff --git a/demo/component-api/components/ChildComponentC.vue b/demo/component-api/components/ChildComponentC.vue
new file mode 100644
index 0000000..ab4225c
--- /dev/null
+++ b/demo/component-api/components/ChildComponentC.vue
@@ -0,0 +1,36 @@
+<template>
+  <div>{{ name }}: {{ counter }} {{ obj.title }}</div>
+  <div>{{ twiceTheCounter }}</div>
+  <button @click="action">点击</button>
+</template>
+
+<script setup>
+import {ref, reactive, onMounted, watch, computed} from "vue";
+// props
+const props = defineProps({
+  name: String,
+})
+// data
+const counter = ref(0);
+const obj = reactive({title: "组件C标题"});
+// computer
+const twiceTheCounter = computed(() => counter.value * 2);
+// watch
+watch(counter, (newValue, oldValue) => {
+      console.log(newValue, oldValue);
+      obj.title = "组件C标题---新"
+    }
+);
+// methods
+const action = () => {
+  counter.value = counter.value + 3;
+}
+// hook
+onMounted(() => {
+  console.log("onMounted")
+})
+</script>
+
+<style scoped>
+
+</style>
diff --git a/demo/component-emit/App.vue b/demo/component-emit/App.vue
new file mode 100644
index 0000000..a167f21
--- /dev/null
+++ b/demo/component-emit/App.vue
@@ -0,0 +1,38 @@
+<template>
+  <!-- 3. 添加自定义事件selected -->
+  <ChildComponentA title="list—data" :list_data="todos" @selected="onSelected"></ChildComponentA>
+  <div>
+    <h3>您选中了{{ selected_status }}</h3>
+  </div>
+</template>
+
+<script>
+import ChildComponentA from "@/components/ChildComponentA.vue";
+
+export default {
+  components: {ChildComponentA},
+  data() {
+    return {
+      todos: [
+          'todo-1',
+          'todo-2',
+          'todo-3',
+          'todo-4',
+          'todo-5'
+      ],
+      // 1. 定义一个变量，用于接收子组件中回传的数据
+      selected_status: ''
+    }
+  },
+  methods: {
+    // 2. 创建一个方法处理接收到的数据，映射到本地，同时在使用子组件标签时进行事件绑定
+    onSelected(item) {
+      this.selected_status = item;
+    }
+  }
+}
+</script>
+
+<style scoped>
+
+</style>
diff --git a/demo/component-emit/components/ChildComponentA.vue b/demo/component-emit/components/ChildComponentA.vue
new file mode 100644
index 0000000..2da5514
--- /dev/null
+++ b/demo/component-emit/components/ChildComponentA.vue
@@ -0,0 +1,38 @@
+<template>
+  <h3>{{ title }}</h3>
+  <ul>
+    <!--  触发事件  -->
+    <li v-for="(item, index) in list_data" :key="index" @click="handleClick(item)">{{ index }} - {{ item }}</li>
+  </ul>
+</template>
+
+<script>
+export default {
+  props: {
+    title: String,
+    list_data: {
+      type: Array,
+      default: () => [],
+      required: true,
+      validator: value => {
+        return value.length >= 0
+      }
+    }
+  },
+  // 1. 注册自定义事件
+  emits: ['selected'],
+  methods: {
+    // 2. 封装一个本地发法，用于触发$emit, $emit格式为(自定义事件名称，参数)
+    handleClick(item) {
+      this.$emit("selected", item);
+    }
+  },
+  mounted() {
+    console.log(this.list_data)
+  }
+}
+</script>
+
+<style scoped>
+
+</style>
diff --git a/demo/component-props/App.vue b/demo/component-props/App.vue
new file mode 100644
index 0000000..96d3e8f
--- /dev/null
+++ b/demo/component-props/App.vue
@@ -0,0 +1,24 @@
+<template>
+  <!-- 第三步使用 -->
+  <ChildComponentA :parent_param="param" :parent_param_full="param2"></ChildComponentA>
+</template>
+
+<script>
+// 第一步 import
+import ChildComponentA from "@/components/ChildComponentA.vue";
+
+export default {
+  // 第二步 注册
+  components: {ChildComponentA},
+  data() {
+    return {
+      param: "这是父组件传递的参数1",
+      param2: "这是父组件传递的参数2"
+    }
+  }
+}
+</script>
+
+<style scoped>
+
+</style>
diff --git a/demo/component-props/components/ChildComponentA.vue b/demo/component-props/components/ChildComponentA.vue
new file mode 100644
index 0000000..44c34e9
--- /dev/null
+++ b/demo/component-props/components/ChildComponentA.vue
@@ -0,0 +1,33 @@
+<template>
+  <h1>{{parent_param}}</h1>
+  <h2>{{parent_param_full}}</h2>
+  <h3>这是子组件h3标签</h3>
+</template>
+
+<script>
+export default {
+  name: "ChildComponentA",
+  // 基本形式
+  // props: ['parent_param', ]
+  // 增加数据类型
+  props: {
+    parent_param: String,
+    parent_param_full: {
+      type: String,
+      default: "子组件的默认值",
+      // 对象或数组默认值必须从一个工厂函数获取
+      // default: function () {
+      //   return { message: 'hello' }
+      // },
+      required: true,
+      validator: value => {
+        return value.length > 0
+      }
+    }
+  }
+}
+</script>
+
+<style scoped>
+
+</style>
diff --git a/src/App-org.vue b/src/App-org.vue
deleted file mode 100644
index 591a031..0000000
--- a/src/App-org.vue
+++ /dev/null
@@ -1,26 +0,0 @@
-<template>
-  <img alt="Vue logo" src="./assets/logo.png">
-  <HelloWorld msg="Welcome to Your Vue.js App"/>
-</template>
-
-<script>
-import HelloWorld from './components/HelloWorld.vue'
-
-export default {
-  name: 'App',
-  components: {
-    HelloWorld
-  }
-}
-</script>
-
-<style>
-#app {
-  font-family: Avenir, Helvetica, Arial, sans-serif;
-  -webkit-font-smoothing: antialiased;
-  -moz-osx-font-smoothing: grayscale;
-  text-align: center;
-  color: #2c3e50;
-  margin-top: 60px;
-}
-</style>
diff --git a/src/App.vue b/src/App.vue
index 390e7e2..a167f21 100644
--- a/src/App.vue
+++ b/src/App.vue
@@ -1,44 +1,38 @@
 <template>
-  <div>{{ name }}: {{ counter }} {{ obj.title }}</div>
-  <div>{{ twiceTheCounter }}</div>
-  <button @click="action">触发action方法</button>
+  <!-- 3. 添加自定义事件selected -->
+  <ChildComponentA title="list—data" :list_data="todos" @selected="onSelected"></ChildComponentA>
+  <div>
+    <h3>您选中了{{ selected_status }}</h3>
+  </div>
 </template>
 
 <script>
+import ChildComponentA from "@/components/ChildComponentA.vue";
+
 export default {
-  // name: "App",
-  props: {
-    name: String,
-  },
+  components: {ChildComponentA},
   data() {
     return {
-      counter: 0,
-      obj: {title: "标题"}
-    }
-  },
-  computed: {
-    twiceTheCounter() {
-      return this.counter * 2
-    }
-  },
-  watch: {
-    counter(newValue, oldValue) {
-      console.log(newValue, oldValue);
-      this.obj.title = "标题变了"
+      todos: [
+          'todo-1',
+          'todo-2',
+          'todo-3',
+          'todo-4',
+          'todo-5'
+      ],
+      // 1. 定义一个变量，用于接收子组件中回传的数据
+      selected_status: ''
     }
   },
   methods: {
-    action() {
-      this.counter = this.counter + 3;
+    // 2. 创建一个方法处理接收到的数据，映射到本地，同时在使用子组件标签时进行事件绑定
+    onSelected(item) {
+      this.selected_status = item;
     }
-  },
-  mounted() {
-    console.log('mounted')
   }
 }
 </script>
 
-
 <style scoped>
 
 </style>
diff --git a/src/components/ChildComponentA.vue b/src/components/ChildComponentA.vue
new file mode 100644
index 0000000..2da5514
--- /dev/null
+++ b/src/components/ChildComponentA.vue
@@ -0,0 +1,38 @@
+<template>
+  <h3>{{ title }}</h3>
+  <ul>
+    <!--  触发事件  -->
+    <li v-for="(item, index) in list_data" :key="index" @click="handleClick(item)">{{ index }} - {{ item }}</li>
+  </ul>
+</template>
+
+<script>
+export default {
+  props: {
+    title: String,
+    list_data: {
+      type: Array,
+      default: () => [],
+      required: true,
+      validator: value => {
+        return value.length >= 0
+      }
+    }
+  },
+  // 1. 注册自定义事件
+  emits: ['selected'],
+  methods: {
+    // 2. 封装一个本地发法，用于触发$emit, $emit格式为(自定义事件名称，参数)
+    handleClick(item) {
+      this.$emit("selected", item);
+    }
+  },
+  mounted() {
+    console.log(this.list_data)
+  }
+}
+</script>
+
+<style scoped>
+
+</style>
diff --git a/src/components/HelloWorld.vue b/src/components/HelloWorld.vue
deleted file mode 100644
index 879051a..0000000
--- a/src/components/HelloWorld.vue
+++ /dev/null
@@ -1,58 +0,0 @@
-<template>
-  <div class="hello">
-    <h1>{{ msg }}</h1>
-    <p>
-      For a guide and recipes on how to configure / customize this project,<br>
-      check out the
-      <a href="https://cli.vuejs.org" target="_blank" rel="noopener">vue-cli documentation</a>.
-    </p>
-    <h3>Installed CLI Plugins</h3>
-    <ul>
-      <li><a href="https://github.com/vuejs/vue-cli/tree/dev/packages/%40vue/cli-plugin-babel" target="_blank" rel="noopener">babel</a></li>
-      <li><a href="https://github.com/vuejs/vue-cli/tree/dev/packages/%40vue/cli-plugin-eslint" target="_blank" rel="noopener">eslint</a></li>
-    </ul>
-    <h3>Essential Links</h3>
-    <ul>
-      <li><a href="https://vuejs.org" target="_blank" rel="noopener">Core Docs</a></li>
-      <li><a href="https://forum.vuejs.org" target="_blank" rel="noopener">Forum</a></li>
-      <li><a href="https://chat.vuejs.org" target="_blank" rel="noopener">Community Chat</a></li>
-      <li><a href="https://twitter.com/vuejs" target="_blank" rel="noopener">Twitter</a></li>
-      <li><a href="https://news.vuejs.org" target="_blank" rel="noopener">News</a></li>
-    </ul>
-    <h3>Ecosystem</h3>
-    <ul>
-      <li><a href="https://router.vuejs.org" target="_blank" rel="noopener">vue-router</a></li>
-      <li><a href="https://vuex.vuejs.org" target="_blank" rel="noopener">vuex</a></li>
-      <li><a href="https://github.com/vuejs/vue-devtools#vue-devtools" target="_blank" rel="noopener">vue-devtools</a></li>
-      <li><a href="https://vue-loader.vuejs.org" target="_blank" rel="noopener">vue-loader</a></li>
-      <li><a href="https://github.com/vuejs/awesome-vue" target="_blank" rel="noopener">awesome-vue</a></li>
-    </ul>
-  </div>
-</template>
-
-<script>
-export default {
-  name: 'HelloWorld',
-  props: {
-    msg: String
-  }
-}
-</script>
-
-<!-- Add "scoped" attribute to limit CSS to this component only -->
-<style scoped>
-h3 {
-  margin: 40px 0 0;
-}
-ul {
-  list-style-type: none;
-  padding: 0;
-}
-li {
-  display: inline-block;
-  margin: 0 10px;
-}
-a {
-  color: #42b983;
-}
-</style>
diff --git a/src/main-org.js b/src/main-org.js
deleted file mode 100644
index b775cfd..0000000
--- a/src/main-org.js
+++ /dev/null
@@ -1,8 +0,0 @@
-import {createApp} from 'vue'
-import ElementPlus from 'element-plus'  // 完整引入Element-Plus
-import 'element-plus/dist/index.css'  // 引入样式文件
-import App from './App-org.vue'
-
-const app = createApp(App)
-app.use(ElementPlus, {size: 'small', zIndex: 3000})
-app.mount('#app')
diff --git a/vue.config.js b/vue.config.js
index 910e297..6596a0b 100644
--- a/vue.config.js
+++ b/vue.config.js
@@ -1,4 +1,5 @@
 const { defineConfig } = require('@vue/cli-service')
 module.exports = defineConfig({
-  transpileDependencies: true
+  transpileDependencies: true,
+  lintOnSave: false
 })