com.raquo.laminar.modifiers.RenderableText.scala Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of laminar_sjs1_2.12 Show documentation
Laminar
The newest version!
package com.raquo.laminar.modifiers

import com.raquo.laminar.nodes.TextNode

import scala.annotation.implicitNotFound

/** `RenderableText[A]` is evidence that you can convert a value of type A to
  * a string for the purpose of rendering it as a TextNode.
  *
  * If you have an implicit val of RenderableText[A], Laminar can render your
  * `A` type values by converting them to strings (and ultimately into
  * [[com.raquo.laminar.nodes.TextNode]]), and will accept your values as
  * a valid [[Modifier]], and in `child.text <--`.
  *
  * See also – [[RenderableNode]]
  */
@implicitNotFound("Implicit instance of RenderableText[${TextLike}] not found. If you want to render `${TextLike}` as a string, define an implicit `RenderableText[${TextLike}]` instance for it.")
trait RenderableText[-TextLike] {

  // override this default value, it's only here to prevent this from qualifying as a SAM trait
  def asString(value: TextLike): String = ""
}

object RenderableText {

  def apply[A](render: A => String): RenderableText[A] = new RenderableText[A] {
    override def asString(value: A): String = render(value)
  }

  // #Note[API] if you want Renderable[TextNode], please let me know why.

  implicit val stringRenderable: RenderableText[String] = RenderableText[String](identity)

  implicit val intRenderable: RenderableText[Int] = RenderableText[Int](_.toString)

  implicit val doubleRenderable: RenderableText[Double] = RenderableText[Double](_.toString)

  implicit val boolRenderable: RenderableText[Boolean] = RenderableText[Boolean](_.toString)

  // --

  /** #Warning: Using this naively in ChildTextInserter is not efficient.
    *  When we encounter this renderable instance, we use ChildInserter instead.
    */
  implicit val textNodeRenderable: RenderableText[TextNode] = RenderableText[TextNode](_.text)

  // --

  implicit lazy val charRenderable: RenderableText[Char] = RenderableText[Char](_.toString)

  implicit lazy val byteRenderable: RenderableText[Byte] = RenderableText[Byte](_.toString)

  implicit lazy val shortRenderable: RenderableText[Short] = RenderableText[Short](_.toString)

  implicit lazy val longRenderable: RenderableText[Long] = RenderableText[Long](_.toString)

  implicit lazy val floatRenderable: RenderableText[Float] = RenderableText[Float](_.toString)
}