Vue3組件(一)做個組件嘗嘗鮮

.vue文件的分類

在工程化項目里面,默認會設置views和components這兩個文件夾,而兩個文件夾里面放的又都是.vue文件,既然是同類型的文件,為啥要設置兩個文件夾呢?因為用途有點區別。

按照使用方式,.vue文件可以分為頁面、組件和控件三類。

頁面

一般存放在views目錄里面,一開始我還以為這里的.vue文件不需要屬性(props)呢,因為沒有誰能給他傳遞屬性值。
后來學習路由知識后發現我錯了,路由不僅可以加載組件,而且還能給組件傳遞屬性。

這樣.vue文件不管在哪,都可以有屬性(props),那么從代碼角度,就沒有明確的區分了。

所以只能從使用方式來區分一下。

頁面可以看做是路由直接加載的組件,作為一個“容器”,存放多個組件,確定其位置,負責各個組件之間的連系。

組件

導航、header、footer這類多個頁面共用的部分,或者功能比較獨立的部分。
從頁面里面分離出來,可以讓代碼更清晰易讀,擴展性和維護性也會更好。
比如我要改個導航,直接去找導航組件就好,不用怕誤改了其他代碼。

其他組件里面也不會看到共用組件里的代碼,指定位置就好。可以把重點放在自己的邏輯上面來。

控件

簡單的說,就是UI庫提供的各種控件,比如表單里的文本框、選擇列表框、日期選擇控件等,還有表單控件、列表控件、分頁控件等。

雖然在vue里面,這些都是組件的形式出現,但是還是可以細分、明確一下,這樣不容易產生誤解。

本系列主要說的是控件這一類的組件。

我們先用一個簡單的文本框來舉個例子。

定義組件

 <template>
  <input
    :value="modelValue"
    @input="myInput"
  ><br>
  組件內部值:{{modelValue}}
</template>

<script>
import { toRef, toRefs, watch } from 'vue'

export default {
  name: 'mytext',
  props: {
    modelValue: String,
    meta: Object
  },
  emits: ['input'],
  setup (props, context) {
    // 向父組件提交修改屬性
    const myInput = (e) => {
      console.log(e)
      context.emit('update:modelValue', e.target.value)
    }

    return {
      myInput
    }
  }
}
</script>
  • template:模板部分,寫html代碼和vue的綁定語句。
  • script:js腳本部分。
  • style:可以寫css。
  • export default:返回一個對象,用于創建組件。
  • name :組件名稱,可以不寫這個屬性,但是如果要寫的話,就不要重名。
  • props:定義組件的屬性。
  • emits:定義組件的事件。
  • setup:vue3的新寫法。雖然vue3也兼容vue2的方式,但是我們都用上vue3了,那么盡量用新的方式。

父組件里面使用組件

<template>
  <div class="home">
    父組件的值:{{value}}<br>
    自己的組件:<mytext v-model="value"/><br>
    原生文本框:<input type="text" v-model="value"/>
  </div>
</template>

<script>
import { ref } from 'vue'
import mytext from '@/components/nf-html/input-text2.vue'

export default {
  name: 'eleBase',
  components: {
    mytext
  },
  setup () {
    const value = ref('1')

    return {
      value
    }
  }
}
</script>
  • import
    可以用 import 的方式引入組件。

  • components
    如果組件沒有做全局注冊的話,那么需要使用 components 在父組件里面注冊。

setup 的參數

setup提供兩個參數,一個是props,傳遞組件的屬性;一個是context(上下文),提供emit這類的方法。

props

在 setup 里面可以通過 props 訪問組件的屬性,但是請注意:原則上是不允許在組件內部直接修改屬性值的。所以一般可以使用 watch 的方式來監控屬性的變化。
但是如果我就是想訪問屬性呢,結果會如何?
我們可以設計幾個方式來看看效果:

    const myProps1 = props // 獲取屬性
    const myProps = toRefs(props) // toRefs的方式獲取屬性
    const myValue = toRef(props, 'modelValue') // toRef獲取指定的屬性
    console.log('原生屬性:', props)
    console.log('toRefs的屬性:', myProps)
    console.log('toRef 的屬性:', myValue)
    console.log('myProps.modelValue:', myProps.modelValue)

    // 直接修改,會報錯(ESLint)
    // props.modelValue = '直接改屬性'

    // 嘗試修改,雖然只有警告不會報錯,但是修改不會成功。
    myProps1.modelValue = '內部直接修改'

    // 嘗試修改,雖然只有警告不會報錯,但是修改不會成功。
    myValue.value = '內部修改屬性'

    // 監控屬性變化
    watch(() => props.modelValue, (v1, v2) => {
      console.log('原值:', v1)
      console.log('新值:', v2)
    })
  • 屬性的打印結果


    002setup-propsKind.png

    從打印結果可以看出來,組件的屬性被封裝成了reactive的形式,然后又在外面套上了readonly,所以實現了無法直接賦值的效果。

注意:不能修改只是對簡單類型有效,如果屬性是對象類型的話,還是可以直接修改屬性值的。

  • 嘗試直接賦值。
    以前嘗試直接賦值的時候會報錯,現在雖然不報錯了,但是無法修改,而且會給出警告,如圖:


    002setup-props1.png
  • toRefs 和 toRef


    003setup-propsTorefs.png

toRefs可以把屬性拆分成多個ref的形式,嘗試了一下,如果屬性是簡單類型,還是不可以直接修改值的。但是如果屬性類型是對象的話,又可以直接修改值了。

toRef也是一樣的效果。

context

我們來看一看context的打印結果:


001setup-context.png

比較常用的就是emit,相當于vue2的this.emit。

我們可以寫一個向父組件提交屬性的函數

   // 向父組件提交修改屬性
    const myInput = (e) => {
      console.log(e)
      context.emit('update:modelValue', e.target.value)
    }
  • update:modelValue
    這是修改父組件的屬性的一種方法,后面是要修改的值。

v-model

vue3支持多個v-model了。父組件可以這樣寫:

v-model:foo="foo" v-model:fo="fo" 

如果只需要一個屬性的話,也可以簡寫

v-model="fooo"

只是組件內部的屬性名稱要寫成固定的“modelValue”,如果是其他屬性名稱的話,必須用帶冒號的方式。

小結

這個只是一個開篇,介紹基礎知識,后面還有更精彩的內容。

源碼:

https://github.com/naturefwvue/nf-vue-element

?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 230,431評論 6 544
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 99,637評論 3 429
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 178,555評論 0 383
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,900評論 1 318
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 72,629評論 6 412
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 55,976評論 1 328
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,976評論 3 448
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 43,139評論 0 290
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 49,686評論 1 336
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 41,411評論 3 358
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 43,641評論 1 374
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 39,129評論 5 364
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,820評論 3 350
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 35,233評論 0 28
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 36,567評論 1 295
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 52,362評論 3 400
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 48,604評論 2 380

推薦閱讀更多精彩內容