Skip to content

ป้าย

คอมโพเนนต์ Badge เป็นตัวบ่งชี้ภาพเล็กๆ ที่สามารถใช้เพื่อสื่อสารข้อมูล สถานะ หรือการแจ้งเตือน มักใช้ร่วมกับองค์ประกอบ UI อื่นๆ เพื่อให้บริบทหรือเน้นข้อมูลสำคัญ ป้ายสามารถปรับแต่งได้ในแง่ของข้อความ สี ขนาด และตำแหน่ง

คุณสมบัติหลัก

  • ข้อความ: ป้ายมักมีข้อความสั้นหรือตัวเลขเพื่อสื่อสารข้อมูล
  • ตัวแปร: ป้ายสามารถมีโครงร่างสีที่แตกต่างกันเพื่อระบุสถานะต่างๆ เช่น ปิดใช้งาน แบรนด์ เสี่ยง หรือข้อมูล
  • ขนาด: ป้ายสามารถมีขนาดที่แตกต่างกันเพื่อให้เหมาะกับความต้องการในการออกแบบต่างๆ (เช่น "big", "small", tiny)
  • การจัดตำแหน่ง: ป้ายสามารถจัดตำแหน่งสัมพันธ์กับองค์ประกอบที่แนบอยู่ เช่น ที่มุมขวาบนหรือมุมขวาล่าง

การใช้งานพื้นฐาน

0
0
0
0
0
0
0
0
0
0
vue
<template>
  <div>
    <spr-badge text="9" variant="neutral" size="big" />
    <spr-badge text="9" variant="disabled" size="big" />
    <spr-badge text="9" variant="danger" size="big" />
    <spr-badge text="9" variant="information" size="big" />
    <spr-badge text="9" variant="brand" size="big" />
  </div>

  <div>
    <spr-badge text="9" variant="neutral" size="small" />
    <spr-badge text="9" variant="disabled" size="small" />
    <spr-badge text="9" variant="danger" size="small" />
    <spr-badge text="9" variant="information" size="small" />
    <spr-badge text="9" variant="brand" size="small" />
  </div>

  <div>
    <spr-badge variant="neutral" size="tiny" />
    <spr-badge variant="disabled" size="tiny" />
    <spr-badge variant="danger" size="tiny" />
    <spr-badge variant="information" size="tiny" />
    <spr-badge variant="brand" size="tiny" />
  </div>
</template>

ตัวแปร

ใช้เพื่อปรับแต่งพื้นหลังของป้าย

9
9
9
9
9
vue
<template>
  <div>
    <spr-badge text="9" variant="neutral" size="big" />
    <spr-badge text="9" variant="disabled" size="big" />
    <spr-badge text="9" variant="danger" size="big" />
    <spr-badge text="9" variant="information" size="big" />
    <spr-badge text="9" variant="brand" size="big" />
  </div>
</template>

ขนาด

0
30
vue
<template>
  <div>
    <spr-badge text="4" variant="information" size="tiny" />
    <spr-badge text="0" variant="information" size="small" />
    <spr-badge text="30" variant="information" size="big" />
  </div>
</template>

ตำแหน่ง

ใช้เพื่อแสดงป้ายในตำแหน่งที่แตกต่างกัน (บน ล่าง)

top
9
top
9
top
top
9
top
9
top
bottom
9
bottom
9
bottom
default
9
default
9
default
vue
<template>
  <div>
    <spr-badge text="9" variant="neutral" size="big" position="top">
      <spr-lozenge label="top" />
    </spr-badge>
    <spr-badge text="9" variant="neutral" size="small" position="top">
      <spr-lozenge label="top" />
    </spr-badge>
    <spr-badge text="9" variant="neutral" size="tiny" position="top">
      <spr-lozenge label="top" />
    </spr-badge>
  </div>

  <div>
    <spr-badge text="9" variant="brand" size="big" position="top">
      <spr-lozenge label="top" />
    </spr-badge>
    <spr-badge text="9" variant="brand" size="small" position="top">
      <spr-lozenge label="top" />
    </spr-badge>
    <spr-badge text="9" variant="brand" size="tiny" position="top">
      <spr-lozenge label="top" />
    </spr-badge>
  </div>

  <div>
    <spr-badge text="9" variant="information" size="big" position="bottom">
      <spr-lozenge label="bottom" />
    </spr-badge>
    <spr-badge text="9" variant="information" size="small" position="bottom">
      <spr-lozenge label="bottom" />
    </spr-badge>
    <spr-badge text="9" variant="information" size="tiny" position="bottom">
      <spr-lozenge label="bottom" />
    </spr-badge>
  </div>

  <div>
    <spr-badge text="9" variant="danger" size="big">
      <spr-lozenge label="default" />
    </spr-badge>
    <spr-badge text="9" variant="danger" size="small">
      <spr-lozenge label="default" />
    </spr-badge>
    <spr-badge text="9" variant="danger" size="tiny">
      <spr-lozenge label="default" />
    </spr-badge>
  </div>
