Download
(57 Kb)
Download
Updated: 12-04-16 12:41 PM
Pictures
File Info
Updated:12-04-16 12:41 PM
Created:10-18-11 07:21 PM
Downloads:9,773
Favorites:11
MD5:
LibSimpleWidgets  Popular! (More than 5000 hits)
Version: 1.14.5
by: doxxx [More]
LibSimpleWidgets is a library which provides a set of simple widgets not provided by the official Rift API. It integrates into the UI.CreateFrame function, adding several new frame types:
  • SimpleCheckbox (checkbox with a label)
  • SimpleGrid (grid of widgets)
  • SimpleList (list of selectable items, single/multi-select)
  • SimpleScrollList (same as above, scrollable, handles very large lists, recommended as replacement for SimpleList+SimpleScrollView)
  • SimpleRadioButton (radio button with a label)
  • SimpleScrollView (wraps any fixed-height frame)
  • SimpleSelect (dropdown list)
  • SimpleSlider (slider with the current value displayed next to it)
  • SimpleTabView (tabbed frames)
  • SimpleTextArea (multi-line textfield in scrollview)
  • SimpleTooltip (mouseover popup frame with text)
  • SimpleWindow (draggable RiftWindow)
The new frame types inherit all of Frame's functions and add a few more functions specific to each widget.

SimpleRadioButton has a companion function called RadioButtonGroup, which returns a controller object that manages a group of radio buttons to ensure that only one is selected at a time and to generate an event when the selected radio button changes.

The Layout function, given a table describing a widget layout, will create frames and lay them out accordingly. If you've ever used AceConfig and AceGUI, then you'll find this familiar. You can call Layout with the same parent frame and config table to refresh the widgets without creating new frames.

You can find the API documentation here: http://rift.curseforge.com/addons/li...documentation/

You can file bugs and feature requests in my author portal.

TODO list
v1.14.5 (4 December 2016)
- Fix SimpleScrollList mouse scrolling bug.
- Add missing Events header in SimpleWindow docs.

v1.14.4 (25 November 2015)
- Fix calculation of minimum scrollbar thickness for SimpleScrollView.

v1.14.3 (23 May 2015)
- Fix recycling of ScrollList item frame's background frames.

v1.14.2 (2 March 2014)
- Fix calls to original mouse events for tooltip injected frames.
- Fix tooltip RemoveEvents to restore original handlers correctly.

v1.14.1 (28 April 2013)
- Add RemoveAllRows function to Grid.
- Fix Grid SetRows to hide old rows.
- Fix ScrollView's content frame resizing to use SetWidth instead of setting a TOPRIGHT point. This prevents a conflict when a Grid has been put into a ScrollView before rows are added to the Grid.
- Raise Select's dropdown layer to ensure that it's on top of everything else.
- Clarify Grid's SetRows documentation.
- Add simple example for Grid to documentation.

v1.14 (27 April 2013)
- Add SimpleGrid widget.
- Fix SimpleSelect's ResizeToFit to take currently selected item width into account.
- Fix SimpleSelect's dropdown layering.
- Add configuration methods to SimpleTabView for colors.
- Change SimpleSelect widget to use SimpleScrollList for dropdown.

v1.13.4 (10 March 2013)
- Fix index param checking in SimpleScrollList's SetSelectedIndex.

v1.13.3 (28 February 2013)
- Fix enter and tab key detection in SimpleTextArea for Rift 2.2.
- Update required environment to 2.2.

v1.13.2 (12 February 2013)
- Fix index param checking in SimpleList's SetSelectedIndex.

v1.13.1 (15 January 2013)
- Fix clicking on SimpleSelect dropdown items.
- Ensure that ScrollList background frame does not interfere with item background frames.

v1.13 (12 January 2013)
- Added SimpleScrollList widget -- scrollable list (like SimpleList) but optimized to handle very large lists without using lots of Rift frames.

v1.12 (22 December 2012)
- Made Select widget's dropdown items scrollable.
- Fixed default sizing of Select widget.
- Includes v1.11.1 fixes.

v1.11.1 (18 December 2012)
- Fixed Tooltip's event injection to pass events onto original handlers as well.
- Fixed Border:Destroy() so that switching border types work.

