Changelog History
Page 3
-
v2.2.1 Changes
June 27, 2016🐛 Bugs
- ⬇️ Dropdown - Fixed issue where using both
<select>
andallowAdditions: true
would cause dropdown selection to fail
- ⬇️ Dropdown - Fixed issue where using both
-
v2.2.0 Changes
June 26, 2016Project Features
- jQuery - Semantic UI is now fully compatible with jQuery
3.0
- Webpack - All css is now webpack-compatible
- NPM - NPM dependencies have all been updated to latest stable releases
🆕 New UI Features
- 💻 All UI - Added new setting
silent
to all modules which allows you to disable all console output including errors. This can be useful for preventing known errors, like a popup which cannot place itself on screen, orsticky
content which initializes before it is visible #3713 - 💻 All UI - All UI now include all sizing variations,
mini
,tiny
,small
,large
,big
,huge
,massive
. Headers remain with only 5 sizessmall-huge
to matchH1-H5
- 💻 All UI - Components that use event handlers on
document
,body
, or asettings.context
now all use DOM mutation observers to detect removal and prevent memory leaks - Button - Added compatibility with
primary
secondary
positive
negative
buttons with thebasic
styling variation. #3756 - Card - Added
raised
card variation Thanks @yordis #2955 - ⬇️ Dropdown - All dropdowns, not just
selection dropdown
, will now select the firstmenu item
that starts with a pressed keyboard key, for example "N" will select "New" - ⬇️ Dropdown - Dropdown now changes user selection on keyboard shortcuts immediately, this will save the extra
enter
key press to confirm selection in most cases. To enable previous pre2.2
selection style use the settingselectOnKeydown: false
- ⬇️ Dropdown - Dropdown will now automatically focus on
search
inside of a dropdown menu after it is opened. - ⬇️ Dropdown - Multiple select dropdown now sizes current dropdown input based on rendered width of a hidden element, not using an estimate based on character count. This means search will never break to a second line earlier than would normally fit in current line.
- Icons - Icons now use the latest Font Awesome
4.6.3
Icons. 80+ new icons+ are included. Thanks @BreadMaker for the PR and @davegandy for the font! - Popup - Added new
tooltip
popup type that works without javascript. Tooltips can specify positioning and some variations usingdata
attributes, and will handle positioning automatically with CSS only. - Progress - Progress now uses a polling interval for updates. Rapidly updating the progress bar over a period quicker than the animation duration (for example with xhr
onprogress
events say every 50ms) will now appear smooth as butter. - Table -
definition table
now includes additional class names for forcing, or ignoring definition cell styles
🆕 New Settings
- 🏗 Build Tools - Added new
autoInstall
option to allow for Semantic to be installed without user interaction. See docs explanation for how to use. #3616 Thanks @algorithme - ⬇️ Dropdown - Added
fullSearchSearch: 'exact'
setting, which requires exact matches for dropdown values #3085 #3994 Thanks @ShawnCholeva - ⬇️ Dropdown - Added new setting for search selection
hideAdditions
this will remove showing user additions inside the menu, making for a more intuitive adding process. Dropdowns now have a new stateempty
which will format an active dropdown with empty results. #3791 - ⬇️ Dropdown - Adds new
allowReselection
option to triggeronChange
events even when reselecting same value ⬇️ Dropdown - Adds new setting
minCharacters
which sets the minimum number of characters required to start filtering results #3886Form Validation - Added
depends
validation rule setting which will only validate a field if another specified field is not emptyPopup - Added new setting
boundary
andscrollContext
.boundary
lets you specify an element that the popup will try to position itself to be contained inside of.scrollContext
lets you specify the element which when scrolled should hide the popupPopup - Added new settings
observeChanges
, which is enabled by default. This will add special mutation observers to triggerdestroy
when the element is removed from the document, preventing memory leaks.Progress - Added
onLabelUpdate
callback, this can be used to specify the exact text that should appear on the actual progress update, perhaps based on some external conditionsRating - Added new setting
fireOnInit
for rating, which defaults tofalse
. When set to trueonRate
will fire when rating is initialized #3712Search - Added a new option
selectFirstResult
, which defaults tofalse
. Will automatically highlight first result on searchSearch - Search now includes a
showNoResults
setting for determining whether no results messages should be shownShape - Shape now lets you specify next side width using setting
width
, can usenext
orinitial
to specify whether it should use old or new side sizeTab - Added new setting
cacheType
, can either behtml
orresponse
(default). HTML will cache resulting html after callbacks,response
will cache the original response so that it can be played back identically on future loads #2534Tab - Added new option
deactivate
, defaults tosiblings
which will only deactivate tab activators that are DOM siblings elements to the activating element. Setting it to 'all' will deactivate any other tab element initialized at the same time.Visibility - Added
onFixed
andonUnfixed
callbacks for visibilitytype: 'fixed'
Visibility - Added
onLoad
andonAllLoaded
callback fortype: 'image'
visibilityVisibility - Added
zIndex
setting for specifying zindex withtype: 'fixed'
#3370
🆕 New Behaviors
- ⬇️ Dropdown - Added new convenience method
restore placeholder text
- Image -
transition hidden image
now shows correctly asvisibility: hidden;
and notdisplay: none
. This will allowoffset
withvisibility
andsticky
to work more seamlessly.hidden image
will still remaindisplay: none;
- Progress - Added progress
is complete
for returning whether success, warning, or error conditions are met
CSS Enhancements
- 💻 All UI Extended variables which return exact pixel values in em (
@relativePX
and @px) up to 64px to allow for simple theming with exact values - Button - Added variables for configuring
disabled
background image and box shadow. - Site - Added colored box shadow defaults.
ui message
now includes individual colored border shadows based on new site defaults. - Site - Added new
@inputColor
and@inputPlaceholderColor
global variables that now control placeholder text styles across all components. - Table -
definition table
now supportsdefinition
variation to specify definition styles on an element that is not:first-child
- Table -
definition table
now supportsignored
variation to force afirst-child
to ignore its default definition stylings
🚑 Critical Bug Fixes
- 💻 All UI - Using
component('setting, {})
to add multiple settings as an object literal, for exampleerror: {}
, will now deep extend the existing object instead of replacing it. - API -
beforeSend
would not correctly cancel request whenreturn false;
is used in callback. #3660 - API -
cache: 'local'
would not return the localstorage cached results in some cases - Divider - Descenders like "g" are cut off in
horizontal divider
#3585 - ⬇️ Dropdown -
forceSelection
will now automatically select values with multi dropdowns. When usinguserAdditions
setting it will now automatically tokenize the current entered value - ⬇️ Dropdown -
search selection
would not let you move back in an entered search string with left arrow #3596 Thanks @Sanjo - ⬇️ Dropdown - Fixed issue where value set using javascript DOM metadata would be cleared when a message or user addition triggered
refresh
#3879 #3622 Thanks @mdehoog - Form Validation / Dropdown - Using "enter" key in a
search dropdown
could cause a form to be submitted #3676 - Form Validation - Fix issue with some foreign email addresses with extended charsets causing email validation to fail #3955 #3755
- Form Validation - Revalidating a field
on: blur
could cause fields not yet interacted with to be validated #3606 - Form - Fixed issue with
(x) fields
andequal width
fields where middle rows would be slightly smaller because they include both left and right padding in % width. (Edges only have one side padding). Field groups now use negative margins instead. - Popup - Fixed issue where clicking element inside popup removed from DOM (like clicking a multi select label) would cause popup to close #3887
- Rail - Fixed incorrect width for
close rail
andvery close rail
caused by variable addition with mixed unitspx
+em
#3835 - Search - Fixed bug where a previously XHR query could cause the next one to fail depending on the latency of the request #2779
- Search - Fixed an issue where
onResult
returningfalse
would not prevent the search menu from hiding. Clicking on an empty results message will also no longer close the search results. #3856 #3870 - Sticky/Visibility - Added mutation observer to teardown element with
destroy
if removed from DOM context, fixing a possible memory leak - Video - Fixed issue with
.video('change')
behavior not properly changing video.
🐛 Bugs
- API - Using
onResponse
withdataType
other than JSON or JSONP would cause an error. (Not allowing plain text responses to be translated) #3653 - 🏗 Build Tools - Fixed gulp help text incorrect for RTL tasks in build tools #3858
- Button -
right icon
likeright arrow icon
would have additional margin inside anicon button
#3525 - Button - Fixed issue where
disabled loading button
would not removepointer-events
#2933 - Button - Fixed typo in
green inverted button
#3873 - Button/Dropdown - Button dropdowns using
default text
no longer receive incorrect font styling for placeholder text - Checkbox - Fixed issue where docs refer to
onEnable
andonDisable
with checkbox but callback was calledonEnabled
andonDisabled
, both callbacks will now be valid until 3.0 #3761 #3763 - Checkbox - Radio buttons received
indeterminate
styles when user has not yet interacted with the page in Chrome - ⬇️ Dropdown -
apiSettings
was not defaulting to usecache: 'local'
as specified in the docs - ⬇️ Dropdown -
get value
would not return correct value when value was blank #3766 - ⬇️ Dropdown - Added
1px
offset for current text so that the blinking text position cursor does not overlap first pixel of underlayed text. - ⬇️ Dropdown - Dropdown would open when an label delete x was clicked when not using
search selection
#3789 - ⬇️ Dropdown - Dropdowns no longer re-open on selection when nested inside of a
<label>
#3917 - ⬇️ Dropdown - Dropdowns with sub-menus would not properly activate on mobile #3183
- ⬇️ Dropdown - Fixed bug where using
action: 'hide'
could causetext
value not to be passed toonChange
callback - ⬇️ Dropdown - Fixed issue where values with
"
(double quotes) would not work with a dropdown using a select, because value would not be encoded as html entities - ⬇️ Dropdown - Long dropdown text entry with
allowAdditions
would cause input to mistakingly drop to next line early #3743 - ⬇️ Dropdown - Regenerated dropdown will no longer ignore
disabled
property #4010 Thanks @eymengunay! - ⬇️ Dropdown - Search selection would lose search input focus when clicking on a choice #3790
- Embed -
API
setting is now disabled by default - Form Validation - Fixed issue where initializing form multiple times would not properly call
destroy
removing previous settings #3798 - Form - Fix
equal width fields
sometimes not including right field spacing on mobile #3913 - Form - Fixed issue where
inline
field was not being correctly inverted in color withinverted form
#4004 #4005 Thanks @tbracken - Form - Grouped
fields
andfield
would cause different margin collapse, makingfields
include larger gaps between content #3717 - Form - Remove deprecated
size()
method inprompt
#3655 Thanks @SimonArdrey - Grid -
centered
content would causejustified
content to appear aligned left. #3496 - Grid - Fixed issue where
vertically divided
grid would have top margin in firstrow
group - Icon - Sizes smaller tham
small
were using withrem
#3782 - Input - Fixed
:active
styles appearing on disabled input, when input is disabled usingdisabled
property #3907 - Input - Fixes issue with
dropdown
or button on the left side of anaction
input not properly rounding - Label - Fixed margin when
right floated
element precedes atop attached label
- List -
relaxed
andvery relaxed
lists included unnecessary padding on the first and last items #3710 - List - Bullets would be affected by font weight, or whether the list item was a link #3715 #3721
- List - Divided lists had unnecessary padding on first and last items, in both horizontal and vertical layouts #3710
- Menu -
stackable
menu withleft/right
menu
oritem
would incorrectly be floated when stacked. #3604 - Menu -
tabular menu
now has correct bottom margin #4167 - Menu -
@dividerSize
was not being used invertical menu
#3781 - Menu -
vertical text menu
no longer includesleft
orright
padding, but will now sit flush with content. - Message - Fixes
compact message
appearing asblock
when inside aform
#3343 Thanks @bcroq - Modal - RGB values set for dimmer
background-color
were not being correctly interpreted #3665 Thanks @larsbo - Modal/Dimmer - Fixed issue with
destroy
not properly removing events from dimmer #3200 - Popup - checking
instanceof SVGGraphicsElement
caused error in IE11 #3043 - Progress - Progress
onSuccess
,onError
, andonWarning
callbacks now occur after the animation completes for the state change. - Rating - Fixed
ui rating
to not used outlined star in basic variation, instead using a lighter filled in star for increased visibility #3730 - Rating - rating does not fire
onRate
when rating is initialized #3712 - Search - Added
refresh
behavior for search to refresh selector cache. Cache will automatically refresh after API results received - Search - Fixed issue where
href
was not pulling correctly on search click when theresult
was ana
itself. #3409 - Segment - Fixed
segments
to not clip border radius when only a single segment is included - Segment/Message -
top attached message
has no border when attached tosegment
#3619 - Statistic - statistic receives incorrect size when using
tiny
large
etc inside a statistic group #3116 - Step - Fix incorrect bottom margin on
top attached steps
- Table -
striped selectable
table would not correctly show hover color on striped rows - Visibility - Using
type: fixed
will now correctly remove all special classes and placeholder content ondestroy
#3548
🔄 Changes
- Sizing -
mini
the smallest size has been modified to align to11px
instead of previous10px
at base em size
📄 Docs
- Progress - Added new examples to progress
- Progress - Added all available behaviors with progress
- Form - Added example of using custom rules with form
- 🏗 Build Tools - Added explanation of using SUI with CI, and auto-install in "recipes" section.
- 🏗 Build Tools - Added explanation of how to build RTL in "recipes" section
- Layouts - Added "attached" example showing content attached to other content
- jQuery - Semantic UI is now fully compatible with jQuery
-
v2.1.8 Changes
January 07, 2016🚑 Critical Fix
- Install - This fixes a regression causing users with NPM
2
from using Semantic UI, caused by removing the deprecatedpeerDependencies
which are necessary for NPM2 install to function correctly. #3511
Minor Fix
- Install - This fixes a regression causing users with NPM
-
v2.1.7 Changes
December 19, 2015✨ Enhancements
- API - All responses fulfilled with settings (like
mockResponse
) will now receive a settings object with all values resolved. For exampleurl
will be/user/2/
and notuser/{id}
in the callback. - #3466 - API - API now allows the use of settings
response
andresponseAsync
to replacemockResponse
andmockResponseAsync
. The use of "mock" may not represent the most common use case which is providing a response from a third party source. (These changes are purely cosmetic and no underlying behavior has changed) - #3491 - Popup - Adds
onUnplaceable
callback when element cannot be placed in visible screen #3388
🐛 Bug Fixes
- 🏗 Build Tools - CSS build will now correctly call callback after both packaged files are created (compressed and uncompressed) Thanks @youngjay #3405
- Flag - A flag with no country set will no longer display an incorrect country flag. Thanks @space-alien #3333
- Form - Fixed issue where text would turn transparent inside a
loading form
#3122 - Menu - Fixed
1px
offset whenattached segment
followstabular menu
(max of 2 consecutive segments) #3479 - Header -
sub header
used inside a header now correctly forcesblock
styling #3020 - Popup - Fixed
is visible
,is animating
, andis fluid
to always returntrue/false
and not the DOM element. #2781 - Popup - Fixed issue with
onEnable
callback being defined with nameonEnabled
andonDisable
withonDisabled
in default settings, causing an error. To preserve backwards compatibility, the misspelled callback name has been left, but the bug has been fixed. #3148 - Search - Search now correctly hides menu when an error message inside results is clicked. #3039
- Sidebar - Fixed css rule issue causing
very thin
sidebar to not work #3300 - Sidebar - Sidebar no longer includes
transform
rules on child elements, this was causing layout issues in some cases (for example dropdowns in sidebars) #3306 - Sticky - Renames variables used to account for scroll offset internally for greater code clarity
- Transition - Fixes
noAnimation
error to more reasonably announce that the element is "not in the DOM" #3040
- API - All responses fulfilled with settings (like
-
v2.1.6 Changes
November 06, 2015🐛 Bug Fixes
- Checkbox/Dropdown/Search - Fixed issue where dropdown/checkbox
change
events were not bubbling. (Dispatched events were swapped to use nativedocument.creatEvent
in2.1.5
unfortunately the flag to bubble events was mistakenly off.)
- Checkbox/Dropdown/Search - Fixed issue where dropdown/checkbox
-
v2.1.5 Changes
November 01, 2015📄 Docs Enhancements
- Examples - All code examples now have a "copy to clipboard" button Thanks @xiwc and @zenorocha for clipboard.js
Minor Enhancements
- Form - Adds
equal width form
andequal width fields
for simpler grouped fields - Modal -
onHide
callback can now cancel event by returning false #3168 Thanks @mdehoog - ⬇️ Dropdown - Added
onLabelRemove
callback that allows value removal to be cancelled by callback Thanks @goloveychuk - Table - Added
selectable
on table cell, allowing for full table-cell links - Popup Added three new variables for
arrow
background color based on position, top, center or bottom. This makes it easier to use gradient backgrounds with popups and still match arrow colors. - Popup - Added behaviors
get popup
andchange content
to more easily determine popup from activating element and change text
🛠 Major Bug Fixes
- Checkbox/Dropdown/Search - Fixed issue where using
.trigger('change')
would not fire nativechange
event. Only triggering event handlers attached with jQuery #3108 - Transition - Fixed bug where static transitions (those that dont animate in/out of view) would not fire
onComplete
event - Sticky - Fixes bug where sticky would stick at incorrect times when using a different scroll container than
body
and scrollTop is not 0 on page load.
🐛 Bugs
- Divider/Step/Modal/AD - Fixes 1px jump at
@mobileBreakpoint
caused by incorrect edge conditions in media query #3180 Thanks @mdehoog - Dimmer - Dimmer can now works correctly with
opacity: 0
#3167 Thanks @mdehoog - ⬇️ Dropdown - Fixed condition where focusing on dropdown would show a blank menu when "no results" was reached and the dropdown was refocused
- ⬇️ Dropdown - Search dropdowns will now correctly filter by current search term on re-focus
- ⬇️ Dropdown - Fixed issue where tabindex was being removed incorrectly with
selection dropdown
in some cases. #3002 - ⬇️ Dropdown - Added
remoteValues
as a possiblefield
setting. Allowing users to return API results using arbitrary JSON object groupings. #3080 - ⬇️ Dropdown - Added ability to pass in
keys
as a setting, to avoid issues with languages where comma delimiter may be a different keycode #3016 - ⬇️ Dropdown -
search dropdown
will now initialize withautocomplete="off"
to avoid triggering native autocomplete menu - Form Validation - Fixes error on
blur
orchange
when using a blank validation object #3131 Thanks @listepo - Form Validation - Fixes some issues with form integer validation #3053 Thanks @maturano
- Form Validation -
decimal
rule now only matches decimals, to match any number usenumber
rule. #3060 - Form - Removed
divider
spacing as part ofui form
, this caused inheritance issues when using special divider types #3092 - Grid - Fixes attached segment 1px offset inside grid column #3226
- Grid - Fixes some inconsistencies with
widescreen only
class #3161 Thanks @mdehoog - Header - Sub headers now force
display: block
#3020 - Popup - Fixes positioning issue when
movePopup: false
#3213 Thanks @parisholley - Popup - Popup now works with
svg
elements #3043 - *Progress - Calling
reset
will now resetvalue
to 0, so increment starts again at 0 - Search - Fixes
onSearchQuery
not firing when results are cached Thanks @mnquintana - Search - Fixes
url
parameter not working correctly due to typo in source Thanks @fabienb4 - Segment - Fixes border on
horizontal segment
when they are:first-child
insidesegments
group 📄 Docs Bugs - ✏️ Thanks to everyone who has submitted PRs for typos, grammatical changes. These are too numerous to count, but really help improve the quality of our docs.
- Progress - Progress example code no longer shows accidental inline css
- Sticky - Fixed issue where pressing home/end button would cause sticky to break due to internal logic not allowing immediate jump from bottom attached to top attached, experienced most likely when pressing "home" or "end" key #3011
-
v2.1.4 Changes
September 13, 2015🛠 Critical Bugfixes
- 🏗 Build - Fixed issue where using a packaged theme without a
site.variables
would cause build to fail #3009 #3010
✨ Enhancements
- Form Validation - Form validation now supports a brand new shorthand which is drastically simpler to specify #2579
javascript // expands out using default prompts and identifier matching property label $('.ui.form') .form({ fields: { name : 'empty', gender : 'empty', username : 'empty', password : ['minLength[6]', 'empty'], skills : ['minCount[2]', 'empty'], terms : 'checked' } }) ;
- Form Validation -
identifier
andprompt
are now optional for all form validation rules. Default prompt values have been added for all rule types, and identifier will now automatically match on the named value for rule if no ID is specified. #3001 #2579 - Form Validation - All form prompts now support templates values,
{value}
,{name}
,{ruleValue}
, and{identifier}
#3001
🛠 Bugfixes
- ⬇️ Dropdown - Fixed issue with ',' key not being allowed in dropdown due to user tagging shortcut key #3016
- Message -
ui list
used insideui message
now aligns properly in all conditions #2958 - Form Validation - Validation messages in
error message
group are now correctly removed when invalid field revalidates on blur - Label - Labels no longer force single line using
word-wrap: nowrap
#3006 - Table - Fixed issue where
(x) column segment table
was inheriting accidentally inheriting some grid styles - Grid - Fixed
middle aligned grid
not applying to columns #2959 - Menu - Fixed issue where
right menu
was not floating correctly inside amenu > container
on mobile #2969 - Button - Fixes
right labeled icon button
with aright
named icon (for exampleright arrow
) having incorrect margin on icon. #2973
- 🏗 Build - Fixed issue where using a packaged theme without a
-
v2.1.3 Changes
September 03, 2015🛠 Bugfixes
- Embed - Fixes issue with
?=
appearing before parameters instead of?
#2956 Thanks @AgentShark - Input - Fixes regression where
ui icon input
inside forms were not correct width #2953 - Input - Fixes typo in focused placeholder text color preventing the value from being used #2939
- Input -
action input
now correctly show focused border on button side, and avoids duplicating borders
- Embed - Fixes issue with
-
v2.1.2 Changes
September 02, 2015🛠 Bugfix
- Form Validation - Fixes callbacks on
onSuccess
so as to not break backwards compatibility. #2945 #2944
- Form Validation - Fixes callbacks on
-
v2.1.1 Changes
September 02, 2015🛠 Bugfix
- 🏗 Build Tools - Fixes issue causing comment banner to incorrectly show version
2.0.7
indist/
- 🏗 Build Tools - Fixes issue causing comment banner to incorrectly show version