0Pricing
Vue Academy · Lektion

Vue Macros und Vorschläge aus der Community

vue-macros-Bibliothek, experimentelles defineModel, defineOptions und Vorschläge für setupSFC

Vue Macros und Vorschläge aus der Community ist eine kostenlose Vue Academy-Lektion auf CoddyKit. Dies ist Lektion 3 von 4. Du kannst die komplette Lektion unten kostenlos lesen – dann übst du sie direkt im Browser mit einem integrierten Code-Editor und einem KI-Tutor rund um die Uhr. Sie ist Teil des Vue Academy-Lernpfads, und dein Fortschritt wird über Web und CoddyKit-App synchronisiert. Der Vue Academy-Kurs umfasst insgesamt 4 Lektionen.

Compiler-Makros in script setup

In <script setup> stellt Vue Compiler-Makros bereit — Funktionen wie defineProps und defineEmits, die zur Compile-Zeit verarbeitet und nicht zur Laufzeit importiert werden. Vue 3.4 und spätere Versionen haben weitere Makros ergänzt, und das Community-Projekt vue-macros erprobt noch mehr davon.

vue-macros: Ein Experimentierfeld

vue-macros ist eine Community-Bibliothek, die experimentelle Makros vor (oder über) dem Funktionsumfang des Vue-Kerns bereitstellt. Erfolgreiche Ideen werden manchmal in den Kern übernommen — defineModel entstand ursprünglich hier, bevor es stabil wurde.

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

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

defineModel: Der frühere Ansatz

Vor defineModel mussten Sie für v-model auf einer Komponente eine modelValue-Prop deklarieren und update:modelValue manuell emittieren — ausführlich und fehleranfällig.

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

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

defineModel: Stabil ab Vue 3.4

defineModel wurde in Vue 3.4 stabil. Es gibt ein beschreibbares ref zurück, das automatisch mit der Prop und dem Update-Event verbunden ist. Beim Lesen erhalten Sie den Wert; eine Zuweisung löst das Update aus.

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

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

Benanntes und typisiertes defineModel

defineModel unterstützt benannte Modelle (v-model:title) sowie Optionen wie required und einen Typ — analog zu defineProps.

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

Mehrere v-models leicht gemacht

Mit benannten Modellen kann eine Komponente mehrere bidirektionale Bindings übersichtlich bereitstellen — etwas, das zuvor viele Prop-/Emit-Paare erforderte.

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

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

defineOptions

defineOptions (stabil in Vue 3.3) ermöglicht es Ihnen, Komponentenoptionen wie name und inheritAttrs direkt in <script setup> festzulegen, sodass kein zweiter <script>-Block mehr erforderlich ist.

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

Warum name und inheritAttrs wichtig sind

Der name einer Komponente unterstützt Devtools, Rekursion sowie das Ein- und Ausschließen bei <KeepAlive>. inheritAttrs: false verhindert das automatische Durchreichen von Attributen, sodass Sie Attribute über v-bind="$attrs" an einem bestimmten inneren Element platzieren können.

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

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

Weitere wichtige Makros

Vue bietet außerdem defineExpose (steuert, worauf ein übergeordnetes ref zugreifen kann), defineSlots (typisiert Slots) und withDefaults (Standardwerte für typbasierte Props). Damit ist das <script setup>-Werkzeugset vollständig.

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

Experimentell oder stabil: Wählen Sie mit Bedacht

Stabile Makros aus dem Vue-Kern (defineModel, defineOptions) können Sie sicher in der Produktion einsetzen. Die Experimente von vue-macros eignen sich für Prototypen und eine frühe Einführung, aber ihre APIs können sich ändern — begrenzen Sie ihren Einsatz in produktiven Apps sorgfältig.

Community-Vorschläge verfolgen

Neue Ideen tauchen als RFCs und in vue-macros auf. Wenn Sie diese Entwicklungen verfolgen, können Sie besser abschätzen, wohin sich das Framework bewegt — und Feedback geben, bevor die Features stabil werden.

Schnelltest

Testen Sie Ihr Verständnis der Vue-Makros.

Zusammenfassung

Sie haben Makros und Vorschläge kennengelernt:

  • vue-macros stellt experimentelle Makros bereit; einige davon werden in den Vue-Kern übernommen
  • defineModel (stabil ab 3.4) vereinfacht das v-model von Komponenten
  • Benannte und typisierte Modelle ermöglichen mehrere übersichtliche bidirektionale Bindings
  • defineOptions legt name/inheritAttrs in <script setup> fest
  • Verwenden Sie in der Produktion bevorzugt stabile Makros und behandeln Sie Experimente mit Vorsicht

Häufig gestellte Fragen

Ist die Lektion „Vue Macros und Vorschläge aus der Community“ kostenlos?

Ja — der vollständige Text von „Vue Macros und Vorschläge aus der Community“ ist hier im Web kostenlos zu lesen. Um sie interaktiv zu üben (integrierter Code-Editor und 24/7 KI-Tutor) und den Rest des Vue Academy-Kurses freizuschalten, upgrade auf CoddyKit PRO. Der Vue Academy-Kurs umfasst insgesamt 4 Lektionen.

Was lerne ich in „Vue Macros und Vorschläge aus der Community“?

vue-macros-Bibliothek, experimentelles defineModel, defineOptions und Vorschläge für setupSFC Du übst Vue Academy mit praktischem Code, den du direkt im Browser ausführst, und ein 24/7 KI-Tutor beantwortet deine Fragen während du die Lektion bearbeitest.

Brauche ich Erfahrung, um Vue Academy zu starten?

Keine Vorkenntnisse erforderlich. Vue Academy auf CoddyKit ist für Anfänger bis fortgeschrittene Lernende strukturiert, sodass du hier starten oder von Anfang an beginnen und in deinem eigenen Tempo voranschreiten kannst. Dies ist Lektion 3 von 4.

Wie lange dauert die Lektion „Vue Macros und Vorschläge aus der Community“?

Die meisten CoddyKit-Lektionen dauern etwa 5–10 Minuten. Jede ist kompakt und interaktiv, sodass du stetig Fortschritte machst und genau dort weitermachst, wo du aufgehört hast – im Web und in der App.

Kann ich in dieser Vue Academy-Lektion Code schreiben und ausführen?

Ja. Jede Vue Academy-Lektion enthält einen integrierten Code-Editor, sodass du echten Code direkt in deinem Browser schreibst und ausführst und sofort KI-Feedback erhältst — ohne lokale Einrichtung erforderlich.

Alle Lektionen in diesem Kurs

  1. Vue Vapor Mode: Optimierung zur Compile-Zeit
  2. Vite-Ökosystem: Plugins und Tooling
  3. Vue Macros und Vorschläge aus der Community
  4. Den passenden Vue-Stack für 2025+ auswählen
← Zurück zu Vue Academy