v1.11 (9 December 2012)
- Added silent parameter to SimpleSlider's SetRange function.
- Properly remove SimpleCheckbox's SetBackgroundColor function.
- Properly remove SimpleRadioButton's SetBackgroundColor function.
- Added rounded and tooltip border styles. This required a change to the argument list for the SetBorder function.
- Use new tooltip border for Tooltip widget.
- Updated SetBorder function to handle both old-style and new-style argument lists and be able to change existing border to a different type.
- Added documentation for SetBorder function.
- Added labelFontSize config setting for checkboxes in Layout function.
- Added anchor support to the Tooltip widget.
- Added 'editable' setting for slider widgets in Layout function.
- Added parameter checking for all frame types and functions.
- Improved positioning of mouse-anchored tooltip to not go over bottom or right screen edge.
- Updated TOC Environment to 2.0.

v1.10 (3 May 2012)
- SimpleTabView: Made tab font size and colors configurable.
- SimpleTabView: Made tab position configurable.
- SimpleTabView: Fixed positioning of remaining tabs when a tab is removed.

v1.9.5 (25 April 2012)
- Added dropdown arrow button to SimpleSelect.
- Added ItemClick event to SimpleList.

v1.9.4 (21 April 2012)
- Made minimum tab width in SimpleTabView configurable.
- Enforce a minimum scrollbar drag button thickness in SimpleScrollView.
- Fixed SimpleScrollView to correctly update its layout when it's resized.

v1.9.3 (8 March 2012)
- Fixed SimpledSlider's SetEnabled to switch to showing the current view when the widget is disabled, since RiftTextfields can't be disabled.
- Removed SimpleCheckbox's and SimpleRadioButton's SetBackgroundColor function so that the default Frame implementation is used.
- Added Get/SetSelectionBackgroundColor function to SimpleList.
- Fixed SimpleList to retain selected item's background color when changing things like font size.

v1.9.2 (7 March 2012)
- Improved how RadioButtons and RadioButtonGroup interact so that they're independent of event handlers.
- Added SetEnabled function to RadioButtonGroup.

v1.9.1 (6 March 2012)
- Fixed error when trying to get an event handler for a custom event (e.g. RadioButtonChange) which had no handler set yet.

v1.9.0 (4 March 2012)
- Added optional editable textfield to SimpleSlider, controlled by Get/SetEditable.
- Fixed SimpleSlider's SetEnabled to actually enable the slider when true is passed.
- Fixed library's addon short name to be "LSW".
- Added silent parameter to SimpleSlider's SetPosition function to suppress the SliderChange event.
- Added silent parameter to SimpleList's selection-changing functions to suppress the ItemSelect and SelectionChange events.
- Added silent parameter to SimpleSelect's selection-changing functions to suppress the ItemSelect events.
- Added silent parameter to SimpleRadioButton's SetSelected function to suppress the RadioButtonSelect event.
- Added SetSelectedIndex function to SimpleRadioButtonGroup.

v1.8.3 (25 February 2012)
- Removed all usage of deprecated Rift API functions and updated required Environment to 1.7.
- Added ResizeToFit functions for SimpleSelect, SimpleCheckbox, SimpleRadioButton, and SimpleSlider.
- Deprecated ResizeToDefault function on SimpleSelect in favor of ResizeToFit.
- Fixed sizing of SimpleTooltip for multiple lines of automatically wrapped text.
- Fixed SimpleSlider's SetBackgroundColor function.
- Improved SimpleTextArea widget to grab key focus when the scroller background is clicked because the text doesn't fill the scroll area. (Thanks TimeBomb!)

v1.8.2 (29 January 2012)
- Fixed scrollbar visibility not tracking scrollview visibility properly. Thanks Xenyr!

v1.8.1 (14 December 2011)
- Fixed nil error when clicking a radio button in a RadioButtonGroup.

v1.8 (11 December 2011)
- Added SimpleRadioButton frame type and RadioButtonGroup function.
- Added TabSelect event and GetActiveTab function to SimpleTabView.

