راهنمای Composition API در Vue 3
4 دقیقه مطالعه علی ارغیانی
vuecomposition-apiآموزشفارسی
Composition API یکی از مهمترین ویژگیهای Vue 3 است که روش جدیدی برای سازماندهی و استفاده مجدد از منطق کامپوننتها ارائه میدهد.
Composition API مشکلات Options API را حل میکند:
برای ایجاد state واکنشپذیر از
ref
reactive
<script setup>
import { ref, reactive } from 'vue'
// با ref
const count = ref(0)
// با reactive
const state = reactive({
name: 'علی',
age: 25
})
</script>
برای مقادیر محاسبهشده از
computed
<script setup>
import { ref, computed } from 'vue'
const firstName = ref('علی')
const lastName = ref('ارغیانی')
const fullName = computed(() => {
return `${firstName.value} ${lastName.value}`
})
</script>
برای نظارت بر تغییرات از
watch
watchEffect
<script setup>
import { ref, watch } from 'vue'
const count = ref(0)
watch(count, (newValue, oldValue) => {
console.log(`تغییر از ${oldValue} به ${newValue}`)
})
</script>
composable ها توابع قابل استفاده مجددی هستند که منطق stateful را کپسوله میکنند:
// composables/useCounter.ts
export function useCounter(initialValue = 0) {
const count = ref(initialValue)
const increment = () => {
count.value++
}
const decrement = () => {
count.value--
}
const reset = () => {
count.value = initialValue
}
return {
count: readonly(count),
increment,
decrement,
reset
}
}
استفاده از composable:
<script setup>
const { count, increment, decrement } = useCounter(10)
</script>
<template>
<div>
<p>شمارنده: {{ count }}</p>
<button @click="increment">افزایش</button>
<button @click="decrement">کاهش</button>
</div>
</template>
از lifecycle hooks در
<script setup>
<script setup>
import { onMounted, onUnmounted } from 'vue'
onMounted(() => {
console.log('کامپوننت mount شد')
})
onUnmounted(() => {
console.log('کامپوننت unmount شد')
})
</script>
<script setup>
این سینتکس مختصرتر و بهینهتر است:
<script setup>
// کد شما اینجا
</script>
composable ها را در دایرکتوری
composables/
composables/
├── useAuth.ts
├── useCounter.ts
└── useFetch.ts
composable ها را با
use
export function useMyFeature() {
// ...
}
Composition API روش قدرتمندی برای نوشتن کامپوننتهای Vue است که کد را قابل نگهداریتر، قابل استفاده مجددتر و type-safe تر میکند.
با تمرین و استفاده مداوم، Composition API به بخش طبیعی از توسعه Vue شما تبدیل خواهد شد.