
* Dashboards: apply sentence-style capitalization * Apply sentence-style capitalization, apply reuse * Apply suggestions from code review Co-authored-by: Joakim Sørensen <joasoe@gmail.com> * Apply suggestions from code review * Add substep on dashboard control * Remove code fence from title - to focus on the topic of the content, rather than the code itself * Apply suggestions from code review Co-authored-by: Joakim Sørensen <joasoe@gmail.com> --------- Co-authored-by: Joakim Sørensen <joasoe@gmail.com>
4.8 KiB
type, title, sidebar_label, description
type | title | sidebar_label | description |
---|---|---|---|
card | Weather forecast card | Weather forecast | The weather forecast card displays the weather. Very useful to include on interfaces that people display on the wall. |
The weather forecast card displays the weather. This card is particularly useful on wall-mounted displays.
Screenshot of the weather card.
{% include dashboard/edit_dashboard.md %}
Card settings
{% configuration_basic %}
Entity:
description: "The entity of the weather
platform to use."
Name:
description: The name of the location where the weather platform is located. If not set, the name will be the name set on the weather entity
Show Forecast:
description: Check this if you would like to show the upcoming forecast under the current weather.
Forecast type:
description: Select the forecast to display between "Daily", "Hourly" and "Twice daily".
Secondary Info Attribute:
description: Here you can specify a secondary attribute to show under the current temperature. Ex. Extrema, Precipitation, Humidity. If not set, it will default to Extrema (High/Low) if available, if not available then Precipitation and if precipitation isn't available then Humidity.
Theme:
description: Name of any loaded theme to be used for this card. For more information about themes, see the frontend documentation.
{% endconfiguration_basic %}
This card works only with platforms that define a weather
entity.
E.g., it works with OpenWeatherMap but not OpenWeatherMap Sensor
YAML configuration
The following YAML options are available when you use YAML mode or just prefer to use YAML in the code editor in the UI.
{% configuration %}
type:
required: true
description: "weather-forecast
"
type: string
entity:
required: true
description: Entity ID of weather
domain.
type: string
name:
required: false
description: Overwrites the friendly name.
type: string
default: Entity name
show_forecast:
required: false
description: Show next hours/days forecast.
type: boolean
default: true
forecast_type:
required: true
description: Type of forecast to display, one of daily
, hourly
or twice_daily
.
type: string
default: Automatically selects in order of daily
, hourly
and twice_daily
.
secondary_info_attribute:
required: false
description: Which attribute to display under the temperature.
type: string
default: Defaults to extrema
if available, if not available then precipitation
and if precipitation isn't available then humidity
.
theme:
required: false
description: Override the used theme for this card with any loaded theme. For more information about themes, see the frontend documentation.
type: string
tap_action:
required: false
description: The action taken on card tap. For more information, see the action documentation.
type: map
hold_action:
required: false
description: The action taken on card tap and hold. For more information, see the action documentation.
type: map
double_tap_action:
required: false
description: The action taken on card double-tap. For more information, see the action documentation.
type: map
{% endconfiguration %}
Example
show_current: true
show_forecast: true
type: weather-forecast
entity: weather.openweathermap
forecast_type: daily
Advanced
Themeable icons
The default weather icons are themable via a theme. Theme variables include:
--weather-icon-cloud-front-color
--weather-icon-cloud-back-color
--weather-icon-sun-color
--weather-icon-rain-color
--weather-icon-moon-color
Example theme configuration:
--weather-icon-cloud-front-color: white
--weather-icon-cloud-back-color: blue
--weather-icon-sun-color: orange
--weather-icon-rain-color: purple
Personal icons
Weather icons can be overwritten with your own personal images via a theme. Theme variables include:
--weather-icon-clear-night
--weather-icon-cloudy
--weather-icon-fog
--weather-icon-lightning
--weather-icon-lightning-rainy
--weather-icon-partlycloudy
--weather-icon-pouring
--weather-icon-rainy
--weather-icon-hail
--weather-icon-snowy
--weather-icon-snowy-rainy
--weather-icon-sunny
--weather-icon-windy
--weather-icon-windy-variant
--weather-icon-exceptional
// If your state is not above, use this format
--weather-icon-<state>
Example theme configuration:
--weather-icon-sunny: url("/local/sunny.png")