HOWTO · Angular
在 Angular 中的输入字段上设置焦点
本教程通过示例演示如何在 Angular 中的输入字段上设置焦点。
本页内容
要在输入框显示时将其聚焦,可使用自定义指令,在表单显示后调用 DOM 元素的 focus() 方法。下面的示例使用的是旧版框架 AngularJS 1.x,并非现代 Angular。ng-model 会将输入框的值绑定到模型属性,但不会聚焦输入框,也不会验证其内容。
在 Angular 中设置输入框焦点的步骤
通过一个简单的替代对象,可以单独观察 focus() 调用。这段 JavaScript 示例不会运行 AngularJS 或浏览器;后面会给出完整的浏览器配置。
运行此示例:
const input = {
focused: false,
focus() {
this.focused = true;
}
};
input.focus();
console.log(`Focused: ${input.focused}`);
输出为 Focused: true,其中标签 Focused: 保持英文。
Focused: true
在 AngularJS 中,将指令注册到与控制器相同的模块上,然后为输入框添加 focus-me 属性。点击处理程序会显示表单并设置聚焦触发值。短暂的 $timeout 会让 AngularJS 先完成视图更新,再由指令聚焦已显示的元素。
下面的独立浏览器页面包含模块、控制器、指令和标记。如果应用不使用 CDN,请将 AngularJS 脚本 URL 替换为本地托管的副本。该页面使用 AngularJS 1.0.4,以匹配原示例所用的版本;这里展示这个旧版本仅供参考,不建议在新应用中使用。
<!doctype html>
<html ng-app="focusDemo">
<head>
<meta charset="utf-8">
<title>AngularJS input focus</title>
<script src="https://ajax.googleapis.com/ajax/libs/angularjs/1.0.4/angular.js"></script>
<script>
var app = angular.module('focusDemo', []);
app.controller('DemoController', ['$scope', function($scope) {
$scope.showForm = false;
$scope.focusInput = false;
}]);
app.directive('focusMe', ['$timeout', function($timeout) {
return {
scope: { focusMe: '=' },
link: function(scope, element) {
scope.$watch('focusMe', function(value) {
if (value) {
$timeout(function() {
element[0].focus();
scope.focusMe = false;
});
}
});
}
};
}]);
</script>
</head>
<body ng-controller="DemoController">
<button type="button" ng-click="showForm = true; focusInput = true">
Show the form
</button>
<div ng-show="showForm">
<label for="name">Name</label>
<input id="name" type="text" ng-model="name" focus-me="focusInput">
<button type="button" ng-click="showForm = false">Done</button>
<p>The browser's focus indicator marks the active input.</p>
</div>
</body>
</html>
AngularJS 会将 focus-me 属性规范化为指令名称 focusMe。指令的隔离作用域属性与该属性同名,而 = 绑定会将它连接到控制器上的 focusInput。按钮将该值设为 true 时,监听器会安排在视图更新后聚焦输入框;随后它会重置该值,以便再次触发此操作。输入框必须处于可见且启用状态,浏览器才能将焦点移到它上面。焦点指示器由浏览器根据自身样式绘制,因此其外观可能因浏览器和主题而异。
焦点会将键盘光标移到输入框,但不会确认输入值是否有效,也不能防止输入错误。需要输入规则时,应另行添加 AngularJS 表单验证。ngBlur 会在元素失去焦点时作出响应,例如用户按 Tab 键移开焦点时;它既不是聚焦输入框所必需的,也不会让焦点离开输入框。此浏览器示例未经运行验证。
表单显示时使用此模式可以少一次点击,并让用户清楚接下来可以在哪里输入。应谨慎使用自动聚焦:如果焦点意外移动,可能会让键盘和屏幕阅读器用户感到困惑,尤其是在较长的操作流程中。请保留可见标签和清晰的 Tab 键顺序,并允许用户在输入框获得焦点后正常移动焦点。