v1.7 (8 December 2011)
- Added SimpleTabView widget.
- Added item levels support to SimpleList.
- Added RemoveEvents to SimpleTooltip.
- Fixed SetBackgroundColor for SimpleList.

v1.6.1 (6 December 2011)
- Added GetSelectedIndices, GetSelectedItems and GetSelectedValues functions to SimpleList.
- Ensure that we never try to position SimpleScrollView's scrollbar outside of its min/max range.

v1.6 (1 December 2011)
- Added multi-select mode to SimpleList. See API documentation for details.

v1.5.4 (30 November 2011)
- Reverted v1.5.2 change and instead fixed SimpleList and SimpleSelect to clear the current selection when SetItems is called. This doesn't trigger an ItemSelect event.

v1.5.3 (30 November 2011)
- Fixed SimpleList and SimpleSelect to trigger an ItemSelect event when the previously selected index is reselected after the list is updated by SetItems.

v1.5.2 (19 November 2011)
- Use a RiftButton with the 'close' skin for the close button on SimpleWindows.
- Use a RiftScrollbar in SimpleScrollView.
- Added GetFontColor/SetFontColor to SimpleTooltip.
- Added GetFontColor/SetFontColor to SimpleCheckbox.

v1.5.1 (16 November 2011)
- Fixed a bug when SimpleScrollView is given a content frame that already has points or sizes set. (Thanks Matrix)
- Fixed a bug when SimpleScrollView is given a content frame that has a height of 0. (Thanks Matrix)

v1.5 (11 November 2011)
- Updated select widget in Layout function to support new values and index features in SimpleSelect.
- The event handlers created by SimpleTooltip's InjectEvents now call the tooltipTextFunc with the tooltip frame as the first parameter.
- Fixed anchoring of SimpleSlider internal frames.
- Added font size support to SimpleCheckbox, SimpleList, SimpleSelect and SimpleTooltip.
- SimpleSelect no longer automatically sets its own width and height when first created.
- Added ResizeToDefault funciton for SimpleSelect.

v1.4 (7 November 2011)
- Added the ability to associate values with items in SimpleList and SimpleSelect.
- Added the ability to use indices with SimpleList and SimpleSelect.
- SimpleList now triggers ItemSelect event when the selection is cleared.
- Reselecting the same item in SimpleList should not trigger the ItemSelect event.
- Fixed "unknown event" bug in EventProxy when a custom event is cleared by setting to nil.
- Layout function can now be used to update an existing widget layout.
- Added spacer type to Layout function.

v1.3.1 (5 November 2011)
- Fixed SetKeyFocus function for SimpleTextArea.

v1.3 (4 November 2011)
- Fix MouseIn/MouseOut/MouseMove events for SimpleCheckbox.
- Don't fire ItemSelect event in SimpleSelect if item is already selected.
- Fixed resizing of underlying textfield as text is changed in SimpleTextArea.
- Fixed SimpleWindow dragging to work when window is initially anchored.
- Improved close button for SimpleWindow.
- Added GetKeyFocus/SetKeyFocus to SimpleTextArea.
- Added missing SetBorder and SetBackgroundColor functions to for SimpleCheckbox, SimpleList and SimpleTextArea.
- Added GetEnabled/SetEnabled functions for SimpleCheckbox, SimpleList, SimpleSelect, SimpleSlider and SimpleTextArea.
- Added Close event to SimpleWindow.
- Added SimpleTooltip widget.
- Added tooltipText setting to config table for Layout function.

v1.2 (25 October 2011)
- Added optional close button to SimpleWindow.
- Added SetBackgroundColor function SimpleSelect.
- Fixed double ItemSelected notification in SimpleList.
- Improved technique used by SetBorder for adding the border. Works with translucent frames now.
- Added SimpleCheckbox widget.
- Added SimpleSlider widget.
- Added Layout function for arrange a set of widgets according to a config table.
- Added EventProxy function which creates a replacement Event table for a frame which contains custom events but can also use the events from the frame's original Event table. This has replaced the Register*Handler functions.
- Added events for various widgets.

v1.1 (22 October 2011)
- Added SimpleTextArea widget.

v1.0 (18 October 2011)
- Initial release.
Optional Files (0)