</template>

ตำแหน่งเริ่มต้นโดยใช้สล็อต

เมื่อใช้ตำแหน่งเริ่มต้น คุณสามารถใช้สล็อตเพื่อห่อหุ้มองค์ประกอบที่คุณต้องการแนบป้าย

top
9
top
9
top
vue
<template>
  <div>
    <spr-badge text="9" variant="brand" size="big" position="top">
      <spr-lozenge label="top" />
    </spr-badge>
    <spr-badge text="9" variant="brand" size="small" position="top">
      <spr-lozenge label="top" />
    </spr-badge>
    <spr-badge text="9" variant="brand" size="tiny" position="top">
      <spr-lozenge label="top" />
    </spr-badge>
  </div>
</template>

API Reference

Props

ชื่อคำอธิบายประเภทค่าเริ่มต้น
text เนื้อหาที่แสดงภายในป้าย โดยปกติจะเป็นข้อความสั้นหรือตัวเลขที่แสดงถึงจำนวน การแจ้งเตือน หรือตัวบ่งชี้สถานะ โปรดทราบว่าหากขนาดถูกตั้งเป็น tiny ข้อความจะไม่ถูกแสดง string'0'
variant กำหนดโครงร่างสีและสไตล์ภาพของป้ายเพื่อระบุสถานะต่างๆ:
  • brand: สีแบรนด์หลัก ใช้สำหรับการแจ้งเตือนมาตรฐาน
  • information: สีน้ำเงิน ใช้สำหรับการแจ้งเตือนข้อมูล
  • danger: สีแดง ใช้สำหรับการแจ้งเตือนที่สำคัญหรือข้อผิดพลาด
  • disabled: สีเทา ใช้สำหรับสถานะที่ไม่ได้ใช้งานหรือปิดใช้งาน
'brand' | 'information' | 'danger' | 'disabled''brand'
size ควบคุมขนาดของป้าย:
  • big: ขนาดใหญ่ที่สุด (ความสูง 20px ความกว้างขั้นต่ำ 20px) เหมาะสำหรับการแจ้งเตือนสำคัญหรือเมื่อใช้ข้อความที่ยาวขึ้น
  • small: ขนาดปานกลาง (ความสูง 16px ความกว้างขั้นต่ำ 16px) เหมาะสำหรับกรณีส่วนใหญ่
  • tiny: ขนาดเล็กที่สุด (ความสูง 10px ความกว้างขั้นต่ำ 10px) ใช้เป็นจุดบ่งชี้แบบง่ายโดยไม่มีข้อความ
'big' | 'small' | 'tiny''small'
position กำหนดตำแหน่งของป้ายสัมพันธ์กับคอนเทนเนอร์หรือเนื้อหาที่สล็อต:
  • top: จัดตำแหน่งป้ายที่มุมขวาบนขององค์ประกอบหลัก
  • bottom: จัดตำแหน่งป้ายที่มุมขวาล่างขององค์ประกอบหลัก
  • default: แสดงป้ายเป็นองค์ประกอบแบบสแตนด์อโลน
เมื่อใช้ตำแหน่ง top หรือ bottom คุณควรใช้สล็อตเริ่มต้นเพื่อห่อหุ้มองค์ประกอบที่ป้ายจะถูกแนบ
'top' | 'bottom' | 'default''default'

Slots

ชื่อคำอธิบาย
default เนื้อหาที่ป้ายจะถูกแนบ สิ่งนี้จำเป็นเมื่อใช้ตำแหน่ง top หรือ bottom ป้ายจะถูกจัดตำแหน่งสัมพันธ์กับเนื้อหานี้ หากไม่มีการระบุเนื้อหาสล็อต ป้ายจะถูกแสดงเป็นองค์ประกอบแบบสแตนด์อโลน

การใช้ผลิตภัณฑ์

Sprout HR
Sprout Sidekick