ripplejs / ripple

A tiny foundation for building reactive views
http://ripplejs.github.io
1.28k stars 66 forks source link

Template Spec (or Documentation) is Unclear... #36

Closed Xalior closed 10 years ago

Xalior commented 10 years ago

It seems that templates only work if they are composed of a single DOM element, even if it's a simple

...

This is not obvious in the documentation -- and templates without this minor wrapper element seem not to parse correctly beyond the first element.

It may be this is by design, but, if so - it's not obvious without inspecting all the examples, etc. :)

(no examples provided, but take any of the standard examples, and remove the outer wrapper element... :-1: )

-Dx

wryk commented 10 years ago

Yep, like others libraries, ripple only use the first root element. But you are right, this should be documented somewhere because it's an unexpected behaviour for some developers.

I didn't see documention for this in AngularJS but it trigger an error for this case : https://docs.angularjs.org/error/$compile/tplrt

Xalior commented 10 years ago

Angular, Yuk! ;-)

I picked ripple because I like an empty DOM not to need over a 1Meg of supporting (SemiPointlessReduandantFactoryProvider) cruft :)

I have updated https://github.com/ripplejs/ripple/wiki/Composing-Views to make this more clear.

Thanks for the clarification!

-Dx

wryk commented 10 years ago

I agree with you, I pick AngularJS as example because it's known. Thanks for the documentation update !