vue3 | isRef、unref、toRef、toRefs
isRef
检查某个值是否是ref
。是返回true
,否则返回false
。
const num = ref(10);
const num1 = 20;
const num2 = reactive({ data: 30 });
console.log(isRef(num)); //true
console.log(isRef(num1)); //false
console.log(isRef(num2)); //false
unref()
如果参数是ref
,则返回内部值,否则返回参数本身。
这是 val = isRef(val) ? val.value : val
计算的一个语法糖。
console.log(unref(num));
console.log(unref(num1));
console.log(unref(num2));
toRef
介绍
基于响应式对象上的某个属性,创建一个对应的 ref。创建出来的 ref 会跟源属性保持同步:更改了 ref 的值就会更改源属性的值,反之亦然。
- 参数一:操作对象
- 参数二:对象属性
const val = reactive({
num: 1,
});
const numRef = toRef(val, "num");
// 更改该 ref 会更新源属性
numRef.value++;
console.log(val.num); // 2
// 更改源属性也会更新该 ref
val.num++;
console.log(numRef.value); // 3
使用场景
toRef()
这个函数在你想把一个 prop 的 ref 传递给一个组合式函数时会很有用当我们向组件传递 props 数据时,如果想要某个数据同父组件同步更新。当 toRef
与组件 props 结合使用时,关于禁止对 props 做出更改的限制依然有效。尝试将新的值传递给 ref 等效于尝试直接更改 props,这是不允许的。在这种场景下,可以使用watch
去监听我们定义ref()
对象。
<template>
<n-modal :show="props.visible">
<n-card
style="width: 600px"
title="编辑"
:bordered="false"
size="huge"
role="dialog"
aria-modal="true"
>
<n-input v-model:value="inputValue"></n-input>
<template #footer>
<n-el class="flex justify-end">
<n-space>
<n-button @click="emits('cancel')">取消</n-button>
<n-button @click="emits('save', inputValue)">确定</n-button>
</n-space>
</n-el>
</template>
</n-card>
</n-modal>
</template>
<script lang="ts" setup>
import { toRef, watch, ref } from 'vue'
const props = defineProps<{
visible: boolean
value: string
}>()
const emits = defineEmits<{
(e: 'save', data: string): void
(e: 'cancel'): void
}>()
const valueToRef = toRef(props, 'value')
const inputValue = ref(props.value)
watch(
() => valueToRef.value,
(v) => (inputValue.value = v)
)
</script>
<style></style>
const visible = ref(true)
const inputValue = ref('哈哈哈哈')
const handleSave = (v: string) => {
console.log('v', v)
}
const handleCancel = () => {
visible.value = false
}
<Demo :value="inputValue" :visible="visible" @save="handleSave" @cancel="handleCancel" />
注:
视图更新的问题
参考: https://www.cnblogs.com/web-learn/p/16725393.html
toRefs()
将一个响应式对象转换为一个普通对象,这个普通对象的每个属性都指向源对象相应的属性的ref
。每个单独的ref
都是使用toRef()
创建的。
const val = reactive({
num: 1,
});
const numRef = toRefs(val);
// 更改该 ref 会更新源属性
numRef.num.value++;
console.log(val.num); // 2
// 更改源属性也会更新该 ref
val.num++;
console.log(numRef.num.value); // 3
toRefs()
解构出来的对象不会失去响应性。
如下:
const obj = reactive({
num: 10,
num2: 20,
});
const { num1, num2 } = toRefs(obj);
toRefs
在调用时只会为源对象上可以枚举的属性创建 ref。如果要为可能还不存在的属性创建 ref,请改用 toRef
。