custom-cards / bignumber-card

Big number card

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

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;
    }