Important Note
Some quirks have been resolved that may cause changes for upgrading users who were expecting these behaviors
Form Validation
If you are using form validation, previous to 2.2.8
calling is valid
would trigger UI updates. This behavior now no longer triggers UI updates, and will only return a boolean
whether form is valid,
To trigger UI updates you can call validate form
. Additional form behaviors have been added as well. See the new documentation on programmatic validation for more examples.
Dropdown
multiple selection dropdown
no longer automatically adds the currently selected value when you "alt-tab" or blur the field, even when forceSelection: true
is set.
Major Enhancements
- Icons - Updates Font Awesome to
4.7.0
Always the man @BreadMaker #4766 - Dropdown - Added new setting
filterRemoteData
, when set totrue
API will be expected to return the complete result set, which will then be filtered clientside to only display matching results. Thanks @enix223 #4815 - Dropdown - Fixed issue where using some usage of special characters like
\
could cause dropdowns to not work. #4688 #4692 - Tab - Added setting
loadOnce
, which when enabled only calls remote endpoint for tab data on first load and leaves the DOM undisturbed afterwards. #2534
Critical Bugs
- Dropdown -
forceSelection
setting will no longer cause highlighted value in multiselect to be selected on blur when using amultiple selection dropdown
#4041 #4516 - Dropdown - Dropdown using search input inside of menu are now tabbable #4490
- Search - Fixes issue where empty results message can still appear when using setting
showNoResults: false
#4616 - Sidebar - Fixed bug where sidebar in
iOS
would show incorrect background when opening sidebar if page is less than 100% height #4264
Critical Doc Fixes
- Visibility - Added documentation for
onOnscreen
andonOffScreen
, two very important callbacks that occur when an element is or isn't in currently scrolled view.
Enhancements
- Items - Added
unstackable
variation to prevent items from stacking on mobile #2901 - Search - Added new parameter
callback
to behaviorsquery
,show results
,hide results
, andsearch remote
to allow a function to be called after completion. - Form Validation - Rules now properly supports identifiers with special characters like brackets, e.g.
name="user[name]"
Thanks @mzygmunt #4163 - Search -
esc
key now hides results and prevents them from being displayed again until form field is blurred
Build Tools
- NPM - Removed dependency on tarball, packaged new patched WrenchJS under Semantic-org as a new package.
Bugs
- Button - Fixed issue where css specificity caused
icon buttons
to not center correctly #4487 - Dropdown - Fixed bug where clicking on a dropdown's
dropdown icon
when using remote data would not open menu #4041 - Dropdown/Search/Checkbox - Removes use of deprecated
dispatchEvent
DOM APIs for generating simulated events - Dropdown - Fixes issue where
left pointing dropdown
andright pointing dropdown
appear styled incorrectly when openingupward
#4896 - Dropdown - Fixed issue where using
fullTextSearch: 'exact'
would still fuzzy search on value Thanks @ rminnett #4651 #3424 - Dropdown - Fix bug where
scrolling menu
orscrolling dropdown
would have excessive right padding by removing scrollbar width from calculation (no longer necessary in modern browsers) - Comments -
small
,large
and other comment sizes now default to global size variables. - Dropdown - Fixed issue where
selectOnKeydown
withhtml
content would cause only non html content to display intext
until blur - Form Validation - Fixes issue where decimal validation would allow multiple
.
in value - Form Validation - Fixes js error caused by revalidating inputs without validation rules #4497 #4547 Thanks @cbxp
- Header - Fixed issue where using
image icon
orimage outline icon
would cause incorrect display withinui header
due to namespace collision withui image
#4145 - Input/Dropdown - Fixed rounding error causing vertical alignment of
dropdown
,search
,input
to sometimes appear off by 1 pixel #4279 - Segment - Fixed
padded vertical segment
very padded vertical segment
mistakenly receives horizontal padding #3012 - Visibility - Images that use
$('img').visibility({ type: 'image'})
will no longer animate a second time if re-initialized. - Form Validation - Fixed issue where using bracketed values, or other special characters could cause errors with selectors #4163 #4164
Documentation
- Comments - Added missing
size
variations to comments docs #4450 - Typos - Thanks to everyone who has submitted typo/grammatical PRs, much appreciated