mirror of
https://github.com/twbs/bootstrap.git
synced 2024-11-30 12:24:19 +01:00
5fd7bc1554
as role="menu" is a very specific (and strict) ARIA pattern for desktop-like application menus, and our dropdowns are often used as pure navigation dropdowns, this change abandons ARIA menus for a more open-ended and light-weight approach (see http://heydonworks.com/practical_aria_examples/#submenus and http://www.w3.org/WAI/tutorials/menus/flyout/#improve-screen-reader-support-using-wai-aria) note that in dropdown.js, switched to now target ``.dropdown-menu`` instead of ``role["menu"]`` - this also prevents bootstrap scripts from "bleeding" into non-bootstrap components on the same page. also removed the ``role=["listbox"]`` part, which appears to be vestigial/unused (only place in bootstrap that uses that role are carousels, and their key handling is done separately)
392 lines
14 KiB
JavaScript
392 lines
14 KiB
JavaScript
$(function () {
|
|
'use strict';
|
|
|
|
QUnit.module('dropdowns plugin')
|
|
|
|
QUnit.test('should be defined on jquery object', function (assert) {
|
|
assert.expect(1)
|
|
assert.ok($(document.body).dropdown, 'dropdown method is defined')
|
|
})
|
|
|
|
QUnit.module('dropdowns', {
|
|
beforeEach: function () {
|
|
// Run all tests in noConflict mode -- it's the only way to ensure that the plugin works in noConflict mode
|
|
$.fn.bootstrapDropdown = $.fn.dropdown.noConflict()
|
|
},
|
|
afterEach: function () {
|
|
$.fn.dropdown = $.fn.bootstrapDropdown
|
|
delete $.fn.bootstrapDropdown
|
|
}
|
|
})
|
|
|
|
QUnit.test('should provide no conflict', function (assert) {
|
|
assert.expect(1)
|
|
assert.strictEqual($.fn.dropdown, undefined, 'dropdown was set back to undefined (org value)')
|
|
})
|
|
|
|
QUnit.test('should return jquery collection containing the element', function (assert) {
|
|
assert.expect(2)
|
|
var $el = $('<div/>')
|
|
var $dropdown = $el.bootstrapDropdown()
|
|
assert.ok($dropdown instanceof $, 'returns jquery collection')
|
|
assert.strictEqual($dropdown[0], $el[0], 'collection contains element')
|
|
})
|
|
|
|
QUnit.test('should not open dropdown if target is disabled via attribute', function (assert) {
|
|
assert.expect(1)
|
|
var dropdownHTML = '<ul class="tabs">'
|
|
+ '<li class="dropdown">'
|
|
+ '<button disabled href="#" class="btn dropdown-toggle" data-toggle="dropdown">Dropdown</button>'
|
|
+ '<ul class="dropdown-menu">'
|
|
+ '<li><a href="#">Secondary link</a></li>'
|
|
+ '<li><a href="#">Something else here</a></li>'
|
|
+ '<li class="divider"/>'
|
|
+ '<li><a href="#">Another link</a></li>'
|
|
+ '</ul>'
|
|
+ '</li>'
|
|
+ '</ul>'
|
|
var $dropdown = $(dropdownHTML).find('[data-toggle="dropdown"]').bootstrapDropdown().trigger('click')
|
|
|
|
assert.ok(!$dropdown.parent('.dropdown').hasClass('open'), '"open" class added on click')
|
|
})
|
|
|
|
QUnit.test('should set aria-expanded="true" on target when dropdown menu is shown', function (assert) {
|
|
assert.expect(1)
|
|
var dropdownHTML = '<ul class="tabs">'
|
|
+ '<li class="dropdown">'
|
|
+ '<a href="#" class="dropdown-toggle" data-toggle="dropdown" aria-expanded="false">Dropdown</a>'
|
|
+ '<ul class="dropdown-menu">'
|
|
+ '<li><a href="#">Secondary link</a></li>'
|
|
+ '<li><a href="#">Something else here</a></li>'
|
|
+ '<li class="divider"/>'
|
|
+ '<li><a href="#">Another link</a></li>'
|
|
+ '</ul>'
|
|
+ '</li>'
|
|
+ '</ul>'
|
|
var $dropdown = $(dropdownHTML)
|
|
.find('[data-toggle="dropdown"]')
|
|
.bootstrapDropdown()
|
|
.trigger('click')
|
|
|
|
assert.strictEqual($dropdown.attr('aria-expanded'), 'true', 'aria-expanded is set to string "true" on click')
|
|
})
|
|
|
|
QUnit.test('should set aria-expanded="false" on target when dropdown menu is hidden', function (assert) {
|
|
assert.expect(1)
|
|
var done = assert.async()
|
|
var dropdownHTML = '<ul class="tabs">'
|
|
+ '<li class="dropdown">'
|
|
+ '<a href="#" class="dropdown-toggle" aria-expanded="false" data-toggle="dropdown">Dropdown</a>'
|
|
+ '<ul class="dropdown-menu">'
|
|
+ '<li><a href="#">Secondary link</a></li>'
|
|
+ '<li><a href="#">Something else here</a></li>'
|
|
+ '<li class="divider"/>'
|
|
+ '<li><a href="#">Another link</a></li>'
|
|
+ '</ul>'
|
|
+ '</li>'
|
|
+ '</ul>'
|
|
var $dropdown = $(dropdownHTML)
|
|
.appendTo('#qunit-fixture')
|
|
.find('[data-toggle="dropdown"]')
|
|
.bootstrapDropdown()
|
|
|
|
$dropdown
|
|
.parent('.dropdown')
|
|
.on('hidden.bs.dropdown', function () {
|
|
assert.strictEqual($dropdown.attr('aria-expanded'), 'false', 'aria-expanded is set to string "false" on hide')
|
|
done()
|
|
})
|
|
|
|
$dropdown.trigger('click')
|
|
$(document.body).trigger('click')
|
|
})
|
|
|
|
QUnit.test('should not open dropdown if target is disabled via class', function (assert) {
|
|
assert.expect(1)
|
|
var dropdownHTML = '<ul class="tabs">'
|
|
+ '<li class="dropdown">'
|
|
+ '<button href="#" class="btn dropdown-toggle disabled" data-toggle="dropdown">Dropdown</button>'
|
|
+ '<ul class="dropdown-menu">'
|
|
+ '<li><a href="#">Secondary link</a></li>'
|
|
+ '<li><a href="#">Something else here</a></li>'
|
|
+ '<li class="divider"/>'
|
|
+ '<li><a href="#">Another link</a></li>'
|
|
+ '</ul>'
|
|
+ '</li>'
|
|
+ '</ul>'
|
|
var $dropdown = $(dropdownHTML).find('[data-toggle="dropdown"]').bootstrapDropdown().trigger('click')
|
|
|
|
assert.ok(!$dropdown.parent('.dropdown').hasClass('open'), '"open" class added on click')
|
|
})
|
|
|
|
QUnit.test('should add class open to menu if clicked', function (assert) {
|
|
assert.expect(1)
|
|
var dropdownHTML = '<ul class="tabs">'
|
|
+ '<li class="dropdown">'
|
|
+ '<a href="#" class="dropdown-toggle" data-toggle="dropdown">Dropdown</a>'
|
|
+ '<ul class="dropdown-menu">'
|
|
+ '<li><a href="#">Secondary link</a></li>'
|
|
+ '<li><a href="#">Something else here</a></li>'
|
|
+ '<li class="divider"/>'
|
|
+ '<li><a href="#">Another link</a></li>'
|
|
+ '</ul>'
|
|
+ '</li>'
|
|
+ '</ul>'
|
|
var $dropdown = $(dropdownHTML).find('[data-toggle="dropdown"]').bootstrapDropdown().trigger('click')
|
|
|
|
assert.ok($dropdown.parent('.dropdown').hasClass('open'), '"open" class added on click')
|
|
})
|
|
|
|
QUnit.test('should test if element has a # before assuming it\'s a selector', function (assert) {
|
|
assert.expect(1)
|
|
var dropdownHTML = '<ul class="tabs">'
|
|
+ '<li class="dropdown">'
|
|
+ '<a href="/foo/" class="dropdown-toggle" data-toggle="dropdown">Dropdown</a>'
|
|
+ '<ul class="dropdown-menu">'
|
|
+ '<li><a href="#">Secondary link</a></li>'
|
|
+ '<li><a href="#">Something else here</a></li>'
|
|
+ '<li class="divider"/>'
|
|
+ '<li><a href="#">Another link</a></li>'
|
|
+ '</ul>'
|
|
+ '</li>'
|
|
+ '</ul>'
|
|
var $dropdown = $(dropdownHTML).find('[data-toggle="dropdown"]').bootstrapDropdown().trigger('click')
|
|
|
|
assert.ok($dropdown.parent('.dropdown').hasClass('open'), '"open" class added on click')
|
|
})
|
|
|
|
|
|
QUnit.test('should remove "open" class if body is clicked', function (assert) {
|
|
assert.expect(2)
|
|
var dropdownHTML = '<ul class="tabs">'
|
|
+ '<li class="dropdown">'
|
|
+ '<a href="#" class="dropdown-toggle" data-toggle="dropdown">Dropdown</a>'
|
|
+ '<ul class="dropdown-menu">'
|
|
+ '<li><a href="#">Secondary link</a></li>'
|
|
+ '<li><a href="#">Something else here</a></li>'
|
|
+ '<li class="divider"/>'
|
|
+ '<li><a href="#">Another link</a></li>'
|
|
+ '</ul>'
|
|
+ '</li>'
|
|
+ '</ul>'
|
|
var $dropdown = $(dropdownHTML)
|
|
.appendTo('#qunit-fixture')
|
|
.find('[data-toggle="dropdown"]')
|
|
.bootstrapDropdown()
|
|
.trigger('click')
|
|
|
|
assert.ok($dropdown.parent('.dropdown').hasClass('open'), '"open" class added on click')
|
|
$(document.body).trigger('click')
|
|
assert.ok(!$dropdown.parent('.dropdown').hasClass('open'), '"open" class removed')
|
|
})
|
|
|
|
QUnit.test('should remove "open" class if body is clicked, with multiple dropdowns', function (assert) {
|
|
assert.expect(7)
|
|
var dropdownHTML = '<ul class="nav">'
|
|
+ '<li><a href="#menu1">Menu 1</a></li>'
|
|
+ '<li class="dropdown" id="testmenu">'
|
|
+ '<a class="dropdown-toggle" data-toggle="dropdown" href="#testmenu">Test menu <span class="caret"/></a>'
|
|
+ '<ul class="dropdown-menu">'
|
|
+ '<li><a href="#sub1">Submenu 1</a></li>'
|
|
+ '</ul>'
|
|
+ '</li>'
|
|
+ '</ul>'
|
|
+ '<div class="btn-group">'
|
|
+ '<button class="btn">Actions</button>'
|
|
+ '<button class="btn dropdown-toggle" data-toggle="dropdown"><span class="caret"/></button>'
|
|
+ '<ul class="dropdown-menu">'
|
|
+ '<li><a href="#">Action 1</a></li>'
|
|
+ '</ul>'
|
|
+ '</div>'
|
|
var $dropdowns = $(dropdownHTML).appendTo('#qunit-fixture').find('[data-toggle="dropdown"]')
|
|
var $first = $dropdowns.first()
|
|
var $last = $dropdowns.last()
|
|
|
|
assert.strictEqual($dropdowns.length, 2, 'two dropdowns')
|
|
|
|
$first.trigger('click')
|
|
assert.strictEqual($first.parents('.open').length, 1, '"open" class added on click')
|
|
assert.strictEqual($('#qunit-fixture .open').length, 1, 'only one dropdown is open')
|
|
$(document.body).trigger('click')
|
|
assert.strictEqual($('#qunit-fixture .open').length, 0, '"open" class removed')
|
|
|
|
$last.trigger('click')
|
|
assert.strictEqual($last.parent('.open').length, 1, '"open" class added on click')
|
|
assert.strictEqual($('#qunit-fixture .open').length, 1, 'only one dropdown is open')
|
|
$(document.body).trigger('click')
|
|
assert.strictEqual($('#qunit-fixture .open').length, 0, '"open" class removed')
|
|
})
|
|
|
|
QUnit.test('should fire show and hide event', function (assert) {
|
|
assert.expect(2)
|
|
var dropdownHTML = '<ul class="tabs">'
|
|
+ '<li class="dropdown">'
|
|
+ '<a href="#" class="dropdown-toggle" data-toggle="dropdown">Dropdown</a>'
|
|
+ '<ul class="dropdown-menu">'
|
|
+ '<li><a href="#">Secondary link</a></li>'
|
|
+ '<li><a href="#">Something else here</a></li>'
|
|
+ '<li class="divider"/>'
|
|
+ '<li><a href="#">Another link</a></li>'
|
|
+ '</ul>'
|
|
+ '</li>'
|
|
+ '</ul>'
|
|
var $dropdown = $(dropdownHTML)
|
|
.appendTo('#qunit-fixture')
|
|
.find('[data-toggle="dropdown"]')
|
|
.bootstrapDropdown()
|
|
|
|
var done = assert.async()
|
|
|
|
$dropdown
|
|
.parent('.dropdown')
|
|
.on('show.bs.dropdown', function () {
|
|
assert.ok(true, 'show was fired')
|
|
})
|
|
.on('hide.bs.dropdown', function () {
|
|
assert.ok(true, 'hide was fired')
|
|
done()
|
|
})
|
|
|
|
$dropdown.trigger('click')
|
|
$(document.body).trigger('click')
|
|
})
|
|
|
|
|
|
QUnit.test('should fire shown and hidden event', function (assert) {
|
|
assert.expect(2)
|
|
var dropdownHTML = '<ul class="tabs">'
|
|
+ '<li class="dropdown">'
|
|
+ '<a href="#" class="dropdown-toggle" data-toggle="dropdown">Dropdown</a>'
|
|
+ '<ul class="dropdown-menu">'
|
|
+ '<li><a href="#">Secondary link</a></li>'
|
|
+ '<li><a href="#">Something else here</a></li>'
|
|
+ '<li class="divider"/>'
|
|
+ '<li><a href="#">Another link</a></li>'
|
|
+ '</ul>'
|
|
+ '</li>'
|
|
+ '</ul>'
|
|
var $dropdown = $(dropdownHTML)
|
|
.appendTo('#qunit-fixture')
|
|
.find('[data-toggle="dropdown"]')
|
|
.bootstrapDropdown()
|
|
|
|
var done = assert.async()
|
|
|
|
$dropdown
|
|
.parent('.dropdown')
|
|
.on('shown.bs.dropdown', function () {
|
|
assert.ok(true, 'shown was fired')
|
|
})
|
|
.on('hidden.bs.dropdown', function () {
|
|
assert.ok(true, 'hidden was fired')
|
|
done()
|
|
})
|
|
|
|
$dropdown.trigger('click')
|
|
$(document.body).trigger('click')
|
|
})
|
|
|
|
QUnit.test('should ignore keyboard events within <input>s and <textarea>s', function (assert) {
|
|
assert.expect(3)
|
|
var done = assert.async()
|
|
|
|
var dropdownHTML = '<ul class="tabs">'
|
|
+ '<li class="dropdown">'
|
|
+ '<a href="#" class="dropdown-toggle" data-toggle="dropdown">Dropdown</a>'
|
|
+ '<ul class="dropdown-menu">'
|
|
+ '<li><a href="#">Secondary link</a></li>'
|
|
+ '<li><a href="#">Something else here</a></li>'
|
|
+ '<li class="divider"/>'
|
|
+ '<li><a href="#">Another link</a></li>'
|
|
+ '<li><input type="text" id="input"></li>'
|
|
+ '<li><textarea id="textarea"/></li>'
|
|
+ '</ul>'
|
|
+ '</li>'
|
|
+ '</ul>'
|
|
var $dropdown = $(dropdownHTML)
|
|
.appendTo('#qunit-fixture')
|
|
.find('[data-toggle="dropdown"]')
|
|
.bootstrapDropdown()
|
|
|
|
var $input = $('#input')
|
|
var $textarea = $('#textarea')
|
|
|
|
$dropdown
|
|
.parent('.dropdown')
|
|
.on('shown.bs.dropdown', function () {
|
|
assert.ok(true, 'shown was fired')
|
|
|
|
$input.trigger('focus').trigger($.Event('keydown', { which: 38 }))
|
|
assert.ok($(document.activeElement).is($input), 'input still focused')
|
|
|
|
$textarea.trigger('focus').trigger($.Event('keydown', { which: 38 }))
|
|
assert.ok($(document.activeElement).is($textarea), 'textarea still focused')
|
|
|
|
done()
|
|
})
|
|
|
|
$dropdown.trigger('click')
|
|
})
|
|
|
|
QUnit.test('should skip disabled element when using keyboard navigation', function (assert) {
|
|
assert.expect(1)
|
|
var dropdownHTML = '<ul class="tabs">'
|
|
+ '<li class="dropdown">'
|
|
+ '<a href="#" class="dropdown-toggle" data-toggle="dropdown">Dropdown</a>'
|
|
+ '<ul class="dropdown-menu">'
|
|
+ '<li class="disabled"><a href="#">Disabled link</a></li>'
|
|
+ '<li><a href="#">Another link</a></li>'
|
|
+ '</ul>'
|
|
+ '</li>'
|
|
+ '</ul>'
|
|
var $dropdown = $(dropdownHTML)
|
|
.appendTo('#qunit-fixture')
|
|
.find('[data-toggle="dropdown"]')
|
|
.bootstrapDropdown()
|
|
.trigger('click')
|
|
|
|
$dropdown.trigger($.Event('keydown', { which: 40 }))
|
|
$dropdown.trigger($.Event('keydown', { which: 40 }))
|
|
|
|
assert.ok(!$(document.activeElement).parent().is('.disabled'), '.disabled is not focused')
|
|
})
|
|
|
|
QUnit.test('should not close the dropdown if the user clicks on a text field', function (assert) {
|
|
assert.expect(1)
|
|
var dropdownHTML = '<div class="btn-group">'
|
|
+ '<button type="button" data-toggle="dropdown">Dropdown</button>'
|
|
+ '<ul class="dropdown-menu">'
|
|
+ '<li><input id="textField" type="text" /></li>'
|
|
+ '</ul>'
|
|
+ '</div>'
|
|
var $dropdown = $(dropdownHTML)
|
|
.appendTo('#qunit-fixture')
|
|
.find('[data-toggle="dropdown"]')
|
|
.bootstrapDropdown()
|
|
.trigger('click')
|
|
|
|
$('#textField').trigger('click')
|
|
|
|
assert.ok($dropdown.parent('.btn-group').hasClass('open'), 'dropdown menu is open')
|
|
})
|
|
|
|
QUnit.test('should not close the dropdown if the user clicks on a textarea', function (assert) {
|
|
assert.expect(1)
|
|
var dropdownHTML = '<div class="btn-group">'
|
|
+ '<button type="button" data-toggle="dropdown">Dropdown</button>'
|
|
+ '<ul class="dropdown-menu">'
|
|
+ '<li><textarea id="textArea"></textarea></li>'
|
|
+ '</ul>'
|
|
+ '</div>'
|
|
var $dropdown = $(dropdownHTML)
|
|
.appendTo('#qunit-fixture')
|
|
.find('[data-toggle="dropdown"]')
|
|
.bootstrapDropdown()
|
|
.trigger('click')
|
|
|
|
$('#textArea').trigger('click')
|
|
|
|
assert.ok($dropdown.parent('.btn-group').hasClass('open'), 'dropdown menu is open')
|
|
})
|
|
})
|