Key Takeaways
- The attempt to create a JavaScript functionality that allows screenreader users to hear their password as they type it, while keeping the field visually obfuscated, failed due to several challenges.
- The first prototype involved copying the password field value to an element with aria-live=”assertive”, which would then announce the value to the screenreader. However, this approach resulted in the entire password being announced as a single word, rather than letter by letter, and special characters or capital letters were not announced correctly.
- The second prototype tried to address this issue by announcing individual letters in response to keypress events. However, this solution limited the input speed and created a new problem.
- The experiment revealed a significant issue with ARIA live regions, where most browser/screenreader combinations do not honor the “assertive” value and treat it the same as “polite”. This means that assertive messages are not announced until the screenreader is silent.
- The key takeaway from this experiment is that if a solution cannot solve a problem in a usable and intuitive way, it has not truly solved the problem. Accessibility is not just about meeting abstract checks, but about improving usability for people with specific needs.
It’s quite common for password fields to have a “Show Password” function — a checkbox or button which temporarily converts the field to plain text, so that users can see the password they’re typing.
However it occurred to me that this might not be secure for screenreader users, because a person who’s blind might not know if someone else is looking at their screen (for example, in a semi-public space such as an office or conference room).
Password fields are obfuscated for screenreaders just as they are visually — the screenreader will say star
or similar for each typed letter, rather than announcing the letter itself. Just as it is for sighted users, the screenreader user has no interactive feedback to confirm that they’ve typed their password correctly.
So I wanted to explore the possibility of scripting this functionality, so that a screenreader user could hear what they’re typing while the field remains visually obfuscated. Then a user who’s listening with earphones would have the security of knowing that their password is not being revealed to anyone around them.
It didn’t work!
But along the way, I was reminded of some home truths about accessible JavaScript, and of an unfortunate problem with ARIA live regions which has wider implications for accessible scripting in general.
The First Prototype
The basic idea I had in mind was quite simple: an element with aria-live="assertive"
would be added to the page, then whenever the password field was edited, its value would be copied to that element. Since it’s a live region, the new value would be immediately announced by screenreaders, but it would also be hidden with off-left positioning and wouldn’t be in the tab order, so it wouldn’t be otherwise apparent.
Here’s the code for that (or view the first prototype on its own page):
If you’re using an ARIA-supporting screenreader, the Hear Password
button should enable this functionality and immediately speak whatever value is already in the field. Then while it remains enabled, the screenreader will announce the value as it’s typed (as well as saying star
).
If you’re not using a screenreader, you won’t hear anything. Although it would be possible to implement direct text-to-speech using something like meSpeak.js, I don’t think that’s a good idea — because anyone who needs this functionality already has a screenreader.
More to the point, they have a screenreader in which they control the voice and speech rate; external TTS would just get in the way.
The following video demonstrates what a screenreader user would experience (using Firefox + NVDA):
Now one problem that’s immediately obvious is that copying the whole value to a live region means that the value is treated as a word; each time the user types a letter, the entire value is announced, rather than just the letter they typed. This is quite different from the behaviour of a standard text field, where the spoken feedback tells you the individual letters as they’re typed.
In that example I typed a password that could be interpreted as a word, but what if the value is more convoluted, something like "NCC-1701"
? Well, in that case NVDA will says n c c one thousand seven hundred and one
, which is problematic for another reason: it didn’t tell us that the first three letters were capitals rather than lower-case, and it didn’t announce the dash at all. The situation is slightly better in Jaws, which does speak the dash, but it still doesn’t mention the capitals.
This is a pretty fundamental problem. If your password happens to be a single lowercase word, then this solution would work quite well, but if it’s a mixture of special characters, then you might not get to hear the whole password at all. You might, for example, think that you typed "ncc1701"
rather than "NCC-1701"
, and the difference is obviously significant when we’re verifying a password!
And that’s not even a particular difficult example. What if your password was something complex like "goHuE&-A"
— NVDA would pronounce that as go hooey and a
, which is really not helpful at all! Or what if your password was something like "gate"
, but you actually typed "gaite"
— the spoken feedback would be exactly the same in both cases.
The Second Prototype
Maybe we could improve this by providing more detailed feedback. Instead of speaking the whole value whenever the value changes, we could speak the individual letters in response to keypress
events.
Here’s the modified code for that approach (or view the second prototype on its own page):
And here it is being used in Firefox + NVDA:
In one sense it’s better, since it provides more detailed feedback as you’re typing, but in another sense it’s worse, because it limits your input speed. Each letter still says star
before it speaks the actual character, so you have to wait for that to happen in order to hear the character; if you type more quickly, then you don’t hear any of the letters until you’ve stopped, at which point you only hear the last one (as demonstrated in the video).
So all this updated prototype does is solve one problem by creating a different one.
No More Prototypes!
Maybe there are ways we can improve it. Perhaps we could split the value by spaces, for example, to output "h e l l o"
instead of "hello"
, so that the individual letters are spoken instead of the whole word. That would work for letters, but it wouldn’t address the problem of not speaking capitals or punctuation, and would only compound the problem with passwords that contained spaces.
In any case, we’re well into the realms of ugly hacking now! Sometimes, it gets to the point where more hacking just leads to more hacking, and we have to step back from what we’re doing, and ask — was the whole thing a bad idea? Unless we can make it respond just like a regular plain text field, we’re never going to have an intuitive solution.
And as watchwords go, that’s pretty useful. If we can’t create an intuitive solution — if the only way to do something is to endlessly hack around the minutiae of a kludgy solution — then maybe it wasn’t worth doing in the first place.
Is This Thing Live?
But there’s a bigger problem to contend with that makes it all rather irrelevant, which is that it doesn’t works in IE + Jaws; since that’s the most popular combination, failing to work there is a pretty big deal.
Here’s the first prototype again being used in IE + Jaws:
You can see how pressing the Hear Password
button simply announces the updated state of the button, it doesn’t read the value in the live region. The reason for this comes down to the behaviour of aria-live="assertive"
.
The aria-live
attribute has three possible values, that determine how assertive the message should be:
"off"
means the change in content is not announced."polite"
means the change should only be announced when the user is idle (i.e. waiting until the screenreader stops whatever it’s speaking at the time)"assertive"
means the change should be immediately announced (i.e. interrupting whatever the screenreader is speaking at the time)
But recently, Russ Weakley and I did some testing with ARIA live regions in preparation for a forthcoming Learnable course, and what we discovered is so significant that it deserves a bold paragraph all on its own:
Assertive live regions are not usually assertive.
In other words, most browser/screenreader combinations don’t actually honour the "assertive"
value, they treat it the same as "polite"
. Specifically — only VoiceOver with Chrome or Safari will actually interrupt the user to announce an assertive message; all other tested combinations (including NVDA or Jaws with any browser) won’t announce it until the screenreader is silent.
What we have in these prototypes then, is an assertive region being treated as polite. The value did get announced in Firefox + NVDA because clicking the Hear Password
button doesn’t trigger anything else — NVDA doesn’t read the updated button text, and since nothing else is being spoken, a polite message can be announced. However in IE + Jaws, clicking the button does cause it to read the updated button text, which means that the reader is not idle, and therefore the live region isn’t announced.
Conclusion
None of this should be taken as a reason for not implementing standard Show Password
functionality (i.e. that simply switches the field type). Those solutions can be accessible to screenreaders, the only concern is the potential security/privacy risk they present.
But if the alternative is not to provide any means for any users to see their password, then it’s arguably better to do that, than to do nothing. (Though there might be a usability case for saying that password fields simply shouldn’t be masked at all, but such questions are beyond the scope of this article.)
We could perhaps mitigate the risk by explaining it for screenreader users, which we can do by adding aria-label
to the triggering button. When a button or link has aria-label
, a screenreader will speak the label text instead of the element’s content — so it must at least contain the same information, but can also have supplementary information that’s only relevant for screenreader users (and this technique has a whole variety of uses):
<button aria-label="Show password as plain text. Note: this will visually expose your password on the screen."> Show Password </button>
Ultimately though, what’s important to take from this experiment is a basic truth about accessible scripting: if it can’t solve a problem in a usable and intuitive way, then it hasn’t solved the problem.
Accessibility is not an exercise in meeting abstract checks, it’s about improving usability for people with specific needs. So a solution that’s technically accessible but is not usable for these groups of users, can’t really be considered accessible at all.
Frequently Asked Questions (FAQs) about JavaScript Password Visibility
How can I create a toggle button to show or hide the password in JavaScript?
Creating a toggle button to show or hide the password in JavaScript involves manipulating the input type attribute. You can create a checkbox and use the ‘change’ event to switch the input type between ‘password’ and ‘text’. Here’s a simple example:var passwordInput = document.getElementById('password');
var toggleButton = document.getElementById('toggle');
toggleButton.addEventListener('change', function () {
if (toggleButton.checked) {
passwordInput.type = 'text';
} else {
passwordInput.type = 'password';
}
});
In this code, when the checkbox is checked, the password input type changes to ‘text’, making the password visible. When it’s unchecked, the input type reverts to ‘password’, hiding the password.
How can I make my password toggle feature accessible?
Accessibility is a crucial aspect of web development. For your password toggle feature, you can improve accessibility by adding appropriate labels and instructions. For instance, you can use the ‘aria-label’ attribute to provide a description of the checkbox’s purpose. You can also use the ‘aria-checked’ attribute to indicate whether the checkbox is checked or not. Here’s how you can modify the previous example for better accessibility:var passwordInput = document.getElementById('password');
var toggleButton = document.getElementById('toggle');
toggleButton.setAttribute('aria-label', 'Show password');
toggleButton.setAttribute('aria-checked', 'false');
toggleButton.addEventListener('change', function () {
if (toggleButton.checked) {
passwordInput.type = 'text';
toggleButton.setAttribute('aria-checked', 'true');
} else {
passwordInput.type = 'password';
toggleButton.setAttribute('aria-checked', 'false');
}
});
In this code, the ‘aria-label’ attribute provides a description of the checkbox, and the ‘aria-checked’ attribute indicates whether the checkbox is checked or not.
Can I use jQuery to toggle password visibility?
Yes, you can use jQuery to toggle password visibility. jQuery provides a simpler and more concise syntax compared to plain JavaScript. Here’s how you can do it:$('#toggle').change(function () {
if ($(this).is(':checked')) {
$('#password').attr('type', 'text');
} else {
$('#password').attr('type', 'password');
}
});
In this code, the ‘change’ event is attached to the checkbox using the ‘ function and the ‘change’ method. The ‘is’ method is used to check whether the checkbox is checked or not, and the ‘attr’ method is used to change the input type.
How can I style the password toggle feature?
You can style the password toggle feature using CSS. For instance, you can change the appearance of the checkbox and the label using the ‘appearance’, ‘width’, ‘height’, ‘background’, and ‘border’ properties. You can also use the ‘:checked’ pseudo-class to style the checkbox when it’s checked. Here’s an example:#toggle {
appearance: none;
width: 20px;
height: 20px;
background: #fff;
border: 1px solid #ccc;
}
#toggle:checked {
background: #0f0;
}
In this code, the ‘appearance’ property is used to remove the default appearance of the checkbox, and the ‘width’, ‘height’, ‘background’, and ‘border’ properties are used to style it. The ‘:checked’ pseudo-class is used to change the background color when the checkbox is checked.
How can I add an icon to the password toggle feature?
You can add an icon to the password toggle feature using an icon library like Font Awesome or by using an image. If you’re using an icon library, you can add the icon as a class to an ‘i’ element. If you’re using an image, you can add it as a background image to the checkbox. Here’s how you can do it with Font Awesome:<input type="password" id="password">
<i class="fas fa-eye" id="toggle"></i>
$('#toggle').click(function () {
if ($('#password').attr('type') === 'password') {
$('#password').attr('type', 'text');
$(this).removeClass('fa-eye').addClass('fa-eye-slash');
} else {
$('#password').attr('type', 'password');
$(this).removeClass('fa-eye-slash').addClass('fa-eye');
}
});
In this code, the ‘click’ event is attached to the icon using the ‘ function and the ‘click’ method. The ‘removeClass’ and ‘addClass’ methods are used to change the icon when it’s clicked.
How can I test the password toggle feature?
You can test the password toggle feature using various methods. One way is to manually test it by entering a password and clicking the checkbox or icon to see if the password is shown or hidden. Another way is to use automated testing tools like Jest or Mocha. These tools allow you to write tests that simulate user interactions and check the resulting changes in the DOM. Here’s an example of a test with Jest:test('toggles password visibility', () => {
document.body.innerHTML = `
<input type="password" id="password">
<input type="checkbox" id="toggle">
`;
require('./togglePassword');
var passwordInput = document.getElementById('password');
var toggleButton = document.getElementById('toggle');
toggleButton.click();
expect(passwordInput.type).toBe('text');
toggleButton.click();
expect(passwordInput.type).toBe('password');
});
In this test, the ‘click’ method is used to simulate a click on the checkbox, and the ‘expect’ function is used to check the input type.
How can I add the password toggle feature to a form?
You can add the password toggle feature to a form by including the password input and the checkbox or icon inside a ‘form’ element. You can also add other inputs like ’email’ or ‘username’ to the form. Here’s an example:<form>
<label for="email">Email:</label>
<input type="email" id="email">
<label for="password">Password:</label>
<input type="password" id="password">
<input type="checkbox" id="toggle">
</form>
In this form, the ‘label’ elements provide descriptions for the inputs, and the ‘for’ attribute associates each label with an input.
How can I prevent the password from being shown when the form is submitted?
You can prevent the password from being shown when the form is submitted by adding a ‘submit’ event listener to the form and changing the password input type to ‘password’ inside the event handler. Here’s how you can do it:var form = document.getElementById('form');
var passwordInput = document.getElementById('password');
form.addEventListener('submit', function (event) {
event.preventDefault();
passwordInput.type = 'password';
});
In this code, the ‘preventDefault’ method is used to prevent the form from being submitted, and the password input type is changed to ‘password’ to hide the password.
How can I improve the security of the password toggle feature?
You can improve the security of the password toggle feature by limiting the time the password is shown. For instance, you can use the ‘setTimeout’ function to change the password input type back to ‘password’ after a certain period of time. Here’s an example:var passwordInput = document.getElementById('password');
var toggleButton = document.getElementById('toggle');
toggleButton.addEventListener('change', function () {
if (toggleButton.checked) {
passwordInput.type = 'text';
setTimeout(function () {
passwordInput.type = 'password';
toggleButton.checked = false;
}, 5000);
} else {
passwordInput.type = 'password';
}
});
In this code, the ‘setTimeout’ function is used to change the password input type back to ‘password’ and uncheck the checkbox after 5 seconds.
How can I add multiple password toggle features to a page?
You can add multiple password toggle features to a page by using class selectors instead of id selectors. You can then use the ‘querySelectorAll’ method to select all the password inputs and checkboxes, and the ‘forEach’ method to attach an event listener to each of them. Here’s how you can do it:var passwordInputs = document.querySelectorAll('.password');
var toggleButtons = document.querySelectorAll('.toggle');
passwordInputs.forEach(function (passwordInput, index) {
var toggleButton = toggleButtons[index];
toggleButton.addEventListener('change', function () {
if (toggleButton.checked) {
passwordInput.type = 'text';
} else {
passwordInput.type = 'password';
}
});
});
In this code, the ‘querySelectorAll’ method is used to select all the password inputs and checkboxes, and the ‘forEach’ method is used to attach an event listener to each of them. The ‘index’ parameter is used to associate each checkbox with a password input.
James is a freelance web developer based in the UK, specialising in JavaScript application development and building accessible websites. With more than a decade's professional experience, he is a published author, a frequent blogger and speaker, and an outspoken advocate of standards-based development.