ngRequired missing from documentation

[ProLoser]

I searched both the API and Guide and could not find an ng-required directive explicitly mentioned anywhere. On the 'input' page (the only place required comes up) the list of attributes for the input shown are just [required]. I actually ended up building a ui-required for AngularUI before someone told me that ng-required actually exists.

Can you guys add it to the docs? Or at least on the directive page.

I realize 'required' is mentioned several times in the docs, however I assumed it was the native html5 required which CAN have ="something" but this isn't an angular expression. There is not a single mention of ngRequired however.

[btford]

Should probably be added here: http://docs.angularjs.org/api/ng.directive:form

I'll write something up when I get a chance.

[RyanQuackenbush]

+1 Ran into the same issue above.

[SmithSamuelM]

2 months, docs not updated yet.

[mhevery]

How about a pull request to help us out with this?

[SmithSamuelM]

Well it took some trial and error to figure out how to use it. If anyone is interested. Here is how to use ng-required.

Appears to work like ng-disabled
Usage: as attribute

    <INPUT ng-required="{expression}">     </INPUT>

If the expression evaluates to true then the "required" attribute will be added to the element, otherwise the "required" attribute will be removed from the element.

Example:
Suppose we want a given input text box to be required if another input check box is checked.
The HTML for the checkbox is given by:

     <input type="checkbox" 
        name="plus" 
        value="false" 
        ng-model="litem.plus">

The base html for the associated text box element is given by:

    <input class="input-medium ng-valid ng-valid-required ng-dirty" 
        type="text" 
        name="test" 
        placeholder="test" 
        ng-model="litem.test" 
        ng-required="litem.plus">

When the scope model property litem.plus == false, then angular will ensure that the "required" attribute is not present even if it was initially present in the base html. (in the example shown above it was not present but could have been)
The HTML for the false case looks like:

    <input class="input-medium ng-valid ng-valid-required ng-dirty" 
        type="text" 
        name="test" 
        placeholder="test" 
        ng-model="litem.test" 
        ng-required="litem.plus">

But when litem.plus == true (which would happen if we checked the check box) then angular ensures that the "required "attribute will be present even if it was not initially present in the base
The HTML for the true case looks like:

    <input class="input-medium ng-valid ng-valid-required ng-dirty" 
        type="text" 
        name="test"  
        placeholder="test" 
        ng-model="litem.test" 
        ng-required="litem.plus" 
        required="required">

I am not yet set up to do pull requests on angular. So if anyone else wants to go ahead, otherwise I hope to do one sometime in the near future.

[marknadig]

Correct me if I'm wrong, but there isn't an 'ng-required' directive. There are input and select directives (ng/directive/input.js and select.js) that support "required" or "ngrequired" attributes and are documented there; e.g.
http://docs.angularjs.org/api/ng.directive:input.text

[ProLoser]

Close! But no cigar.

Do you see ngRequired anywhere on the page?

I know it seems trivial but it's already lead to 2 people recreating it lol

On Thu, Nov 8, 2012 at 4:05 PM, Mark Nadig notifications@github.com wrote:

Correct me if I'm wrong, but there isn't an 'ng-required' directive. There
are input and select directives (ng/directive/input.js and select.js)
that support "required" or "ngrequired" attributes and are documented
there; e.g.
http://docs.angularjs.org/api/ng.directive:input.text

—
Reply to this email directly or view it on GitHubhttps://github.com//issues/1202#issuecomment-10210647.

Dean J Sofer
DeanSofer@gmail.com

BS Computer Information Systems
California State Polytechnic University, Pomona
Telephone: 714-900-2254
Website: www.DeanSofer.com
Github: github.com/ProLoser

[marknadig]

nice :)

[IgorMinar]

I made a bunch of changes as landed this as c8fd7fd

[IgorMinar]

thanks!