Skip to content

custom-cards/bignumber-card

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

32 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Big number card

A simple card to display big numbers for sensors. It also supports severity levels as background.

bignumber

Options

Name Type Default Description
type string Required custom:bignumber-card
title string optional Name to display on card
scale string 50px Base scale for card: '50px'
entity string Required sensor.my_temperature
attribute string optional the entity attribute you want to display e.g. current_temperature. The entity state will be shown if not defined.
min number optional Minimum value. If specified you get bar display
max number optional Maximum value. Must be specified if you added min
color string var(--primary-text-color) Default font color. Can be either hex or HA variable. Example: 'var(--secondary-text-color)'
bnStyle string var(--label-badge-blue) Default bar color. Can be either hex or HA variable. Example: 'var(--label-badge-green)'
from string left Direction from where the bar will start filling (must have min/max specified)
severity list optional A list of severity objects. Items in list must be ascending based on 'value'
hideunit boolean optional hide the unit of measurement if set to true. If absent, unit of measurement will be shown
noneString string optional String to use for value if value == None
noneCardClass string optional CSS class to add to card if value == None
noneValueClass string optional CSS class to add to value if value == None
round int optional Number of decimals to round to. (If not present, do not round.)

Severity object

Name Type Default Description
value number Required Value until which to use this severity
bnStyle string Required Color of severity. Can be either hex or HA variable. Example: 'var(--label-badge-green)'
color string var(--primary-text-color) Font color of the severity. Can be either hex or HA variable. Example: 'var(--secondary-text-color)'

WARNINGS

  • Make sure you use ascending object values to have consistent behaviour
  • Values are the upper limit until which that severity is applied
  • Note there is a breaking change with this release. In order to add the flexibility of using card-mod styling, the style configuration options have been changed to bnStyle.

Example

- type: custom:bignumber-card
  title: Humidity
  entity: sensor.outside_humidity
  scale: 30px
  from: bottom
  min: 0
  max: 100
  hideunit: true
  color: '#000000'
  bnStyle: 'var(--label-badge-blue)'
  severity:
    - value: 70
      bnStyle: 'var(--label-badge-green)'
    - value: 90
      bnStyle: 'var(--label-badge-yellow)'
    - value: 100
      bnStyle: 'var(--label-badge-red)'
      color: '#FFFFFF'

Handling None values

If your sensor may result in None (for instance if it is offline), you may wish to handle that separately. Here is an example, which uses card-mod to add special styling for the None case.

- type: custom:bignumber-card
  title: Humidity
  entity: sensor.outside_humidity
  scale: 30px
  from: bottom
  min: 0
  max: 100
  color: '#000000'
  bnStyle: 'var(--label-badge-blue)' 
  severity:
    - value: 70
      bnStyle: 'var(--label-badge-green)'
    - value: 90
      bnStyle: 'var(--label-badge-yellow)'
    - value: 100
      bnStyle: 'var(--label-badge-red)'
      color: '#FFFFFF'
  noneString: Offline
  noneCardClass: none-card-class
  noneValueClass: none-value-class
  style: |
    .none-card-class {
      background-color: yellow;
    }
    .none-value-class {
      font-size: 22px !important;
    }