aboutsummaryrefslogtreecommitdiffstats
path: root/docs
AgeCommit message (Collapse)Author
2013-08-02docs(compile/iscp): description for compile/iscp errorMisko Hevery
2013-08-01fix(docs): handle the empty string in errorDisplayKen Sheedlo
2013-07-31fix(location): fix parameter handling on search()Misko Hevery
2013-07-31fix(resource): check whether response matches action.isArrayPete Bacon Darwin
When using $resource you must setup your actions carefully based on what the server returns. If the server responds to a request with an array then you must configure the action with `isArray:true` and vice versa. The built-in `get` action defaults to `isArray:false` and the `query` action defaults to `isArray:true`, which is must be changed if the server does not do this. Before the error message was an exception inside angular.copy, which didn't explain what the real problem was. Rather than changing the way that angular.copy works, this change ensures that a better error message is provided to the programmer if they do not set up their resource actions correctly. Closes #2255, #1044
2013-07-31docs(header): replace logo.png with logo.svgBrenton
The current logo looks awful on high-density displays. SVG is a better choice because it can scale to any resolution without increasing file size. Amending #2775 to add support for IE 8 by falling back to existing PNG with img.onerror Using relative URLs as directed by @btford and @petebacondarwin. (commit by Brenton Simpson - @appsforartists) Closes #2874
2013-07-31feat(directive): support as instance syntaxLucas Galfasó
Support controller: 'MyController as my' syntax for directives which publishes the controller instance to the directive scope. Support controllerAs syntax to define an alias to the controller within the directive scope.
2013-07-30docs(error): improve the cacheFactory/iid.ngdocIgor Minar
2013-07-29chore(ngdocs): all animation-supported directives working with docs examples ↵Matias Niemelä
and jsFiddle/Plunkr pages
2013-07-29chore(ngdocs): fixed jsFiddle/Plunkr examples to include ngAnimate and use a ↵Matias Niemelä
default App the module is not set
2013-07-29fix(ngdocs): make jsFiddle and Plunkr links work with external AngularJS modulesMatias Niemelä
2013-07-29fix(bower): update bower usage and resourcesKen Sheedlo
Changes: - Fix our old code to use bower_components/ as the install dir - Fix the Bootstrap asset to use github.com/twbs/bootstrap (it moved) - Fail the build on Bower failure. Bower should not fail silently.
2013-07-27fix(docs): fix margin around nav-list itemsKen Sheedlo
Closes #3363
2013-07-27docs(tutorial): mention the controller along the scopeRoland
2013-07-27docs(tutorial): add formattingRoland
the string literal {{query}} was missing as it was not enclosed into ``
2013-07-27docs(tutorial): add that the test also creates a controllerRoland
2013-07-26chore(ngdocs): fix docs search to properly hide the X button when collapsedMatias Niemelä
2013-07-26fix(ngAnimate): $timeout integration and cancel callbacks addedMatias Niemelä
2013-07-26fix(ngInclude): $animate refactoring + use transclusionMatias Niemelä
BREAKING CHANGE: previously ngInclude only updated its content, after this change ngInclude will recreate itself every time a new content is included. This ensures that a single rootElement for all the included contents always exists, which makes definition of css styles for animations much easier.
2013-07-26chore($animate): replace show/hide with addClass/removeClassMatias Niemelä
2013-07-26feat(ngAnimate): complete rewrite of animationsMatias Niemelä
- ngAnimate directive is gone and was replaced with class based animations/transitions - support for triggering animations on css class additions and removals - done callback was added to all animation apis - $animation and $animator where merged into a single $animate service with api: - $animate.enter(element, parent, after, done); - $animate.leave(element, done); - $animate.move(element, parent, after, done); - $animate.addClass(element, className, done); - $animate.removeClass(element, className, done); BREAKING CHANGE: too many things changed, we'll write up a separate doc with migration instructions
2013-07-26fix($compile): don't use new with minErrKen Sheedlo
Someone wrote `throw new $compileMinErr(...)` when it should have been `throw $compileMinErr(...)`. This caused a build warning.
2013-07-26chore(ngdocs): replace showdown.js with marked.jsMatias Niemelä
2013-07-25docs(guide): remove superfluous });Roland
2013-07-25feat($sce): new $sce service for Strict Contextual Escaping.Chirayu Krishnappa
$sce is a service that provides Strict Contextual Escaping services to AngularJS. Strict Contextual Escaping -------------------------- Strict Contextual Escaping (SCE) is a mode in which AngularJS requires bindings in certain contexts to result in a value that is marked as safe to use for that context One example of such a context is binding arbitrary html controlled by the user via ng-bind-html-unsafe. We refer to these contexts as privileged or SCE contexts. As of version 1.2, Angular ships with SCE enabled by default. Note: When enabled (the default), IE8 in quirks mode is not supported. In this mode, IE8 allows one to execute arbitrary javascript by the use of the expression() syntax. Refer http://blogs.msdn.com/b/ie/archive/2008/10/16/ending-expressions.aspx to learn more about them. You can ensure your document is in standards mode and not quirks mode by adding <!doctype html> to the top of your HTML document. SCE assists in writing code in way that (a) is secure by default and (b) makes auditing for security vulnerabilities such as XSS, clickjacking, etc. a lot easier. Here's an example of a binding in a privileged context: <input ng-model="userHtml"> <div ng-bind-html-unsafe="{{userHtml}}"> Notice that ng-bind-html-unsafe is bound to {{userHtml}} controlled by the user. With SCE disabled, this application allows the user to render arbitrary HTML into the DIV. In a more realistic example, one may be rendering user comments, blog articles, etc. via bindings. (HTML is just one example of a context where rendering user controlled input creates security vulnerabilities.) For the case of HTML, you might use a library, either on the client side, or on the server side, to sanitize unsafe HTML before binding to the value and rendering it in the document. How would you ensure that every place that used these types of bindings was bound to a value that was sanitized by your library (or returned as safe for rendering by your server?) How can you ensure that you didn't accidentally delete the line that sanitized the value, or renamed some properties/fields and forgot to update the binding to the sanitized value? To be secure by default, you want to ensure that any such bindings are disallowed unless you can determine that something explicitly says it's safe to use a value for binding in that context. You can then audit your code (a simple grep would do) to ensure that this is only done for those values that you can easily tell are safe - because they were received from your server, sanitized by your library, etc. You can organize your codebase to help with this - perhaps allowing only the files in a specific directory to do this. Ensuring that the internal API exposed by that code doesn't markup arbitrary values as safe then becomes a more manageable task. In the case of AngularJS' SCE service, one uses $sce.trustAs (and shorthand methods such as $sce.trustAsHtml, etc.) to obtain values that will be accepted by SCE / privileged contexts. In privileged contexts, directives and code will bind to the result of $sce.getTrusted(context, value) rather than to the value directly. Directives use $sce.parseAs rather than $parse to watch attribute bindings, which performs the $sce.getTrusted behind the scenes on non-constant literals. As an example, ngBindHtmlUnsafe uses $sce.parseAsHtml(binding expression). Here's the actual code (slightly simplified): var ngBindHtmlUnsafeDirective = ['$sce', function($sce) { return function(scope, element, attr) { scope.$watch($sce.parseAsHtml(attr.ngBindHtmlUnsafe), function(value) { element.html(value || ''); }); }; }]; Impact on loading templates --------------------------- This applies both to the ng-include directive as well as templateUrl's specified by directives. By default, Angular only loads templates from the same domain and protocol as the application document. This is done by calling $sce.getTrustedResourceUrl on the template URL. To load templates from other domains and/or protocols, you may either either whitelist them or wrap it into a trusted value. *Please note*: The browser's Same Origin Policy and Cross-Origin Resource Sharing (CORS) policy apply in addition to this and may further restrict whether the template is successfully loaded. This means that without the right CORS policy, loading templates from a different domain won't work on all browsers. Also, loading templates from file:// URL does not work on some browsers. This feels like too much overhead for the developer? ---------------------------------------------------- It's important to remember that SCE only applies to interpolation expressions. If your expressions are constant literals, they're automatically trusted and you don't need to call $sce.trustAs on them. e.g. <div ng-html-bind-unsafe="'<b>implicitly trusted</b>'"></div> just works. Additionally, a[href] and img[src] automatically sanitize their URLs and do not pass them through $sce.getTrusted. SCE doesn't play a role here. The included $sceDelegate comes with sane defaults to allow you to load templates in ng-include from your application's domain without having to even know about SCE. It blocks loading templates from other domains or loading templates over http from an https served document. You can change these by setting your own custom whitelists and blacklists for matching such URLs. This significantly reduces the overhead. It is far easier to pay the small overhead and have an application that's secure and can be audited to verify that with much more ease than bolting security onto an application later.
2013-07-24docs(directive): Clarified and cleaned up directive guideDean Sofer
- corrected terminology about how directives use `require` - added more variations to the DirectiveDefinitionObject - removed some slightly superfluous text docs(directive): Minor correction to example to avoid bad practice Anchor tags should use `ng-href` instead of `href` for interpolation. docs(directive): Supplementing DDO description DDO = Directive Definition Object Tweak recommended here: https://github.com/angular/angular.js/pull/2888/files#r4664565
2013-07-24docs(minErr): Build minErr doc siteKen Sheedlo
2013-07-23docs(bootstrap): Note that ngScenario requires ngAppBraden Shepherdson
ngScenario expects an ngApp directive to be used, and doesn't work for manually bootstrapped apps. The failure mode is to hang on navigation. Trying to make this wont-fix bug less obscure by documenting it. Eventually Protractor will replace ngScenario and fix this.
2013-07-23docs(index): add seed app link to menu itemRichard John
2013-07-18chore(ngdocs): fix improve button overlapMatias Niemelä
2013-07-16fix(writer): fix makeDir directory tree bugKen Sheedlo
2013-07-15fix($animator): ensure animations are always disabled for an element that is ↵Matias Niemelä
not attached to the DOM
2013-07-15chore(ngdocs): remove autofocus for the filtering searchMatias Niemelä
2013-07-14docs(di): promote registering controllers on modulessdesmond
2013-07-12chore(ngdoc): wrap all pages inside of a container tag for easy stylingMatias Niemelä
2013-07-12style(ngdocs): fix minor CSS issuesAlex Olshansky
2013-07-11feat(ngDocs): add links to source for APIJulien Bouquillon
- add tests - the link points to the gruntUtil.getVersion().number tree on github
2013-07-10docs(guide): clarify examplesdesmond
2013-07-10docs(guide): example filter does not conditionally assign a colorsdesmond
2013-07-10docs(guide/di): fix typoRobert Fauver
2013-07-10docs(contribute): improve git instructionsTay Ray Chuan
2013-07-10docs(overview): fix typoLefteris Paraskevas
Removed repeated "the" in the sentence: The input invalidates itself by turning red when you enter invalid data or leave "the" the input fields blank (Line 137).
2013-07-09fix(ngdocs): merge duplicate css class attributesAlex Olshansky
2013-07-07docs(guide/e2e-testing): fix typostgkokk
2013-07-04docs(guide/directive): make directive controller minification-safeAndrew O'Brien
It is best to emphasize that the "controller" property needs to be min safe Closes #3125
2013-07-02docs(tutorial/step9): formatted Unicode character lineexex zian
Add tick and cross mark corresponding to their respective unicodes.
2013-07-02docs(guide/location): fix example code - `hashPrefix` is a methodNiall Smart
2013-06-28docs(misc/faq): remove obsolte t-shirt instructionsIgor Minar
2013-06-27docs(guide/e2e-testing): clarify description of input(name) selectorAdam
The description of the input selector made it seem that you were selecting an input element based upon it's name attribute. In reality, you are selecting an element by the string in the ng-model attribute.
2013-06-27docs(tutorial): add experiment showing reverse sortNelson Blaha
2013-06-25docs(guide/controller): fix an error in the scope inheritance exampleJeffrey Palmer
The chained scope creation example at the bottom of this document was using the childCtrl to create the babyScope, instead of the childScope.