/*! * Angular Material Design * https://github.com/angular/material * @license MIT * v1.1.3 */ goog.provide('ngmaterial.components.subheader'); goog.require('ngmaterial.components.sticky'); goog.require('ngmaterial.core'); /** * @ngdoc module * @name material.components.subheader * @description * SubHeader module * * Subheaders are special list tiles that delineate distinct sections of a * list or grid list and are typically related to the current filtering or * sorting criteria. Subheader tiles are either displayed inline with tiles or * can be associated with content, for example, in an adjacent column. * * Upon scrolling, subheaders remain pinned to the top of the screen and remain * pinned until pushed on or off screen by the next subheader. @see [Material * Design Specifications](https://www.google.com/design/spec/components/subheaders.html) * * > To improve the visual grouping of content, use the system color for your subheaders. * */ MdSubheaderDirective['$inject'] = ["$mdSticky", "$compile", "$mdTheming", "$mdUtil", "$mdAria"]; angular .module('material.components.subheader', [ 'material.core', 'material.components.sticky' ]) .directive('mdSubheader', MdSubheaderDirective); /** * @ngdoc directive * @name mdSubheader * @module material.components.subheader * * @restrict E * * @description * The `md-subheader` directive creates a sticky subheader for a section. * * Developers are able to disable the stickiness of the subheader by using the following markup * * * Not Sticky * * * ### Notes * - The `md-subheader` directive uses the $mdSticky service * to make the subheader sticky. * * > Whenever the current browser doesn't support stickiness natively, the subheader * will be compiled twice to create a sticky clone of the subheader. * * @usage * * Online Friends * */ function MdSubheaderDirective($mdSticky, $compile, $mdTheming, $mdUtil, $mdAria) { return { restrict: 'E', replace: true, transclude: true, template: ( '
' + '
' + '
' + '
' + '
' ), link: function postLink(scope, element, attr, controllers, transclude) { $mdTheming(element); element.addClass('_md'); // Remove the ngRepeat attribute from the root element, because we don't want to compile // the ngRepeat for the sticky clone again. $mdUtil.prefixer().removeAttribute(element, 'ng-repeat'); var outerHTML = element[0].outerHTML; function getContent(el) { return angular.element(el[0].querySelector('.md-subheader-content')); } // Set the ARIA attributes on the original element since it keeps it's original place in // the DOM, whereas the clones are in reverse order. Should be done after the outerHTML, // in order to avoid having multiple element be marked as headers. attr.$set('role', 'heading'); $mdAria.expect(element, 'aria-level', '2'); // Transclude the user-given contents of the subheader // the conventional way. transclude(scope, function(clone) { getContent(element).append(clone); }); // Create another clone, that uses the outer and inner contents // of the element, that will be 'stickied' as the user scrolls. if (!element.hasClass('md-no-sticky')) { transclude(scope, function(clone) { // If the user adds an ng-if or ng-repeat directly to the md-subheader element, the // compiled clone below will only be a comment tag (since they replace their elements with // a comment) which cannot be properly passed to the $mdSticky; so we wrap it in our own // DIV to ensure we have something $mdSticky can use var wrapper = $compile('')(scope); // Delay initialization until after any `ng-if`/`ng-repeat`/etc has finished before // attempting to create the clone $mdUtil.nextTick(function() { // Append our transcluded clone into the wrapper. // We don't have to recompile the element again, because the clone is already // compiled in it's transclusion scope. If we recompile the outerHTML of the new clone, we would lose // our ngIf's and other previous registered bindings / properties. getContent(wrapper).append(clone); }); // Make the element sticky and provide the stickyClone our self, to avoid recompilation of the subheader // element. $mdSticky(scope, element, wrapper); }); } } }; } ngmaterial.components.subheader = angular.module("material.components.subheader");