All notable changes to this project will be documented in this file.
- Added SVG graphic support module. It's being integrated into the widgets. This will allow the developer to support SVG images for Icons. Material font codepoints will remain as-is and SVG will be an option per widget. Currently only newIconButton() uses it.
- Fixed newTextBox() issue when less text is put into the box when prior text existed. It would push the text down on the screen.
- Turn on Svg support, activate the 'nanosvg' plugin from CoronaLabs Marketplace. Supply the flag 'useSvg' set to true in the initialization call. Example: mui.init(nil, {parent=self.view, useSvg = true})
- Added 'ignoreTap' to all buttons to 'ignore' tap event.
- Improved support for inset settings for display (iPhone X)
- Detecting if Phone or Tablet using mui.isPhone() returns boolean true/false.
- Fixed Cards
- Added insertRowsTableView() appends rows to an existing table view. Arguments are name of tableView and a list of entries. See documentation for newTableView with Helpers.
- Added removeAllRowsFromTableView() remove all rows from an existing table view. Argument is the name of the tableView. See documentation for newTableView with Helpers.
- Created a Pagination demo of sqlite database entries using the above methods. See http://www.anedix.com/fileshare/table-paginator.zip and look at file table-paginator.lua. Note it includes a small database abstraction layer I created. Feel free to use it for other things and it will be improved with caching, etc.
- Updated demo for showing how to attach things to a tableView too. See http://www.anedix.com/fileshare/checklist.zip
-
WARNING: getScaleVal() has been depreciated. Scaling is now fixed and works with config.lua. See config.lua for more information in demo. Any existing code based on it needs updated to adjust sizes and placement (x, y). Sorry, it was for the better.
-
With scaling fixed, the material design font letters show up and such on various devices now. There was an issue where these did not show correctly.
-
Requires Corona SDK build 2017.3135.
-
Supports safe zone insets and iPhone X display area.
-
Safe area/zone implemented.
-
mui-data must be included at the top of your scene file as it needs it for safeArea values. See menu.lua for example.
-- mui, place below mui require local muiData = require( "materialui.mui-data" )
-
For iOS devices, please add to you "plist": UILaunchStoryboardName = "LaunchScreen",
-
For iOS devices, copy the folder "LaunchScreen.storyboardc" to your project ONLY if it doesn't already exist. If it exist skip this step!
-
To place a background in the safe zone be sure to look at the top of the menu.lua file for an example.
-
See menu.lua and fun.lua for examples using the new methods.
-
Fixed newSelect() to render correctly.
-
Fixed some demo code.
-
All instances of getScaleVal() have been removed.
- newTableView() - Added parameter "valign" to attachToRow(). Allows you to vertically align the object.
- newTableView() - Added parameter "valign" to 'list' and 'columns' which allows you to vertically align the text.
- newTableView() - Documentation updated for the "valign" addition.
- newTableView() - Added parameter "align" to documentation.
- newTableView() - Added internal method attachBackgroundToRow(..). if the newTableView() options in attribute list now supports 'backgroundImage' which you specify the image to use for the row's background. Each row has to be set and if not it will use the normal color scheme.
- Adding controls to left / right align on a row didn't work correctly.
- Added return "true" to avoid propagation to other controls for buttons. Added a special case for "newTableView()" which avoids the row's callback being used if a button event occurs on top.
- newSelect() - Fixed issue where value was being used in the 'selected' text instead of the text for the button. Now after choosing a drop down item the 'text' for the item is shown.
- newTableView() - Tapping repeatly did not register an event. This is fixed now. Which was an issue on all devices and simulator.
- newSlidePanel() - Slide panel would not always slide out fully. This is fixed now.
- newSelect() displays correctly now using a scrollView. It resides within the scrollView. The drop down shows below or just above the select input area depending on visible scroll area.
- newSlidePanel() demo updated on menu.lua. It demos a custom callback to avoid the default animation when scene switching. It demos using the animated switching.
- Plugin - The library will soon be a plug-in on Corona Marketplace. Free of course! Stay tuned for the release. The documenation has been updated to reflect this change. The GitHub repo will continue to work as it did before, so either grab it by Plugin or Github. The GitHub will contain latest changes and once approved they will be migrated into the Plugin.
- Copying the font files to your project's main directory is no longer required. It now uses the "icon-font" directory.
- mui.init(module_list, options) has been changed. You No longer need to pre-append "materialui." to each module. Just name them like "mui-button" for example.
- Event handler added to method newRadioButton() "label" text. This allows the user to touch/click on the radio button or the label text.
- Event handlers updated with "return true" where needed. Prevent event propagation to other controls.
- Added global debug variable "_mui_debug" and if true will use 'mui.debug()' else do not output debugging information. Just defined it to true/false in your main.lua at top. It defaults to "false" or debugging off.
- Added method mui.debug() to output debug information. See _mui_debug above for more information.
- onboard.lua example arrow button was non-responsive due to missing callback.
- newTextBox() options for "doneButton", options for overlay. Due to mobile devices not having an easy way to edit textareas an overlay w/ "done" button (on right of textbox) has been added. The overlay and button is "not" used on non-mobile devices. Please see documentation and fun.lua for a complete example. This makes editing in a textbox easier on mobile.
- setSelectorList() method added to set the named drop-down selector with the contents of a list. This makes it easier to dynamically update the list after declaration. See commented out example in fun.lua.
- setSelectorValue() method added to set the named drop-down selector's current text and value content.
- Fixed newTextBox() contents overflowing out of defined area. The text is now in a container and the text is always around to the top (shows first line of content on down).
- getOrientation() gets the current orientation as locked. mui only supports Portrait or Landscape. It cannot be both at this time.
- setSceneToSwitchToAfterDestroy([name]) to override what scene to go to after mui.destroy() executes.
- 'sceneTransitionAnimation' parameter for scene transitions. Is boolean and if "true" (default) it will animate before going to next scene. If "false" it will not animate and go to next scene immediately. See menu.lua for an example.
- muiData.parent variable is replaced with mui.getParent() method. muiData.parent is still supported but will be deprecated in the future.
- Fixed getScaleVal() and orientation issues. This was causing issues on device and in emulator. Issues like crashing since the device could be rotated, flipped etc messing up the calculations. Again use a locked position for now in "mui" and go with Portrait or Landscape. These in any "portait" or "landscape" orientation, but not both "portrait" and "landscape"
- Using a new animation for switching between scenes. It's smoother.
- Re-did the order of mui.destroy() and now it will cancel all "transitions" before proceeding to destroy.
- newSlidePanel() supports swipe gestures to open and close the menu.
- newSlidePanel() 'isVisible' added to options of slide panel. If present, hide the slide panel and reveal once a button is touched or swipe gestures. See main.lua for demo.
- newNavbar() added method support for getWidgetBaseObject() and 'parent' object support in options for newNavbar().
- Fixed issue with newSlidePanel() labelColor, labelColorOff and iconColor and iconColorOff not setting correctly when selected and de-selected.
- Fixed issue with newSlidePanel() not hiding and showing correctly. Custom methods to hide/show the menu are optional.
- newRoundedRectButton() and newRectButton() can now show a icon from material font or an image (jpg/png) to the left of the button text. See docs, example and list of options includes: iconText, iconFont, iconFontColor, iconImage.
- newTableView() - bug fixes and example updated to show multi-columns. Example of highlighting a row is also been given but is commented out.
- Fixed bug in newTileGrid() when using composer to switch scenes and not using the built-in library method actionSwitchScene().
- 'newTableView()' added support for multiple columns. See menu.lua and options for a row called "columns" which defines the columns (text, value, align). Each row supports: text, value, font, fontSize, fillColor, isCategory.
- 'newTableView()' see 'columnOptions' in options to set the width per column.
- 'getTableViewProperty()' added 'list' to be able to access the list table (list = {}) for the rows or rows and columns.
- 'onRowTouchDemo()' added example of pulling column data.
- 'onRowTouchDemo()' added 'hidden' example of changing a rows color when clicked.
- bugs fixes
- 'newSlidePanel()' events fixed. Now the menu stays resident and hides/shows instead of destroying the menu. Menu is destroyed when switching scenes or when removeSlidePanel("name") is called. It will also highlight the current selected item.
- removed dependency of utf8 plugin. This may be added back in future versions. For now it simplifies the installation and not requiring Internet access to build in simulator. A pure lua utf8 method was put in place to handle the requirements. Feel free to use the utf8 plugin as the method here will not conflict with it. uft8 plugin is awesome for internationalization.
- "newSlidePanel" now will highlight the last menu item selected. This requires the methods hideSlidePanel() and showSlidePanel(). If not it will 'destroy' the menu after an item is selected. Just use these in your callbacks.
- Fixed some bugs.
- "mui.materialFont" variable. The font is mapped to use "MaterialIcons-Regular.ttf" or "MaterialIcons-Regular.otf" font icons. The font is automatically assigned to the variable and is determined by mobile OS compability. This is optional usage, but can help so there are no 'hard coded' fonts to replace.
- fixed issue with attachToNavBar() when attaching a custom widget and supplying a destroy method was crashing.
- UTF-8 string plugin from Corona Labs is now "required" and must be installed to use this version. See updated README or online documentation for installation. This was done to support UTF-8 in material icon font and for future UTF-8 support.
- MaterialIcons-Regular.otf font file to support older devices. This is partially implemented but required now for installation. Be sure to copy it to the same folder where "MaterialIcons-Regular.ttf" resides.
- 'isFontIcon' a boolean for newIconButton, newCircleButton, newToolbarButton, basically where there is an Icon this is needed. Backwards compatibility included. Use "isFontIcon" in the options for the methods and if true it will use the codepoint for the Material icon font.
- fixed issues with fonts and Material design font.
- many bug fixes and now supports Android KitKat 4.4.4 - Nougat 7.x. Android Icecream and Jelly Bean should work. However, anything older than Android 4.x is "not" supported at this time.
- fixed fontSize issue with newIconButton() and newCircleButton and newToolbarButton().
- fixed newTextBox() on focus issue, it now uses the full width x height of textbox fake area.
- 'rowBackgroundColor' parameter to newTableView() and newSelect(). If no background color is specified per row use this color for background.
- 'trimFakeTextAt' parameter to newTextField() and newTextBox() options. Trim the text displayed when not editing to 1..Number and add ".." on end.
- 'textFieldFontSize' parameter to newTextField() options. Sets font size used in text field.
- 'textBoxFontSize' parameter to newTextBox() options. Sets font size used in text box.
- 'fontSize' parameter added to both newTextField() and newTextBox() to set the label size.
- Font size of textboxes were really small. Now it sets the font and the size appropriately.
- 'iconImage' parameter to newTileGrid() list options. Allows a tile to use an image (jpg/png) instead of icon font text.
- 'fontIsScaled' parameter to newTileGrid(). Defaults to true. If true scale the font to fit the width of the tile. If false let the user define the font to any size.
- 'fontSize' parameter to newTileGrid(). Sets the overall font size for icon and text.
- 'parent' parameter to newTileGrid(). If used it will place the newTileGrid widget into the group/parent.
- 'hideSlidePanel()' method to hide a newSlidePanel() widget by name. This can be used in your callBacks. This keeps the slide panel in memory and hides it.
- 'showSlidePanel()' method to show a newSlidePanel() widget by name. This can be used in your callBacks. This uses the slide panel in memory and shows it. See menu.lua for example.
- 'closeSlidePanel()' method to close a newSlidePanel() widget by name. This is now the default action if used the built-in callBack. You may call this in your own callBacks. Example: mui.closeSlidePanel("slidepanel-demo")
- 'callBack' parameter added to each menu item. If used this callBack will be called instead of the parent callBack for the entire newSlidePanel() widget.
- 'callBackData' parameter added to each menu item. if used the data will be passed to the callBack being used.
- Fixed issue #143 reported by StevenWarren: "useActualDimensions" parameter to mui.init() was setting useActualDimensions to true.
- Fixed issue #142 reported by taigak: newCard demo example in documentation was incorrect. It's fixed.
- Added else statement in mui-textinput.lua from StevenWarren
- Added new example to menu textfield_demo_with_placeholder from StevenWarren
- 'newShadowShape' being used in mui-card and mui-button. These will render as intended.
- 'iconColor' parameter to newToolbar list {} options. Specify color in on state per icon.
- 'iconColorOff' parameter to newToolbar list {} options. Specify color in off state per icon.
- 'iconColor' parameter to newSlidePanel list {} options. Specify color in on state per icon.
- 'iconColorOff' parameter to newSlidePanel list {} options. Specify color in off state per icon.
- Color bugs in newSlidePanel and newToolbar methods.
- Fixed bug where newSlidePanel forced white background on buttons, user-defined now. It uses the background color of the whole panel by parameter "fillColor"
- 'iconImage' parameter to newToolbar() method. It will fit the image to the font size dimensions. This is so it will look correct. See demo and "list {}" for an example.
- 'iconImage' parameter to newSlidePanel() method. It will fit the image to the font size dimensions. This is so it will look correct. See demo and "list {}" for an example.
- 'headerImage' parameter to newSlidePanel() method. It will fit the image to the menu header dimensions.
- Method "newSnackBar" for creating snack bar and action button text. These flow up from the bottom. Like "Removed Msgs UNDO" and it times out after 3 seconds. Use "timeOut" to specify timeout in microseconds.
- Fixed all "parent" group/scene paramater for all controls. The demo is updated using a parent for all buttons. Click "coffee cup" to see all the controls slide up (snack bar).
- Added "useTimeOut" parameter to newToast(..) method. useTimeOut is boolean. This is used to automatically timeout and close the toast notification. If not "timeOut" in microseconds is specified it defaults to 2000 or 2 seconds.
- Added "timeOut" parameter to newToast(..) method. timeOut is in microseconds. This is used to automatically timeout and close the toast notification.
- Refactored shadows for buttons, cards, shadow shapes. newShadowShape() has been refactored. Added system event to handle re-creating the opengl textures that make up the shadows per widget. This is run automatically on device resume.
- 'arcX' and 'arcY' removed from newProgressArc(..) as parameters. Instead uses 'x' and 'y' for corrdinates.
- 'isLocked' parameter to newTableView(..). Boolean to lock/unlock scrolling of table.
- 'newPopover()' method to create popover menu lists. See menu.lua for an example.
- Support for 'parent' parameter for all controls (buttons, cards, date, time, image, slider, etc). It will insert the mui object into the 'parent' or group. This will help adding to the current view's group for one.
- newCard() method to create a basic card that can contain up to two colors for top and bottom area. The card can be defined in a Corona SDK group or container.
- newCardObject() method to attach MUI library objects or non-mui library objects like Corona newText(..) for example.
- removeWidgetByName() method to remove a widget by name.
- newProgressArc() parameter "hideProgressText" a boolean. Enables or disables the progress text (100%) used in the arc.
- newProgressArc() method with "endpoint" and "continuous" indicators. Multiple callBacks and parameters. See demo at http://www.anedix.com/fileshare/progress-arc.zip and API documentation.
- Bug fixes.
- 'onComplete' parameter to newProgressCircle() method. This is a function and if set it will be called on each step interval minus 100%. On 100% the 'callBack' method if defined will be called. See demo at http://www.anedix.com/fileshare/progress-circle.zip
- Bug fixes.
- newProgressCircle() method to create a "determinate" fill circle. It can contain text which is either normal or embossed text. See demo at http://www.anedix.com/fileshare/progress-circle.zip
- Bug fixes.
- Updated README to point to new API Documentation at http://www.anedix.com/docs/mui/
- Updated Wiki to reflect the new documentation.
- Bug fixes.
- "newShadowShape()" method -- create a shadow shape for rectangle (rect), rounded rectangle (rounded_rect) and circle (circle).
- shadow support to newRectButton, newRoundedRectButton and newCircleButton. See wiki https://github.com/arcadefx/material-ui/wiki/Buttons for more information.
- "value" property to all buttons, user input and such. Use getWidgetProperty() to get the value of the widget.
- support for display.newImage() and display.newImageRect() via wrappers. See mui-image.lua for options. For an example usage see http://www.anedix.com/fileshare/login-form.zip
- "value" to both newTextField and newTextBox properties. This allows pulling the information later in another method. Example: local email = mui.getWidgetProperty("textfield_email", "value")
- Bug fix for newRoundedRect() method so it won't have the "white" outline on it if gradient shadows are not used.
- Bug fixes.
- Image buttons. These can be specified using a single image or two images for on/off states. See menu.lua and look for "Open Dialog" for an example. See project wiki too https://github.com/arcadefx/material-ui/wiki/Buttons for more information.
- tile widget method newTileGrid() supports "getWidgetProperty and child property"
- fixed bug in slider widget
- tile widget method newTileGrid() supports "touch points". It's enabled in the demo. See tile.lua for an example and to view demo, click on last circle button in main scene. Next version will support dynamic changing tiles.
- tile widget method newTileGrid(). See tile.lua for an example and to view demo, click on last circle button in main scene. Next version will support dynamic changing tiles.
- Bug fixes and optimizations
- All widgets minus date/time and onboarding have getWidgetProperty() now available.
- This project to GitHub