Skip to main content

Status Tags

Overview​

CmAdmin provides a set of custom status tag classes used to display enum or state values with a colored badge. These are rendered via the :tag field type and are controlled using the tag_class option.

Available Tag Classes​

ClassPreviewUse Case Example
active-oneSampleActive, In Progress, Enabled
active-twoSamplePending, Awaiting, Draft
active-threeSampleOn Hold, Needs Review
active-fourSampleScheduled, Queued
active-fiveSampleInfo, Processing
completedSampleCompleted, Approved, Verified
neutralSampleInactive, Archived, Unknown
dangerSampleRejected, Failed, Blocked, Deleted
note

active is an alias for active-one and produces the same blue styling. Prefer active-one for new usage to keep things explicit.

Best Practices​

  1. Use completed for positive terminal states (approved, verified, done)
  2. Use danger for negative terminal states (rejected, failed, blocked)
  3. Use neutral for inactive or non-significant states (archived, unknown)
  4. Use active-one for currently live or enabled items
  5. Use active-two for items awaiting action (pending, draft)
  6. Use active-three through active-five to differentiate multiple intermediate states when two or more non-red/green statuses exist
  7. Avoid mixing Bootstrap badge color classes (success, warning, etc.) with these custom classes — they are not equivalent and will produce inconsistent styling