Auction
Bid Panel
Bid placement panel with current bid, bid form, auto-bidding toggle, and bid history.
Full bid placement panel for auction product pages. Displays current bid status, a bid form with minimum increment enforcement, optional auto-bidding (proxy bid), buy-it-now, and recent bid history.
Preview
Current Highest Bid
$2,500
14 bids · Min increment: $100
Recent Bids
john_d
$2,500jane_s
$2,200mike_r
$1,800Usage
<CBidPanel
:auction="product.auction"
:bids="recentBids"
currency-symbol="SAR "
@place-bid="handlePlaceBid"
/>
Loading State
<CBidPanel :auction="auctionMeta" loading />
Props
| Prop | Type | Default | Description |
|---|---|---|---|
auction | AuctionProductMeta | required | Auction metadata |
bids | Bid[] | [] | Recent bid history |
loading | boolean | false | Submitting a bid |
currencySymbol | string | '' | Currency prefix for display |
ui | Partial<{...}> | — | Per-instance theme overrides |
Events
| Event | Payload | Description |
|---|---|---|
place-bid | PlaceBidInput | Bid submitted { productId, amount, maxAutoBid? } |
Features
- Minimum increment enforcement: Auto-calculates minimum bid based on current highest + increment
- Auto-bidding: Optional proxy bidding with max amount limit (when
auction.autoBiddingEnabled) - Buy it now: Shows buy-now button when
auction.buyNowPriceavailable - Status-aware: Shows different UI for
active,ended, andupcomingauctions - Bid history: Displays recent bids with winning indicator and auto-bid badges