Add Field-Level Help Option (as Popover)

[gizmoboy]

Add support to all field types to add an option to display help via an AngularStrap popover (http://mgcrea.github.io/angular-strap/##popovers).

The button for the help should be represented as an icon (question mark in a circle) to the right of the label (if they must be hardcoded, but ideally, styles should be able to be used to change its appearance and position to suit.)

This will require adding an option called helpText which is an object with the following properties:

• title (string, optional): The title of the popover. Defaults to no title. (translates into the "title" attribute of the popover, if present)
• class (string, optional): the css class(es) to apply to the popover. (translates into the "class" attribute of the popover, if present)
• data-content (string): The content of the popover (translates into the "data-content" attribute of the popover)
• data-animation (string, optional): The animation effect to apply to the popover. (translates into the "data-animation" attribute of the popover, if present)

[kentcdodds]

Would really like to seek out @Astrism's guidance on this one. This is not possible without using some javascript whether it be bootstrap, Angular-UI Bootstrap, or AngularStrap.

Personally, I'd say we'd want to do a pure bootstrap implementation so we don't tie people down to angular-ui bootstrap or AngularStrap. However, in all of my personal projects, I don't even include bootstrap's javascript, I just use Angular-UI Bootstrap...

Another solution would be to implement it with both Angular-UI Bootstrap and AngularStrap and allow it to be configurable. Unfortunately, the directives for each library are slightly different so we'd have to have an additional template for each small variation... Though we could always try for either an ng-include or a directive for each template where the template property is a function that returns a configured template (between the two I like the later option)...

Let me know what you think @Astrism, but either way, without a use case of my own for this, and with the effort it would take to implement (however that's done) I don't think I'd have the time to do it at the current bounty...

[ghelton]

sorry been pretty busy this week. I'll look over this with you guys by Wed I believe

[gizmoboy]

kenctcdobbs, I think an implementation in AngularStrap and Angular-UI Bootstrap would be great. Even support for the base bootstrap popover functionality would be great (though it'd need to be angularized anyway, so why reinvent the wheel?). But perhaps the base implementation for purists would also be ideal.

[gizmoboy]

Per the discussion in #77, My bounty would be for either plain-vanilla bootstrap or an AngularStrap plugin set that allowed the help popovers to be added.

[ghelton]

Sounds like this would be a separate build of formly dedicated to AngularStrap, at the very least. However since the functionality requested is above and beyond the base functionality of AngularStrap I'm not sure that it belongs anywhere other than a custom form field. Something that is tailored to your project, of course it could always be based on an AngularStrap/Formly build, but as @kentcdodds mentioned it would require custom templates across all fields, which wouldn't even be part of the AngularStrap build. I would see a AngularStrap build focusing on implementing their form related components, Timepicker, Datepicker, Select, and maybe typeahead. Anything beyond that wouldn't make a lot of sense in my opinion.

[gizmoboy]

I did this on a separate project. Once the repos get split out, we'll clean it up and contribute an AngularStrap set of templates for Formly.