angular.widget.select

Description

HTML SELECT element with angular data-binding.

ng:options

Optionally ng:options attribute can be used to dynamically generate a list of <option> elements for a <select> element using an array or an object obtained by evaluating the ng:options expression.

When an item in the select menu is select, the value of array element or object property represented by the selected option will be bound to the model identified by the ng:model attribute of the parent select element.

Optionally, a single hard-coded <option> element, with the value set to an empty string, can be nested into the <select> element. This element will then represent null or "not selected" option. See example below for demonstration.

Note: ng:options provides iterator facility for <option> element which must be used instead of ng:repeat. ng:repeat is not suitable for use with <option> element because of the following reasons:

Usage

In HTML Template Binding

<select
       name="..."
       [required]
       [ng:options="..."]></select>

Parameters

Example

  <script>
  function MyCntrl() {
    this.colors = [
      {name:'black', shade:'dark'},
      {name:'white', shade:'light'},
      {name:'red', shade:'dark'},
      {name:'blue', shade:'dark'},
      {name:'yellow', shade:'light'}
    ];
    this.color = this.colors[2]; // red
  }
  </script>
  <div ng:controller="MyCntrl">
    <ul>
      <li ng:repeat="color in colors">
        Name: <input ng:model="color.name">
        [<a href ng:click="colors.$remove(color)">X</a>]
      </li>
      <li>
        [<a href ng:click="colors.push({})">add</a>]
      </li>
    </ul>
    <hr/>
    Color (null not allowed):
    <select ng:model="color" ng:options="c.name for c in colors"></select><br>

    Color (null allowed):
    <div  class="nullable">
      <select ng:model="color" ng:options="c.name for c in colors">
        <option value="">-- chose color --</option>
      </select>
    </div><br/>

    Color grouped by shade:
    <select ng:model="color" ng:options="c.name group by c.shade for c in colors">
    </select><br/>


    Select <a href ng:click="color={name:'not in list'}">bogus</a>.<br>
    <hr/>
    Currently selected: {{ {selected_color:color}  }}
    <div style="border:solid 1px black; height:20px"
         ng:style="{'background-color':color.name}">
    </div>
  </div>
   it('should check ng:options', function() {
     expect(binding('color')).toMatch('red');
     select('color').option('0');
     expect(binding('color')).toMatch('black');
     using('.nullable').select('color').option('');
     expect(binding('color')).toMatch('null');
   });