## RELEASE NOTES ### Version 2.2.8 - December 21, 2016 ### Important Changes > Some behaviors have been changed, as these are patches of incorrect behaviors this is still being considered a patch release, however if you have relied on these quirks you might need to update your code. #### 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, as this was the intended functionality. To trigger UI updates you can call `validate form`. Additional UI behaviors have been added as well, [see new documentation on programmatic validation](http://semantic-ui.com/behaviors/form.html#validating-programmatically) #### Dropdown Dropdown no longer automatically selects the currently selected value in a multi-select dropdown when you "alt-tab" or click out of a field. In most cases this is an unexpected behavior, even with `forceSelection`. ------------------------------------------------------- **Major Enhancements** - **Icons** - Updates Font Awesome to `4.7.0` **Always the man @BreadMaker** [#4766](https://github.com/Semantic-Org/Semantic-UI/pull/4766) - **Dropdown** - Added new setting `filterAPIResults` which when enabled will filter results locally by query after API returns, allowing your API call to return the full dropdown dataset. **Thanks @enix223** [#4815](https://github.com/Semantic-Org/Semantic-UI/pull/4815) - **Dropdown** - Fixed issue where using special characters like `\` inside values could cause them not to work properly [#4688 [#4692](https://github.com/Semantic-Org/Semantic-UI/pull/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](https://github.com/Semantic-Org/Semantic-UI/pull/2534) **Critical Bugs** - **Dropdown** - `forceSelection` setting will no longer cause highlighted value in multiselect to be selected on blur when using a `multiple selection dropdown` [#4041 [#4516](https://github.com/Semantic-Org/Semantic-UI/pull/4516) - **Dropdown** - Fix issue where `dropdown` with `search` in menu are not tabbable [#4490](https://github.com/Semantic-Org/Semantic-UI/pull/4490) - **Search** - Fixes issue where search will re-appear with incorrect results when using `show `showNoResults: false` to hide no results messages. [#4616](https://github.com/Semantic-Org/Semantic-UI/pull/4616) - **Sidebar** - Fixed bug where sidebar in `iOS` would show background behind page when page is less than 100% height [#4264](https://github.com/Semantic-Org/Semantic-UI/pull/4264) **Enhancements** - **Items** - Added `unstackable` variation to prevent items from stacking on mobile [#2901](https://github.com/Semantic-Org/Semantic-UI/pull/2901) - **Search** - Added callback as a parameter to behaviors `query`, `show results`, `hide results`, and `search remote`. - **Form Validation** - Validation now properly supports rules with brackets, like `name="user[name]"` **Thanks @@mzygmunt** [#4163](https://github.com/Semantic-Org/Semantic-UI/pull/4163) - **Search** - `esc` key now hides results and prevents them from being displayed again until form field is blurred **Bugs** - **Button** - Fixed issue where css specificity caused `icon buttons` to not center correctly [#4487](https://github.com/Semantic-Org/Semantic-UI/pull/4487) - **Dropdown** - Fixed bug where clicking `dropdown icon` using remote data would cause nothing to happen [#4041](https://github.com/Semantic-Org/Semantic-UI/pull/4041) - **Dropdown/Search/Checkbox** - Removes use of deprecated `dispatchEvent` usage for generating simulated events - **Dropdown** - Fixes issue where `left pointing dropdown` and `right pointing dropdown` appear styled incorrectly when opening `upward` [#4896](https://github.com/Semantic-Org/Semantic-UI/pull/4896) - **Dropdown** - Fixed issue where using `fullTextSearch: 'exact'` would still fuzzy search on value **Thanks @ rminnett** [#4651 [#3424](https://github.com/Semantic-Org/Semantic-UI/pull/3424) - **Dropdown** - Fix bug where `scrolling menu` or `scrolling 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` with `html` content would cause only non html content to display in `text` 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**](https://github.com/Semantic-Org/Semantic-UI/pull/xp**) - **Header** - Using `image icon` or `image outline icon` would cause incorrect display within `ui header` due to namespace collision with `ui image` [#4145](https://github.com/Semantic-Org/Semantic-UI/pull/4145) - **Input/Dropdown** - Fixed rounding error causing vertical alignment of `dropdown`, `search`, `input` to sometimes appear off by 1 pixel [#4279](https://github.com/Semantic-Org/Semantic-UI/pull/4279) - **Segment** - Fixed `padded vertical segment` `very padded vertical segment` would receive horizontal padding [#3012](https://github.com/Semantic-Org/Semantic-UI/pull/3012) - **Visibility* - Fixes issue where reinitializing, `.visibility({ type: 'image'})` will cause it to re-animate when visibile again - **Form Validation** - Fixed issue where using bracketed values, or other special characters could cause errors with selectors [#4163 [#4164](https://github.com/Semantic-Org/Semantic-UI/pull/4164) **Documentation** - **Visibility** - Added documentation for `onOnscreen` and `onOffScreen` to important callbacks somehow omitted from docs - **Comments** - Added missing `size` variations to comments docs [#4450](https://github.com/Semantic-Org/Semantic-UI/pull/4450) - **Typos** - Thanks to everyone who has submitted typo/grammatical PRs, much appreciated ### Version 2.2.7 - December 21, 2016 **Build Tools** - **Autoinstall** - Fixes issue where `autoinstall: true` was not copying build files during `npm install` **Thanks @AnsonT** [#4430](https://github.com/Semantic-Org/Semantic-UI/pull/4430) - **Dependencies** - Updates build dependencies ### Version 2.2.6 - October, 27, 2016 **Bugs** -**Tab** - Hotfix for accidental use of ES6 `let` ### Version 2.2.5 - October, 27, 2016 **Bugs** - **Search** - Fixed issue where pressing "up" key when no results selected would cause bottom result to be selected - **Search** - Fixed issue where input may attempt to refocus when search element is immediately removed from browser's DOM after a result is clicked. - **Flat Theme** - Fixes inverted input color **Enhancements** - **Tab** - Added new tab cache type `DOM` which preserves the final DOM state after scripts rendering. This can be used to avoid re-running returned `