62 lines
3.8 KiB
HTML
Executable file
62 lines
3.8 KiB
HTML
Executable file
<a href="http://github.com/angular/angular.js/tree/v1.2.0rc1/src/ng/directive/ngBind.js#L3" class="view-source btn btn-action"><i class="icon-zoom-in"> </i> View source</a><a href="http://github.com/angular/angular.js/edit/master/src/ng/directive/ngBind.js" class="improve-docs btn btn-primary"><i class="icon-edit"> </i> Improve this doc</a><h1><code ng:non-bindable="">ngBind</code>
|
|
<div><span class="hint">directive in module <code ng:non-bindable="">ng</code>
|
|
</span>
|
|
</div>
|
|
</h1>
|
|
<div><h2 id="Description">Description</h2>
|
|
<div class="description"><div class="ng-directive-page ng-directive-ngbind-page"><p>The <code>ngBind</code> attribute tells Angular to replace the text content of the specified HTML element
|
|
with the value of a given expression, and to update the text content when the value of that
|
|
expression changes.</p>
|
|
<p>Typically, you don't use <code>ngBind</code> directly, but instead you use the double curly markup like
|
|
<code>{{ expression }}</code> which is similar but less verbose.</p>
|
|
<p>It is preferrable to use <code>ngBind</code> instead of <code>{{ expression }}</code> when a template is momentarily
|
|
displayed by the browser in its raw state before Angular compiles it. Since <code>ngBind</code> is an
|
|
element attribute, it makes the bindings invisible to the user while the page is loading.</p>
|
|
<p>An alternative solution to this problem would be using the
|
|
<a href="api/ng.directive:ngCloak"><code>ngCloak</code></a> directive.</p>
|
|
</div></div>
|
|
<h2 id="Usage">Usage</h2>
|
|
<div class="usage">as attribute<pre class="prettyprint linenums"><ANY ng-bind="{expression}">
|
|
...
|
|
</ANY></pre>
|
|
as class<pre class="prettyprint linenums"><ANY class="ng-bind: {expression};">
|
|
...
|
|
</ANY></pre>
|
|
<h4 id="parameters">Parameters</h4><table class="variables-matrix table table-bordered table-striped"><thead><tr><th>Param</th><th>Type</th><th>Details</th></tr></thead><tbody><tr><td>ngBind</td><td><a href="" class="label type-hint type-hint-expression">expression</a></td><td><div class="ng-directive-page ng-directive-ngbind-page"><p><a href="guide/expression">Expression</a> to evaluate.</p>
|
|
</div></td></tr></tbody></table></div>
|
|
<h2 id="Example">Example</h2>
|
|
<div class="example"><div class="ng-directive-page ng-directive-ngbind-page"><p>Enter a name in the Live Preview text box; the greeting below the text box changes instantly.
|
|
<h4>Source</h2>
|
|
<div source-edit="" source-edit-deps="angular.js script.js" source-edit-html="index.html-17" source-edit-css="" source-edit-js="script.js-16" source-edit-json="" source-edit-unit="" source-edit-scenario="scenario.js-18"></div>
|
|
<div class="tabbable"><div class="tab-pane" title="index.html">
|
|
<pre class="prettyprint linenums" ng-set-text="index.html-17" ng-html-wrap=" angular.js script.js"></pre>
|
|
<script type="text/ng-template" id="index.html-17">
|
|
|
|
<div ng-controller="Ctrl">
|
|
Enter name: <input type="text" ng-model="name"><br>
|
|
Hello <span ng-bind="name"></span>!
|
|
</div>
|
|
</script>
|
|
</div>
|
|
<div class="tab-pane" title="script.js">
|
|
<pre class="prettyprint linenums" ng-set-text="script.js-16"></pre>
|
|
<script type="text/ng-template" id="script.js-16">
|
|
function Ctrl($scope) {
|
|
$scope.name = 'Whirled';
|
|
}
|
|
</script>
|
|
</div>
|
|
<div class="tab-pane" title="End to end test">
|
|
<pre class="prettyprint linenums" ng-set-text="scenario.js-18"></pre>
|
|
<script type="text/ng-template" id="scenario.js-18">
|
|
it('should check ng-bind', function() {
|
|
expect(using('.doc-example-live').binding('name')).toBe('Whirled');
|
|
using('.doc-example-live').input('name').enter('world');
|
|
expect(using('.doc-example-live').binding('name')).toBe('world');
|
|
});
|
|
</script>
|
|
</div>
|
|
</div><h2>Demo</h4>
|
|
<div class="well doc-example-live animate-container" ng-embed-app="" ng-set-html="index.html-17" ng-eval-javascript="script.js-16"></div>
|
|
</div></div>
|
|
</div>
|