107 lines
5.1 KiB
HTML
107 lines
5.1 KiB
HTML
<h1><code ng:non-bindable="">input [text]</code>
|
||
<span class="hint">(directive in module <code ng:non-bindable="">ng</code>
|
||
)</span>
|
||
</h1>
|
||
<div><a href="http://github.com/angular/angular.js/edit/master/src/ng/directive/input.js" class="improve-docs btn btn-primary">Improve this doc</a><h2 id="Description">Description</h2>
|
||
<div class="description"><p>Standard HTML text input with angular data binding.</p></div>
|
||
<h2 id="Usage">Usage</h2>
|
||
<div class="usage"><pre class="prettyprint linenums"><input type="text"
|
||
ng-model="{string}"
|
||
[name="{string}"]
|
||
[required]
|
||
[ng-required="{string}"]
|
||
[ng-minlength="{number}"]
|
||
[ng-maxlength="{number}"]
|
||
[ng-pattern="{string}"]
|
||
[ng-change="{string}"]
|
||
[ng-trim="{boolean}"]></pre>
|
||
<h3 id="Parameters">Parameters</h3>
|
||
<ul class="parameters"><li><code ng:non-bindable="">ngModel – {string} – </code>
|
||
<p>Assignable angular expression to data-bind to.</p></li>
|
||
<li><code ng:non-bindable="">name<i>(optional)</i> – {string=} – </code>
|
||
<p>Property name of the form under which the control is published.</p></li>
|
||
<li><code ng:non-bindable="">required<i>(optional)</i> – {string=} – </code>
|
||
<p>Adds <code>required</code> validation error key if the value is not entered.</p></li>
|
||
<li><code ng:non-bindable="">ngRequired<i>(optional)</i> – {string=} – </code>
|
||
<p>Adds <code>required</code> attribute and <code>required</code> validation constraint to
|
||
the element when the ngRequired expression evaluates to true. Use <code>ngRequired</code> instead of
|
||
<code>required</code> when you want to data-bind to the <code>required</code> attribute.</p></li>
|
||
<li><code ng:non-bindable="">ngMinlength<i>(optional)</i> – {number=} – </code>
|
||
<p>Sets <code>minlength</code> validation error key if the value is shorter than
|
||
minlength.</p></li>
|
||
<li><code ng:non-bindable="">ngMaxlength<i>(optional)</i> – {number=} – </code>
|
||
<p>Sets <code>maxlength</code> validation error key if the value is longer than
|
||
maxlength.</p></li>
|
||
<li><code ng:non-bindable="">ngPattern<i>(optional)</i> – {string=} – </code>
|
||
<p>Sets <code>pattern</code> validation error key if the value does not match the
|
||
RegExp pattern expression. Expected value is <code>/regexp/</code> for inline patterns or <code>regexp</code> for
|
||
patterns defined as scope expressions.</p></li>
|
||
<li><code ng:non-bindable="">ngChange<i>(optional)</i> – {string=} – </code>
|
||
<p>Angular expression to be executed when input changes due to user
|
||
interaction with the input element.</p></li>
|
||
<li><code ng:non-bindable="">ngTrim<i>(optional=true)</i> – {boolean=} – </code>
|
||
<p>If set to false Angular will not automatically trimming the
|
||
input.</p></li>
|
||
</ul>
|
||
</div>
|
||
<h2 id="Example">Example</h2>
|
||
<div class="example"><h4>Source</h4>
|
||
<div source-edit="" source-edit-deps="angular.js script.js" source-edit-html="index.html-119" source-edit-css="" source-edit-js="script.js-118" source-edit-unit="" source-edit-scenario="scenario.js-120"></div>
|
||
<div class="tabbable"><div class="tab-pane" title="index.html">
|
||
<pre class="prettyprint linenums" ng-set-text="index.html-119" ng-html-wrap=" angular.js script.js"></pre>
|
||
<script type="text/ng-template" id="index.html-119">
|
||
|
||
<form name="myForm" ng-controller="Ctrl">
|
||
Single word: <input type="text" name="input" ng-model="text"
|
||
ng-pattern="word" required ng-trim="false">
|
||
<span class="error" ng-show="myForm.input.$error.required">
|
||
Required!</span>
|
||
<span class="error" ng-show="myForm.input.$error.pattern">
|
||
Single word only!</span>
|
||
|
||
<tt>text = {{text}}</tt><br/>
|
||
<tt>myForm.input.$valid = {{myForm.input.$valid}}</tt><br/>
|
||
<tt>myForm.input.$error = {{myForm.input.$error}}</tt><br/>
|
||
<tt>myForm.$valid = {{myForm.$valid}}</tt><br/>
|
||
<tt>myForm.$error.required = {{!!myForm.$error.required}}</tt><br/>
|
||
</form>
|
||
</script>
|
||
</div>
|
||
<div class="tab-pane" title="script.js">
|
||
<pre class="prettyprint linenums" ng-set-text="script.js-118"></pre>
|
||
<script type="text/ng-template" id="script.js-118">
|
||
function Ctrl($scope) {
|
||
$scope.text = 'guest';
|
||
$scope.word = /^\s*\w*\s*$/;
|
||
}
|
||
</script>
|
||
</div>
|
||
<div class="tab-pane" title="End to end test">
|
||
<pre class="prettyprint linenums" ng-set-text="scenario.js-120"></pre>
|
||
<script type="text/ng-template" id="scenario.js-120">
|
||
it('should initialize to model', function() {
|
||
expect(binding('text')).toEqual('guest');
|
||
expect(binding('myForm.input.$valid')).toEqual('true');
|
||
});
|
||
|
||
it('should be invalid if empty', function() {
|
||
input('text').enter('');
|
||
expect(binding('text')).toEqual('');
|
||
expect(binding('myForm.input.$valid')).toEqual('false');
|
||
});
|
||
|
||
it('should be invalid if multi word', function() {
|
||
input('text').enter('hello world');
|
||
expect(binding('myForm.input.$valid')).toEqual('false');
|
||
});
|
||
|
||
it('should not be trimmed', function() {
|
||
input('text').enter('untrimmed ');
|
||
expect(binding('text')).toEqual('untrimmed ');
|
||
expect(binding('myForm.input.$valid')).toEqual('true');
|
||
});
|
||
</script>
|
||
</div>
|
||
</div><h4>Demo</h4>
|
||
<div class="well doc-example-live animator-container" ng-embed-app="" ng-set-html="index.html-119" ng-eval-javascript="script.js-118"></div></div>
|
||
</div>
|