Versions Compared

Old Version 7

changes.mady.by.user Bri Prebilic Cole

Saved on

compared with

New Version Current

changes.mady.by.user Bri Prebilic Cole

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This page is a work in progress.

Table Directives

Table is Directives are an extension of the Widget module with the name table.js. It provides Angular directives for Tabular View features. To use these directives, see the documentation on Angular directives.

...

NameOther AttributesSummary
onos-table-resizecol-widthResizes the table to fit the available window space and sets table columns to custom widths.
onos-sortable-headercolId, sortableSorts the table contents by the header and direction indicated on click.
onos-flash-changesid-prop, ng-repeat-complete, row-idFlashes the table rows whose information is new or updated.

Note that all of these directives can be used with each other. All of the Tabular Views use all three directives in tandem.

Directive Usage

onos-table-resize

...

RequirementsOther AttributesSummary
  • onos-sortable-header has to be on an element that has children that represent the table header row (<td> elements)
    • in the above example, the directive is on the <div>, but it would also work on the <table> or <tr> elements
  • the <td> elements you want to be sortable must have the sortable and the colId attributes (see right -->)
  • ALL column headers must be <td> elements NOT <th>

sortable - (required) put this attribute (with no value) on the td element whose column you want to be sortable.

colId - (required) this attribute's value must be the tag of the column's contents which you want to sort by. As shown above, to sort by ID, the attribute must be colId="id"

** If you don't include these attributes, then the column won't be sortable. **

This directive selects all of the <td> elements below the onos-sortable-header attribute and checks if they have the sortable attribute. If it does, then it installs a sort click event on the <td> element.

...

onos-flash-changes

Flashes the table rows whose information is new or updated.

 

...

Example Usage

Code Block
themeConfluence
languagexml
linenumberstrue
<div class="summary-list">
	<div>
		<table>
			<tr>
				<td>ID</td>
				<td>Foo</td>
				<td>Bar</td>
				<td>Baz</td>
			</tr>
		</table>
	</div>
	<div>
		<table onos-flash-changes id-prop="id">
			<tr ng-repeat="item in tableData track by $index"
				ng-repeat-complete row-id="{{item.id}}">
				<td>{{item.id}}</td>
				<td>{{item.foo}}</td>
				<td>{{item.bar}}</td>
				<td>{{item.baz}}</td>
			</tr>
		</table>
	</div>
</div>

You will also need CSS to style the table flash.

Code Block
themeConfluence
languagecss
linenumberstrue
div.summary-list tr {
    transition: background-color 500ms;
}
.light div.summary-list tr.data-change {
    background-color: #FDFFDC;
}
.dark div.summary-list tr.data-change {
    background-color: #5A5600;
}
RequirementsOther AttributesSummary
  • onos-flash-changes must be on the <div> or <table> elements that represent the table body
  • id-props must be on the same element as onos-flash-changes (see right)
  • include the directive ng-repeat-complete in the same element that ng-repeat is in
  • include row-id attribute with the interpolated unique identifier (see right)

id-props - the value for this attribute must be the property key for the unique identifier. Most often, the unique identifier will be "id", but not always.

row-id - put the interpolated value of the unique identifier for this item as the value for this attribute, such as {{item.id}} (which will evaluate to the actual value at runtime)

ng-repeat-complete - tells onos-flash-changes to start looking for the elements that have changed in the dataset

Finds changes in the tableData set and finds the element that corresponds to those changes. The class "data-change" will appear for a 1.5 seconds and then be removed.