Archived Files (38)
File Name
Version
Size
Author
Date
1.14.4
57kB
doxxx
11-25-15 05:14 PM
1.14.3
55kB
doxxx
05-23-15 07:22 AM
1.14.2
57kB
doxxx
03-02-14 10:15 AM
1.14.1
57kB
doxxx
04-28-13 11:44 AM
1.14
57kB
doxxx
04-27-13 07:12 PM
1.13.4
55kB
doxxx
03-10-13 04:30 PM
1.13.3
55kB
doxxx
02-28-13 05:47 PM
1.13.2
55kB
doxxx
02-12-13 06:39 PM
1.13.1
55kB
doxxx
01-15-13 06:03 PM
1.13
55kB
doxxx
01-12-13 12:04 AM
1.12
50kB
doxxx
12-22-12 10:53 AM
1.11.1
50kB
doxxx
12-18-12 06:07 PM
1.11
50kB
doxxx
12-09-12 07:54 PM
1.10
36kB
doxxx
05-03-12 06:42 PM
1.9.5
29kB
doxxx
04-25-12 07:49 PM
1.9.4
24kB
doxxx
04-21-12 08:43 AM
1.9.3
23kB
doxxx
03-08-12 07:01 PM
1.9.2
23kB
doxxx
03-07-12 07:17 PM
1.9.1
23kB
doxxx
03-06-12 07:12 PM
1.9.0
22kB
doxxx
03-04-12 09:44 AM
1.8.3
22kB
doxxx
02-25-12 12:32 PM
1.8.2
22kB
doxxx
01-29-12 01:17 PM
1.8.1
22kB
doxxx
12-14-11 07:44 PM
1.8
22kB
doxxx
12-11-11 01:30 PM
1.7
17kB
doxxx
12-08-11 09:27 PM
1.6.1
15kB
doxxx
12-06-11 05:32 PM
1.6
15kB
doxxx
12-01-11 09:55 PM
1.5.4
14kB
doxxx
11-30-11 07:04 PM
1.5.3
14kB
doxxx
11-30-11 05:55 PM
1.5.2
15kB
doxxx
11-19-11 05:51 PM
1.5.1
20kB
doxxx
11-16-11 10:51 PM
1.5
20kB
doxxx
11-11-11 04:57 PM
1.4
19kB
doxxx
11-07-11 07:45 PM
1.3.1
18kB
doxxx
11-05-11 08:13 AM
1.3
18kB
doxxx
11-04-11 07:06 PM
1.2
15kB
doxxx
10-25-11 06:10 PM
1.1
6kB
doxxx
10-22-11 12:34 PM
1.0
5kB
doxxx
10-18-11 07:21 PM


Post A Reply Comment Options
Unread 12-04-16, 12:47 PM  
doxxx
Claw of Regulos
 
doxxx's Avatar
AddOn Author - Click to view AddOns

Forum posts: 11
File comments: 106
Uploads: 1
I've uploaded version 1.14.5, which includes a fix for a SimpleScrollList bug when scrolling with the mousewheel. Thanks to Lynx3d on Curseforge for reporting the bug!
doxxx is offline Report comment to moderator  
Reply With Quote
Unread 11-25-15, 05:16 PM  
doxxx
Claw of Regulos
 
doxxx's Avatar
AddOn Author - Click to view AddOns

Forum posts: 11
File comments: 106
Uploads: 1
I've uploaded version 1.14.4 which fixes the calculation of the minimum thickness of the scrollbar thumb button in SimpleScrollView.
doxxx is offline Report comment to moderator  
Reply With Quote
Unread 05-23-15, 07:28 AM  
doxxx
Claw of Regulos
 
doxxx's Avatar
AddOn Author - Click to view AddOns

Forum posts: 11
File comments: 106
Uploads: 1
Thanks for the bug report, Xenyr. I've uploaded version 1.14.3 which applies your fix.
doxxx is offline Report comment to moderator  
Reply With Quote
Unread 05-20-15, 06:06 AM  
Xenyr
Zombie
AddOn Author - Click to view AddOns

Forum posts: 3
File comments: 68
Uploads: 1
Hey doxxx,

