goapp-mdc

module
v0.2.4 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Mar 22, 2022 License: MIT

README

goapp-mdc

go-app implementations of Material Components for the web

Go Report Card GitHub release Go Reference GitHub go.mod Go version GitHub

Goal

Provide a set of components for go-app that make use of material-components-web for styling, animations, and interaction.

Dependencies

Material Components Web

The material-components-web project are what components in this library depend on for styling, animation, and interaction. Usage of this library assumes that the stock css and js from material-components-web are referenced via CDN or included in application in the /web folder. See Getting Started in material-components-web.

A custom styled theme may be used, but this library depends on the css and js objects being in the right spots. i.e. new mdc.ripple.MDCRipple(element) and class="mdc-ripple-surface" need to work in order for this library to render components correctly.

Material Icons

This project also depends on the Material Icons font being pulled in correctly via Material Icons Guide. This project's icon package contains a generated constants file for the list of current (as of Oct 2021) icons and custom names not found in these constants can be used by passing in a MaterialIcon variable with a custom icon name. The supported icon style class is currently material-icons. Other styles like material-icons-outlined or material-icons-sharp could be added with a bit of work.

Progress

First a word on stability - "This is a work in progress. Expect breaking changes before the v1 release."

Packages

This library's package structure loosely follows the naming of packages under material-components-web/packages but some library packages like mdc-animation won't have a goapp-mdc component.

PackageProgress shows this mapping and also the development progress, if any.

Directories

Path Synopsis
attic module
pkg
autoinit
Package autoinit allows interaction between go-app components and mdc.autoInit().
Package autoinit allows interaction between go-app components and mdc.autoInit().
banner
Package banner provides the banner component and interactions with that component.
Package banner provides the banner component and interactions with that component.
bar
Package bar implements the mdc-top-app-bar component.
Package bar implements the mdc-top-app-bar component.
fab
layout
Package layout implements the markup defined in https://github.com/material-components/material-components-web/tree/master/packages/mdc-layout-grid See ExampleGrid for usage.
Package layout implements the markup defined in https://github.com/material-components/material-components-web/tree/master/packages/mdc-layout-grid See ExampleGrid for usage.
tab
Package tab is the implementation of mdc-tab-bar.
Package tab is the implementation of mdc-tab-bar.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL