Vue Academy · Lektion

Vue Macros og community-forslag

vue-macros-biblioteket, eksperimentel defineModel, defineOptions og forslag til setupSFC

Lektion 3 af 413 trin

Vue Macros og community-forslag er en gratis Vue Academy-lektion på CoddyKit. Dette er lektion 3 af 4. Du kan læse alle 3 lektioner i dette læringsspor gratis i deres fulde længde — derefter låser CoddyKit PRO alle lektioner op samt praktiske øvelser med en indbygget kodeeditor og en AI-underviser døgnet rundt. Den er en del af læringsforløbet i Vue Academy, og dine fremskridt synkroniseres på tværs af nettet og CoddyKit-appen. Vue Academy-kurset indeholder 4 lektioner i alt.

Compilermakroer i script setup

I <script setup> tilbyder Vue compilermakroer — funktioner som defineProps og defineEmits, der behandles ved kompilering og ikke importeres under kørsel. Vue 3.4 og nyere versioner tilføjede flere, og communityprojektet vue-macros eksperimenterer med endnu flere.

vue-macros: Et eksperimentelt område

vue-macros er et communitybibliotek, der leverer eksperimentelle makroer før (eller ud over) Vues kerne. Vellykkede idéer bliver sommetider en del af kernen — defineModel startede her, før den blev stabil.

// vite.config
import VueMacros from 'unplugin-vue-macros/vite'
import vue from '@vitejs/plugin-vue'

export default defineConfig({
  plugins: [VueMacros({ plugins: { vue: vue() } })]
})

defineModel: Den gamle metode

Før defineModel krævede implementering af v-model på en komponent, at du erklærede en modelValue-prop og manuelt udsendte update:modelValue — omstændeligt og fejlbehæftet.

<script setup>
const props = defineProps(['modelValue'])
const emit = defineEmits(['update:modelValue'])

function onInput(e) {
  emit('update:modelValue', e.target.value)
}
</script>

defineModel: Stabil i Vue 3.4

defineModel blev stabil i Vue 3.4. Den returnerer en skrivbar ref, som automatisk forbindes med proppen og opdateringshændelsen. Når du læser fra den, får du værdien; når du tildeler en værdi, udsender den opdateringen.

<script setup>
const model = defineModel()
// model.value reads modelValue
// model.value = x emits update:modelValue
</script>

<template>
  <input v-model="model" />
</template>

Navngivet og typeangivet defineModel

defineModel understøtter navngivne modeller (v-model:title) og indstillinger som required samt en type, ligesom defineProps.

<script setup>
const title = defineModel('title', { type: String, required: true })
const count = defineModel('count', { default: 0 })
</script>

Flere v-model-bindinger på en enkel måde

Med navngivne modeller kan en komponent på en enkel måde udstille flere tovejsbindinger — noget, der tidligere krævede mange prop/emit-par.

<!-- parent -->
<UserForm v-model:name="name" v-model:email="email" />

<!-- UserForm script setup -->
<!-- const name = defineModel('name') -->
<!-- const email = defineModel('email') -->

defineOptions

defineOptions (stabil i Vue 3.3) lader dig angive komponentindstillinger som name og inheritAttrs direkte i <script setup>, så du ikke længere behøver en ekstra <script>-blok.

<script setup>
defineOptions({
  name: 'UserCard',
  inheritAttrs: false
})
</script>

Hvorfor name og inheritAttrs er vigtige

En komponents name hjælper med devtools, rekursion og include/exclude i <KeepAlive>. inheritAttrs: false stopper automatisk videregivelse af attributter, så du kan placere attrs på et bestemt indre element via v-bind="$attrs".

<script setup>
defineOptions({ inheritAttrs: false })
</script>

<template>
  <div class="wrapper">
    <input v-bind="$attrs" />
  </div>
</template>

Andre bemærkelsesværdige makroer

Vue tilbyder også defineExpose (styrer, hvad en overordnet komponents ref kan tilgå), defineSlots (angiver typer for slots) og withDefaults (standardværdier for typebaserede props). Når du kender disse, har du et komplet <script setup>-værktøjssæt.

<script setup lang="ts">
const props = withDefaults(
  defineProps<{ size?: 'sm' | 'lg' }>(),
  { size: 'sm' }
)
defineExpose({ focus })
</script>

Eksperimentelle eller stabile: Vælg med omtanke

Stabile makroer i kernen (defineModel og defineOptions) er sikre til produktion. Eksperimenter i vue-macros er nyttige til prototyper og tidlig indførelse, men API'er kan ændre sig — afskærm dem omhyggeligt i apps, der skal i produktion.

Følg forslag fra fællesskabet

Nye idéer dukker op som RFC'er og i vue-macros. Hvis du følger dem, kan du forudse, hvilken retning frameworket bevæger sig i — og komme med tilbagemeldinger, før funktionerne bliver stabile.

Hurtig kontrol

Test din forståelse af Vue-makroer.

Opsummering

Du har lært om makroer og forslag:

  • vue-macros indeholder eksperimentelle makroer; nogle bliver en del af kernen
  • defineModel (stabil i 3.4) forenkler komponenters v-model
  • Navngivne og typeangivne modeller muliggør flere enkle tovejsbindinger
  • defineOptions angiver name og inheritAttrs i <script setup>
  • Foretræk stabile makroer i produktion, og håndter eksperimenter med omtanke
Gratis at komme i gang

Lær HTML med en AI-underviser — gratis

Skriv og kør rigtig kode i din browser, få øjeblikkelig hjælp fra en AI-underviser døgnet rundt, og fortsæt, hvor du slap, på web eller i appen.

Kurser
42
Lektioner
156

Ofte stillede spørgsmål

Er lektionen “Vue Macros og community-forslag” gratis?

Ja — alle 3 lektioner i læringssporet Vue Academy, inklusive “Vue Macros og community-forslag”, kan læses gratis i deres fulde længde her på webstedet. Derefter låser CoddyKit PRO alle lektioner op samt interaktive øvelser med en indbygget kodeeditor og en AI-underviser døgnet rundt. Vue Academy-kurset indeholder 4 lektioner i alt.

Hvad lærer jeg i “Vue Macros og community-forslag”?

vue-macros-biblioteket, eksperimentel defineModel, defineOptions og forslag til setupSFC Du øver dig i Vue Academy med praktisk kode, som du kører direkte i browseren, og en AI-vejleder døgnet rundt besvarer dine spørgsmål, mens du arbejder dig gennem lektionen.

Skal jeg have erfaring for at begynde på Vue Academy?

Der kræves ingen tidligere erfaring. Vue Academy på CoddyKit er tilrettelagt for både begyndere og øvede, så du kan starte her eller fra begyndelsen og lære i dit eget tempo. Dette er lektion 3 af 4.

Hvor lang tid tager lektionen “Vue Macros og community-forslag”?

De fleste CoddyKit-lektioner tager cirka 5–10 minutter. Hver lektion er kort og interaktiv, så du gør løbende fremskridt og kan fortsætte, hvor du slap – på både web og app.

Kan jeg skrive og køre kode i denne Vue Academy-lektion?

Ja. Alle Vue Academy-lektioner har en indbygget kodeeditor, så du kan skrive og køre rigtig kode direkte i din browser og få øjeblikkelig feedback fra AI – uden lokal opsætning.

Alle lektioner i dette kursus

  1. Vue Vapor Mode: Optimering ved kompilering
  2. Vite-økosystemet: Plugins og værktøjer
  3. Vue Macros og community-forslag
  4. Valg af den rette Vue-stack til 2025+
← Tilbage til Vue Academy