Frame:SetAttribute

Main Menu
WoW API Lua API FrameXML util Widget API Widget scripts XML schema Events CVars Macro commands Combat Log Escape sequences Hyperlinks API changes HOWTOs wowuidev

Sets an attribute on the frame.

Frame:SetAttribute(attributeName, value)
Frame:SetAttributeNoHandler(attributeName, value)

Arguments

attributeName

string - The name of the attribute (case-insensitive) to be modified.

value

any - The value to be stored.

Details

• Attributes are typically used to launder values from insecure code to a protected or restricted environment, as described in Secure Execution and Tainting. They should not be confused with XML attributes.
• Calling Frame:SetAttribute() triggers the OnAttributeChanged script handler. Conversely, calling Frame:SetAttributeNoHandler() will not trigger this.

Patch changes

Patch 9.2.0 (2022-02-22): Added suppressScriptHandler parameter. Later removed in hotfix build 42488 on 25 Feb 2022, replaced by the addition of Frame:SetAttributeNoHandler().
Patch 2.0.1 (2006-12-05): Added.