Skip to content

收藏按钮 FavoriteBtn ​

用于商品卡片右上角或详情页顶部的收藏状态切换按钮(图标 15×15,内置 32×32 扩大防误触热区)。点击瞬间完成空心轮廓星与金黄色面性星切换,并带有微回弹缩放动效。

基本用法 ​

点击星标即可切换收藏状态,支持 v-model 双向绑定。

当前状态:未收藏
vue
<template>
  <FavoriteBtn @change="handleFavChange" v-model="isFavorited"/>
</template>

<script setup lang="ts">
import { ref } from 'vue'
import FavoriteBtn from '@/components/common/FavoriteBtn.vue'

const isFavorited = ref(false)
const handleFavChange = (val: boolean) => {
  console.log('收藏状态变更:', val)
}
</script>

自定义星标颜色 ​

可通过 active-color 与 unactive-color 自定义激活与未激活色彩。

自定义红色激活态
vue
<FavoriteBtn active-color="#FF2E38" unactive-color="#C9CCD1" v-model="isFavorited"/>

API 参数说明 ​

参数名说明类型默认值
modelValue是否已收藏(支持 v-model)booleanfalse
activeColor已收藏实心星填充色string'#F3AF00'
unactiveColor未收藏空心星描边色string'#9799A2'

事件说明 ​

事件名说明回调参数
update:modelValue状态切换时触发(val: boolean)
change点击按钮切换收藏状态时触发(val: boolean)