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 键顺序,并允许用户在输入框获得焦点后正常移动焦点。