شعاع الإطار (BorderBeam)

يرسم تأثير شعاع الإطار (BorderBeam) شعاعًا من الضوء يدور حول إطار البطاقة أو الحاوية.

التثبيت

bash
npx @smicolon/cli add border-beam

قبل إضافة أي مكوّن، شغّل الأمر init مرة واحدة في مشروعك. التفاصيل في صفحة التثبيت.

معاينة

تخفيضات الخريف تنتهي الليلة

خصم حتى 30% على الكتان والصوف.

إطار متوهج ثابت

إذا أردت إبراز البطاقة دون حركة، فاستخدم الجزء GlowingBorder بدل الشعاع. يرسم إطارًا ملوّنًا ثابتًا، حوله توهّج خفيف قريب منه.

تخفيضات الخريف تنتهي الليلة

خصم حتى 30% على الكتان والصوف.

إتاحة الوصول (accessibility)

  • الشعاع زخرفي ولا يستجيب لمؤشر الفأرة، ويعمل المحتوى داخله كالمعتاد.
  • إذا فعّل المستخدم إعداد prefers-reduced-motion، يحلّ محل الشعاع إطار ثابت بنصف الشدة.

الخصائص (props)

الخاصيةالنوعالافتراضيالوصف
childrenReactNodeلا يوجدالمحتوى داخل الإطار.
durationnumber4مدة الدورة الواحدة بالثواني.
borderWidthnumber2عرض الشعاع بالبكسل.
colorFromstring"var(--primary)"لون رأس الشعاع.
colorTostring"transparent"اللون الذي يتلاشى إليه الشعاع.
delaynumber0الثواني قبل بدء الحركة.
GlowingBorder{ glowColor, borderRadius, intensity: "sm" | "md" | "lg" }لا يوجدإطار ملوّن ثابت حوله توهّج قريب.
classNamestringلا يوجدأصناف (class) إضافية للمكوّن.

الاستخدام

tsx
import { BorderBeam, GlowingBorder } from "@/components/ui/border-beam"

<BorderBeam className="rounded-xl" duration={3}>
  <div className="p-6">تخفيضات الخريف تنتهي الليلة</div>
</BorderBeam>

<GlowingBorder glowColor="var(--chart-2)" intensity="lg">
  <div className="p-6">تخفيضات الخريف تنتهي الليلة</div>
</GlowingBorder>