Packages

  • package root
    Definition Classes
    root
  • package net
    Definition Classes
    root
  • package liftweb
    Definition Classes
    net
  • package http
    Definition Classes
    liftweb
  • object Bindings

    A collection of types and implicit transformations used to allow composition of page elements based upon the types of rendered objects.

    A collection of types and implicit transformations used to allow composition of page elements based upon the types of rendered objects.

    In Lift, a "snippet" is a function from NodeSeq => NodeSeq, where the argument to the function is a template, and the result is a fragment of a page to be rendered. Of course, this is a bit of an abbreviation; the snippet function also has an argument which is the application state made available from S. A DataBinding[T] is very similar in this respect; it is a function from some piece of information of type T to a function from NodeSeq => NodeSeq. Since DataBinding is strongly typed with respect to the type of information being rendered, DataBinding instances are ideal for the rendering of objects that is used to build up snippets. For example:

    import net.liftweb.http.Bindings._

case class MyClass(str: String, i: Int, other: MyOtherClass)
case class MyOtherClass(foo: String)

trait MyClassBinding extends DataBinding[MyClass] {
  implicit val otherBinding: DataBinding[MyOtherClass]

  override def apply(entity: MyClass) = (xhtml: NodeSeq) => {
    val otherTemplate = chooseTemplate("myclass", "other", xhtml)
    bind(
      "myclass", xhtml,
      "str" -> Text("#" + entity.str + "#"),
      "i" -> Text(entity.i.toString),
      "other" -> entity.other.bind(otherTemplate)
    )
  }

}

object myOtherClassBinding extends DataBinding[MyOtherClass] {
  override def apply(other: MyOtherClass) = (xhtml: NodeSeq) => {
    bind("other", xhtml, "foo" -> Text("%" + other.foo + "%"))
  }
}

object MyClassConcreteBinding extends MyClassBinding {
  override val otherBinding = myOtherClassBinding
}

    In this example, two classes and their associated bindings are constructed; the first binding for MyClass is abstract, needing a specific instance of DataBinding[MyOtherClass] to enable the implicit conversion needed to render the contained MyOtherClass instance. A subtemplate is selected, and the call to other.bind both necessitates the implicit conversion to a Bindings.Binder instance and applies the appropriate formatting. You can see how this usage keeps the concerns of the view and the model nicely separated, while allowing composition over object graphs.

    Please see the tests, as well as this blog post for additional details.

    Definition Classes
    http
  • Binder
  • EmptyBinding

case class Binder(binding: Binding) extends Product with Serializable

A decorator for a binding function that allows it to be called as bind() rather than apply(). This class also provides facilities for binding to a specific template

Linear Supertypes
Serializable, Serializable, Product, Equals, AnyRef, Any
Ordering
  1. Alphabetic
  2. By Inheritance
Inherited
  1. Binder
  2. Serializable
  3. Serializable
  4. Product
  5. Equals
  6. AnyRef
  7. Any
  1. Hide All
  2. Show All
Visibility
  1. Public
  2. All

Instance Constructors

  1. new Binder(binding: Binding)

Value Members

  1. final def !=(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  2. final def ##(): Int
    Definition Classes
    AnyRef → Any
  3. final def ==(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  4. final def asInstanceOf[T0]: T0
    Definition Classes
    Any
  5. def bind(templatePath: List[String]): NodeSeq

    Apply this binder's binding function to the specified templated looked up using Templates.apply

  6. def bind(xhtml: NodeSeq): NodeSeq

    Apply this binder's binding function to the specified NodeSeq.

  7. val binding: Binding
  8. def clone(): AnyRef
    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  9. final def eq(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef
  10. def finalize(): Unit
    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( classOf[java.lang.Throwable] )
  11. final def getClass(): Class[_]
    Definition Classes
    AnyRef → Any
  12. final def isInstanceOf[T0]: Boolean
    Definition Classes
    Any
  13. final def ne(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef
  14. final def notify(): Unit
    Definition Classes
    AnyRef
  15. final def notifyAll(): Unit
    Definition Classes
    AnyRef
  16. final def synchronized[T0](arg0: ⇒ T0): T0
    Definition Classes
    AnyRef
  17. final def wait(): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  18. final def wait(arg0: Long, arg1: Int): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  19. final def wait(arg0: Long): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )

Inherited from Serializable

Inherited from Serializable

Inherited from Product

Inherited from Equals

Inherited from AnyRef

Inherited from Any

Ungrouped