Toggle

Contents

• Overview
• Preview
• Fields
• Simple DB Toggle
• Explicit Getter and Setter
• Common Mistakes

Overview

A toggle stores a boolean value. Use type = "toggle" or type = "checkbox".

Preview

Fields

Field	Type	Description
id	string	Stable control id.
key	string	DB key for direct persistence.
label	string	Row label.
description	string	Short explanation.
default	boolean/function	Default value.
getValue	function	Explicit value reader.
setValue	function	Explicit value writer.
isEnabled	function	Disabled-state gate.
parentCheck	function	Parent enabled-state gate.

Legacy aliases such as var, text, desc, get, and set are only safe through wrapper/legacy mapping. New direct registrations should use canonical fields.

Simple DB Toggle

app:RegisterControl("general.core", {
  id = "enabled",
  key = "enabled",
  type = "toggle",
  label = ENABLE or "Enable",
  description = "Enable this feature.",
  default = true,
})

Explicit Getter and Setter

app:RegisterControl("general.core", {
  id = "privateMode",
  type = "toggle",
  label = "Private mode",
  default = false,
  getValue = function()
    return MyAddonPrivateDB.privateMode == true
  end,
  setValue = function(value)
    MyAddonPrivateDB.privateMode = value == true
    MyAddon.RefreshPrivateMode()
  end,
})

Common Mistakes

• Do not store string values like "true" or "false".
• Do not rebuild the settings frame from the setter.
• Use explicit getters/setters for nested DB values.