AngularJS ng-list directive

The ng-list directive in AngularJS is a useful way to display a list of items in the view with a separator of your choice. This directive is commonly used when dealing with inputs that require a comma-separated list of values.

Usage

To use the ng-list directive, simply add it to the appropriate element in your HTML code:

<ul>
  <li ng-repeat="item in items" ng-bind="item"></li>
</ul>

Then, in your AngularJS controller, define the items array:

$scope.items = ['item 1', 'item 2', 'item 3'];

You can then use the ng-list directive to display the items with a separator:

<ul ng-list=",">
  <li ng-repeat="item in items" ng-bind="item"></li>
</ul>

The above code would display the items with a comma separating each item:

• item 1
• item 2
• item 3

You can also use other separators, such as a hyphen or a space:

<ul ng-list="-">
  <li ng-repeat="item in items" ng-bind="item"></li>
</ul>

<ul ng-list=" ">
  <li ng-repeat="item in items" ng-bind="item"></li>
</ul>

Advanced Usage

The ng-list directive also has several advanced features that allow you to customize how the list is displayed.

Empty Values

By default, the ng-list directive will remove empty values from the list. This can be useful for input fields that allow users to enter multiple values separated by a comma or other separator. To disable this behavior, set the ng-list attribute to true:

<ul ng-list="true" ng-list-separator=",">
  <li ng-repeat="item in items" ng-bind="item"></li>
</ul>

Custom Separators

By default, the separator used by the ng-list directive is a comma. However, you can customize the separator by using the ng-list-separator attribute:

<ul ng-list="/">
  <li ng-repeat="item in items" ng-bind="item"></li>
</ul>

<ul ng-list="|" ng-list-separator="/">
  <li ng-repeat="item in items" ng-bind="item"></li>
</ul>

Trim Whitespace

By default, the ng-list directive will trim whitespace from the items in the list. This can be useful for input fields that allow users to enter multiple values separated by a comma or other separator. To disable this behavior, set the ng-list-trim attribute to false:

<ul ng-list="true" ng-list-separator=",">
  <li ng-repeat="item in items" ng-bind="item"></li>
</ul>

<ul ng-list-trim="false" ng-list-separator="/">
  <li ng-repeat="item in items" ng-bind="item"></li>
</ul>

Conclusion

The ng-list directive is a useful tool when working with inputs that require a comma-separated list of values. With its advanced features, you can customize how the list is displayed and how empty values and whitespace are handled. This makes it a valuable tool for any AngularJS developer.