diff options
| author | Peter Bacon Darwin | 2014-02-12 22:47:42 +0000 |
|---|---|---|
| committer | Peter Bacon Darwin | 2014-02-16 19:03:41 +0000 |
| commit | 389d4879da4aa620ee95d789b19ff9be44eb730a (patch) | |
| tree | 93352ddc8738a975904a1774d51b93d585ca1075 /docs/src/templates/js | |
| parent | a564160511bf1bbed5a4fe5d2981fae1bb664eca (diff) | |
| download | angular.js-389d4879da4aa620ee95d789b19ff9be44eb730a.tar.bz2 | |
chore(doc-gen): new docs
chore(doc-gen): implement dgeni
Diffstat (limited to 'docs/src/templates/js')
| -rw-r--r-- | docs/src/templates/js/docs.js | 933 |
1 files changed, 0 insertions, 933 deletions
diff --git a/docs/src/templates/js/docs.js b/docs/src/templates/js/docs.js deleted file mode 100644 index dad57aa5..00000000 --- a/docs/src/templates/js/docs.js +++ /dev/null @@ -1,933 +0,0 @@ -var docsApp = { - controller: {}, - directive: {}, - serviceFactory: {}, - filter: {} -}; - -docsApp.controller.DocsVersionsCtrl = ['$scope', '$rootScope', '$window', 'NG_VERSIONS', 'NG_VERSION', function($scope, $rootScope, $window, NG_VERSIONS, NG_VERSION) { - $scope.docs_versions = NG_VERSIONS; - $scope.docs_version = NG_VERSIONS[0]; - - $scope.jumpToDocsVersion = function(version) { - var currentPagePath = ''; - - // preserve URL path when switching between doc versions - if (angular.isObject($rootScope.currentPage) && $rootScope.currentPage.section && $rootScope.currentPage.id) { - currentPagePath = '/' + $rootScope.currentPage.section + '/' + $rootScope.currentPage.id; - } - - $window.location = version.url + currentPagePath; - }; -}]; - -docsApp.controller.DocsNavigationCtrl = ['$scope', '$location', 'docsSearch', function($scope, $location, docsSearch) { - function clearResults() { - $scope.results = []; - $scope.colClassName = null; - $scope.hasResults = false; - } - - $scope.search = function(q) { - var MIN_SEARCH_LENGTH = 3; - if(q.length >= MIN_SEARCH_LENGTH) { - var results = docsSearch(q); - var totalSections = 0; - for(var i in results) { - ++totalSections; - } - if(totalSections > 0) { - $scope.colClassName = 'cols-' + totalSections; - } - $scope.hasResults = totalSections > 0; - $scope.results = results; - } - else { - clearResults(); - } - if(!$scope.$$phase) $scope.$apply(); - }; - $scope.submit = function() { - var result; - for(var i in $scope.results) { - result = $scope.results[i][0]; - if(result) { - break; - } - } - if(result) { - $location.path(result.url); - $scope.hideResults(); - } - }; - $scope.hideResults = function() { - clearResults(); - $scope.q = ''; - }; -}]; - -docsApp.serviceFactory.lunrSearch = function() { - return function(properties) { - if (window.RUNNING_IN_NG_TEST_RUNNER) return null; - - var engine = lunr(properties); - return { - store : function(values) { - engine.add(values); - }, - search : function(q) { - return engine.search(q); - } - }; - }; -}; - -docsApp.serviceFactory.docsSearch = ['$rootScope','lunrSearch', 'NG_PAGES', - function($rootScope, lunrSearch, NG_PAGES) { - if (window.RUNNING_IN_NG_TEST_RUNNER) { - return null; - } - - var index = lunrSearch(function() { - this.ref('id'); - this.field('title', {boost: 50}); - this.field('description', { boost : 20 }); - }); - - angular.forEach(NG_PAGES, function(page, i) { - var title = page.shortName; - if(title.charAt(0) == 'n' && title.charAt(1) == 'g') { - title = title + ' ' + title.charAt(2).toLowerCase() + title.substr(3); - } - index.store({ - id: i, - title: title, - description: page.keywords - }); - }); - - return function(q) { - var results = {}; - angular.forEach(index.search(q), function(result) { - var item = NG_PAGES[result.ref]; - var section = item.section; - results[section] = results[section] || []; - if(results[section].length < 15) { - results[section].push(item); - } - }); - return results; - }; -}]; - -docsApp.directive.focused = function($timeout) { - return function(scope, element, attrs) { - element[0].focus(); - element.on('focus', function() { - scope.$apply(attrs.focused + '=true'); - }); - element.on('blur', function() { - // have to use $timeout, so that we close the drop-down after the user clicks, - // otherwise when the user clicks we process the closing before we process the click. - $timeout(function() { - scope.$eval(attrs.focused + '=false'); - }); - }); - scope.$eval(attrs.focused + '=true'); - }; -}; - -docsApp.directive.docsSearchInput = ['$document',function($document) { - return function(scope, element, attrs) { - var ESCAPE_KEY_KEYCODE = 27, - FORWARD_SLASH_KEYCODE = 191; - angular.element($document[0].body).bind('keydown', function(event) { - if(event.keyCode == FORWARD_SLASH_KEYCODE && document.activeElement) { - var activeElement = document.activeElement; - var activeTagName = activeElement.nodeName.toLowerCase(); - var hasInputFocus = activeTagName == 'input' || activeTagName == 'select' || - activeTagName == 'option' || activeTagName == 'textarea' || - activeElement.hasAttribute('contenteditable'); - if(!hasInputFocus) { - event.stopPropagation(); - event.preventDefault(); - - var input = element[0]; - input.focus(); - } - } - }); - - element.bind('keydown', function(event) { - if(event.keyCode == ESCAPE_KEY_KEYCODE) { - event.stopPropagation(); - event.preventDefault(); - scope.$apply(function() { - scope.hideResults(); - }); - } - }); - }; -}]; - - -docsApp.directive.code = function() { - return { restrict:'E', terminal: true }; -}; - - -docsApp.directive.sourceEdit = function(getEmbeddedTemplate) { - return { - template: '<div class="btn-group pull-right">' + - '<a class="btn dropdown-toggle btn-primary" data-toggle="dropdown" href>' + - ' <i class="icon-pencil icon-white"></i> Edit<span class="caret"></span>' + - '</a>' + - '<ul class="dropdown-menu">' + - ' <li><a ng-click="plunkr($event)" href="">In Plunkr</a></li>' + - ' <li><a ng-click="fiddle($event)" href="">In JsFiddle</a></li>' + - '</ul>' + - '</div>', - scope: true, - controller: function($scope, $attrs, openJsFiddle, openPlunkr) { - var sources = { - module: $attrs.sourceEdit, - deps: read($attrs.sourceEditDeps), - html: read($attrs.sourceEditHtml), - css: read($attrs.sourceEditCss), - js: read($attrs.sourceEditJs), - json: read($attrs.sourceEditJson), - unit: read($attrs.sourceEditUnit), - scenario: read($attrs.sourceEditScenario) - }; - $scope.fiddle = function(e) { - e.stopPropagation(); - openJsFiddle(sources); - }; - $scope.plunkr = function(e) { - e.stopPropagation(); - openPlunkr(sources); - }; - } - }; - - function read(text) { - var files = []; - angular.forEach(text ? text.split(' ') : [], function(refId) { - // refId is index.html-343, so we need to strip the unique ID when exporting the name - files.push({name: refId.replace(/-\d+$/, ''), content: getEmbeddedTemplate(refId)}); - }); - return files; - } -}; - -docsApp.directive.docModuleComponents = function() { - return { - template: ' <div class="component-breakdown">' + - ' <h2>Module Components</h2>' + - ' <div ng-repeat="(key, section) in components">' + - ' <h3 class="component-heading" id="{{ section.type }}">{{ section.title }}</h3>' + - ' <table class="definition-table">' + - ' <tr>' + - ' <th>Name</th>' + - ' <th>Description</th>' + - ' </tr>' + - ' <tr ng-repeat="component in section.components">' + - ' <td><a ng-href="{{ component.url }}">{{ component.shortName }}</a></td>' + - ' <td>{{ component.shortDescription }}</td>' + - ' </tr>' + - ' </table>' + - ' </div>' + - ' </div>', - scope : { - module : '@docModuleComponents' - }, - controller : ['$scope', '$anchorScroll', '$timeout', 'sections', - function($scope, $anchorScroll, $timeout, sections) { - var validTypes = ['property','function','directive','service','object','filter']; - var components = {}; - angular.forEach(sections.api, function(item) { - if(item.moduleName == $scope.module) { - var type = item.type; - if(type == 'object') type = 'service'; - if(validTypes.indexOf(type) >= 0) { - components[type] = components[type] || { - title : type, - type : type, - components : [] - }; - components[type].components.push(item); - } - } - }); - $scope.components = components; - $timeout($anchorScroll, 0, false); - }] - }; -}; - -docsApp.directive.docTutorialNav = function(templateMerge) { - var pages = [ - '', - 'step_00', 'step_01', 'step_02', 'step_03', 'step_04', - 'step_05', 'step_06', 'step_07', 'step_08', 'step_09', - 'step_10', 'step_11', 'step_12', 'the_end' - ]; - return { - compile: function(element, attrs) { - var seq = 1 * attrs.docTutorialNav, - props = { - seq: seq, - prev: pages[seq], - next: pages[2 + seq], - diffLo: seq ? (seq - 1): '0~1', - diffHi: seq - }; - - element.addClass('btn-group'); - element.addClass('tutorial-nav'); - element.append(templateMerge( - '<a href="tutorial/{{prev}}"><li class="btn btn-primary"><i class="icon-step-backward"></i> Previous</li></a>\n' + - '<a href="http://angular.github.com/angular-phonecat/step-{{seq}}/app"><li class="btn btn-primary"><i class="icon-play"></i> Live Demo</li></a>\n' + - '<a href="https://github.com/angular/angular-phonecat/compare/step-{{diffLo}}...step-{{diffHi}}"><li class="btn btn-primary"><i class="icon-search"></i> Code Diff</li></a>\n' + - '<a href="tutorial/{{next}}"><li class="btn btn-primary">Next <i class="icon-step-forward"></i></li></a>', props)); - } - }; -}; - - -docsApp.directive.docTutorialReset = function() { - function tab(name, command, id, step) { - return '' + - ' <div class=\'tab-pane well\' title="' + name + '" value="' + id + '">\n' + - ' <ol>\n' + - ' <li><p>Reset the workspace to step ' + step + '.</p>' + - ' <pre>' + command + '</pre></li>\n' + - ' <li><p>Refresh your browser or check the app out on <a href="http://angular.github.com/angular-phonecat/step-' + step + '/app">Angular\'s server</a>.</p></li>\n' + - ' </ol>\n' + - ' </div>\n'; - } - - return { - compile: function(element, attrs) { - var step = attrs.docTutorialReset; - element.html( - '<div ng-hide="show">' + - '<p><a href="" ng-click="show=true;$event.stopPropagation()">Workspace Reset Instructions ➤</a></p>' + - '</div>\n' + - '<div class="tabbable" ng-show="show" ng-model="$cookies.platformPreference">\n' + - tab('Git on Mac/Linux', 'git checkout -f step-' + step, 'gitUnix', step) + - tab('Git on Windows', 'git checkout -f step-' + step, 'gitWin', step) + - '</div>\n'); - } - }; -}; - - -docsApp.filter.errorLink = ['$sanitize', function ($sanitize) { - var LINKY_URL_REGEXP = /((ftp|https?):\/\/|(mailto:)?[A-Za-z0-9._%+-]+@)\S*[^\s\.\;\,\(\)\{\}\<\>]/g, - MAILTO_REGEXP = /^mailto:/, - STACK_TRACE_REGEXP = /:\d+:\d+$/; - - var truncate = function (text, nchars) { - if (text.length > nchars) { - return text.substr(0, nchars - 3) + '...'; - } - return text; - }; - - return function (text, target) { - var targetHtml = target ? ' target="' + target + '"' : ''; - - if (!text) return text; - - return $sanitize(text.replace(LINKY_URL_REGEXP, function (url) { - if (STACK_TRACE_REGEXP.test(url)) { - return url; - } - - // if we did not match ftp/http/mailto then assume mailto - if (!/^((ftp|https?):\/\/|mailto:)/.test(url)) url = 'mailto:' + url; - - return '<a' + targetHtml + ' href="' + url +'">' + - truncate(url.replace(MAILTO_REGEXP, ''), 60) + - '</a>'; - })); - }; -}]; - - -docsApp.directive.errorDisplay = ['$location', 'errorLinkFilter', function ($location, errorLinkFilter) { - var interpolate = function (formatString) { - var formatArgs = arguments; - return formatString.replace(/\{\d+\}/g, function (match) { - // Drop the braces and use the unary plus to convert to an integer. - // The index will be off by one because of the formatString. - var index = +match.slice(1, -1); - if (index + 1 >= formatArgs.length) { - return match; - } - return formatArgs[index+1]; - }); - }; - - return { - link: function (scope, element, attrs) { - var search = $location.search(), - formatArgs = [attrs.errorDisplay], - i; - - for (i = 0; angular.isDefined(search['p'+i]); i++) { - formatArgs.push(search['p'+i]); - } - element.html(errorLinkFilter(interpolate.apply(null, formatArgs), '_blank')); - } - }; -}]; - - -/** - * backToTop Directive - * @param {Function} $anchorScroll - * - * @description Ensure that the browser scrolls when the anchor is clicked - */ -docsApp.directive.backToTop = ['$anchorScroll', function($anchorScroll) { - return function link(scope, element) { - element.on('click', function(event) { - scope.$apply($anchorScroll); - }); - }; -}]; - - -docsApp.serviceFactory.angularUrls = function($document) { - var urls = {}; - - angular.forEach($document.find('script'), function(script) { - var match = script.src.match(/^.*\/(angular[^\/]*\.js)$/); - if (match) { - urls[match[1].replace(/(\-\d.*)?(\.min)?\.js$/, '.js')] = match[0]; - } - }); - - return urls; -}; - - -docsApp.serviceFactory.formPostData = function($document) { - return function(url, fields) { - var form = angular.element('<form style="display: none;" method="post" action="' + url + '" target="_blank"></form>'); - angular.forEach(fields, function(value, name) { - var input = angular.element('<input type="hidden" name="' + name + '">'); - input.attr('value', value); - form.append(input); - }); - $document.find('body').append(form); - form[0].submit(); - form.remove(); - }; -}; - - -docsApp.serviceFactory.prepareDefaultAppModule = function() { - return function(content) { - var deps = []; - angular.forEach(content.deps, function(file) { - if(file.name == 'angular-animate.js') { - deps.push('ngAnimate'); - } - }); - - var moduleName = 'App'; - return { - module : moduleName, - script : "angular.module('" + moduleName + "', [" + - (deps.length ? "'" + deps.join("','") + "'" : "") + "]);\n\n" - }; - }; -}; - -docsApp.serviceFactory.prepareEditorAssetTags = function(angularUrls) { - return function(content, options) { - options = options || {}; - var includeLocalFiles = options.includeLocalFiles; - var html = makeScriptTag(angularUrls['angular.js']); - - var allFiles = [].concat(content.js, content.css, content.html, content.json); - angular.forEach(content.deps, function(file) { - if (file.name !== 'angular.js') { - var isLocal = false; - for(var i=0;i<allFiles.length;i++) { - if(allFiles[i].name == file.name) { - isLocal = true; - break; - } - } - if(!(isLocal && !includeLocalFiles)) { - var assetUrl = angularUrls[file.name] || file.name; - html += makeScriptTag(assetUrl); - } - } - }); - - if(includeLocalFiles) { - angular.forEach(content.css, function(file, index) { - html += makeCssLinkTag(file.name); - }); - } - - return html; - - - function makeScriptTag(src) { - return '<script type="text/javascript" src="' + src + '"></script>\n'; - }; - - function makeCssLinkTag(src) { - return '<link rel="stylesheet" type="text/css" href="' + src + '" />\n'; - }; - }; -}; - - -docsApp.serviceFactory.openPlunkr = function(templateMerge, formPostData, prepareEditorAssetTags, prepareDefaultAppModule) { - return function(content) { - var hasRouting = false; - angular.forEach(content.deps, function(file) { - hasRouting = hasRouting || file.name == 'angular-route.js'; - }); - var indexHtmlContent = '<!doctype html>\n' + - '<html ng-app="{{module}}">\n' + - ' <head>\n' + - '{{scriptDeps}}'; - - if(hasRouting) { - indexHtmlContent += '<script type="text/javascript">\n' + - '//this is here to make plunkr work with AngularJS routing\n' + - 'angular.element(document.getElementsByTagName(\'head\')).append(' + - 'angular.element(\'<base href="\' + window.location.pathname + \'" />\')' + - ');\n' + - '</script>\n'; - } - - indexHtmlContent += '</head>\n' + - ' <body>\n\n' + - '{{indexContents}}\n\n' + - ' </body>\n' + - '</html>\n'; - - indexProp = { - module: content.module, - scriptDeps: prepareEditorAssetTags(content, { includeLocalFiles : true }), - indexContents: content.html[0].content - }; - - var allFiles = [].concat(content.js, content.css, content.html, content.json); - - if(!content.module) { - var moduleData = prepareDefaultAppModule(content); - indexProp.module = moduleData.module; - - var found = false; - angular.forEach(content.js, function(file) { - if(file.name == 'script.js') { - file.content = moduleData.script + file.content; - found = true; - } - }); - if(!found) { - indexProp.scriptDeps += '<script type="text/javascript" src="script.js"></script>\n'; - allFiles.push({ - name : 'script.js', - content : moduleData.script - }); - } - }; - - var postData = {}; - - angular.forEach(allFiles, function(file, index) { - if (file.content && file.name != 'index.html') { - postData['files[' + file.name + ']'] = file.content; - } - }); - - postData['files[index.html]'] = templateMerge(indexHtmlContent, indexProp); - postData['tags[]'] = "angularjs"; - - postData.private = true; - postData.description = 'AngularJS Example Plunkr'; - - formPostData('http://plnkr.co/edit/?p=preview', postData); - }; -}; - -docsApp.serviceFactory.openJsFiddle = function(templateMerge, formPostData, prepareEditorAssetTags, prepareDefaultAppModule) { - var HTML = '<div ng-app=\"{{module}}\">\n{{html:2}}</div>', - CSS = '</style> <!-- Ugly Hack to make remote files preload in jsFiddle --> \n' + - '{{head:0}}<style>{{css}}', - SCRIPT = '{{script}}', - SCRIPT_CACHE = '\n\n<!-- {{name}} -->\n<script type="text/ng-template" id="{{name}}">\n{{content:2}}</script>', - BASE_HREF_TAG = '<!-- Ugly Hack to make AngularJS routing work inside of jsFiddle -->\n' + - '<base href="/" />\n\n'; - - return function(content) { - var prop = { - module: content.module, - html: '', - css: '', - script: '' - }; - if(!prop.module) { - var moduleData = prepareDefaultAppModule(content); - prop.script = moduleData.script; - prop.module = moduleData.module; - }; - - angular.forEach(content.html, function(file, index) { - if (index) { - prop.html += templateMerge(SCRIPT_CACHE, file); - } else { - prop.html += file.content; - } - }); - - prop.head = prepareEditorAssetTags(content, { includeLocalFiles : false }); - - angular.forEach(content.js, function(file, index) { - prop.script += file.content; - }); - - angular.forEach(content.css, function(file, index) { - prop.css += file.content; - }); - - var hasRouting = false; - angular.forEach(content.deps, function(file) { - hasRouting = hasRouting || file.name == 'angular-route.js'; - }); - - var compiledHTML = templateMerge(HTML, prop); - if(hasRouting) { - compiledHTML = BASE_HREF_TAG + compiledHTML; - } - formPostData("http://jsfiddle.net/api/post/library/pure/", { - title: 'AngularJS Example', - html: compiledHTML, - js: templateMerge(SCRIPT, prop), - css: templateMerge(CSS, prop) - }); - }; -}; - - -docsApp.serviceFactory.sections = ['NG_PAGES', function sections(NG_PAGES) { - var sections = { - guide: [], - api: [], - tutorial: [], - misc: [], - error: [], - getPage: function(sectionId, partialId) { - var pages = sections[sectionId]; - - partialId = partialId || 'index'; - - for (var i = 0, ii = pages.length; i < ii; i++) { - if (pages[i].id == partialId) { - return pages[i]; - } - } - return null; - } - }; - - angular.forEach(NG_PAGES, function(page) { - page.url = page.section + '/' + page.id; - if (page.id == 'angular.Module') { - page.partialUrl = 'partials/api/angular.IModule.html'; - } else { - page.partialUrl = 'partials/' + page.url + '.html'; - } - - sections[page.section].push(page); - }); - - return sections; -}]; - - -docsApp.controller.DocsController = function($scope, $rootScope, $location, $window, $cookies, sections) { - $scope.fold = function(url) { - if(url) { - $scope.docs_fold = '/notes/' + url; - if(/\/build/.test($window.location.href)) { - $scope.docs_fold = '/build/docs' + $scope.docs_fold; - } - window.scrollTo(0,0); - } - else { - $scope.docs_fold = null; - } - }; - var OFFLINE_COOKIE_NAME = 'ng-offline', - DOCS_PATH = /^\/(api)|(guide)|(misc)|(tutorial)|(error)/, - INDEX_PATH = /^(\/|\/index[^\.]*.html)$/, - GLOBALS = /^angular\.([^\.]+)$/, - ERROR = /^([a-zA-Z0-9_$]+:)?([a-zA-Z0-9_$]+)$/, - MODULE = /^((?:(?!^angular\.)[^\.])+)$/, - MODULE_MOCK = /^angular\.mock\.([^\.]+)$/, - MODULE_DIRECTIVE = /^((?:(?!^angular\.)[^\.])+)\.directive:([^\.]+)$/, - MODULE_DIRECTIVE_INPUT = /^((?:(?!^angular\.)[^\.])+)\.directive:input\.([^\.]+)$/, - MODULE_FILTER = /^((?:(?!^angular\.)[^\.])+)\.filter:([^\.]+)$/, - MODULE_SERVICE = /^((?:(?!^angular\.)[^\.])+)\.([^\.]+?)(Provider)?$/, - MODULE_TYPE = /^((?:(?!^angular\.)[^\.])+)\..+\.([A-Z][^\.]+)$/, - URL = { - module: 'guide/module', - directive: 'guide/directive', - input: 'api/ng.directive:input', - filter: 'guide/dev_guide.templates.filters', - service: 'guide/dev_guide.services', - type: 'guide/types' - }; - - - /********************************** - Publish methods - ***********************************/ - - $scope.navClass = function(page1, page2) { - return { - last: this.$last, - active: page1 && this.currentPage == page1 || page2 && this.currentPage == page2 - }; - }; - - $scope.afterPartialLoaded = function() { - var currentPageId = $location.path(); - $scope.partialTitle = $scope.currentPage.shortName; - $window._gaq.push(['_trackPageview', currentPageId]); - }; - - /** stores a cookie that is used by apache to decide which manifest ot send */ - $scope.enableOffline = function() { - //The cookie will be good for one year! - var date = new Date(); - date.setTime(date.getTime()+(365*24*60*60*1000)); - var expires = "; expires="+date.toGMTString(); - var value = angular.version.full; - document.cookie = OFFLINE_COOKIE_NAME + "="+value+expires+"; path=" + $location.path; - - //force the page to reload so server can serve new manifest file - window.location.reload(true); - }; - - - - /********************************** - Watches - ***********************************/ - - var SECTION_NAME = { - api: 'API Reference', - guide: 'Developer Guide', - misc: 'Miscellaneous', - tutorial: 'Tutorial', - error: 'Error Reference' - }; - - populateComponentsList(); - - $scope.$watch(function docsPathWatch() {return $location.path(); }, function docsPathWatchAction(path) { - // ignore non-doc links which are used in examples - if (DOCS_PATH.test(path)) { - var parts = path.split('/'), - sectionId = parts[1], - partialId = parts.slice(2).join('/'), - sectionName = SECTION_NAME[sectionId] || sectionId, - page = sections.getPage(sectionId, partialId); - - $rootScope.currentPage = sections.getPage(sectionId, partialId); - - if (!$rootScope.currentPage) { - $scope.partialTitle = 'Error: Page Not Found!'; - } - - populateComponentsList(); - - // Update breadcrumbs - var breadcrumb = $scope.breadcrumb = [], - match; - - if (partialId) { - breadcrumb.push({ name: sectionName, url: sectionId }); - if (partialId == 'angular.Module') { - breadcrumb.push({ name: 'angular.Module' }); - } else if (match = partialId.match(GLOBALS)) { - breadcrumb.push({ name: partialId }); - } else if (match = partialId.match(MODULE)) { - breadcrumb.push({ name: match[1] }); - } else if (match = partialId.match(MODULE_FILTER)) { - breadcrumb.push({ name: match[1], url: sectionId + '/' + match[1] }); - breadcrumb.push({ name: match[2] }); - } else if (match = partialId.match(MODULE_DIRECTIVE)) { - breadcrumb.push({ name: match[1], url: sectionId + '/' + match[1] }); - breadcrumb.push({ name: match[2] }); - } else if (match = partialId.match(MODULE_DIRECTIVE_INPUT)) { - breadcrumb.push({ name: match[1], url: sectionId + '/' + match[1] }); - breadcrumb.push({ name: 'input', url: URL.input }); - breadcrumb.push({ name: match[2] }); - } else if (match = partialId.match(MODULE_TYPE)) { - breadcrumb.push({ name: match[1], url: sectionId + '/' + match[1] }); - breadcrumb.push({ name: match[2] }); - } else if (match = partialId.match(MODULE_SERVICE)) { - breadcrumb.push({ name: match[1], url: sectionId + '/' + match[1] }); - breadcrumb.push({ name: match[2] + (match[3] || '') }); - } else if (match = partialId.match(MODULE_MOCK)) { - breadcrumb.push({ name: 'angular.mock.' + match[1] }); - } else { - breadcrumb.push({ name: page.shortName }); - } - } else { - breadcrumb.push({ name: sectionName }); - } - } - }); - - /********************************** - Initialize - ***********************************/ - - $scope.versionNumber = angular.version.full; - $scope.version = angular.version.full + " " + angular.version.codeName; - $scope.subpage = false; - $scope.offlineEnabled = ($cookies[OFFLINE_COOKIE_NAME] == angular.version.full); - $scope.futurePartialTitle = null; - $scope.loading = 0; - $scope.URL = URL; - $scope.$cookies = $cookies; - - $cookies.platformPreference = $cookies.platformPreference || 'gitUnix'; - - if (!$location.path() || INDEX_PATH.test($location.path())) { - $location.path('/api').replace(); - } - // bind escape to hash reset callback - angular.element(window).on('keydown', function(e) { - if (e.keyCode === 27) { - $scope.$apply(function() { - $scope.subpage = false; - }); - } - }); - - /********************************** - Private methods - ***********************************/ - - function populateComponentsList() { - var area = $location.path().split('/')[1]; - area = /^index-\w/.test(area) ? 'api' : area; - var moduleCache = {}, - namespaceCache = {}, - pages = sections[area], - modules = $scope.modules = [], - namespaces = $scope.namespaces = [], - globalErrors = $scope.globalErrors = [], - otherPages = $scope.pages = [], - search = $scope.search; - - angular.forEach(pages, function(page) { - var match, - id = page.id; - - if (page.id == 'index') { - //skip - } else if (page.section != 'api') { - if (page.section === 'error') { - match = id.match(ERROR); - if (match[1] !== undefined) { - namespace(match[1].replace(/:/g, '')).errors.push(page); - } else { - globalErrors.push(page); - } - } else { - otherPages.push(page); - } - } else if (id == 'angular.Module') { - module('ng').types.push(page); - } else if (match = id.match(GLOBALS)) { - module('ng').globals.push(page); - } else if (match = id.match(MODULE)) { - module(match[1]); - } else if (match = id.match(MODULE_FILTER)) { - module(match[1]).filters.push(page); - } else if (match = id.match(MODULE_DIRECTIVE)) { - module(match[1]).directives.push(page); - } else if (match = id.match(MODULE_DIRECTIVE_INPUT)) { - module(match[1]).directives.push(page); - } else if (match = id.match(MODULE_SERVICE)) { - module(match[1]).service(match[2])[match[3] ? 'provider' : 'instance'] = page; - } else if (match = id.match(MODULE_TYPE)) { - module(match[1]).types.push(page); - } else if (match = id.match(MODULE_MOCK)) { - module('ngMock').globals.push(page); - } - - }); - - function module(name) { - var module = moduleCache[name]; - - if (!module) { - module = moduleCache[name] = { - name: name, - url: 'api/' + name, - globals: [], - directives: [], - services: [], - service: function(name) { - var service = moduleCache[this.name + ':' + name]; - if (!service) { - service = {name: name}; - moduleCache[this.name + ':' + name] = service; - this.services.push(service); - } - return service; - }, - types: [], - filters: [] - }; - modules.push(module); - } - return module; - } - - function namespace(name) { - var namespace = namespaceCache[name]; - - if (!namespace) { - namespace = namespaceCache[name] = { - name: name, - url: 'error/' + name, - errors: [] - }; - namespaces.push(namespace); - } - return namespace; - } - } -}; - - -angular.module('docsApp', ['ngResource', 'ngRoute', 'ngCookies', 'ngSanitize', 'ngAnimate', 'bootstrap', 'bootstrapPrettify', 'docsData']). - config(function($locationProvider) { - $locationProvider.html5Mode(true).hashPrefix('!'); - }). - factory(docsApp.serviceFactory). - directive(docsApp.directive). - controller(docsApp.controller); - -angular.forEach(docsApp.filter, function (docsAppFilter, filterName) { - angular.module('docsApp').filter(filterName, docsAppFilter); -}); |