I've noticed an issue with the SimpleScrollList. I was finding that I couldn't select items after having changed the contents of a list a few times. I finally tracked the issue down to the ReleaseItemFrame function. It was setting the itemFrame visibility to false, but still leaving the bgFrame visible. The released bgFrame was sometimes capturing the mouse events over the correct frame. I fixed the issue locally by changing ReleaseItemFrame as below:

Code:
local function ReleaseItemFrame(self, itemFrame)
  itemFrame:SetVisible(false)
  itemFrame.bgFrame:SetVisible(false)
  itemFrame.index = nil
  table.insert(self.itemFramePool, itemFrame)
end
Xenyr is offline Report comment to moderator  
Reply With Quote
Unread 03-02-14, 10:17 AM  
doxxx
Claw of Regulos
 
doxxx's Avatar
AddOn Author - Click to view AddOns

Forum posts: 11
File comments: 106
Uploads: 1
I've just posted v1.14.2, which fixes the pass-through for MouseIn, MouseOut and MouseMove events on frames which had a SimpleTooltip injected into them. It also fixes the RemoveEvents function for SimpleTooltip to properly restore the original mouse events.
doxxx is offline Report comment to moderator  
Reply With Quote
Unread 03-02-14, 10:14 AM  
doxxx
Claw of Regulos
 
doxxx's Avatar
AddOn Author - Click to view AddOns

Forum posts: 11
File comments: 106
Uploads: 1
Nope, scratch that, I'm wrong, you're right. I'll fix it.
doxxx is offline Report comment to moderator  
Reply With Quote
Unread 03-02-14, 09:49 AM  
doxxx
Claw of Regulos
 
doxxx's Avatar
AddOn Author - Click to view AddOns

Forum posts: 11
File comments: 106
Uploads: 1
Quote:
Originally Posted by Xenyr
but it works if I change it to be:

Code:
frame.Event.MouseMove = function(a, x, y)
    tooltip:Show(frame, tooltipTextFunc(tooltip), anchor, xoffset, yoffset)
    if oldMouseMove then oldMouseMove(a, x, y) end
end
If I do this then it will break addons which depend on the old parameter order.

You can workaround the problem by using an upvalue in your MouseMove function:

Code:
local myFrame = UI.CreateFrame(...)
myFrame.Event.MouseMove = function(x, y)
  myFrame:doStuff()
end
myFrame.tooltip = UI.CreateFrame("SimpleTooltip", "MyFrameTooltip", context)
myFrame.tooltip:InjectEvents(myFrame, function() return "Hello!" end)
The value of myFrame will be captured at the time your MouseMove function is defined (i.e. when the above code is executed).
doxxx is offline Report comment to moderator  
Reply With Quote
Unread 03-02-14, 09:17 AM  
doxxx
Claw of Regulos
 
doxxx's Avatar
AddOn Author - Click to view AddOns

Forum posts: 11
File comments: 106
Uploads: 1
Quote:
Originally Posted by Xenyr
Hey doxxx, I'm getting a nil y value passed to my MouseMove handler from the Tooltip:InjectEvents function. I think the self variable is missing from the function handler.
Thanks, I'll take a look.
doxxx is offline Report comment to moderator  
Reply With Quote
Unread 03-01-14, 08:52 AM  
Xenyr
Zombie
AddOn Author - Click to view AddOns

Forum posts: 3
File comments: 68
Uploads: 1
Hey doxxx, I'm getting a nil y value passed to my MouseMove handler from the Tooltip:InjectEvents function. I think the self variable is missing from the function handler. The current code is:

Code:
frame.Event.MouseMove = function(x, y)
    tooltip:Show(frame, tooltipTextFunc(tooltip), anchor, xoffset, yoffset)
    if oldMouseMove then oldMouseMove(x, y) end
end
but it works if I change it to be:

Code:
frame.Event.MouseMove = function(a, x, y)
    tooltip:Show(frame, tooltipTextFunc(tooltip), anchor, xoffset, yoffset)
    if oldMouseMove then oldMouseMove(a, x, y) end
end
Xenyr is offline Report comment to moderator  
Reply With Quote
Unread 02-06-14, 04:55 PM  
Kikimora

Forum posts: 0
File comments: 2
Uploads: 0
Re: Re: SetPosition for SimpleScrollView

