3.5.2.1.6. 大小写锁定提示器

这个组件在用户使用 PasswordField 输入密码的时候提示用户是否开启了大小写锁定。

该组件对应的 XML 名称: capsLockIndicator

gui capsLockIndicator

可以用 capsLockOnMessage 和 capsLockOffMessage 属性来定义大小写锁定开启和关闭时的提示信息。

示例:

  1. <hbox spacing="true">
  2.     <passwordField id="passwordField"
  3.                    capsLockIndicator="capsLockIndicator"/>
  4.     <capsLockIndicator id="capsLockIndicator"/>
  5. </hbox>
  1. CapsLockIndicator capsLockIndicator = uiComponents.create(CapsLockIndicator.NAME);
  2. capsLockIndicator.setId("capsLockIndicator");
  3. passwordField.setCapsLockIndicator(capsLockIndicator);

CapsLockIndicator 组件被设计为配合 PasswordField 一起使用，当 PasswordField 获得焦点的时候该组件处理大小写锁定状态，当 PasswordField 失去焦点时，大小写锁定的状态就变成 inactive 了。因为此时没法监控关联的密码控件输入情况了。

可以用 visible 属性来动态改变 CapsLockIndicator 的可见性。但是如果此时界面已经打开了，控制可见性就不一定能按预想工作。

CapsLockIndicator 的展示可以使用带 $cuba-capslockindicator-* 前缀的 SCSS 变量进行自定义。可以在创建一个 主题扩展 或者一个 自定义主题 之后在可视化编辑器里修改这些变量的值。

capsLockIndicator 的属性

align - capsLockOffMessage - capsLockOnMessage - colspan - css - box.expandRatio - height - id - rowspan - stylename - visible - width