开源软件名称（OpenSource Name）：

开源软件地址(OpenSource Url)：

开源编程语言(OpenSource Language)：

开源软件介绍(OpenSource Introduction)：

Material Design UI for Corona Labs SDK

This README is just an overview document. You can find more detailed documentation within the repo in future updates.

What is material-ui?

A loosely based Material UI library for Corona Labs SDK. It is written in Lua using the free edition of the SDK. The library will help build a UI based on Material Design.

• Requires Corona SDK build 2017.3135 or greater.

• Supports: iOS 9+, Android 6.x+ and other Corona SDK supported platforms.

Installing material-ui from the repo on GitHub

• Clone the repo or download archive

git clone git://github.com/arcadefx/material-ui.git

• Copy the required folders into your project:

materialui (folder)
icon-font (folder)

• Read config.lua to copy to your config.lua the "MUI SET UP" section and also follow the 'content' section for specifying width and height.

Using material-ui

Warning: The latest update could break your code if you used an older copy. I have not updated the documentation yet. I will get it updated :).

• If using the GitHub repo, edit your scene file and be sure to include at the top:

local mui = require( "materialui.mui" )
local muiData = require( "materialui.mui-data" )

• In the scene create function add in the initializer and any user-interface elements

    mui.init()
    mui.newRoundedRectButton({
        name = "newGame",
        text = "New Game",
        width = 150,
        height = 30,
        x = 100,
        y = 100,
        font = native.systemFont,
        fillColor = { 0, 0.82, 1 },
        textColor = { 1, 1, 1 },
        callBack = mui.actionForButton
    })

• In the scene destroy function add in the destroy method to remove all user-interface elements in the scene.

    mui.destroy()

Building for Device

Due to device keyboard possibly covering up input fields, be sure to include "coronaWindowMovesWhenKeyboardAppears=true" into iOS settings->iphone->plist table and Android settings.

For an example, see build.settings file.

• 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

Try a Demo

Using Corona Simulator open up the "main.lua" file in the folder.

Sample Screenshot

• Note: The text input is the "Hello, world!"
• Video: https://youtu.be/c8p3DMA6PzU

Available Methods and Documentation

• See Documentation. View Documentation for more information on methods, examples and properties.

Contributing

• Feel free to contribute code, testing and feedback.
• Once we get additional authors they will be included in the repo and get recognition for their efforts.
• Please follow the licensing terms for any software included.
• See materialui/mui-example.lua for creating additional modules or review any mui-[name].lua module to see the format.

Contributors (by code, testing, helping, etc):

willcastillo
bluetardis
StevenWarren
bodily11
taigak
lmy46

Change Log

• Please see "CHANGELOG.md" in this repo for information on latest changes.

To-Do

• Expand the library (new widgets: card, clock, calendar, etc)
• Develop a layout engine
• Develop a palette engine

Summary

There are also many other files not described here, please review the .lua files for additional information. :-)

Enjoy!