Quote:
Originally Posted by doxxx

Try this:

Code:
window.ScrollInfo:ScrollTo(0)
It's not a public function, which means that it doesn't do any bounds checking or other safety checks, so be careful with the numbers you give it.
thx, i tryed it and it worked
Kikimora is offline Report comment to moderator  
Reply With Quote
Unread 02-01-14, 11:15 AM  
doxxx
Claw of Regulos
 
doxxx's Avatar
AddOn Author - Click to view AddOns

Forum posts: 11
File comments: 106
Uploads: 1
Re: SetPosition for SimpleScrollView

Quote:
Originally Posted by Kikimora
i was working on an addon using your LibSimpleWidgets and was making some scroll windows using SimpleScrollView and i wanted to use :SetPosition to set the scrollbar to the beginning, but that was not working.

Code:
window.ScrollInfo:SetPosition(0)
it gave me error: " Attempt to call method 'SetPosition' (a nil value) "

now i was wondering if that works in another way using your SimpleScrollView function.

greeting Kikimora
Try this:

Code:
window.ScrollInfo:ScrollTo(0)
It's not a public function, which means that it doesn't do any bounds checking or other safety checks, so be careful with the numbers you give it.
doxxx is offline Report comment to moderator  
Reply With Quote
Unread 02-01-14, 08:34 AM  
Kikimora

Forum posts: 0
File comments: 2
Uploads: 0
SetPosition for SimpleScrollView

i was working on an addon using your LibSimpleWidgets and was making some scroll windows using SimpleScrollView and i wanted to use :SetPosition to set the scrollbar to the beginning, but that was not working.

Code:
window.ScrollInfo:SetPosition(0)
it gave me error: " Attempt to call method 'SetPosition' (a nil value) "

now i was wondering if that works in another way using your SimpleScrollView function.

greeting Kikimora
Kikimora is offline Report comment to moderator  
Reply With Quote
Unread 06-18-13, 01:12 PM  
doxxx
Claw of Regulos
 
doxxx's Avatar
AddOn Author - Click to view AddOns

Forum posts: 11
File comments: 106
Uploads: 1
Somewhat good news: Emaill feeds for addon comments should be fixed now, so hopefully my response times will improve.
doxxx is offline Report comment to moderator  
Reply With Quote
Unread 06-16-13, 06:59 AM  
doxxx
Claw of Regulos
 
doxxx's Avatar
AddOn Author - Click to view AddOns

Forum posts: 11
File comments: 106
Uploads: 1
Sorry for the slowness in replies, guys, I'm not getting email notifications of comments being posted.

Solsis, if it is at all possible, I will update this addon for when the old event system is removed. However, as far as I know, the old event system still currently works. I know this sucks, you have to use different event handling mechanisms if you use raw widgets and my widgets, but there is nothing I can do about it until Zorba adds the ability to define custom frame events. You're right that backwards compatibility is basically pointless.

All my custom widgets are normal Frames, with additional child frames or other modifications. So theoretically you could use the new event system on them for standard Rift events and then use the old system for the custom events (ItemSelected, etc.). I don't know if that would be better, but it's an option.

I'll continue to look into this to see if there is anything I can do before Zorba fixes it, but that is the state of things as they currently stand.
doxxx is offline Report comment to moderator  
Reply With Quote
Unread 06-16-13, 06:49 AM  
doxxx
Claw of Regulos
 
doxxx's Avatar
AddOn Author - Click to view AddOns

Forum posts: 11
File comments: 106
Uploads: 1
Quote:
Originally Posted by RavenDust
Hi,

i really love the way this lib works Makes everything easier, thank you for that

But i have one question: How would i populate the second column of the layout?
If you're referring to the Layout function, it does it automatically. If there are two half-width widgets one after the other in the config structure, they will be placed next to each other. But a half-width widget is followed by a full-width widget, then the space to the right of the half-width widget will be left blank and the full-width widget will be on the next row.


So the ordering of your widgets in the config structure is important. You should use the "order" field in each widget table to define the order in which they appear.
doxxx is offline Report comment to moderator  
Reply With Quote
Post A Reply



Category Jump: