aboutsummaryrefslogtreecommitdiff
path: root/docs
AgeCommit message (Collapse)AuthorFilesLines
2017-04-19Add Johann-S to Core team :fireworks:Johann-S1-0/+4
2017-04-18Port button group accessibility callout from v3 to v4Patrick H. Lauke1-0/+8
2017-04-18Add dropdown menu accessibility callout and fix <a> examplePatrick H. Lauke1-1/+11
As the question often comes up about why Bootstrap does not do "true" ARIA menus (with their `role="menu"` etc), add an admittedly lengthy note (tl;dr because BS is generic, and ARIA menus are specific and quite limiting). Additionally, fixes up the `<a>` example for dropdown trigger, with the missing `role="button"` and neutering the `href` (which would be useless anyway since BS overrides the link-like nature of the `<a>` so it could never be triggered/followed anyway)
2017-04-17Fix carousel "hover" behavior on touch-enabled devicesPatrick H. Lauke1-1/+2
* Add carousel mouse listeners even if touch events enabled - touch events are enabled not just on "mobile", just also on touch-enabled desktop/laptop devices; additionally, it's possible to pair a mouse with traditionally touch-only devices (e.g. Android phones/tablets); currently, in these situations the carousel WON'T pause even when using a mouse * Restart cycle after touchend as `mouseenter` is fired as part of the touch compatibility events, the previous change results in carousels which cycle until the user tapped/interacted with them. after that they stop cycling (as `mouseleave` is not sent to the carousel after user scrolled/tapped away). this fix resets the cycling after `touchend` - essentially returning to the previous behavior, where on touch the carousel essentially never pauses, but now with the previous fix it at least pauses correctly for mouse users on touch-enabled devices. includes documentation for this new behavior.
2017-04-17Rewrite getting started/accessibility docsPatrick H. Lauke1-26/+26
A long overdue rewrite of the accessibility section - instead of the few snippets of strangely superficial and out-of-context advice (skip links, use correct heading levels), this tries to answer some of the fundamental questions about "is Bootstrap accessible", with emphasis on the fact that the final result will depend in large part on what BS is applied to/on (since BS relies on the markup etc authored by developers). This also sets out our ambition to have things work for keyboard and assistive tech users, and that we strive to make all our examples etc accessible and semantic. * Changes based on @mdo's feedback
2017-04-16fixes #22244 by providing more specific guidance on input typesMark Otto1-1/+1
2017-04-16Make "Copy" buttons actual buttonsPatrick H. Lauke2-2/+10
This makes them keyboard-accessible. For mouse users, the only change here is that the focus outline will remain on the button once clicked (in future, this can be solved with :focus-ring, but for now this would require a polyfill). the tooltip is explicitly hidden on `mouseleave`, so even though the `<button>` retains focus after clicking, the tooltip won't stay visible once mouse user moves away. the mouse hover styles have explicitly not been make to also apply to :focus, so as to minimise the visual impact for mouse users (though the tooltip remains visible) - but due to the default outline and the custom tooltip, it should be fairly clear when keyboard users set focus to a copy button too.
2017-04-16gruntMark Otto10-70/+35
2017-04-14Replace dropdown backdrop hack with cleaner JS-only hackPatrick H. Lauke1-1/+3
* Replace backdrop with simple noop mouse listener As discussed in https://github.com/twbs/bootstrap/pull/22422 the current approach of injecting a backdrop (to work around iOS' broken event delegation for the `click` event) has annoying consequences on touch-enabled laptop/desktop devices. Instead of a backdrop `<div>`, here we simply add extra empty/noop mouse listeners to the immediate children of `<body>` (and remove them when the dropdown is closed) in order to force iOS to properly bubble a `click` resulting from a tap (essentially, method 2 from https://www.quirksmode.org/blog/archives/2014/02/mouse_event_bub.html) This is sufficient (except in rare cases where the user does manage to tap on the body itself, rather than any child elements of body - which is not very likely in an iOS phone/tablet scenario for most layouts) to get iOS to get a grip and do the correct event bubbling/delegation, meaning the regular "click" event will bubble back to the `<body>` when tapping outside of the dropdown, and the dropdown will close properly (just like it already does, even without this fix, in non-iOS touchscreen devices/browsers, like Chrome/Android and Windows on a touch laptop). This approach, though a bit hacky, has no impact on the DOM structure, and has no unforeseen side effects on touch-enabled laptops/desktops. And crucially, it works just fine in iOS. * Remove dropdown backdrop styles * Update doc for dropdowns and touch-enabled devices
2017-04-12Reword "mobile" to "touch-enabled"Patrick H. Lauke1-1/+1
...as touch is not exclusive to "mobile" anymore nowadays. also explicitly clarifies this is a fix for iOS, and that it impacts touch laptops etc as well. lastly, renames the variable from "dropdown" to "backdrop" for clarity/consistency
2017-04-11Remove inappropriate role="listbox" from carouselsPatrick H. Lauke2-5/+5
2017-04-10Fix collapse.js aria-expanded behaviorPatrick H. Lauke1-1/+1
* Remove aria-expanded from collapse.js target element aria-expanded="true"/aria-expanded="false" only applies to the trigger, not the element that is being expanded/collapsed. * Tweak collapse.js accessibility section ...to make it clearer that the aria-expanded attribute always just goes on the control. * Fix collapse.js unit tests - reword some of the text to make it clear we're checking behavior of trigger/control - move incorrect aria-expanded out of the <div>s and to the actual trigger/control <a>s - fix incorrect test assertion text output false -> true
2017-04-09Merge branch 'v4-dev' into v4-dev-docs-navs-js-tabpanel-fixPatrick H. Lauke12-30/+30
2017-04-09Remove incorrect role="tabpanel" from navs docsPatrick H. Lauke1-6/+4
`role="tabpanel"` is not appropriate as role for the overall container - it only applies to the individual content parts of each tab
2017-04-09Merge branch 'v4-dev' into v4-docs-button-group-a11y-patch1Patrick H. Lauke24-895/+978
2017-04-08gruntMark Otto4-84/+83
2017-04-08drop img-fluid for w-100Mark Otto1-12/+12
2017-04-08Revert "Drop width from sizing utils given .col- classes can do the same ↵Mark Otto1-3/+10
thing (follow up to #22376)" This reverts commit 2f21403a933336f7cb01c86bf3c650490bc658a6.
2017-04-08Drop width from sizing utils given .col- classes can do the same thing ↵Mark Otto1-10/+3
(follow up to #22376)
2017-04-08Docs and CSS updates for #21807 (#22336)Mark Otto3-44/+25
* tweak some copy * fix up scrollspy docs * remove nav styles that were added * fix nav-based docs by requiring .nav-item on .nav-link
2017-04-08gruntMark Otto16-731/+263
2017-04-07Documentation - Add inserted event for Tooltip and PopoverJohann-S2-0/+8
2017-04-02Rename navbar-toggleable to navbar-expand in docs (#22309)Pierre Vanduynslager1-17/+17
2017-04-02Merge branch 'v4-dev' of https://github.com/twbs/bootstrap into v4-devMark Otto4-27/+593
2017-04-02Tabs/Scrollspy/.nav/.list-group/.active independent of markup (<nav>, ↵Pierre Vanduynslager4-27/+593
.nav-item, <li> etc...)
2017-04-01gruntMark Otto6-39/+36
2017-03-30Add explicit aria-label to placeholder-only inputsPatrick H. Lauke12-30/+30
While `placeholder` is nominally valid per spec http://rawgit.com/w3c/html-api-map/master/index.html#accessible-name-and-description-calculation it is inelegant, a fallback, and not supported in ios/safari/voiceover and android/chrome/talkback, to name a few combinations `aria-describedby` is also not really the right tool for providing a name/label equivalent, so remove that from the list of possible alternative methods / clarify how it can be used
2017-03-28Fix JS components console error "Error: <Component> is transitioning"Pierre Vanduynslager8-23/+69
2017-03-28quickly fix #21761 by adding .text-gray-dark exampleMark Otto1-0/+1
2017-03-28gruntMark Otto7-18/+32
2017-03-27gruntMark Otto6-15/+18
2017-03-27Card image fixes (#22288)Mark Otto1-4/+4
* fix image stretching due to flexbox * fix broke text-muted on dark bg * no img-fluid needed
2017-03-26fixes #21608Mark Otto1-0/+1
2017-03-26gruntMark Otto4-5/+5
2017-03-26gruntMark Otto10-22/+68
2017-03-26fixes #22111Mark Otto1-2/+2
- add .col-*-auto to the extend in our grid framework mixins so it gets padding - this means we can avoid the col-12 classes in our docs for the responsive variants
2017-03-26git that a link too for nowMark Otto1-0/+2
2017-03-26add example and document bug behavior to fix #21967Mark Otto1-0/+16
2017-03-26fix broken fieldset grid, workaround for flexbug 9Mark Otto1-20/+22
2017-03-26fixes #22133Mark Otto1-1/+2
2017-03-26doh forgot to saveMark Otto1-1/+1
2017-03-26clarify docs a bit more and remove some words; closes #21683Mark Otto1-4/+4
2017-03-26Redo semantic grid example and make it real in the docsMark Otto2-17/+52
2017-03-26clean up mixin docsMark Otto1-48/+6
2017-03-26gruntMark Otto7-110/+133
2017-03-24Add missing v4 docs for tooltip/popover methods (#22246)Sid2-0/+36
Add missing v4 docs for tooltip/popover methods
2017-03-23fix dupe idsMark Otto1-38/+38
2017-03-23fix broken justified-nav example, fixes #21874Mark Otto1-3/+3
2017-03-23rename from .navbar-toggleable to .navbar-expand to reflect mobile first ↵Mark Otto12-23/+180
approach everywhere else
2017-03-23more docs updatesMark Otto10-37/+37