电池

非官方测试版翻译

本页面由 PageTurner AI 翻译（测试版）。未经项目官方认可。 发现错误？ 报告问题 →

功能

注意

检测到 WSL 1 时，该段落在 Windows 上不受支持并会自动禁用。在 WSL 2 下工作正常。

Battery 段落用于显示电池的剩余电量百分比。

示例配置

json

{
  "type": "battery",
  "style": "powerline",
  "powerline_symbol": "",
  "foreground": "#193549",
  "background": "#ffeb3b",
  "background_templates": [
    "{{if eq \"Charging\" .State.String}}#40c4ff{{end}}",
    "{{if eq \"Discharging\" .State.String}}#ff5722{{end}}",
    "{{if eq \"Full\" .State.String}}#4caf50{{end}}"
  ],
  "template": " {{ if not .Error }}{{ .Icon }}{{ .Percentage }}{{ end }} ",
  "options": {
    "discharging_icon": " ",
    "charging_icon": " ",
    "charged_icon": " "
  }
}

yaml

type: battery
style: powerline
powerline_symbol: 
foreground: "#193549"
background: "#ffeb3b"
background_templates:
  - '{{if eq "Charging" .State.String}}#40c4ff{{end}}'
  - '{{if eq "Discharging" .State.String}}#ff5722{{end}}'
  - '{{if eq "Full" .State.String}}#4caf50{{end}}'
template: " {{ if not .Error }}{{ .Icon }}{{ .Percentage }}{{ end }} "
options:
  discharging_icon: " "
  charging_icon: " "
  charged_icon: " "

toml

type = "battery"
style = "powerline"
powerline_symbol = ""
foreground = "#193549"
background = "#ffeb3b"
background_templates = [ "{{if eq \"Charging\" .State.String}}#40c4ff{{end}}", "{{if eq \"Discharging\" .State.String}}#ff5722{{end}}", "{{if eq \"Full\" .State.String}}#4caf50{{end}}" ]
template = " {{ if not .Error }}{{ .Icon }}{{ .Percentage }}{{ end }} "

[options]
discharging_icon = " "
charging_icon = " "
charged_icon = " "

选项

Name	Type	Default	Description
display_error	boolean	false	show the error context when failing to retrieve the battery information
charging_icon	string		icon to display when charging
discharging_icon	string		icon to display when discharging
charged_icon	string		icon to display when fully charged
not_charging_icon	string		icon to display when fully charged

模板 (信息)

默认模板

 {{ if not .Error }}{{ .Icon }}{{ .Percentage }}{{ end }}{{ .Error }}

属性

Name	Type	Description
.State	struct	the battery state, has a .String function
.Current	float64	Current (momentary) charge rate (in mW).
.Full	float64	Last known full capacity (in mWh)
.Design	float64	Reported design capacity (in mWh)
.ChargeRate	float64	Current (momentary) charge rate (in mW). It is always non-negative, consult .State field to check whether it means charging or discharging (on some systems this might be always 0 if the battery doesn't support it)
.Voltage	float64	Current voltage (in V)
.DesignVoltage	float64	Design voltage (in V). Some systems (e.g. macOS) do not provide a separate value for this. In such cases, or if getting this fails, but getting Voltage succeeds, this field will have the same value as Voltage, for convenience
.Percentage	float64	the current battery percentage
.Error	string	the error in case fetching the battery information failed
.Icon	string	the icon based on the battery state