LibSFDropDown is designed to be embedded into the addons that use it. The user should never have to worry about what version of the library they have, or even really be aware of the library’s existence.

Embedding the library is a fairly simple task. Simply include LibSFDropDown.xml in your addon’s files and add it into your TOC to be loaded.
Make sure that you include LibStub as well, and that it loaded before LibSFDropDown.

local lsfdd = LibStub("LibSFDropDown-1.5")

local button = lsfdd:CreateButton([parent[, width]])

Creates a button with DropDownButtonMixin applied.

local button = lsfdd:CreateModernButton([parent[, width]])

Creates a button with DropDownButtonMixin applied.

local button = lsfdd:CreateStretchButton([parent[, width[, height[, wrap]]]])

Creates a stretch button with DropDownButtonMixin applied.

lsfdd:SetMixin(frame)

Applies DropDownButtonMixin to the frame and returns the same frame.

lsfdd:IterateCreatedButtons()

Iterates the created buttons.

lsfdd:IterateCreatedModernButtons()

Iterates the created modern buttons.

lsfdd:IterateCreatedStretchButtons()

Iterates the created stretchable buttons.

lsfdd:GetMenu([level])

Returns the menu of the specified level.

lsfdd:IterateMenus()

Iterates the menus.

lsfdd:IterateMenuButtons([level])

Iterates the buttons of the specified menu level.

lsfdd:IterateSearchFrames()

Iterates the search frames.

lsfdd:IterateSearchFrameButtons([num])

Iterates the buttons of the specified search frame.

lsfdd:CreateMenuStyle(name[, overwrite], frameFunc)

Creates the menu style. Returns true if the style is created.

lsfdd:SetDefaultStyle(name)

Sets the default menu style.

lsfdd:SetMenuStyle(name)

Sets style with name "menu".

button:ddSetSelectedValue(value, [level[, anchorFrame]])

Only for the button that was created by lsfdd:CreateButton().
Sets value for the button.

button:ddGetSelectedValue()

Returns the value of the button.

button:ddSetSelectedText(text[, icon[, iconInfo[, iconOnly[, fontObject[, font]]]]])

Only for the button that was created by lsfdd:CreateButton().
Sets the text and icon for the button.

button:ddSetAutoSetText(enabled)

Only for the button that was created by lsfdd:CreateButton().
Sets to automatically set the text for the button from the selected menu item (Default: true).

button:ddInitialize([level[, value]], initFunction)

Only for the button that was created by lsfdd:CreateButton().
Sets the initialization function and initializes to set the button text.

button:ddSetInitFunc(initFunction)

Sets the initialization function.

button:ddSetDisplayMode(displayMode)

Sets the style for the menu.

button:ddSetNoGlobalMouseEvent(enabled[, frame])

Sets a flag for a frame or self that disables closing the menu when you click on it.

button:ddHideWhenButtonHidden([frame])

Hooks the OnHide event from the frame or self to close the menu.

button:ddSetMenuButtonHeight(height)

Sets the height of the menu button

button:ddSetMaxHeight(height)

Sets the maximum height of the menu if the menu is higher then scrolling is added.

button:ddSetMinMenuWidth(width)

Sets the minimum width of the menu.

button:ddSetOpenMenuUp(enabled)

Sets the menu opening direction.

button:ddIsOpenMenuUp()

Return true if the menu opens up.

button:ddSetValue(value)

Sets the value that will be passed to the initFunction function if the value passed in ddToggle is nill.

button:ddToggle(level, value, anchorFrame[, point][, rPoint][, xOffset[, yOffset]])

Openes / closes the menu.

button:ddRefresh([level[, anchorFrame]])

Refreshes the menu items.

button:ddIsMenuShown([level])

Returns true if the menu is open for that button.

button:ddCloseMenus([level])

Closes the menu.

button:ddAddSeparator([level])

Adds a separator to the menu.

button:ddGetSeparatorInfo()

Returns separator info table.

button:ddAddSpace([level])

Adds an empty line to the menu.

button:ddGetSpaceInfo([level])

Returns space info table.

button:ddAddButton(info[, level])

Adds a button to the menu.

button:ddEasyMenu(menuList, anchorFrame[, xOffset, yOffset[, displayMode]])

Sets and opens the menu from the menuList table.

It's a table with arguments:

It's a table with arguments:

{
  {
    width = [nil, number], -- width of widget, default 16
    height = [nil, number], -- height of widget, default 16
    icon = [texture], -- An icon or an atlas for the widget
    iconInfo = [nil, table], -- icon info table
    OnClick = [function(infoBtn, arg1, arg2)] -- The function that is called when you click the button
    OnEnter = [function(infoBtn, arg1, arg2)] -- Handler OnEnter
    OnLeave = [function(infoBtn, arg1, arg2)] -- Handler OnLeave
    OnTooltipShow = [function(infoBtn, tooltipFrame, arg1, arg2)] -- Handler tooltip show
  },
}