/laminar-web-components

Web Component definitions for Laminar

Primary LanguageScalaMIT LicenseMIT

Laminar Web Components

Laminar type definitions for web component collections. Currently included collections:

Usage

Add dependency

Package is published to GitHub Packages in this repository. To reference it, you can use sbt-github-packages SBT plugin:

resolvers += Resolver.githubPackages("uosis")

libraryDependencies += "com.github.uosis" %%% "laminar-web-components-material" % "0.1.0"

Ensure you have sbt-scalajs-bundler plugin

Web Components have NPM dependencies.

Use components in your app

Web Components have similar interface to built-in elements. See examples below.

Examples

Component Showcase

Displays a collection of Web Components

To run:

  • cd examples/showcase
  • sbt fastOptJS::webpack
  • Open index-fastopt.html in browser

Generator

generator folder contains Ammonite scripts used to generate component type definitions. If you want to tweak the generated types, changes should be made here.

To run code generation:

  • amm generator/main.sc
  • Format material/src/main/scala/material.scala using scalafmt
  • Check in the new generated code

Adding new component to existing collection or modifying existing component

  • Add/modify the component in the generation script
    • For example, if it's a new Google Material Web Component, add it to material.sc using one of the existing components as an example.
  • Run code generation as described above
  • Check in generated code

Adding new component collection

  • Create new definitions script using material.sc as an example
  • Create new SBT project using material/ project as an example
  • Update main.sc to include new project
  • Run code generation
  • Check in generated code