RFC: v1.0.0 api and feature set

[jtrussell]

In our opinion this directive has reached a level of maturity and stability such that we'd like to nail down the api and feature set with a shiny new major version number. This is a request for comments on anything related to desired features, api changes, examples/documentation, etc. that should be addressed before that happens.

Here's our short list of items:

Features and Fixes

• Allow for programmatic expand/collapse (Allow for programmatic expand/collapse #24)
• Make node templates customizable (Make node templates customizable #25)
• Be able to configure all options independently (Allow multiple treeviews in a single app to be configured differently #32)
• Rename "click" handler to "toggle" (Rename click-handler to toggle-handler/toggle-callback #45)
• Investigate swapping callbacks to be expression based (Possibly use angular expressions for handlers rather than callbackes? #55)

Examples and Demos

E.g. create a jsbin from the template in the README for...

• Default selected state/validate on startup (Add examples explaining default selected state and validate on startup #26)
  • Programmatic expand/collapse
• Custom Node Templates
  • Global template
  • Inline template
  • Options hash template
  • Transcluded template
• Custom inline template (as option)
• Custom inline template (as transcluded content)
• Toggle Handler
• Change Handler (fix for new syntax)
• ivhTreeviewMgr dot
  • select / deselect
  • selectAll / deselectAll
  • selectEach / deselectEach
  • expandTo / collapseParents
  • expandRecursive / collapseParents
  • validate

Documentation

• Document which classes are provided on which elements. E.g. ivh-treeview-node-label, etc. (Document supported classnames #44)
• Better site (gh-pages branch in progress). (Better Site (gh-pages) #46)

Things to consider making opt-in/opt-out-able:

• Watching children lengths for changes, for large static trees this is a fair bit of unnecessary watching.
• Inline tuple declarations, again a lot of extra checks for something that may not be used very often

Possible optimizations...

• Only render child nodes when parent is expanded (Slower Rendering/Filtering with 10,000+ Nodes #62)
• ivhTreeviewMgr.sanitize - Sanitize a node, i.e. remove all treeview attributes