Restricted

A CssStyle for creating custom style types restricted to fixed parameters.

Whereas CSS styles are by default open-ended and let you define any combination of modifiers that you want, it can sometimes be useful to present a user with a constructor of fixed parameters, having the style then created for it behind the scenes.

For example:

class MyButtonBehavior(fontSize: CSSLengthNumericValue, hoverColor: CSSColorValue) : CssStyle.Restricted(init = {
  base { Modifier.fontSize(fontSize) }
  hover { Modifier.backgroundColor(hoverColor) }
}) {
  companion object {
    val Quiet = MyButtonBehavior(1.cssRem, Colors.Gray)
    val Loud = MyButtonBehavior(2.cssRem, Colors.Red)
  }
}

A user can declare an instance of this class in their own code:

val UserButtonBehavior = MyButtonBehavior(1.5.cssRem, Colors.Blue)

which will automatically create a CSS class corresponding to the property.

Inheritors