Bug Fixes
- Search - Passing in
cache: falsewill now affect default settings forapiSettingswhen using a remote endpoint. Previously you would also have to pass inapiSettings: { cache: false}as well - CSS - Update LESS syntax to be compatible with LESS 3.0 Thanks @sciyoshi #6447
- Icon - Several icon names have been deprecated due to incompatibility with
transition inandtransition outused in animations.
linkedin inis nowlinkedin alternatezoom inis nowzoom-inzoom outis nowzoom-outsign inis nowsign-insign outis nowsign-outlog outis nowlogoutin cartis nowin-cart
Enhancements
- Modal - Modal and Dimmer now prevent background page from scrolling on mobile or where touch events are present
- Button - Add
invertedandinverted basicvariations forprimaryandsecondarybuttons Thanks @hammy2899 #6242
Theming
- Global - Add
hoverdownactiveandfocusvariables for@invertedPrimaryColorand@invertedSecondaryColor
Bugs
- Dropdown Fixed bug that could cause dropdown to recursively trigger network requests specifically when using
apiSettingswith a url that returns valid response but with no results when clicking directly on thedropdown icon. Thanks @vpeti #5231 #5809 - Statistics - Fix issue where grouped statistics would have excess bottom margin if they are
:last-child - Label - Fix
basic labeldoes not use@basicBackgroundvariables Thanks @levithomson - Modal - Modal will not refocus a field if field is already focused Thanks @nikolaybobrovskiy #6301
- Icon - Fix
wechat iconnot displaying due to typo Thanks @alex-karo #6429
A Special Message about Flex Modals There will be an update shortly to resolve issues related to flex modals when using multiple modals and
detachable: false, in order to not hold up this release, we've decided to move forward without a fix.
A general solution will most likely require branching code for IE11 which will disable flex (as IE11 doesnt correctly implement the latest spec for absolute positioned flex containers).
Critical Bugs
- Dropdown - Fixed issue in
2.3.0that could cause multiselect dropdowns initialized by converting<select>to not add initial selected options. #6123 - Search - Fixes using category search with
fullTextSearch: 'exact'@Thanks @prudho returning duplicate results #6223 #6221 - Icon - Fixes
centeredandborderedicons appearing incorrectly with FA5 Thanks @w96k #6192 - Icons - Fixes missing aliases/incorrect icons from Font Awesome 5 port in
2.3.0Thanks hammy2899 #6181 #6175 #6176 #6174 #6175 - Icons - Fixed issue where
link iconwere appearing incorrectly due to changes in icons #6180
Enhancements
- Search - Adds disabled variation Thanks @prudho #6225
- Form Validation - Form can now return their validation prompt dynamically based on their current value. Thanks @xDaizu #6016 #3864
Bugs
- Dropdown - Fixed
onChangemissingtextfrom callback when dropdown is set toaction: 'select'Thanks @martinduparc #4183 #4510 - Icons - Fixes some icons that were incorrectly named. Thanks hammy2899 #6181
- Icons - Added ability to choose whether solid, outline and brand icons should be included in your theme via the
@importSolidIcons,importRegularIconsand@importBrandIconsvariables Thanks hammy2899 - Icons - Increased specifity on
fitted iconto fix compatibility with other components #6125 - Visibility - Fixed bug that could cause
onScreencallback to not occur properly for elements that are taller than screen. - Menu - Fixes
disabled itemshowing hover style forsecondary menuThanks @tcmal #6268 - CSS Variables - Added use of
@normalfor normal font weight for all non-default themes included in repo. #6227 - Image - Fixes margin being applied twice to
ui images#6224 - Reveal - Fix
whitespace: nowrap;applying to content insideslide revealandmove reveal
Docs
- Fixes CDN links in docs Thanks @KSH-code
- Fixed issue where iframes may not load correctly in
/examples/theming.html#6269
Major Enhancements
-
Icons - Font Awesome 5 is now included in Semantic UI Thanks @hammy2899 #6085
-
Search - Category search can now work with local search by adding a
categoryproperty to any result and specifyingtype: 'category'
var categoryContent = [
{ category: 'South America', title: 'Brazil' },
{ category: 'South America', title: 'Peru' },
{ category: 'North America', title: 'Canada' },
{ category: 'Asia', title: 'South Korea' },
{ category: 'Asia', title: 'Japan' },
{ category: 'Asia', title: 'China' },
{ category: 'Europe', title: 'Denmark' },
{ category: 'Europe', title: 'England' },
{ category: 'Europe', title: 'France' },
{ category: 'Europe', title: 'Germany' },
{ category: 'Africa', title: 'Ethiopia' },
{ category: 'Africa', title: 'Nigeria' },
{ category: 'Africa', title: 'Zimbabwe' },
];
$('.ui.search')
.search({
type: 'category',
source: categoryContent
})
;-
Popup - Popup can now position elements correctly even when they have a different offset context than their activating element. Like in this example.
-
Popup - Popup will now align the center of the arrow (not the edge of the popup) when it would be reasonable (up to 2x arrow's offset from edge). See this explanation
To preserve functionality movePopup default has remained as true (moving the popup to the same offset context), however now setting movePopup: false should now always position correctly. Be sure to use movePopup: true to avoid issues with ui popup inside menu, input or other places where it may inherit rules from its activating element or its context.
-
Transition - Adds new
glowtransition for highlighting an element on the page, andzoomanimation for scaling elements without opacity tween. -
Modal - Modal has been rewritten to use
flexbox. No need to callrefresh()to recalculate vertical centering. -
Modal - Modals now have a setting
centeredwhich can be used to disable vertical centering. This can be useful for modals with content that changes dynamically to prevent content from jumping in position.
Minor Enhancements
- Theming - Added global variables for reassigning
normalandboldfont weights for custom font stacks. Thanks @jaridmargolin #6167 - Search - Category results now has
exactsetting matching dropdown forfullTextSearchpreventing fuzzy search - Search - Category results will now responsively adjust
titlerow if titles are long instead of forcing a title width - Dimmer - Dimmers now have centered content with a single wrapping
contentelement. - Modal - You can now modify
closablesetting after init Thanks @mdehoog #3396 - Accordion - Added
onChangingcallback for accordion that occurs before animation in both directions Thanks @GammeGames #5892
Tiny Enhancements
- Popup -
arrowBackgroundnow inherits frombackground#6059 Thanks @devsli - Popup - Adds new variable
headerFontWeight - Search - Search now has responsive styles for mobile to prevent results being large than page width.
Bugs
- Modal - Modal
autofocussetting now checks to see if currently focused element is in modal, avoiding issues where focus could be set inonVisibleoronShow - Menu - Fixes
bigandhugesizes being swapped in menu Thanks @jeremy091 #5902 #5899 - Table - Fixes tr not having correct border on first row when using multiple
tbodyThanks @Mlukman #4458 - Popup - Popup will now use
contentspecified in settings beforetitleattribute #4614 Thanks @aaronbhansen - Form Validation - Fixes bug where
on: 'change'would still show validation prompts onblurwhen usinginline: true#4423 Thanks @avalanche1 - Dimmer - Fixes issue with
inverted dimmerwithcontenthaving wrong text color Thanks @rijk #4631 - Images / Transition - Fixed issue where
ui imageswould show nested images withtransition hiddenas block (Fixes sequential img animation demo in docs)
Doc Updates
- Icons - Icon documentation now has a search that will copy the relevent icon html to clipboard
- Icons - Icon documentation now lists publicly all icon aliases
Doc Bugs
- UI Examples - Fixe some improper html in UI examples included with repo #6127 Thanks @perdian
- Admin - Fixes bug in admin script that caused leaked global vars Thanks @esbena #6136
Critical Bugs
- Form - Fixes issue where radio checkbox would not return correct value from
get valuesThanks @tincdev #5713 #6043 - Modal - Fixes issue where an oversized modal would appear behind an existing modal when using
allowMultiple: trueand a second modal that is larger than the screen height. #2423
Enhancements
- Button - YouTube's red color now matches their current brand guidelines Thanks @hammy2899 #6110
- Flag - Adds missing flag for England Thanks @zyzniewski #5944
- Reveal -
ribbon labelcan now work withreveal#5681 - Dropdown - Added new setting
ignoreCase(defaults to false) that will prevent values from being added that match existing values (case insensitive). This is particularly useful when using allowAdditions for tagging to not allow case insensitive matches. - Site - Site theme now includes
@customScrollbarHeightand specifies a default horizontal scrollbar height Thanks @jayphelps #5749
Bugs
- Checkbox - Fixes issue where
toggle checkboxbox shadow was missing Thanks @banandrew #5096 - Dropdown - Fixed issue where dropdowns could incorrectly open upward and leftward opening when using
contextsetting due to an incorrect offset calculation. Thanks @dannyBies #5974 #5366 - Form Validation - Fixed issue where default prompts for
containanddoesntContainrules were swapped. Thanks @xiongyu-git #5530 - Visibility - Fixes issue where
bottomPassedandtopPassedwould not fire under some conditions - Dropdown - Fixes issue where dropdowns might accidentally animate closed two times when quickly tabbing through fields
- Popup - Fixed an error which could cause popup not to move to right offset context when using a different target setting.
- Dropdown - Fixed issue where using
ui inputin a dropdown menu could cause the input to be too wide in some cases Thanks @banandrew #5085 - Menu / Popup - Fixed issue where
inverted menurules would cause popup inside a menu to have incorrect link styling inlink listThanks @banandrew #5585 #5603 - CSS Build - Fixed issue where package
gulp-clonewas only set to use >1.0causing issues with gulp builds due to upstream error #6067
Hotfix (2)
- Install - Some interactive install script issues may be fixed. Forked
gulp-promptplugin to allow for updatedinquirerversion - Build Tools - Fixes typo causing fix for build tools to fail #5391
Major Enhancements (1)
- Dropdown - Dropdown can now have
valuesspecified in javascript when initializing.This should simplify cases where dropdown contents are contingent on other fields, for example listing sub categories. You can see some examples here and in the usage section of dropdown docs
Critical Bugs (3)
- Dropdown - Fixed regression that caused sub menu
dropdowninsideui menuto always appear on left edge of dropdown introduced2.2.11#5542 - Popup - Fixed a regression with
popupin2.2.11that caused popups to appear out of place in some cases due to incorrect calculation ofoffsetParent#5549 #5597 #5590 - Build Tools - Fixes issue with deprecated uglify setting that could cause build tools to fail with the following error:
GulpUglifyError: unable to minify JavaScript
Caused by: DefaultsError: `preserveComments` is not a supported optionEnhancements (2)
- Dropdown - Dropdown mutation observers now watch to see if the entire
<select>DOM node is replaced with a different select, and not just if new<option>are added - Modal - Modal will now take into account absolutely positioned elements inside a modal when determining if scrolling is necessary. #5578 Thanks @lulalala
Bugs (4)
- Dropdown - Fixed an issue where css rule for
focused default textwas not being applied for multiselects #5633 - Dropdown - Calling dropdown methods on
<select>will now work when usingsettingbehavior to set settings after load #3744 - Header - Fixes vertical alignment
- Header/List - Fixes issue where icons appear slightly offset with text due to line-height offset fixes no longer being necessary in modern browsers.
- Modal - Fixes issue where init order matters when multiple modals are shown at same time and
allowMultiple: trueis used #5559
Critical Bugs (5)
- Dropdown - Fixed issue where using
downkey to re-open dropdown when usingsearch selection dropdownwould start at the top element instead of jumping to selected element #4506 - Modal - Using multiple modals with different
invertedblurringorclosablesettings will now function normally in all cases #4368 - Modal - Fixed issue where modal
refreshwas being called on modals even if they are hidden, causing display issues when multiple modals are shown. Thanks @p2kmgcl #5319 - Form Validation - Fixed issue where radio was not being included in
onFailurevalues if not set #5064 - Sticky - Fix issue where sticky would cause page to shift when
contextheight was determined by sticky's height inposition: static;#3430
New Features (6)
- Dropdown - Dropdowns will automatically detect when they are offscreen to the right and will open leftward instead Thanks @Graveheart #4211
- Form Validation - Added
add ruleadd field,remove rule,remove fieldto programmatically and and remove validation rules from form validation #4267 #5253 - Site - Site now includes custom styles for in-page UI scrollbars (but not actual page scrollbar) by default in WebKit/Chrome. Components with inverted content like dimmer include an inverted scrollbar. You can disable this by setting
@useCustomScrollbars: falsein yoursite.variables - Modal - Adds new
scrolling contentvariation to have a modal with content that scrolls - Sticky - Sticky now includes a new setting
setSizeto determine whether it should set content size on stick to the size before sticking (fixed content uses different positioning system) #4360 - Reset - Upgrades to normalize.css 7.0 Thanks @ivantcholakov #4647
- Modal - Adds
tinyandminisized modals Thanks @Banandrew #5123 - Steps - Steps now include an
unstackablevariation Thanks @TemaSM #3714
Enhancements (4)
- Build Tools - All Gulp/NPM dependencies have been updated to their latest versions
- Dropdown - Improved spacing on
imageinsidemenu itemand for selectedtext - Popup - Added
bind clickawaybind touch closebind close on scrollbehaviors to make it easier foron: 'manual'popup to specify behavior - Popup - Separated className setting for
visibleintovisibleandpopupVisible, this way you can remove visible indication on activating element without modifying popup visibility.
Bug Fixes (19)
- Table- Fix inverted table header color not applying properly to
sortable tableThanks @Banandrew #5303 - Dimmer - Changing closable or inverted settings dynamically with
settingwill now modify settings correctly on next show/hide without re-initialization - Dropdown - Fix dropdown arrow being slightly off center due to em calculation being incorrect due to differences in relative em
- Dropdown - Fix
loading dropdownicon position being slightly offset - Dropdown - Fixed issue where
search selection dropdownwould reset list to top after selection when re-opening dropdown #4506 - Icon - Changed
content iconto use an existing aliassidebar icon, as it is most common use case and prevents naming collisions withcontentof elements Thanks @philrykoff #4574 - Sidebar - Removed use of
iosbrowser detection, and use of-webkit-overflow-scrolling: touch;. iOS no longer has sizing issues when displaying sidebar content in latest iOS. - Search - Fixed issue where
searchDelaycould cause results to appear after search had lost focus. - Sticky - Fixed edge case where using
offsetsetting, sticky element would not internally scroll if the rail contents (without the offset setting) would fit on screen - Popup - Fixed bug where
supports svgwas not working correctly due to incorrect comparison toundefinedThanks @mathiasrw #4544 - Input - Fix issue where transparent input had a border radius and could cut off descendors #5281
- Input - Fixes disabled style being applied twice on input Thanks @levithomason #5284
- Message - Fix issue with
compact icon messagenot appearing compact #4759 - Menu - Fixed issue where
left menuandright menudid not display correctly instackable menuon mobile Thanks @BleuDiamant @Traverse #3604 #5116 - Menu - Fixed issue where
(x) item attached menuwas off by 1 pixel due to a css inheritance issue #4248 - Popup - Fixed issue where popup would incorrectly add itself to the wrong offset context when using
popupandtargetsetting together in cases where thetargethas a differentoffsetParentthan the activating element. - Segment - Fixed issue where using colored segment e.g.
red segmentinsidesegmentswould not work when:first-child#4013 - Sticky - Fixed an issue where
ui stickyused with a percentage based width would not resize properly if the content size of container changed when "stuck" #4360 - Dimmer - Fixed typo causing body dimmer to add unnecessary
position: relative;Thanks @jinyangzhen #4707
Doc Fixes (3)
- Form - Updated docs to include new examples of adding/removing validation rules
- API - Clarified in docs that all AJAX parameters can be passed to API
- Form Validation - Added undocumented
add promptto list of behaviors
Critical Bugs
- Dropdown - Fix search input inside dropdown menu causing dropdown to close before selection when selecting an item #5113
- Dropdown - (IE11 Only) Fixed issue where dropdown re-opens immediately after closing when using a
searchinside menu. #4237
Bugs
- Button - Fixes
@basicActiveBoxShadowbeing used incorrectly in basic button variables - Visibility - Visibility events now fire correctly when using
contextother than body that hasoverflow-xoroverflow-yset toautoorscroll - Dropdown - Fixes an issue where dropdown would not correctly open
upwardat bottom edge of the screen when using acontextwithoverflow-xoroverflow-yset toauto - Modal -
onDenyandonApprovecallbacks can no longer occur multiple times if you rapidly click a approve/deny button in a. #4479
Enhancements -Form - Credit card validation now no longer fails validation with dashed credit card values #5122 Thanks @neokio
Bugs
- Visibility - Fixed bug where using visibility with
contextsetting on a scrollable context (with overflow) would cause callbacks to fire incorrectly - Visibility - Fixed bug where
top passedandbottom passedwould appear as incorrect values if using settings fromget element calculationswhen element is off screen.
Build Tools
- Fixes
2.2.8npm install script failing due to incorrect path inrequirestatement
Some quirks have been resolved that may cause changes for upgrading users who were expecting these behaviors
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.
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.0Always the man @BreadMaker #4766 - Dropdown - Added new setting
filterRemoteData, when set totrueAPI 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 -
forceSelectionsetting 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
iOSwould show incorrect background when opening sidebar if page is less than 100% height #4264
Critical Doc Fixes
- Visibility - Added documentation for
onOnscreenandonOffScreen, two very important callbacks that occur when an element is or isn't in currently scrolled view.
Enhancements
- Items - Added
unstackablevariation to prevent items from stacking on mobile #2901 - Search - Added new parameter
callbackto behaviorsquery,show results,hide results, andsearch remoteto 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 -
esckey 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 buttonsto not center correctly #4487 - Dropdown - Fixed bug where clicking on a dropdown's
dropdown iconwhen using remote data would not open menu #4041 - Dropdown/Search/Checkbox - Removes use of deprecated
dispatchEventDOM APIs for generating simulated events - Dropdown - Fixes issue where
left pointing dropdownandright pointing dropdownappear 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 menuorscrolling dropdownwould have excessive right padding by removing scrollbar width from calculation (no longer necessary in modern browsers) - Comments -
small,largeand other comment sizes now default to global size variables. - Dropdown - Fixed issue where
selectOnKeydownwithhtmlcontent would cause only non html content to display intextuntil 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 iconorimage outline iconwould cause incorrect display withinui headerdue to namespace collision withui image#4145 - Input/Dropdown - Fixed rounding error causing vertical alignment of
dropdown,search,inputto sometimes appear off by 1 pixel #4279 - Segment - Fixed
padded vertical segmentvery padded vertical segmentmistakenly 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
sizevariations to comments docs #4450 - Typos - Thanks to everyone who has submitted typo/grammatical PRs, much appreciated
Build Tools
- Autoinstall - Fixes issue where
autoinstall: truewas not copying build files duringnpm installThanks @AnsonT #4430 - Dependencies - Updates build dependencies
Bugs
-Tab - Hotfix for accidental use of ES6 let
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
DOMwhich preserves the final DOM state after scripts rendering. This can be used to avoid re-running returned<script>tags on each cached read #2534 - Checkbox - Adds additional variables for styling toggle checkbox on/off state
- Sticky - Adds
containersetting. This can be used to specify the offsetParent of the sticky element and avoid having to calculate on initialization (improving performance) - Progress - Progress now includes transitionEnd failback for progress bar animations, this will prevent labels from continuing to be updated if the
transitionEndcss callback does not fire correctly - Transition - You can now specify
data-displayto specify the final display state for an animation in cases that it is detected incorrectly (you can also pass in as a setting)
Critical Bug
- Search - Fixed issue where keyboard navigation for search was broken in
2.2.3due to regression #4469
Bugs
- Build Tools - Removed unnecessary
gulp-minify-csspackage from deps #4463
Enhancements
- Message - Added additional variables for
@padding
Enhancements
- Form Validation - Bracketed notation can now be omitted for rules, instead passing in bracketed values with the
valueparameter #3313 - Dropdown - Using
search selectionwithselectOnKeydownwill now highlight the partial search matching the currently keyboard selected value - Modal - Modal now includes setting to enable/disable keyboard shortcuts
- Modal - Modal will now focus first tabable element, not just
input#4370
Bugs
- Comments - Adds missing sizes (mini, tiny etc) Thanks @ilanus #4408
- NPM - Fixed
package.jsonto allow either jQuery2.xor3.x#4254 - Button/Dropdown - Fixed issue where
ui dropdown buttoncould have incorrect spacing for dropdown icon Thanks @ilanus #4408 - Form/Segment - Fix typo causing
pointer-events: noneno to work onloading segmentandloading formThanks @YamiOdymel and @ilanus #4403 - Icon -
iconscan now receivelinkstyling Thanks @tbracken #4399 - Button - Fixed
vertical buttonswith only 1 button having incorrect border radius Thanks @Denhai #4107 - Grid - Fixed issue where
(x) aligned columninside a(x) aligned rowwould not properly apply thecolumnalignment - Form - Fixed issue where
disabled fieldswith radio inputs would not correctly dim the label Thanks @louwers #4366 - Menu - Fixed issue where
dropdowninvertical menuwould not correctly openupwardwhen no space below Thanks @gdaunton [#4150 #4156 - Dropdown - Using
search selection withselectOnKeydown` and text content that includes html, will not apply html content (like images) to the text until dropdown blur, making sure that content can align correctly with the partial search content of the search input (which cannot include HTML) - Dropdown - Fixed issue where dropdown
clearwould not remove active state whenuseLabels: trueand multiple dropdown Thanks vinh123456789 #4275 #4366 - Dropdown -
dropdown iconno longer relies on stopping event propagation. This means using the dropdown icon will now cause other dropdowns to correctly hide. #3998 - Dropdown - Fixes
action: selectnot working correctly since2.2due to incorrect use of new function signature. #4183 - Dropdown - Fixed typo causing selectObserver mutation observer not to disconnect Thanks @Paklausk #4311
- Icon - Fixed missing
dribbbleicon due to incorrect count of "b" (should be 3). #4185 - Icon - Fixes
grab iconandtelevision iconnot appearing correctly #4178 - Form -
inputstyles now apply totype="file"thanks @coldfire79 #4074 - Popup/Menu - Fixed issue where popup would not appear correctly when nested in menu in some ways.
- Icon - Fixes
talkicon not working correctly Thanks @anantogosh #4354 - Transition - Removed unreachable code Thanks @basarat #4225
- Grid - Fixed alignment in `centered justified grid** Thanks @bretto36 #4224
- Popup - Fixed issue where
observeChanges: falsesetting in popup would not prevent mutation observers
Docs
- Icons - Fixed some duplicate icons (External) and mispelled icons (Dribbble)
- Popup - Fixed popup in menu example
Themes
- Material - Fixed paths to
Robotogoogle font to usehttpsThanks @AndyR207 #4051
Bugs
- Shape - Fixed issue where shape was animating incorrectly when using jQuery 3.0, due to secret changes in how
widthare calculated on elements withtransform - Dropdown - Fixed "pointer" cursor appearing in hitbox above search input in
search selection, now all input area will appear with "text" input cursor - Dimmer/Modal - Fixed a bug which could cause a modal's dimmer to not obey
inverted: trueorblurring: truewhen initializing modals with then afterwards without either setting.
Bugs
- Dropdown - Fixed issue where using both
<select>andallowAdditions: truewould cause dropdown selection to fail
Project 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
silentto 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, orstickycontent 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-hugeto matchH1-H5 - All UI - Components that use event handlers on
document,body, or asettings.contextnow all use DOM mutation observers to detect removal and prevent memory leaks - Button - Added compatibility with
primarysecondarypositivenegativebuttons with thebasicstyling variation. #3756 - Card - Added
raisedcard variation Thanks @yordis #2955 - Dropdown - All dropdowns, not just
selection dropdown, will now select the firstmenu itemthat 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
enterkey press to confirm selection in most cases. To enable previous pre2.2selection style use the settingselectOnKeydown: false - Dropdown - Dropdown will now automatically focus on
searchinside 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.3Icons. 80+ new icons+ are included. Thanks @BreadMaker for the PR and @davegandy for the font! - Popup - Added new
tooltippopup type that works without javascript. Tooltips can specify positioning and some variations usingdataattributes, 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
onprogressevents say every 50ms) will now appear smooth as butter. - Table -
definition tablenow includes additional class names for forcing, or ignoring definition cell styles
New Settings
-
Build Tools - Added new
autoInstalloption 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
hideAdditionsthis will remove showing user additions inside the menu, making for a more intuitive adding process. Dropdowns now have a new stateemptywhich will format an active dropdown with empty results. #3791 -
Dropdown - Adds new
allowReselectionoption to triggeronChangeevents even when reselecting same value -
Dropdown - Adds new setting
minCharacterswhich sets the minimum number of characters required to start filtering results #3886 -
Form Validation - Added
dependsvalidation rule setting which will only validate a field if another specified field is not empty -
Popup - Added new setting
boundaryandscrollContext.boundarylets you specify an element that the popup will try to position itself to be contained inside of.scrollContextlets you specify the element which when scrolled should hide the popup -
Popup - Added new settings
observeChanges, which is enabled by default. This will add special mutation observers to triggerdestroywhen the element is removed from the document, preventing memory leaks. -
Progress - Added
onLabelUpdatecallback, this can be used to specify the exact text that should appear on the actual progress update, perhaps based on some external conditions -
Rating - Added new setting
fireOnInitfor rating, which defaults tofalse. When set to trueonRatewill fire when rating is initialized #3712 -
Search - Added a new option
selectFirstResult, which defaults tofalse. Will automatically highlight first result on search -
Search - Search now includes a
showNoResultssetting for determining whether no results messages should be shown -
Shape - Shape now lets you specify next side width using setting
width, can usenextorinitialto specify whether it should use old or new side size -
Tab - Added new setting
cacheType, can either behtmlorresponse(default). HTML will cache resulting html after callbacks,responsewill cache the original response so that it can be played back identically on future loads #2534 -
Tab - Added new option
deactivate, defaults tosiblingswhich 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
onFixedandonUnfixedcallbacks for visibilitytype: 'fixed' -
Visibility - Added
onLoadandonAllLoadedcallback fortype: 'image'visibility -
Visibility - Added
zIndexsetting for specifying zindex withtype: 'fixed'#3370
New Behaviors
- Dropdown - Added new convenience method
restore placeholder text - Image -
transition hidden imagenow shows correctly asvisibility: hidden;and notdisplay: none. This will allowoffsetwithvisibilityandstickyto work more seamlessly.hidden imagewill still remaindisplay: none; - Progress - Added progress
is completefor returning whether success, warning, or error conditions are met
CSS Enhancements
- All UI Extended variables which return exact pixel values in em (
@relativePXand @px) up to 64px to allow for simple theming with exact values - Button - Added variables for configuring
disabledbackground image and box shadow. - Site - Added colored box shadow defaults.
ui messagenow includes individual colored border shadows based on new site defaults. - Site - Added new
@inputColorand@inputPlaceholderColorglobal variables that now control placeholder text styles across all components. - Table -
definition tablenow supportsdefinitionvariation to specify definition styles on an element that is not:first-child - Table -
definition tablenow supportsignoredvariation to force afirst-childto 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 -
beforeSendwould 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 -
forceSelectionwill now automatically select values with multi dropdowns. When usinguserAdditionssetting it will now automatically tokenize the current entered value - Dropdown -
search selectionwould 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 dropdowncould 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: blurcould cause fields not yet interacted with to be validated #3606 - Form - Fixed issue with
(x) fieldsandequal widthfields 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 railandvery close railcaused 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
onResultreturningfalsewould 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
destroyif removed from DOM context, fixing a possible memory leak - Video - Fixed issue with
.video('change')behavior not properly changing video.
Bugs
- API - Using
onResponsewithdataTypeother 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 iconlikeright arrow iconwould have additional margin inside anicon button#3525 - Button - Fixed issue where
disabled loading buttonwould not removepointer-events#2933 - Button - Fixed typo in
green inverted button#3873 - Button/Dropdown - Button dropdowns using
default textno longer receive incorrect font styling for placeholder text - Checkbox - Fixed issue where docs refer to
onEnableandonDisablewith checkbox but callback was calledonEnabledandonDisabled, both callbacks will now be valid until 3.0 #3761 #3763 - Checkbox - Radio buttons received
indeterminatestyles when user has not yet interacted with the page in Chrome - Dropdown -
apiSettingswas not defaulting to usecache: 'local'as specified in the docs - Dropdown -
get valuewould not return correct value when value was blank #3766 - Dropdown - Added
1pxoffset 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 causetextvalue not to be passed toonChangecallback - 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
allowAdditionswould cause input to mistakingly drop to next line early #3743 - Dropdown - Regenerated dropdown will no longer ignore
disabledproperty #4010 Thanks @eymengunay! - Dropdown - Search selection would lose search input focus when clicking on a choice #3790
- Embed -
APIsetting is now disabled by default - Form Validation - Fixed issue where initializing form multiple times would not properly call
destroyremoving previous settings #3798 - Form - Fix
equal width fieldssometimes not including right field spacing on mobile #3913 - Form - Fixed issue where
inlinefield was not being correctly inverted in color withinverted form#4004 #4005 Thanks @tbracken - Form - Grouped
fieldsandfieldwould cause different margin collapse, makingfieldsinclude larger gaps between content #3717 - Form - Remove deprecated
size()method inprompt#3655 Thanks @SimonArdrey - Grid -
centeredcontent would causejustifiedcontent to appear aligned left. #3496 - Grid - Fixed issue where
vertically dividedgrid would have top margin in firstrowgroup - Icon - Sizes smaller tham
smallwere using withrem#3782 - Input - Fixed
:activestyles appearing on disabled input, when input is disabled usingdisabledproperty #3907 - Input - Fixes issue with
dropdownor button on the left side of anactioninput not properly rounding - Label - Fixed margin when
right floatedelement precedes atop attached label - List -
relaxedandvery relaxedlists 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 -
stackablemenu withleft/rightmenuoritemwould incorrectly be floated when stacked. #3604 - Menu -
tabular menunow has correct bottom margin #4167 - Menu -
@dividerSizewas not being used invertical menu#3781 - Menu -
vertical text menuno longer includesleftorrightpadding, but will now sit flush with content. - Message - Fixes
compact messageappearing asblockwhen inside aform#3343 Thanks @bcroq - Modal - RGB values set for dimmer
background-colorwere not being correctly interpreted #3665 Thanks @larsbo - Modal/Dimmer - Fixed issue with
destroynot properly removing events from dimmer #3200 - Popup - checking
instanceof SVGGraphicsElementcaused error in IE11 #3043 - Progress - Progress
onSuccess,onError, andonWarningcallbacks now occur after the animation completes for the state change. - Rating - Fixed
ui ratingto not used outlined star in basic variation, instead using a lighter filled in star for increased visibility #3730 - Rating - rating does not fire
onRatewhen rating is initialized #3712 - Search - Added
refreshbehavior for search to refresh selector cache. Cache will automatically refresh after API results received - Search - Fixed issue where
hrefwas not pulling correctly on search click when theresultwas anaitself. #3409 - Segment - Fixed
segmentsto not clip border radius when only a single segment is included - Segment/Message -
top attached messagehas no border when attached tosegment#3619 - Statistic - statistic receives incorrect size when using
tinylargeetc inside a statistic group #3116 - Step - Fix incorrect bottom margin on
top attached steps - Table -
striped selectabletable would not correctly show hover color on striped rows - Visibility - Using
type: fixedwill now correctly remove all special classes and placeholder content ondestroy#3548
Changes
- Sizing -
minithe smallest size has been modified to align to11pxinstead of previous10pxat 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
Critical Fix
- Install - This fixes a regression causing users with NPM
2from using Semantic UI, caused by removing the deprecatedpeerDependencieswhich are necessary for NPM2 install to function correctly. #3511
Minor Fix
- Flag - Adds Scotland and Wales flag #3494 Thanks @edumucelli
- Install - Fixes post-install scripts not exiting with correct return values #3515 Thanks @Jeff-Tian
Enhancements
- API - All responses fulfilled with settings (like
mockResponse) will now receive a settings object with all values resolved. For exampleurlwill be/user/2/and notuser/{id}in the callback. - #3466 - API - API now allows the use of settings
responseandresponseAsyncto replacemockResponseandmockResponseAsync. 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
onUnplaceablecallback 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
1pxoffset whenattached segmentfollowstabular menu(max of 2 consecutive segments) #3479 - Header -
sub headerused inside a header now correctly forcesblockstyling #3020 - Popup - Fixed
is visible,is animating, andis fluidto always returntrue/falseand not the DOM element. #2781 - Popup - Fixed issue with
onEnablecallback being defined with nameonEnabledandonDisablewithonDisabledin 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 thinsidebar to not work #3300 - Sidebar - Sidebar no longer includes
transformrules 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
noAnimationerror to more reasonably announce that the element is "not in the DOM" #3040
Bug Fixes
- Checkbox/Dropdown/Search - Fixed issue where dropdown/checkbox
changeevents were not bubbling. (Dispatched events were swapped to use nativedocument.creatEventin2.1.5unfortunately the flag to bubble events was mistakenly off.)
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 formandequal width fieldsfor simpler grouped fields - Modal -
onHidecallback can now cancel event by returning false #3168 Thanks @mdehoog - Dropdown - Added
onLabelRemovecallback that allows value removal to be cancelled by callback Thanks @goloveychuk - Table - Added
selectableon table cell, allowing for full table-cell links - Popup Added three new variables for
arrowbackground 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 popupandchange contentto 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 nativechangeevent. 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
onCompleteevent - Sticky - Fixes bug where sticky would stick at incorrect times when using a different scroll container than
bodyand scrollTop is not 0 on page load.
Bugs
- Divider/Step/Modal/AD - Fixes 1px jump at
@mobileBreakpointcaused 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 dropdownin some cases. #3002 - Dropdown - Added
remoteValuesas a possiblefieldsetting. Allowing users to return API results using arbitrary JSON object groupings. #3080 - Dropdown - Added ability to pass in
keysas a setting, to avoid issues with languages where comma delimiter may be a different keycode #3016 - Dropdown -
search dropdownwill now initialize withautocomplete="off"to avoid triggering native autocomplete menu - Form Validation - Fixes error on
blurorchangewhen using a blank validation object #3131 Thanks @listepo - Form Validation - Fixes some issues with form integer validation #3053 Thanks @maturano
- Form Validation -
decimalrule now only matches decimals, to match any number usenumberrule. #3060 - Form - Removed
dividerspacing 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 onlyclass #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
svgelements #3043 - *Progress - Calling
resetwill now resetvalueto 0, so increment starts again at 0 - Search - Fixes
onSearchQuerynot firing when results are cached Thanks @mnquintana - Search - Fixes
urlparameter not working correctly due to typo in source Thanks @fabienb4 - Segment - Fixes border on
horizontal segmentwhen they are:first-childinsidesegmentsgroup 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
Critical Bugfixes
- Build - Fixed issue where using a packaged theme without a
site.variableswould cause build to fail #3009 #3010
Enhancements
- Form Validation - Form validation now supports a brand new shorthand which is drastically simpler to specify #2579
// 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 -
identifierandpromptare 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 listused insideui messagenow aligns properly in all conditions #2958 - Form Validation - Validation messages in
error messagegroup 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 tablewas inheriting accidentally inheriting some grid styles - Grid - Fixed
middle aligned gridnot applying to columns #2959 - Menu - Fixed issue where
right menuwas not floating correctly inside amenu > containeron mobile #2969 - Button - Fixes
right labeled icon buttonwith arightnamed icon (for exampleright arrow) having incorrect margin on icon. #2973
Bugfixes
- Embed - Fixes issue with
?=appearing before parameters instead of?#2956 Thanks @AgentShark - Input - Fixes regression where
ui icon inputinside forms were not correct width #2953 - Input - Fixes typo in focused placeholder text color preventing the value from being used #2939
- Input -
action inputnow correctly show focused border on button side, and avoids duplicating borders
Bugfix
- Form Validation - Fixes callbacks on
onSuccessso as to not break backwards compatibility. #2945 #2944
Bugfix
- Build Tools - Fixes issue causing comment banner to incorrectly show version
2.0.7indist/
New UI Features
- API - Added
encodeParametersoption to enable/disable parameters being encoded withencodeURIComponent#2752 - API Added new setting
hideError, defaults toauto(will automatically hide error for elements that are not forms). #2586 - Build Tools - Packaged
.overridesfile are now an optional include - Button -
colored basicbutton are now colored before:hoverin the default theme, this is more in line with common usage across other websites. - Button - Added
labeled buttonvariation for display a count next to a button. - Cards - Added documentation for
stackablecards which was available but undocumented in previous versions. - Checkbox - Added 4 new callbacks
beforeChecked,beforeUnchecked,beforeDeterminate,beforeIndeterminate. You can now cancel a state change by returning false from these callbacks. - Divider - Vertical divider can now be used multiple times in a single column row (not just 50/50 split). #2808
- Dropdown - Dropdown using remote data, can now customize the property names returned by api call using
fields(similar to search). - Dropdown - Dropdown will now automatically update selected values when hidden input value changes (so long as
changeevent is triggered) #2626 - Dropdown - Dropdown with user additions now will use custom templated messages to distinguish added choice from preselected choice #2923
- Form Validation - Added credit card validation, supports array of card types, and international cards including non luhn cards like China UnionPay #2729
- Form Validation - Updated appearance of form validation prompts to use a more lightweight style. Added variables for controlling error validation prompt styles in
form.variables - Grid - Added new responsive
reversedvariations for reversing column order, these are also compatible with other grid types likedividedandcelledby device #2685 - Icon - Added
fittedicon variation, and new small sizestinyandmini - Input - Added
disabledstate for inputs #2694 - Input - Added ability for labeled input to be attached to both sides #2922 Thanks @maturano
- Label - Added a new
basic labelstyle, works symbiotically with other label types to provide a more lightweight style label - Menu - Added new
tabularmenu types,right tabular,bottom tabular, added many newtabularmenu variables for customizing - Menu - Appearance of
labeled icon menuhas been modified. Horizontal menus now have icons above text, and icons are slightly larger than before. - Search - Search now can use any server response mapping, use the
fieldsparameter to pass in a mapping of server response to content thanks @anibalmf1 #2645 - Site - Added global variable
@focusedFormBorderColorfor controlling form focus border color - Table - New
fixedtable variation added for use withtable-layout: fixed;. This also supports "..." ellipsis when used withsingle linecontent
- Breadcrumb - Breadcrumb no longer receives vertical spacing by default. This may often cause vertical alignment issues when displayed next to other
inline-blockcontent. - Dropdown - Added
get default textandget placeholder textbehaviors for returning text values. - Dropdown - Pointing dropdown (dropdown with arrows) now support
upward, and will automatically move pointer arrows when appearing upward #2733 - Form -
inverted formnow remove input border, added new variables for controlling inverted form input styles - GitHub Theme - Added github icon theme with port of Octicons.
- Label - Added
basiclabel variation, useful for item counts - Menu -
inverted menunow supportcoloredindividual items Thanks @maturano #2850 - Menu -
text menunow uses padding for hitboxes to make target area for links larger
- Build Tools -
gulp buildnow correctly callscallback, allowing those importing tasks to chain it correctly #2836 Thanks @artemkaint - Dropdown - Dropdown
showandhideare now cancellable by returningfalsefromonShoworonHidecallbacks. - Flag - England flag alias is now correctly set #2770 Thanks @eduardom
- Form Validation - Added
numberanddecimalvalidations to form Thanks @TonnyORG #2537 - Form Validation - Form
onSuccessandonFailurenow receive current form fields as a parameter Thanks @guodong - Popup - Popup will now look for inline popup as any next adjacent sibling #2772 Thanks @malacalypse
- Accordion - Added missing notation for accordion docs #2812
- Build Tools - Fixed bug where
gulp versionwould showx.x[#2875 #2920 - Build Tools - Fixes issue where component glob
{tab, table}caused table to be included twice in concatenated source ** - Button - Fixes inverted button missing an
activeandactive focusstate #2635 - Button - Fixes issue where
basic buttonwould not have focus color text when colored #2264 - Checkbox - Clicking a link inside an initialized checkbox
labelwill now work correctly, and will not toggle the checkbox. #2804 - Container - Fix issue with
fluid containerbeing100% + gutterat mobile resolution (causing overflow) - Dropdown -
forceSelectionno longer sets current value in search selection when current query is blank #2058 - Dropdown - Dropdown
@arrowSizewill now automatically reposition itself if size is changed with variable - Dropdown - Dropdown arrow now has a variable
@dropdownArrowSize, and is slightly smaller than previously - Dropdown - Fix
left menuinsideui menuappearing horizontally #2778 - Dropdown - Fixed error where menu would disappear when entering spaced words using
allowAdditions: truecaused by value matching its own whitespace-trimed value #2853 - Dropdown - Fixed issue where "no results" message would be still be visible before search query on input focus #2824
- Dropdown - Fixed issue where
onChangewould not fire when usingaction: 'hide'. #2818 - Dropdown - Fixed issue where selected item would not be shown when being re-shown after filtering with single search selection #2824
- Dropdown - Fixes issues with setting "" (empty quote) values when
placeholder: falseis used. Fixes issues with usingclearandrestore defaultswithout placeholders. #2637 - Dropdown - Remove use of
trimwhich causes issues IE 11 and below #2806 - Embed - Remove accidental
console.logstatements in js #2760 - Form / Input - Fixes
::placeholdertext color forui error input, modifies form error placeholder color to distinguish from form value error color #2786 - Form / Input - Fixes issue where
ui inputwould sometimes collapse to0pxwidth, especially when used inside aninline field[#2705 [#2621 #2821 - Form -
disabled field(s)now removepointer-eventsallowing it to disable checkbox and dropdown functionality #555 - Form - Date input and other special input in chrome now are the same height as normal input (adds custom vendor shadow dom styling) #2704
- Form - Form will no longer show messages that are empty in
error,warning, orsuccessstate. - Grid - Fixed issue where
relaxed stackable gridwould have incorrect margin on mobile width - Grid - Fixed issue where nested
stackable gridwould have incorrect margin on mobile. - Header - Fixed
attached headerto have the correct bottom border ontop attachedandattachedvariations. #2798 - Icon - Fixed typo in cube icon alias caused by bad grep #2765
- Input - Fixed issue with appearance of
left corner labeled left icon input#2782 - Item - Fixed
bottom alignednot working in item due to incorrect flex value #2826 - List - Lists can now be
right floatedorleft floated - Menu - Fixed
(x) columnnested grid with alignment stacking vertically (wrong flex-direction) #2810 - Menu - Sub menus now work correctly and are correctly spaced inside
secondary menuand text menu` #2862 - Modal - Fix autofocus setting in modal not working due to improper selector #2737
- Modal - Increased
closespecificity, modal will now only close on> .close#2736 - Popup - Fixes issue where variation would not be added to a pre-existing popup even if specified in javascript #26011
- Search - Calling
.search('show results')no longer fails when input is not focused #2842 - Table/Label -
ribbon labelswill now automatically position themselves when used inside a table #1930 - Transition - Transition callbacks now all have the correct
thisset. #2758
- API - API debug is now
falseby default, like other modules. #2817 - Build Tools - Removed octal literals from install scripts (for color escaping), and uses of future ECMAScript reserved words [#2838 #2839 Thanks @artemkaint
- Dropdown - Fixed issue where label could not be removed when using a numeric value due to mismatched types [#2754 #2755 Thanks @dgurkaynak
- Menu - Fixes tabular menu missing variable for background. Thanks @frontdevde
- Step - Fixed issue with display of step groups with only one step having incorrect border radius Thanks @elliotisonfire #2869
- Sticky - Sticky now sets width and height with
!importantto avoid inheritance issues in some cases Thanks @lauri-elevant #2710 - Tab - Fixed issue where simple path would be tested before full path, i.e.
first/vs/second/first/causing tab to not open in some cases Thanks @habibutsu #2843
Additional Bugs
- API - API now will use automatically use
formaction if no api event is specified now when form isstateContextbut not initialized element - Build Tools - Fixes issue on
winplatform where packaged theme would not correctly update when using watch due to regExp not matching windows path separators. - Dropdown - Dropdown will no longer fire native
onchangeevent on hidden input when setting value during initial load (unlessfireOnInit: true) #2795 Thanks @lauri-elevant - Dropdown - Fixed issue where
forceSelectionwould not occur whenpageLostFocus(clicked into another tab and back) - Dropdown - Fixed issue where using the specific value
value="false"would cause an option to not be removable from a multiple select - Dropdown - When
useLabels: falseplaceholder text will now show up when 0 items selected, instead of the text "0 items selected" - Dropdown/Tab - Fixed an instance where
metadatawas not referencing settings metadata value - Form Validation - Fixed issue with
get value(s)where unchecked checkboxes would not correctly retrieve values - Form - Dropdown in
inline fieldnow use auto width instead of 100% - Grid / Container -
ui relaxed grid containerandui very relaxed grid containerwill now all render at same container width - Grid - Fixed
stackable celled gridhaving doubled border width between rows - Header - Fixed issue with em sizing of
chubbyandbookishheader themes appearing too large - Icons - Fixed issue where
active iconoremphasized iconwould not adjust opacity inside menus - Input -
labeled inputnow keeps border on label edge so that focus color appears correctly - Input - Input now will reset
font-weightandfont-styleif set on parent; - Input
action inputandlabeled inputnow have focused border on inner edge with label/button - Label -
pointingandattachedlabels are now word order sensitive to allow them to work correctly with other directional variations. - Label -
pointint labelnow rounds to exact pixel em value, should align correctly in more cases - Menu -
@pressedItemColorhas been renamed to@pressedItemTextColorto match naming conventions of other variables - Menu - Added
flex: 0 0 autoto menu item to make sure menu do not collapse text content to reduce space - Menu - Fix text align on
dropdown iteminsideicon menu - Menu - Fixed hybrid initialization not creating
menucorrectly. Fixed docs example of hybrid<select>initialization - Menu - Fixed issue with
labeled inputtext inside menu not appearing vertically centered - Popup - Fixed
onRemovefiring even when popup is not removed - Reveal - Reveal now uses
display: inheritinstead of forcinginline-block
All UI - This release should fix issues caused when importing individual component using require when using single component repos. See discussion in #2816, and previously #1156, and #1878
Important Note
This release should fix bugs some may have encountered with npm install semantic-ui hanging after set-up. See this thread for more details.
- API - Fixed some cases where
onComplete,onSuccessandonFailurewould receive XHR as first parameter and notresponse. #2713 - API - Fixed issue where
onFailurewould pass response as stringified JSON and not a JS object #2713 - Build Tools - Fixed some cases of
npm installwith CI or tests. Install will not stop to ask questions if project has an existingsemantic.jsonfile (more quiet options to come) #1816 - Dropdown - Fixed border radius on
circular labeled icon button#2700 - Dropdown - Fixed issue where dropdown nested inside
labelwould not open. #2711 - Popup - Fixed issue where popup would not open on tablets with both touchscreen and mouse on mouseenter. #2715
- Build Tools - Fixed autoprefixer not correctly setting
last 2 versions#2717 Thanks @frontdevde - Gulp Import - Fixes error
Cannot find module 'gulp-help'which may occur when importing gulp tasks #2653 #2668 Thanks @fholzer
Docs
- Recipes - Add links to Sketch files for SUI. Add example repo on how to import gulp tasks.
Minor Enhancements
- API - All API callbacks now receive
xhrfrom API request as the third callback parameter
Additional Fixes
- Checkbox - Fix checkbox "check" appearing italicized when included inside italicized text
- Popup - Fixed terribly typo where popup
onShowwas mistakenly being called instead ofonHidewhen hiding popup - Popup - Popup on
touchstartnow occurs immediately without waiting fordelay.show
Important Notes
- Form Validation - In
2.0.4lengthrules were corrected to match "exact length" and not "minimum length". This may have caused issues for those who were using this rule as min length previously. We've remedied any breaking changes introduced by by returninglengthto functioning as "minimum length" and added a new ruleexactLengthfor matching exact length. #2681
- Dropdown - Fixed issue where
disableddropdown would still receive focus #2699 - Dropdown - Fixed
restore valuesometimes now working correctly due to "animating out" label still being mistaken for selected. #2690 - Dropdown - Added
set exactlyto remedy confusion ofset selectednot removing current selections with multiple #2689 - List- Fixed issue where using an image variation like
ui image labelas a direct child of anitemwould remove right padding #2691
Additional Fixes
- Dropdown - Fixed issue where using text labels,
useLabels: false, would cause selection count to appear incorrect. - Dropdown - Text labels,
useLabels: false, now works correctly withmaxSelections, and receives special UX considerations
- API - Data replaced in urls,
urlData, will now be url encoded by default. Additionally checks were added to avoid double encoding already encoded values. #2394 - Checkbox - Fix issue with
onChangenot firing when space key is used. Checkbox keyboard shortcuts now occur onkeydownbut cancel events correctly onkeyup#2676 - Radio Checkbox - Fixed regression causing radio checkboxes to all appear selected in chrome due to
:indeterminateselector #2505 - Dropdown - Fixed issue causing
multiple search dropdownusingsearchinside menu to break when multiple #2666 - Message - Fixed issues where icon would overlap in
icon messagewhen at mobile resolutions due toflex-collapsevalue being incorrect #2665
Additional Fixes
- Dropdown -
<select>dropdowns initialized withoutmultipleproperty set on<select>will now produce an error to alert users selection will not be preserved correctly. Related #2573 - Dropdown - Dropdown
<option>added withuserAdditionnow receive class nameadditionto distinguish from original<select>options. #2573 - Dropdown - User additions now have their
<option>removed if a user deselects an addition. #2573
- Build Tools - Fixed issue where sub tasks were undefined when importing SUI's
buildandwatchtasks into custom gulpfile #2648 - Button - Fixed
fluid buttonsnot working correctly with<button>due to button tags not supportingflexrules. #2617 - Button - Fixed colored vertical basic buttons appearing 2px offset #2655
- Checkbox - Checkbox now focuses after click, allowing for tab navigation from current position #2610
- Checkbox - Fixed checkbox not using javascript having incorrect colors on focus #2607
- Dropdown - Fixed
search selectionappearing incorrectly inside menu (default text would not disappear) #2624 - Form - Added
doesntContainanddoesntContainExactly#2638 - Form - Fixed issue with
minLength[1]validation not behaving same asminLength > 2#2636. - Form - Fixes errors when a field identifier is named
identifier#2629 - Form - Form fields will now error when a non-string identifier is used
- Formatting - Fixed several source files that had
CR LF(Windows) line endings #2649 - Input - Fixed
left action inputdisplaying with incorrectinputborder radius insideui form#2638 - Modal - Modal
actionnow uses a more specific selector to prevent modifyingcomment action - Popup -
fluidpopup withsetFluidWidth: true(default value), will now useparentwidth and notoffsetContextwidth #2526 - Popup - Fixed issues where rounding could cause elements that are against edge of page from not appearing. Add new
jittersetting for allowing popups to escape page boundaries by a small margin #2526 - Segment - Added additional variables for
invertedsegment. - *Segment -
horizontal segmentsin IE will no longer stretch to the natural width of child imgs #2550 flexbug [#1](h - Sidebar -
right,top, andbottomsidebar will not have their direction removed ondestroy#2644 - Sticky - Fixed
stickyelement that cannot fit in viewport not scrolling correctly when fixed to viewport #2605 - Transition - Fixed issue where animating same element in its own
onCompletewould fail because animation had not yet calledforce visible/hidden#2583 - Visibility -
refreshOnResizenow correctly includes a default value #2615 - Menu/Segment/Table - Consolidated
attachedlogic for all components using attached. #2599
Additional Bugs
- Checkbox - Fixed
spaceshortcut causing checkbox to trigger twice - Checkbox - Updated
coloredtheme to add new focus color variables. - Popup -
wideandvery widepopup will now limit themselves to normal popup widths on mobile so that they still appear on screen. - Message - Fixes
attached icon messagenot usingflex - Sticky - Fixed
stickycontent jumping fromfixedtobound bottomwhen scroll position has surpassed bottom of container during page refresh. - Sticky - Sticky no longer uses
bottomPaddingto determine bottom edge of container. - Steps - Updated
basicsteps theme to appear correctly
Docs
- Fixed theme previews appearing incorrectly in all UI in docs. Regex parsing
.variablefiles would ignore first variable after a comment. - Added individual examples of all form validation rules
- Partial rewrite of sidebar documentation
- Updated example in theme guide to include checkbox focus colors
Docs Updates
- Examples - Source code examples have been greatly improved. Required class names for each example will be highlighted in yellow. Other UI elements used in examples will now link out to their definition pages.
- Checkbox - Checkbox initialized with JS and with
for/idmatching would cause toggle to occur twice on click (making it seem as if nothing was updated) thanks @malacalypse #2572 - Divider/Grid -
vertical dividerno longer has inexplicable right border when stacked on mobile #2558 - Dropdown - Dropdown using
<select>andapiSettingswill now correctly add new<option>value when selections are made #2573 - Icon -
black iconhave been added back as a color option #2556 - Icon - Adds missing
squareandsquare outlineicon #2532 - Input - Fixed errored input field having incorrect border radius with
labeled input - Modal - Modal that is larger than page height will now correctly reset body height on remove #2576
- Popup - Popup
preservesetting (which preserves popup in DOM to avoid regenerating on each show/hide) was set totrueby default causing generated popups to remain in DOM. #1369 - Steps - Fixed
githubtheme for steps not displaying correctly in 2.0 #2545 - Steps - Last
stepno longer incorrectly shows arrow #2552 - Transition - Fixes
get current animationerroring whenmodule cacheis cleared. #2469
Additional Bugs
- Form - URL regexp will now match now works correctly, and matches against non
http://prefixed urls likewww.google.com
- Dropdown - Fixed regression in
2.0.1causing search dropdown not to clear values correctly #2533 - Site - Sizing variables now are relative to
@emSizeadjusting all sizing variations proportionately as@emSizechanges #2538 - Dropdown - Dropdown icon will now always toggle menu visibility #2510
- Dropdown - Pressing same key on dropdown with multiple choices with same first letter will now cycle selections. For example "California" then "Colorado" when pressing C #2516
- Dropdown - Dropdown now changes text before calling
onChangecallback so that callback reflects new dropdown conditions #2539
Additional Bugs
- Dropdown - Clicking on label, or deleting a label will no longer trigger dropdown menu toggling
- Dropdown - Multiselect that do use text labels (e.g. "5 selected") will now remove filters on selection and scroll to last selected value
- Label - Attached labels now use a border-radius for corner-edges that matches more closely #2500
- Label - Fixes incorrect label sizing for
largeand bigger sizes #2486 - Segment - Fixed incorrect margin set on
attached segment#2503 - Card -
centered cardsvariation now works similar tocentered card. #2520 - Checkbox - Fixed issue in chrome where radio checkbox would appear incorrectly when no default value was selected #2505
- Dropdown - Fixed transparent tap color not being set correctly. Removed toggle behavior from touch events on multiple dropdown. #2524
- Checkbox - Fixed issue where radio checkbox were not properly receiving
checkedclass #2506 - Tab - Tab now correctly obeys
cachesetting. Removed use of API's local caching by default. #2493 - Form -
resetwill no longer clear values if no default value is found #2504
Additional Bugs
- Dimmer - Dimmer now removes variations like
blurringandinvertedwhendestroyis called. - Dropdown -
restore defaultsin dropdown when used with multiple will now correctly clear other values selected that were not there on page load. - Dropdown - Removes accidental console.log statement in dropdown
- Dropdown - Dropdown no longer closes after max selections reached and enter key used for selection.
- Dropdown - Dropdown will now show correctly when menu only includes a message with no other items
- Menu - Fixed
pointing menuarrow color slightly off - Progress - Progress included
debug: trueby default. This has been now correctly set tofalse - Modal -
scrolling modalnow correctly inherits rules so that it appears at top of screen on mobile - Menu - Inverted menu no longer includes a 1px transparent border.
- Menu - Fixes
compact vertical menuusingflexstyle incorrectly - Menu - Fixes
border-topnot appearing onbottom fixedmenu - Tab - Fixed bug where remote loaded tab content would not show
loading tabon first load.
Docs
- Form - Clarified usage for
resetin form docs #2504 - Docs -
1.0docs are now available at http://1.semantic-ui.com Link in footer has been fixed. - Image - Fixed
mini imagehaving wrong pixel size in docs #2521 - Image - Added docs for missing
fluid imagevariation - Modal - Removed legacy JS animation settings still accidentally in docs
- Tab - Added new examples for
evaluateScriptsand HTML5 state tabs
Migration Guide
- Modal - If you are using a modal with image content, you will need to use
image contenton the parent element. This is becauseflexrules require parent styling that the previoustable-rowrules did not. - Modal - Modal will now only close on buttons matching
denyorapproveselector. Any button that should hide modal on click should either match one of these selectors, or call$('.ui.modal').modal('hide')onclick. - Grid -
page gridhas been deprecated.page gridsused percentage gutters which made it unnecessarily difficult to style responsive page content. Moving forward we recommend usingui containera fixed width responsive container for holding page contents. - Dropdown - Dropdowns will now change opening directions automatically based on available screen space. If you need to force a dropdown direction use
dropdown({ direction: 'upward'}) - Form Validation - Form validation now passes settings through a
fieldsobject. This is to make form initialization match other components. The previous syntax will continue to work but will produce deprecation notices in console - Checkbox - Checkbox
fireOnInitnow defaults to false. Checkboxes now also do not require javascript to function. - Dropdown - Dropdown item
descriptionnow are floated in default theme and should be included before otheritemcontent - Form -
grouped inline fieldno longer display horizontally. Useinline fieldinstead for horizontal inline field groups. - Input -
pointer-eventshave been removed fromiconinicon inputunless alink iconis used. This is to make sure the hitbox for focusing an input includes the icon. - Popup - Popups are no longer exclusive by default. Opening a popup will not necessarily close other visible popups. You can change this behavior by using the setting
exclusive: true. Additionally the default theme now uses1remsize for standard popups. - Colors - Default colors have been adjusted, which may cause slight changes in your design. New colors have also been added to fill in missing gaps in color naming.
- Segment - Segment no longer includes a clearfix by default. You will need to specify a
clearing segmentto clear floated content. - Rail - Rail now uses
border-boxinstead ofcontent-box. This means manually specified rail widths will now need to account for padding. This was added to fix issues where railheight: 100%would incorrectly match content when a rail had padding. - Menu -
tiered menuhas been removed in2.0. This may be rewritten in the future, but was not up to the standards of the rest of the library and has been removed. - Tab -
onTabInitandonTabLoadhave been renamed toonFirstLoadandonLoadrespectively. This is to conform to the naming conventions of other modules (no self reference). Previous callbacks will continue to work but will produce deprecation notices in console. Two new callbacksonVisibleandonRequesthave been added as well. - Button -
widevariations using numbers2 wide,3 widehave been removed due to incompatibilities with some build tools. Please usetwo wide, orthree wideinstead. - Video - The undocumented
videomodule has been renamed toembed. Behaviors remain the same, but users need to adjust their javascript init to$('.ui.embed').embed(); - API - API
onFailurewill now be called in all failure conditions, when a request is errored (504, 404 etc), aborted (page change or CORS), or JSON does not passsuccessTestfunction.onErrorandonAbortwill also fire for each specific failure condition.
New UI
- Container - Containers are fixed width containers meant for holding page contents, and are a simpler alternative to
ui page grid, view more examples in docs - Multiselect - New
multipledropdown types have been added. Many new dropdown improvements have been added including tagging/tokenizing features and loading data through API requests. - Embed - New embed component allows for responsive iframe embeds that maintain their aspect ratio. Embed can be used with YouTube or Vimeo videos, along with placeholder content to avoid loading third party libraries until a user chooses to interact with the video.
Major Enhancements (Please Read)
- Site - Added new colors
olive,violet,brownandgrey. These are available in all elements with color variations. Thanks @lemartialou - API - API can now be used with mocked responses, and custom AJAX requests.
mockResponsehas been added to resolve request with a prespecified JSON object, or a synchronous function callback. - API
mockResponseAsynchas been added for custom asynchronous requests. This allows you to specify a custom async callback to resolve an API request, helping with integration with libraries like Ember or Angular that may wrap AJAX requests. - API - API callbacks now have an
onResponsecallback that can adjust a servers response before it is parsed by other callbacks for success or failure conditions. Thanks @mnquintana - API - API now provides a local caching setting to avoid server roundtrips for identical urls by using
cache: 'local'. This is not enabled by default. Local caching is useful for results that should return the same values across a single session, for example when querying an autocomplete. - Card - Cards now support multiple custom
contentblocks. Content blocks and images can now appear in any order. - Checkbox - Checkbox no longer require javascript to function.
- Checkbox - Added support for
indeterminatecheckboxes, along with new stylings. - Checkbox - Now includes separate behaviors for triggering state changes without invoking callbacks
set checkedvschecked - Dropdown - Added remote API integration with dropdown, to allow
search selectionto query against a remote dataset. - Dimmer - Dimmers now have a
blurringvariation which apply a glass-like effect when dimmed - Dropdown - Dropdowns now automatically observe changes in
menuand will update selector cache with new additions - Dropdowns - Added ability to add custom choices to all search selection dropdowns (multi/single) using
allowAdditions: truesetting. Search now displays error messages on no results in all cases. - Dropdown - Keyboard shortcuts have been added for selecting dropdown choices, for example "N" will scroll to "New York" in a state selection list, similar to native
<select>behavior. - Dropdown - Added new dropdown variation
scrolling dropdownandscrolling menu, this can be used to include a scrollable section inside a dropdown menu. - Dropdown - Dropdown will automatically animate upward if there is not enough space to appear below.
- Dropdown - Using
page upandpage downkeys will now scroll menus by a page at a time - Form - Forms now use
flexboxfor creating field groups. Inline fields now support(x) widesizing usingflex - Grid - Grids now use
flexbox, columns are now all equal height by default. New flexbox alignment types likestretchhave been added for easier vertical alignment. - Multiple UI - Many components now use flexbox, which means previous confusing fixes like
font-size: 0;to remove white-space from inline block is no longer necessary. Removing this hack, now means any element can be a direct child ofgridormenu. - Modal - Added new settings
blurringandinvertedwhich automatically set a modal's dimmer to either inverted or blurring. - Menu - Menu now uses flexbox. This allows menu items to match each others heights regardless of each items content size.
right menucontent should now follow other menu content instead of preceding it (no longer uses float). - Grid - Grids are now
flexboxandequal heightby default, theequal heightvariation can safely be removed - Popup - Popup has been rewritten to drastically improve performance, especially when testing multiple positions.
- Transition - Fallback javascript animations have been removed from UI components like dropdown and popup to increase performance. This removes need for expensive pseudo selectors like
:visible,:animatedand:hiddenand reduces filesize. - Form Validation - Form validation now uses a single
settingsobject like other modules. Using(fields, settings)will continue to work but will produce a deprecation notifications inconsole - Form Validation - Form validation now supports many new validation rules, including some specifically for use with multiple select values.
- Item - Items now uses
flexboxfor layout. - Message -
icon messagenow usesflexboxfor layout - Menu -
vertical tabular menu, a vertical tab menu, has been added - Input - All
inputtypes useflexboxfor layout - Segment - Segments now support complex nesting, many new rules for how segment groups should appear inside groups
- Segment - New
horizontal segmentgroups make laying out auto resizing text columns much easier. - Sidebar - iOS will now correctly report
scrollTopvalues fordocumentorbodywhen using a sidebar. Chrome on iOS no longer has issues with fixed content not sticking immediately when using a sidebar. - Shapes - Shapes now correctly adjusts for margin on
sides - Steps - Steps now use
flexbox, fluid steps now center content inside each step - Steps - Steps no longer need
item countand will automatically divide evenly - Transition - Transition code has been optimized to increase performance. 100% improvement on first animation, and 40% improvement on subsequent animations.
- Visibility - Using
.visibility({ type: 'fixed'})will now automatically add a placeholder element which will swap places with an element when it is attached to the viewport. This should make fixed content drastically simpler. - Visibility - Visibility and sticky now use a more performant pub/sub pattern that will only attach a single event to context
scroll. - Visibility - Added two new visibility callbacks
onOnScreenandonOffScreen, which occur, most obviously when an element first appears in or out of a browser's viewport.
Enhancements
- Site - Added many new site variables, including the ability to control input size across all UI
inputPadding, along with more border colors, accents, and colors. - Accordion - adds
onOpeningandonClosingcallback (before animation) to go withonOpen,onClose(after animation) Thanks @cluppric - Accordion - Added
onsetting for specifying accordion trigger event. - Activity Feed - Activity feed has been rewritten to use
flexbox - API - API now has new settings
throttleFirstRequestandinterruptRequests. Interrupt requests will abort a previous request on an element when making a new request.throttleFirstRequest, sets whether the first request or only subsequent requests should be throttled when athrottleduration is specified. - Build Tools - Build tools will now display pre-specified errors when a theme file is missing or an element specifies an unavailable theme.
- Build Tools - Adjusting
site.variableswill now rebuild all UI, instead of justsite.less - Button - Added
:focusstyles for all button types, all button examples in docs now are keyboard focusable using either<button>ortabindexwhere appropriate. - Card - Card now includes a
centeredvariation - Checkbox - Checkbox will now gracefully correct behaviors invoked on the child input element instead of the
ui checkbox. - Checkbox - Reduced kb size of icon font
- Divider -
vertical dividerinsideui gridnow accounts for column padding - Dropdown - Nested
scrollingmenus now support keyboard selection, e.g. pressing "A" for apple, and keyboard scrolling. - Dropdown - Dropdowns now have
matchsetting to specify whether to match ontext,valueorboth - Dropdown - Multi select dropdowns now have new settings for specifying maximum selection count
- Dropdown - Dropdown has new
placeholdersetting for setting placeholder text in javascript - Dropdown - Added
showOnFocusoption that lets you specify whether dropdown menu should show on focus - Dropdown -
fullTextSearch: truenow uses fuzzy search (same asui search) - Dropdown - Page down and page up now works with dropdown menus
- Dropdown - Dropdown initialized with
disabledprop on anoptionwill now correctly appear disabled - Dropdown - Added
disabled itemstate, disabled items will automatically be skipped with keyboard selection - Form - Added a host of new styles for form fields autocompleted by your browser, including autocompleted error, and focus states
- Form - Added placeholder color rules for IE,
ms-input-placeholder - Form - Fix
errored fielddropdown keyboard selection color - Form - Adds form
successstate - Form Validation - Added
is validbehavior, returnstrue/falseif form is valid - Form Validation - Added
different[field]rule which requires a field to be different than another field - Form Validation -
data-validatenow takes precedence over other validation matching schemes likenameorid - Form Validation - New rules for matching against custom regular expressions
- Form Validation - Form validation now has
minCount,maxCount, andexactCountfor validating multiple selections - Grid -
celled gridnow removes internal cells on mobile and tablet when used withdoublinggrid responsive variation. - Grid - Added
large screen onlyandwidescreen onlyresponsive variations for grid. - Grid -
equal widthgrids now works withoutrowwrappers - Grid - rows can now be
stretchedas well asmiddle aligned,bottom alignedandtop aligned! - Grid - Fixed margins on
internally celledgrid - Grid -
celledandinternally celledgrid now use flexbox instead ofdisplay: table; - Headers - Added new header type
sub header, useful for displaying small headers alongside text content. See examples in the header docs - Image - Images now include a
spacedvariation for adding whitespace around images when used inline with text. - Input - Added placeholder color rules for IE,
ms-input-placeholder - Input - Action input now supports multiple buttons, and dropdown
- Label - Labels now have
activeandactive hoverstates - Label - Label now sets an
imgheight even when not using animage label - List - Any content inside a
ui listcan now be vertically aligned - Menu - Add examples/documentation for
fixed menu - Menu - Added
stackablemenu variation for simple responsive menus - Menu - Added many new variables to menu
- Menu - Fixed several inheritance issues for
dropdown iteminsidemenuappearing asmenu item. - Menu - Horizontal menus now set a default image size for images / logos
- Menu - Menus items are now slightly more padded
- Menu - The hover/active state of
dropdown itemhave been adjusted to matchitem. Dropdown styles can be themed specifically insidemenu. - Menu - Vertical dropdown menus are no longer 100%
min-width - Modal - Modal now uses an adjusted
scale intransition in the default theme, that should be more subtle and work better with long modal content. - Modal - Modal
onApproveandonDenynow receive the activating element as the first parameter. Added documentation about usingreturn falseto avoid hiding element on click. - Modal - Modal content now uses flex, image content now requires
image contentclass on parent to allow for flex stylings. - Popup - Popup now defines a
transform-originso animations will be affected by the direction the element is placed - Popup -
onShowandonHidecallback can now cancel popup from showing or hiding by returning false - Popup - Added more size variations for popup
mini,tiny - Progress -
indicatinglabels now are more legible use separate css variables fromindicatingbar color - Reveal - Added new
activestate that allows you to showrevealprogrammatically - Search - Cache can now be cleared using
$('.search').search('clear cache') - Segment - Added
paddedandvery paddedsegment variations - Search - Search now operates off a unique id generated by result position to retrieve results. For example category #1's first result is 'A1' . Previously result titles were used as their "id", which could cause issues with duplicate titles, or results that do not contain a title.
- Search - Search will now automatically add class
categorywhen usingtype: category. - Search - Search will now generate
resultscontainer if one is not present on init - Search - Search now uses
emfor resizes, making sure it will resize with the surrounding content - Search - Search
promptnow has focus styles defined if not usingui input - Segment - Added
clearingsegment for cases that need a clearfix. - Sidebar - Improved animation performance through performance debugging. Sidebar now caches, width, height, rtl direction on load.
- Site - Fixed mixed globals
@defaultDurationand@transitionDurationusage to use a single variable across all UI@defaultDuration, the same for@defaultEasingand@transitionEasing - Site - Added in
pageOverflowXvariable, default theme hides horizontal scrollbars onbody - Site - Added default
focuscolors for all color variations - Site - All floating/raised variations now inherit from a global
@floatedShadowmaking theming easier - Sticky - Sticky now internally caches current scroll position when
cantFit = trueto avoid getting DOM property on scroll. - Statistic - Added new evenly divided group variation, for example
three statisticsshows 3 per row - Statistic - Statistic group now use
flex. Styles have been updated. - Steps - Added
attachedsteps, which can now be attached to other UI likesegment - Tabs - Tab will now manually correct page scroll position when linking to an in-page anchor in a hidden tab
- Tabs - Added new callbacks
onTabVisibleandonRequest - Tabs - Added
parseScriptsoption, defaults toonceparsing inline scripts only first load - Table - Adds
selectable tablevariation, which shows hover effect on row when hovering - Table - Added
vertical alignmentvariations toui table - Table - Added
single linetable variation which prevents text from wrapping - Transition - Adjusting
styleorclassduring a transition, will no longer reset the change after transition completes. - Transition - Transition will no longer force visible/hidden with inline styles if
onCompletecallback sets visibility. - Visibility/Sticky - Visibility and sticky now refresh automatically after page content loading to deal with changes in position from images loading
- Visibility/Sticky - Visibility now uses pub/sub pattern to greatly improve scroll performance when attaching multiple events
- Visibility - Visibility includes a new setting
checkOnRefreshwhich determines whether visibility callbacks should occur on resize or refresh - Visibility - Visibility
imagewill now wait to lazy load images that are above the current screen position, not just below.
Bugs
- All Modules - Performance logging now delays 500ms instead of 100ms for console logging to ensure all logs are captured in one group
- All Modules/Transition - Transitions no longer use
rotateZ(0deg)to trigger GPU display of visible state. This causes issues withtransformcreating new stacking context that can disruptz-index. - Accordion - Fixed bug where
exclusive: truecould sometimes cause other accordion element animations to get stuck when animating rapidly - API - API longer uses
readyState = 0as sole check for request abort, this may accidentally trigger withJSONPorCORSrequests. - API - Fixed
thiscontext ofbeforeSendto usestateContextnotelement - API - Fixed
loadingDurationnot correctly delaying requests when invoking with.api('query') - Build Tools - Fixes issue with out of date minify dependency causing rules with
background: inherit;to be removed. - Button - Fixed
attached buttons1px offset when attached to segment and menu (border vs box shadow border) - Card - IE11 now can correctly use
flexboxcards Thanks @Widcket - Checkbox - Fix
disabled checkboxsometimes displaying hand cursor - Checkbox - Fixes nested
dropdowninsidecheckboxcausing issues - Checkbox - Fix
:focusstyles only applying if checkbox is unchecked - Divider - Hidden divider now correctly hides vertical dividers
- Divider - Fixes single icon alignment inside
vertical dividerorhorizontal divider - Divider - Fixed slight offset in
vertical dividerwhen it automatically adjusts tohorizontal dividerinside astackable grid - Dropdown -
focusafter changing tabs will no longer cause menu to re-open Thanks @trevorharwell - Dropdown - Fix issue with search dropdown refocusing on self the first time after "tabbing" away in Chrome
- Dropdown - Fixes issue with headers disappearing inside of
ui dropdownwhen nested inui menu - Dropdown - Fixes
onChangeto fire when input value changes, not just when menu UI changes - Dropdown - Dropdowns with
transition: nonenow work correctly. - Dropdown - Fixed issue where
sortSelectwas relying on object key enumeration order which is browser dependent and unreliable. It now uses a sort function which functions the same in all browsers - Dropdown - Fixed issue with
search selectionnot changing text when reselecting same value from list - Dropdown - Fixed
min-widthissues causing background to not appear behind unwrapped text withwhite-space: nowrap - Dropdown - Dropdown
menunow use same font size as dropdown - Dropdown - Fixed dropdown
metadataattribute caching causing issues with React integration - Dropdown - Fixed border radius on
sub menuwhen alignedleft - Dropdown - Fixed
inline dropdownicon not aligning with content - Dropdown - Fixed behaviors called on
<select>after initialization not being correctly applied toui dropdown - Dropdown - Fixed issue with matching boolean values, and using
set selectedwithtrueorfalse - Dropdown - Fixed
search dropdownsubmitting parent form when enter shortcut pressed - Dropdown - Fixed dropdown menu items should not center inside of a center aligned container.
- Dropdown - Fixed some cases where onChange would not occur for values matching equality against '', for example
0 - Form - Form will no longer set a height for
textareausing therowsproperty - Form -
inline fieldsare now1emand do not match label's reduced size - Form -
fieldinsidefieldsno longer produce double sized margins. - Form - Form sizes and input sizes now inherit from
site.variables - Form Validation - Fixed bug causing
matchrule not to work as expected. - Form Validation - Fixed
clearandresetcausing validation error to appear on checkbox if empty rule was set on checkbox. - Form Validation - Form validation now validates correctly on
<select>change - Form - Fixed autocompleted
ui selection dropdownhaving dropdown icon z-index issues - Form/Input -
ui labeled inputinsideformwill no longer escape column width.ui fluid inputwill now use input widths shorter than browser default. - Grid - Fixed responsive styling for grid types, more consistent display for
divided,celled,on mobile - Grid - Fix
doubling rownot working correctly inside a differentdoubling grid(css spec issue) - Grid - Fix
doubling gridincorrectly applying width to(x) column row - Grid - First column on
stackable gridno longer receives top margin - Grid -
x column wideinsideequal width/heightnow cannot grow beyond column size - Grid - Fixes colored grid columns not appearing when not nested in rows
- Icon - Fixes
ascendinganddescendingicon being swapped - Icon - Fixes phone icon only appearing as alias
call - Image -
rounded imageandcircular imagenow apply border radius to all child elements, fixing dimmers, and other content rounding - Input - Fixed improper left padding on
transparent left icon inputThanks @zxfwinder - Input - Fixed
placeholdercolor not changing correctly on focus Thanks @zxfwinder - Input - Fixed right padding on
labeled inputthat were notcorner labeled - Label - Labels inside
headernow vertical align better by accounting for line height offset - List -
horizontal listare now alignedmiddleby default, while vertical lists are alignedtop. - List - Fixes numbers not appearing when using
inverted ordered listThanks @pcj - List -
aelements inside aui listwill no longer apply styles onuielements likebuttonThanks @ahtinurme - List - Fixed
divided bulleted listchild lists getting wrong indent - List - Bullets and numbers are no longer selectable in
bulleted listandordered list - List - Fixed
inverted bulleted listbullet color - List - Fix first element touches border on
ui horizontal celled list - List - Added many new variables for link stylings inside list, added separate variables and defaults for child-list spacing
- Loader - Fix position of
inline centered loaderto be centered correctly - Message - Message now uses
@lineHeightfromsite.variables - Menu - Fixed menus like
left fixedright fixedare all now class order dependent. - Menu - Fixed 1px border on last element of inline menus like
pagination menuorcompact menu - Modal - Modal no longer hides page scroll bar causing dimmed page content to jump positions.
- Modal - Fixed bug where clicking an element detached from dom would cause modal to hide prematurely
- Modal - Clicking on other modals will no longer close open modal when
allowMultiple: true - Modal - Fixed
scrollingclass not being removed after opening a normal modal after ascrollingmodal. - Message - Updated all message colors for legibility
- Message - Close icon position adjusted to align with headers
- Menu - Fixes divider appears on last element of
(x) item menu - Menu - Fixed
top attached menunot having margin-top, andbottom attached menunot havingmargin-bottom - Menu - Menu now has a
min-heightthat matches standard item padding - Menu -
dropdown menuin asecondary pointing menuortabular menunow receive distinct active styling from otheractive item - Menu - Fixed arrow position in
pointing menuto be more consistent, round to exact pixels and account for arrow border width - Menu - Fix issue with
pointingarrow having too high az-indexand appearing aboveui dropdown menu - Modal -
scrollable modalnow correctly adds padding below modal - Modal - Modal with
detachable: falseinsideui sidebarpusherelement will now show correctly - Popup - Popup now correctly adjusts if
dataattributes change - Popup - Fixes issue with
min-widthin firefox exceedingmax-widthcausing element to not wrap correctly - Popup - Popup will now produce an error message and not mistakenly appear in the top left corner of page, if called with a
popuportargetthat does not exist. - Popup - Popup will no longer appear incorrectly if the targeted element is not visible on page
- Popup - Fixed bug which could cause pre-existing inline popup to be removed from DOM after hiding
- Popup - Fixes popup offstage position calculations with pages including horizontal scrollbars
- Popup - Added
addTouchEventsto specify whether touch events should be added to trigger popup on mobile - Progress - Fixed bug where percentage complete values between 0-1% would display incorrectly (0.5% would show as 50%)
- Rail - Rail 100% height now uses
border-boxto ensure exact height match to container - Rating - Rating now correctly adjusts if
dataattributes change - Reveal - Removed
maskedreveal, all reveals are masked by default - RTL - Fixed
rtl: 'both'insemantic.jsonnot building both versions of source correctly. - Search - Search will no longer incorrectly produce an error when API settings are passed through metadata
- Sidebar - Top/Bottom sidebar will now show scroll bars correctly when taller than 100% page height
- Sidebar - Fixed bug where having a
style[title]in page causing page not to be pushed correctly - Sidebar - Last menu item now has a border when sidebar and menu are used together
- Segment - Segment groups can now be
raisedorpiledorstacked - Search - Fixed
category searchnot applying active styles correctly to category names - Search - Fixed
onSelectnot returning the correct value when usingtype: category - Search - Fixed
onSelectreturning the first term that matches the beginning of the selected value not the exact value. - Search - Fix
loading searchwith anicon buttoncausing double loaders. - Search -
searchFieldssetting now correctly replaces default fields instead of adding the user fields to defaults - Search - Calls to
set valueorquerynow obeyminCharacterLength - Search - Search API calls now use the same level debug settings as search
- Steps - Fixes bug where
ordered stepshad smaller numbers inIE10 - Steps - Fixed bug where
stackable stepswere not working correctly - Sticky - Fix issue with sticky content scroll css transition causing element to scroll too slowly when cannot fit on screen.
- Sticky - Fix issues when
pushing: truewith sticky content having incorrect bottom spacing, when container has bottom padding - Sticky - Fixed issue with sticky content animating width on display in some cases.
- Tab - multiple tab groups initialized together with
context: 'parent'will now each use their own parent - Tab - Tabs now use the standard component design pattern internally
- Table - Fixes
sortedcolumn are not correctly centered withcenter aligneddue to margin on sort icon - Table - Fixes
ascendinganddescendingicons were reversed in table - Table -
very basic tablenow works together withpadded table - Table - Fix inheritance of text alignment and vertical alignment
- Transition - Fixed bug where transition out would cause unwanted focus event in IE if element has focus
- Transition - Calling an
outanimation during aninanimation withqueue: falsenow correctly calls thecompleteevent of the original animation - Transition - Fixed bug where transition could sometimes not occur when an element was determined to always be hidden
Changes
- All Modules - All modules now default to
verbose: false - Accordion - Accordion no longer sets a
font-sizeto better couple with other components defaults - Button - Button focus color now uses hoverColor background instead of blue box shadow
- Button -
basic colored buttonnow grow their border size to 2px in default theme on hover - Breadcrumb - Fixed breadcrumb
emrounding, adjusted distance in default theme - Card - Card styles have been adjusted,
link cardnow raise to show selection. Colored variations now have shadows. - Checkbox - Toggle now uses
@primaryColor - Dropdown - Dropdown padding values now resolve to exact pixel values from em
- Dropdown -
itemdescriptionis now floated by default - Feed - Removed
extra textpointer border - Form -
set valueno longer automatically callsvalidate form - Grid - Small computer
page gridgutters have been adjusted from 8% to 3% to allow for roomier layouts on small screens. - Grid - Vertically divided grids now double row spacing to account for dividers
- Grid -
center alignedno longer centers rows, just text. Usecentered gridto center a grid column on the page. - Header/Table/Divider - These components now pull border color defaults from
site.variablesinstead of using their own values - Image -
avatar imagesize has been slightly decreased - Image -
mini imagedefault width has been increased to35px - Item - item
descriptionnow longer sets amax-width - Icon -
disabled iconnow havepointer-eventsagain. - Label - Label size now varies by type.
pointing labelare now1emby default. - Label - Padding on
corner labelhas been increased - Input - Input now use
eminstead ofremso they will inherit the size of the elements they are nested inside - Progress - Update contrast on
indicating, update default styles. Fixed some examples - Menu - Menu now uses
borderfor borders instead ofbox-shadow - Menu -
secondary pointing menuhas had some slight design tweaks, thinner lines, more padding - Menu - Active sub-menu items are now
bold - Menu - Menus no longer have additional borders on
active itemin the default theme - Menu -
tiered menuhas been removed - Menu - Increased contrast on
invertedmenu selection for legibility - Modal - Modals now used fixed widths and not percentage widths. Widths might be slightly different.
- Modal - Modal no longer observes DOM changes by default, added setting to enable
- Message - Slightly increases
box-shadow - Popup - Popups now default to
exclusive: falseand will not hide other popups when opening - Popup - Popup no longer produces a console error when a position cannot be found on the page.
- Rating - Rating styles have been adjusted to use subtle transitions and tweaked color values.
- Segment - Clearfix has been removed from
ui segment - Sidebar - Sidebar
legacyanimations have been removed. 3D transforms are now available in all supported browsers. - Search - Slightly adjusted search result theme for clarity
- Segment - Segment now uses
borderfor border instead of a secondbox-shadow, this may adjust position by 1pixel - Statistic - Statistic label styles have been updated
- Site - Additional font variables have been added to site to help clarify variable purpose.
- Site - Increase contrast on default hovered/down colors for colored variations
- Site - Page background is now
#FFFFFFby default instead of an offwhite#F7F7F7 - Site - Adjusted global line height to the closest even pixel value
- Table - Table header colors and padding defaults have been slightly adjusted
- Table - Horizontal cell padding has been slightly reduced, and cell borders are slightly lighter.
- Transition - Transition no longer checks for vendor prefixed
animation-namecss property. This was introduced in jQuery1.8 - Transition - Some transition have been modified so that the
inanimation is more telegraphed than theoutanimation, which may now recede more gently. - Visibility - In returned
calculationsobject,visibleandhiddenare renamed toonScreenandoffScreen, since this describes more accurately what the value represents.
Announcement Version 2.0 will be launching on June 1st, which will include 100+ bug fixes, enhancements, new ui, and default theme improvements.
Bugs
- Grid - Fixes bug causing colored variations not to work on columns without row wrappers. Backport from
2.x
Bugs
- Dropdown - Fixed
leftandrightarrow does not move input cursor withvisible selection dropdown. Event accidentally prevented bysub menushortcut keys.
Bugs
- Dropdown - Fixes issue with chained dropdown methods used on a
<select>not applying to the generatedui dropdownBackport from 2.0 - Input - Fixes labeled inputs not adjusting correctly with flex. Backported from 2.0
- Input - Fixes placeholder text color prefixes for
webkitBackport from 2.0 - *Progress - Fixes rounding error in precision settings Thanks @aaroncox
- Popup - Removes
min-width: moz-max-contentfrom popups, which may cause display differences between chrome and FF
Enhancements
- Visibility - Adds updated visibility module from
2.xchannel. Visibility will automatically refresh by default after images load on page refresh. Fixes issues with element positions after image loading. - Sticky - Adds sticky module from
2.xbranch. Sticky elements now use pub/sub with drastically improved performance. Sticky elements that do not fit on page will now scroll at the same speed as the page is scrolled instead of slower.
Changes
- Popup - Popup no longer produces a console error when it cannot find an adequate position in the browser viewport.
Bugs
- Build Tools - Fixes issue with component glob matching twice (causing build to include file twice) if duplicate values found in
semantic.jsoncomponent. - Input - Backports fix from
2.xforui fluid inputnot appearing correctly. - Visibility - Fixed issue where
precachebehavior was missing from visibility causingimagelazy loading to fail
Bugs
- Build Tools - Fixed
npm installwithoutsemantic.jsonto merge changes with site theme and packaged themes in a similar fashion tonpm update - Build -
gulp buildnow properly warns against missingsemantic.jsonThanks @rudyrk
Bugs
- Sticky - Fixes errant
console.logstatement appearing in source - Card - Fixes card
flexdisplay issues in IE - Build Tools - Fixes issue where
npm updateinstall scripts would remove custom themes fromsrc/themes/during copy after updating Semantic UI
More critical bug backports from 2.x branch, as well as fixes for browserify
Bugs
- Menu/Dropdown - Fix dropdown headers disappearing inside menus
- Dropdown - Fix unescaped character in css property causing css validation errors
- Form - Fix
grouped requiredfields display issues Thanks @palmsey - All UI - Fix
index.jsnpm build to work with browserify in individual component repos Thanks @sdimit - LESS Repo - Add missing
semantic.lessfile to less repo for importing components
This version backports several bugs that were being packed in 2.0 to 1.x.
2.0 will be coming in the next 1-2 weeks.
Bugs
- Build Tools - Adjusting site.variables will now rebuild all UI, instead of just site.less
- Build Tools - LESS will now throw errors correctly in
watch - Card - Fixes dimmer background shorthand property causes transparent dimmer in minified version
- Dimmer - Fixed
variationsetting not working correctly - Dropdown -
onChangeno longer fires when reselecting same value - Dropdown - Fix bug where element will not blur on tab key when search selection and no selection made
- Dropdown - Dropdown init on
selectnow returnsui dropdowncreated for chaining - Dropdown - Dropdown
focuscolor has been adjusted to match forms more closely - Dropdown - Fixes IE10 scrollbar width in menu (calc was being precompiled in LESS) Thanks @gabormeszoly
Enhancements
- Grid - Added opt-in
stretchedvariation forequal heightinstead of forcingflexon allequal height columnswhich may cause layout issues due to changes in rendering withflexbox.
Fixes
- Build Tools - Fix issues with minified CSS
@importnot being on top of minified semantic ui concatenated release due to bug in clean-css - Grid - Fixes
stackableequal height/widthgrid to removeflexon mobile when stacking - Grid - Fixed
right/left/center alignedto adjustalign-itemsin flex containers likeequal height/width
Enhancements
- Accordion - Accordion can now specify a trigger element instead of
title, added an example in docs - Accordion - Accordion can now hide while opening animation is still occurring
- Grid - Equal width grids will now make column content stretch to full height, not just the column itself (requires flexbox). See examples in the grid docs
- Header - Labels inside headers have been slightly increased in size
- Search - Search now uses internally fuzzy search as its new full text search algorithm.
Important Fixes
- Build Tools - Fix issues with minified component CSS
@importnot always being on top of files due to bug in clean-css
Bugs
- Accordion - Removed mistaken extra
1pxtop border on nestedstyled accordion - Modal - Fixes modal
buttonson mobile devices to not have extra bottom padding. - Card/Dimmer - Fix dimmer z-index being too high when inside a
ui card. Added variable for specifying default dimmer color inside card. - Site -
h1-h5now have no top margin whenfirst-childand no bottom margin whenlast-child - Dropdown - Fix issue in
setup reference(added in1.11.1) where chaining would not returnui dropdownimmediately after initialization
Enhancements
- Dropdown - Calling behaviors on a dropdown
selectwill now automatically route them to the appropriate parentui dropdown
Bugs
- Grid - Fix issue in
centered gridnot centeringcolumninsiderow - Dropdown - Added select styles for elements before they are initialized instead of FOIC (Flash of invisible content)
New Components
- Visibility - Attach callbacks to elements visibility conditions like
top visiblebottom visible,passing. Useful for things like: image lazy loading, infinite scroll content, and recording tracking metrics.
See the examples online for a demonstration.
Enhancements
- Menu - Horizontal menus now use flexbox so they can resize automatically to content size.
- Form -
<select>now receive error formatting onform errorThanks @davialexandre - Transition - Added more reasonable default durations for each animation
- Loader -
inline loadernow has acenteredvariation - Modal - Modal no longer hides and reshows dimmer when opening a modal with another modal open with
exclusive: true - Popup - Added
exclusiveparameter to automatically close other popups on open - Transition - Added
togglebehavior and docs forshowandhide - Transition - transition now has
stop,stop all, andclear queuefor removing transitions, (undocumented methodstop, andstartrenamed toenableanddisable) - Dimmer - Add
opacitysetting to override css value. Add to docs several undocumented settings, likeuseCSS, andvariation. - Icon - added
@srcvariable to make it adjustable with themes that dont support all types likewoff2
Deprecations
- Menu -
ui tiered menuhas been deprecated. It has been removed from the docs, and will be removed eventually in2.0
Bugs
- Input - Fix bug with vertical centering of
ui action inputinsidemenudue toflexboxchanges - Dropdown - Fixes issue where dropdown would not open after restoring previous value on failed
search dropdownsearch - Dropdown - Fixes issue where dropdown would not open after restoring previous value on failed
search dropdownsearch - Grid - Fixes specificity of grid
columncolors to not affect other elements with columns - Icon - Fix
clockwise rotated iconcausingclockwiseicon to appear - Popup - Fix issue with
popupnot re-opening until another element gains focus on a mobile touchscreen - Modal - Fixed issue with modal not appearing when calling
showduring another modalhide - Popup - Popup will now fire
onHiddenwhen an element is hidden by opening a different popup - Popup - Fix popup not namespacing
windowevents and unbinding ondestroyThanks @revov - Table - Fixes table on
mobilesizes can surpass parent container width - Transition - Fixes
swing outanimations not working correctly - Transition - Fixed display state other than
blocknot determined when usingshowandhidewithout an animation - Transition - Fix bug in
remove loopingcausing next animation to use same duration - Segment - Fix first/last margins on
ui segments - Search - Fix special characters not searching correctly with local search
- Search - Fix a bug with
onSelectreturningnullwhenminCharacters: 0 - Search - Fix a bug with
onSelect returningnull` when results retrieved from cached API query - Sticky - Fixed sticky position when page loads and content is below sticky content.
- Sticky - Fix bottom attached position not adjusting for bottom padding on container element
- Menu - Fix vertical pointing menu, sub menu arrow color
- **Item ** -
imginside ofui item contentnow do not receive size formatting by default - Form - Added
input[type="search"]styles toui form
Docs
- Transition - Adds examples of
hide,show,toggle,stop,stop all, andclear queue` - Item - Significant rewrite of
ui itemdocumentation
- API - Remove console error message when no API url is specified but element is a
form(defaults toformaction) - API -
apicheck for serialize object optional dependency no longer produces error whenserializeForm: trueand dependency is not found.
Bugs
- Build Tools - All UI components now have component name in comment banners and release version
- Menu - Fixes dropdown menu item not having a hover state inside inverted menu
- Search - Fixes bug in category search causing item selection to sometimes produce a javascript error.
- Button - Fixes
<button>insidevertical buttonsnot taking full container width
No changes, fixes stale pm component builds
New Features
- Transition - Transitions now have
intervalto allow grouped elements to animate one by one with a delay between each animation. Grouped animations determine order based on transition direction to avoid reflows, or can manually be reversed by usingreverse: trueSee Examples for more details.
Critical Fixes
- Transition - Webkit
failSafeused for Chromium Bug #437860 now also works for queued animations
Enhancements
- Form Validation - Adds
containsExactly,notExactly,isExactlycase sensitive validation rules, makecontains,not,iscase insensitive. - Form Validation -
containsrule is now case insensitive - Form Validation - Validation messages no longer increase field height on
inline fieldslike checkboxes after error appears - API - Added
was cancelledto determine whether request was cancelled bybeforeSend - *Image - Added
hidden imagestate
Fixes
- Build Tools - Fixed issue with recursive merge for site themes in update scripts, details here Thanks @derekslife
- Cards - Fix
.ui.cards > .ui.cardmargins to match.ui.cards > .cardmargins - Cards - Fix consecutive card groups to preserve row flow (similar to consecutive grids)
- Sidebar - Sidebar using
exclusive: truenow queue animations after hiding previous sidebar (unlessoverlay) to avoid rendering issues - State - Text states now handle
cancelledAPI requests correctly - Search - Category search no longer displays unnecessary error message about maxResults
- Composer - Composer.json should now read version from tags, adjusted some fields.
- Grid - Stackable grid now has horizontal padding by default on mobile unless nested inside a
ui gridorui segment(not vertical) - Menu - Fixes pointing menu displaying under dropdown menu
-Docs
-Transition - useFailSafe was incorrectly shown as false by default
Bugs
- RTL - Fixes
rtltasks not running correctly ongulp builddue to name typo,build rtlinstead ofbuild-rtl - Tab - Fixed bug when loading
remotecontent withtabwhere current tab would not hide while another tab is loading - Tab - Tab with remote content and
auto: truenow removes duplicate slashes from url path - API - Simplified
apidebug output to console to more clearly label url and data sent
Docs
- Tab - Added new tab remote content example with stubbed AJAX using SinonJS
Added new repositories for css and less only versions, can be installed with
npm install semantic-ui-less
npm install semantic-ui-cssBug Fixes
- Modal - Fixes typo causing
middle alignedimage not to work correctly. - Build -
gulp watchnow compiles concatenated css (missing in1.9.1only)
LESS Changes
Importing individual components into other less files now requires scoping. This is to prevent issues with variable scope that cannot be resolved inside definitions.
/* Import a specific component */
& { @import 'src/definitions/elements/button'; }Importing semantic.less still does not require any special syntax
@import 'src/semantic';
Bugs
- Fixed issue directly importing
semantic.lesscaused by variable scoping in.loadOverrides(). - Fix bug where
equal heightrow could not becentered, or less than full width
npm install semantic-uiis now the recommended path for getting Semantic UI- Added
npmpost-installscripts which automatically install or update semantic
- Semantic tasks are now each defined in their own file, and can be directly imported into external gulpfiles. Read more about importing tasks here
- If you are using Grunt, you may be able to import these tasks using Grunt-gulp
- Semantic LESS files can now be directly included in other LESS files.
- You can import all UI with
@import 'src/semantic'; - You can also import individual definitions using
@import 'src/definitions/elements/button'.
Major Enhancements
- Card - Cards now equalize height by default using
display: flex. No longer are card heights required to be specified manually to align - Flag - Reduced the file size of flag sprite to a measly 28kb (500%+ file size reduction)
- Icon - Added Font Awesome 4.3 including many new icons
- Input - Input with dropdowns is now much easier, see docs.
action inputandlabeled inputnow usedisplay: flex.ui action inputnow supports<button>tag usage (!) which supportflexbut nottable-cell - Segment - Added plural variation
ui segmentsthat stack together in groups without using additional class names
Enhancement
- API - API now has an
onRequestcallback setting that receives the XHR promise after initializing the request - Button - Loading buttons no longer receive
pointer-eventsin default theme. Added variable forloading buttonopacity. - Card - Card now has colored variations Thanks @romuloctba
- Dropdown -
search selection dropdownwill now close the menu when adropdown iconis clicked - Dropdown - Added new dropdown setting,
forceSelectionwhich forcessearch selectionto a selected value on blur. Defaults totrue. - Flag - Updated Burma/Myanmar flag to current flag (was pre-2010 flag)
- Form - Input rules now apply to
input[type="time"] - Form Validation -
get values,set valuesnow support multiple select e.g.field[] - Form Validation - Dropdown and checkbox will now validate after interaction with
on: 'blur' - Headers - Headers can now contain images alongside text, added examples to docs
- Icon - Added woff2 icon files for supported browsers (20% file-size decrease) Thanks FontAwesome
- Label -
ribbon labelcan now be used insideui imageandui cardcorrectly - Sidebar - Sidebars in IE now work correctly with
contextspecified - Rating - Vertical alignment of
ui ratingwith inline content now accounts for parent line height
Bugs
- All Modules - Fixed bug where element
destroycould remove third party events when re-initialized - Breadcrumb - Breadcrumb icon now has exact px value to alleviate vertical align issues
- Card - Star / Like button colors have been fixed to match
ui ratinginsidecard - Card - Hiding a card with
display: noneno longer causes layout issues with(x) cards - Card -
imageinsidecontentno longer has a fixed size Thanks @romuloctba - Form -
info messageare no longer hidden by default insideui form - Form - Lightened error dropdown hover text color to be more legible
- Dropdown - Upward dropdown now has upward arrow icon
- Icon -
external linkandexternal link squarehas been renamed toexternal iconto no longer receivelinkstyles by default - Modal - Modal now swaps to
scrolling modalwhenclose iconno longer can be displayed, instead of modalcontent - Steps - Fixed bug where evenly divided steps were no longer fluid
- Transition - Fixes bug where
moduleNamespacewas being omitted - Transition - Transitions with direction now use word order dependency to prevent conflict with component directions, for example `bottom left popup slide down in transition
Docs
- Fixed bug with chinese mirror modal appearing on every page load when selecting chinese language
Bugs
- Grid - Removed
text-align: leftfrom column definition. Now inherits from grid. - Input -
ui labeled inputnow usesflexadded example in ui docs with dropdown - Input - Fix border radius on
ui action inputwith button groups, akaui buttons - Popup - Popup
hide allwill now use transition set insettings.transitionwhen closing other popups - Grid - Fix
doubling gridsetting100% widthwhich may cause
View Closed Issues View Commits
Key Features
- Form - Form now has new methods
reset,clear,set value(s), andread value(s)for modifying and reading form data. Check docs for details on implementation. Thanks @mktm - Search - Search
onSelectnow receives JSON object matching currently selected element, you can now programmatically retrieve result JSON using.search('get result', 'query')or.search('get results').get resultwill default to current value unless specified as first parameter. - Transition - Added many new transitions, and new directions for existing transitions Thanks @ph7vc
- Dropdown - Dropdown now stores
placeholder text(prompt text) as separate fromdefault text(text set on page load). You can now reset placeholder conditions using `$('.ui.dropdown').dropdown('clear');``
Enhancements
- API - Added new behavior
$.api('abort')which cancels current request - Dropdown - Keyboard navigation will now allow opening of sub menus with right/left arrow. Enter will open sub-menus on an unselectable category (
allowCategorySelection: false) as well. - Dropdown - Mutation observers will now observe changed in
<select>values after initialization, and will automatically update dropdown menu when changed - Dropdown - Dropdown behavior
set selectedwill now also callset valueautomatically, so you do not have to invoke two behaviors to update aselection dropdownThanks @mktm - Form - Form will now prevent browsers from resubmitting form repeatedly when keydown is pressed on input field.
- Header - Content headers now inherit
@h1-h6sizes fromsite.variables - Header - Sub headers now adjust in size depending on header size, added new variables for subheader resizing
- Search - Greatly reduced search delay from
300msto100ms. Previous request will automatically abortxhrwhen new request made - Search - Search
onSelectandonResultsAddcan now cancel default actions by returningfalse. - Transition - Transition duration now defaults to what is specified in
css, to set custom duration you can still pass at run-time as a different value. Animation duration no longer set by default during animation. - Transition - Transition will now prevent repeated animations when using an inferred direction i.e. animation without
inoroutspecified. Whenqueue: trueonly animations with explicit direction, e.g.fade in, will be ignored when called repeatedly.
Bugs
- API - Fixed bug where
$.api('get xhr')was not correctly returning xhr promise - API - Fixed bug where API would query resource immediately when specifying
on: false - Button - ``ui vertical basic buttons` now have dividers in default theme
- Button - Fixes formatting for
disabled buttoninsideui buttons - Checkbox - Checkbox now only modifies
input[type="radio"]andinput[type="checkbox"]ignoring any other inputs - Dropdown - Dropdown no longer will not show menu when no
itemare present in menu. Dropdown will now only filter results forui search dropdown#1632 Thanks PSyton. - Dropdown - Dropdown will now produce an error if behaviors on an initialized
<select>are not invoked onui dropdown - Dropdown - Fixed bug where link items would not open in sub-menus due to
event.preventDefault - Label - Fixed
ui corner labelappearing on-top ofui dropdownmenu due to issue in z-index hierarchy - Label - Fixed issue with
ui ribbon labelnot positioning itself correctly when using sizes likesmallorlarge - List -
relaxed listandvery relaxed listno longer add padding to child menu items - Popup - Popup will now only use a max of one element when
settings.popupmistakingly passes multiple DOM elements - Popup - Popups will now by default appear over all UI content, even dimmers.
- Search - Search results no longer hide/show when user changes tab or page loses focus
- Sidebar - Fixed bug with
pusherinheriting first child margins due tomargin-collapse - Sidebar - Mobile
is mobilewas using RegExptest()which would return an incorrect value when called multiple times - Sidebar - Sidebar will now only close if you click on
pusheror underlayedbody(scale out). Clicking on fixed elements will not close sidebar. - Transition - Fixed bug with animations that contain the strings 'in' or 'out' as part of their names, for example "swing"
- Sticky - Fixes issue with container size not being set explicitly on rail due to improper method renaming
- Installer - Fix issue with component list in
semantic.jsonnot correctly overriding default components
Bugs
- Installer - Fixes installer not including RTL parameter correctly
- UI - Fixes
progress,ad, andsidebarnot loading.overridefiles correctly - Removed undocumented components from
theme.config.example
Major Changes
- Project - Right-to-left (RTL) support added. New gulp tasks for RTL file generation and install setting. Docs however do not yet support RTL.Thanks @MohammadYounes for constant support with RTL!.
- Project - Install now let you specify the outputted file permissions (express/custom install)
Enhancements / Changes
- Grid - Added
equal widthvariation usingflex-box,equal heightnow also usesflex-box(this may have to be removed if causes unexpected browser issues) - Sidebar - Having a sidebar visible on page load is now much simpler. You can include
ui visible sidebaron page load to have a sidebar element appear on page load. To close call$('.ui.sidebar').sidebar('hide') - Sidebar - Added documentation on using sidebar on a custom context. Sidebars using a custom context no longer add background colors like those initialized on
body - Site - Form input highlighting color added (helps differentiate form colors with autocompleted fields). Default text highlighting color moved from highlighter yellow to a mellow blue.
- Dropdown - Javascript Dropdown can now be disabled by adding ``disabled
class. No need to calldestroy`. Thanks Psyton - Dropdown - Search dropdown input can now have backgrounds. Fixes issues with autocompleted search dropdowns which have forced yellow "autocompleted" bg.
- Dropdown - Fix issue with search selection not correctly matching when values are not strings
- Progress - Progress bars can now display percent or amount left using
{value}in text templates - Dropdown - New
upward dropdownvariation, which opens its menu upward. Default animation now uses ``settings.transition = 'auto'` and determines direction of animation based on menu direction - Dropdown - Dropdown matching fields without values now trims whitespace by default
- Checkbox - Checkbox now toggles on spacebar when focused (previously only toggled on enter key).
- Popup - Popup now uses its own custom method for determining
offsetParentmeaning 3D contexts (like inside an animation) no longer should break positioning - Popup - Popup now uses
preserve: falseby default, this is slightly less performant but will reduce page clutter caused by leaving generated elements in the DOM
Code / Build
- Build -
Dist/files now set file permissions in build.644by default. Can adjust insemantic.jsonor during gulp install. You will need to runnpm installto add the new gulp-chmod dependency Thanks @PeterDaveHello - Sidebar -
setup layoutnot occurs synchronously if you initialize a sidebar without the proper html. This makes sure calls to sidebar will occur correctly before the page is setup. A new settingdelaySetupwill override this, increasing performance. - Modules - Remove use of deprecated
.size()for.lengthacross all modules - Modules - Use of
$.proxyswapped to nativefunction.call()for performance gains across all modules
Bugs
- Video - Video component now uses
//instead of defaulting tohttp - Dropdown -
restore defaultswill now set placeholder styling and remove active element. Added example in docs. - Dropdown - Fixed bug where sub menus may sometimes have dropdown icon overlap text
- Dropdown - Fixes dropdown search input from filtering text values when input is inside menu, i.e "In-Menu Search"
- Dropdown - Fix issue with search selection not correctly creating RegExp when select values are not strings Thanks @alufers
- Dropdown - Fix issue with
left floatedandright floatedcontent sometimes not applying correctly - Popup -
wideandvery widepopup will now appear when screen size is below theirmax-width - Popup - Popup no longer blurs element on popup hide
- Segment -
ui tabular menunow correctly aligns with attached segment when using fluid variation Thanks @MohammadYounes - Segment -
basic segmentno longer removes padding on first and last elements - Steps - Steps now use
table-cellto allow steps to be equal height by default, even with different content height. - Button - Fix issue with labeled icon groups in material theme
- Progress - Fixes bug with progress that use
totalandvaluereceiving the wrong values for text templates - List - Fix some styling issues with
ui listinsideui menu
1.6.3contained an unintentional character at beginning oflabel.lessre-released as1.6.4
Bugs
- Build - Fix CSS property typo in list icon, and label causing issues with some custom build tools
1.6.3contained an unintentional character at beginning oflabel.lessre-released as1.6.4
Bugs
- Build - Fix CSS property typo in list icon, and label causing issues with some custom build tools
- Label - Fix attached labels to have correct border radius inside of attached segments of all kinds
Site Variables
- Site - EM values for
smalllargeetc are now all calculated from@emSizeallowing you to only change one variable.
Bugs
- Button - Fixes active orange button color
- Menu - Fixes
fluid text menuto have correct margins
Bugs
- Accordion - Accordion now uses
useFailSafe: trueto avoid callbacks not occurring because of race conditions withtransitionendin webkit
Build
- Dist - Build will now output version number in comment banner
Updates / Enhancements
- Accordion - Child element animations now use
$.fn.transitionand css animations by default (if available) - Accordion - Added
animateChildrenoption to disable/enable opacity animation on child elements - Accordion - Accordion now uses `easeOutQuint
instead ofeaseInOutQuint`` to increase perceived responsiveness of drawers - Grid -
stackable gridnow only adds horizontal padding when usingstackable page grid, otherwise content will take up full width of parent element
Bugs
- Tab/Segment - Fixes first tab being 1pixel taller than all other tabs
- Popup - Fix issue with
ui popupreceiving error$offsetParent is undefinedwhen using a pre-defined popup - Popup - Fix issue with
ui popup` not appearing withui flowing popupdue to newly addedmin-width: max-content`` - Form -
ui search dropdowninside a form has incorrect focus style - Menu - Fixes
ui fluid labeled icon menuto not havemin-width
Bugs
- Sidebar - Fix bug with
useLegacyintroduced in1.5.1
Bugs
- Button - Fixed vertical alignment of
ui animated button - Search - Fixed issue with local search returning all results due to improper regexp
Critical Bugs
- Build Tools
1.4.0introduced a bug with concatenated uncompresseddist/release including minified code. This would occur only when no components were specified in installer orsemantic.json.
Enhancements
- Dropdown - New setting
allowCategorySelectionlets menu items with sub menus be selected. Added example in docs. - Reset - Reset now inherits
box-sizingfrom html tag - Label -
ui ribbon labelcan now appear on the right side of content when specifyingui right ribbon label - Checkbox - Checkboxes now can handle labels with multiple lines of text
- Progress - Progress bars now display all intermediary percentage values when animating. Improved performance when progress bar is rapidly updated.
- Popup - Popup now uses the new property
min-width: max-contentto allow for better display withinlinein some circumstances where it escapes parent element. - Table - Table now has coupling with image to make sure size is preserved correctly with table sizing when used inside a table cell.
- Menu -
ui fixed menunow defaults toui top fixed menu
Bugs
- Form - Fixed (x) wide field not having correct bottom field margin when in
fieldsgroup on tablet or mobile - Tab - Calls to global
$.tab()would not pass arguments correctly - Dropdown/Search - Fixed issues with
ui searchandui search dropdownusingRegExp testwhich advances pointer on match causing results to display incorrectly - Form -
ui inputnow receives the same formatting as a normal input inside aninline field - Grid - Fix display of equal height stackable grid. Add padding to divided stackable grid for dividers
- Input - Fixed bug when
ui action inputuses aui icon button, button was receivingi.iconformatting. - List - Fixed bug when using
ui icon buttonorui icon headercausing element to receive icon formatting - Grid - Fixed issues where negative margins on
ui stackable gridcould cause horizontal scroll bars on mobile - Popup - Popup destroy will now also destroy any unfired timers (show/hide delay)
- Popup - Popup now moves to the same offset context to avoid positioning errors when using a named pre-existing popup.
Build Tools
gulp buildwill now only builddist/components/for components selected in install- Fixed bug where interactive installer was not correctly setting components in
expressandcustominstall
Bugs
- Dropdown -
<select>elements will now preserve original<option>order by default. AddedsortSelectsetting (disabled by default) to automatically sort<option>on initialization - Button - Fixes issue with
will-changeproperty added toui buttoncausing layout z-indexing issues (dropdown button)
Enhancements
- Modal - Modal now accepts custom dimmer settings with setting `dimmerSettings``
- Form - Form inputs without
typespecified are now formatted Thanks PSyton - Accordion - Added inverted accordion variation
Bugs
- Progress - Fixes bug where
ui indicating progresswould not update its label immediately in webkit - Button - Fix Chrome bug with buttons sometimes not correctly repainting (particularly evenly divided groups)
- Menu - Fix border radius of dropdown menu inside
ui vertical menu - Menu - Fix formatting of
ui selection dropdowninsidemenu
Docs
- Improved documentation for API and Tab to be slightly more comprehensive
- Modal - Fixed issue with modal dimmer appearing cut off in some browsers, and not hiding
- Button - Dist version of button accidentally included
chubbytheme instead ofdefaulttheme
Browse Closed Issues for 1.3.0
Critical Bugs
- Build Tools - Fixed issue with
theme.configcausinggulp watchto throw an error
Enhancement
- Dropdown - Dropdown can now specify which direction a menu should appear left/right, dropdown icons can also appear on the left
- Dropdown - Full text search now defaults to
false, meaning search terms will return only results beginning with letters - Dropdown - Search Dropdown is now much more responsive, js improvements and input throttling added.Throttling defaults to
50msand can be modified with settingsdelay.search - Dropdown - Search Dropdown now correctly replaces placeholder text when backspacing to empty value
- Dropdown - Search Dropdown now has a callback when all results filtered
onNoResults - Dropdown - Search dropdown will now strip html before searching values when searching html
- Dropdown - Search now has keyboard shortcut to open dropdown on arrow down
- Form - Form will no longer process validation rules on disabled fields
- Label - Corner attached labels now display correctly inside of attached segments
- Steps - Steps are now responsive for mobile by default, and have optional responsive styles for tablet
- Table - Table has now variations to remove responsive stylings, specify responsiveness for tablet
- Table - Table now has a
structured tabletype, which removes some formatting considerations to support complex table layouts withcolspanandrowspan
Bugs
- Button - Button "or" positioning variables have been adjusted to be automatically calculated without magic numbers
- Dropdown - Dropdown now always scrolls to active element on menu open, calculates position with new
loadingclass - Dropdown - Fix bug in position of sub menus with
floating dropdown - Form - Fixed positioning of horizontal field groups, aka
fieldsfor mobile. - Grid -
stackable gridnow display correctly when nested inside a differentstackable grid - Image - UI image now works with SVG
- Modal - Fixed issue with modal losing scroll position on mobile
- Modal/Dimmer - Fixed issues with modal hiding during showing and showing during hiding, fixed issues with "hiding other" modals while a modal is mid-animation.
- Segment - Vertical segments now have padding on first/last element, fixing issues when using with grids
- Sidebar - Mobile sidebars now only set
overflowon page'shtmlwhen browsing fromiOSdevices. Using overflow caused issues with page's scroll being lost when resizing a browser to mobile widths. This also affected modules that used `$(window).scrollTop()`` at mobile screen sizes - Step - Fix issue with completed ordered step icon alignment
- Table - Fix responsive styles when applied to
definition table. - All UI - Adds error message when triggering an invalid module behavior i.e. typos
$('.dropdown').dropdown('hid');
Docs
- Button - Add tabindex /keyboard nav documentation
- Grid - Add another grid example
- Updates to reflect all new changes to UI listed above
Enhancement
- Form - Form validation now has parameter
optionalwhich will only validate a field against a set of rules if the user does not leave it blank Thanks DHNCarlos - Fonts - Add font subset variable for
site.variablesThanks gabormeszoly - Modal - Default modal shadow now more subtle
- Sidebar - Now has behaviors
is open/closedthat are aliases foris visible/hidden - Checkbox - JS Checkbox now handles several variations of html. Labels can be before inputs, after, or not included at all. This should work better with server side form generation.
- Progress - Adds
limitValuessetting to adjust values outside of 0-100 automatically to within range, defaults to true
Bugs
- Grid - Fixes
ui stackable gridsometimes not aligning correctly at mobile sizes withui page grid - Progress - Fixes issues with setting progress to 0% not working as expected
- Modal - Fixes issues with multiple modals sometimes not closing dimmers
- Modal - When a second modal that is not scrolling is opened after a scrolling modal it no longer causes the first modal to not be scrollable
- Modal - "Hammer" clicking multiple times on a hiding dimmer no longer causes animation issues
- Sidebar - Fixes issue with multiple sidebars sometimes causing dimmer to close prematurely
- Sidebar - Dimmer can now be clicked even before sidebar has finished showing to immediately close sidebar
- Item/Card - Default link formatting inside element simplified to avoid adjusting other nested
uilink styles - Dropdown - Fixes bug with dropdown converted from
selectthat use<optionvalues with capital letters not being selectable - Form - Fixes required checkbox asterisks formatting incorrect
Docs / Build
- Fixed documentation on dropdown actions, form field widths, form validation types, and many odds & ends
- Adds components to semantic.json.example
- Theme.config.example now links to final site folder
- NPM - Fixes issue with
dist/not being included when using NPM due to.gitignore
Bugs
- Step - Fixes step content appearing overlapped due to use of
eminstead ofremfor line-height. - Sidebar - Fixes issue that may cause sidebars to stay open in some circumstances when using multiple sidebars
Enhancements
- Transition - Transition's caching of final display state and animation existence now has improved performance.
- Popup - Popup now has a
settings.preferthat defaults toadjacent. This setting sets prefered next placement when a popup cannot fit on screen in the chosen placement.prefercan also be set tooppositeto prefer the same position on the opposite side - Popup - Popup can now use a setting
lastResort. When set to a position it will be used as a last resort even if popup does not entirely fit on the page. Setting this tofalsewill produce an error when a popup cannot fit on screen. - Transition now has
useFailSafeparameter (off by default) to ensure transition callback fires even if nativeonAnimationEndevent does not fire due to element visibility. Chromium Bug Report by Product Manager @ Mozilla and this open issue - All UI - Many
emmeasurements adjusted slightly to calculate out as exact pixel values (Fixes 1px rounding errors) - Steps - Now use global border color
- Progress - Progress now has sizing variations
- Input -
transparent inputcan now beinverted - Dropdown - Dropdown
onChangecallback now fires when callingsetSelectedprogrammatically.
Bugs
- Build Tools - NPM now correctly pins dependencies instead of using bleeding-edge versions which may break builds
- Transition - Transition now correctly detects missing animations, errors do not cause future image transitions to break
- Menu/Segment Fixes double border on pointing menu with attached segment Thanks davialexandre
- Progress - Fixes indicating progress appearing incorrectly at 100% complete Thanks ordepdev
- Icon -
remove iconis now formatted correctly when used asremove link icon - Input -
ui action inputcan now accomodateui buttonthat adjust padding from default - Dropdown - Fix
action inputused insideui dropdownto appear correctly Thanks ordepdev
Docs
- Progress - Added missing settings docs for progress module
Bugs
- Site - Add protocol variable for Google Font loader to avoid issues with
//when loading locally causing freezing - Icon - Fix horizontal centering of circular icon
- Transition - Fix vertical flip not working due to css typo Thanks cgroner
- Menu - Removes missing image loader variable Thanks ryan-mahoney
- Card/Item - Fix generic link stylings erroneously affecting linked ui elements like buttons
- Table - Fixes table cell transition animating all properties
Breaking Changes
- Word Order - Many multi word variations now require proper word order, for example
left alignedorright floatedclassnames must be adjacent. This is to prevent conflicts with other multiple word variations - Form - Date field has been removed, use a
ui icon inputwith acalendar iconinstead - Label - Corner labels no longer support text, only icons.
- Dropdown - Sub menus inside dropdowns now need a wrapping div text around sub-menu descriptions
- Checkbox - Checkbox "enable" and "disable" have been replaced with "check" and "uncheck"
- Modal - Modal
leftandrightsections are now replaced withimageanddescription - Accordion - Accordions are now unstyled by default allowing for simpler coupling with other UI without having to override styles. Styled accordions are now included as a variation
ui styled accordion - List - List item selectors are now more strict, list items must be immediate children of
ui listorui list list - Item - 0.x.x's UI card has been adjusted heavily. Vertically listed content should use
ui itemwhile floated grouped content should continue to useui card. Some 'card' view content has been slightly adjusted. Please refer to documentation - Header / Icon - Inverted headers and icons no longer invert background colors, but instead use a lighter version of colors more legible on dark backgrounds. Inverted circular icons, still however invert the color of the circle.
- Input - Labeled inputs now have
cornerleftandtoplabel types. Any labeled inputs should be converted tocorner labeled inputto preserve functionality from0.x - Modal - allowMultiple (allowing multiple modals at once) is now set to false by default.
- Table - Tables are no longer striped by default, instead you must specify the 'striped' variation
- Transition - Complete, and Start callbacks are now
onCompleteandonStart
Enhancements
- General - CSS animations now hint with will change properties to increase performance in supported browsers
- General - Many modules now use DOM Mutations and event delegation to allow content adjustment after initialization
- Accordion - Accordion now includes all icons in an embedded font instead of requiring icons
- Button - Now has compact form, used for fitting into tight spaces
- Button - Now has CSS loaders to allow loading state to maintain other styles
- Checkbox - Now correctly handles read-only and disabled, has read-only and disabled states
- Checkbox - All styles have been redone. Standard checkboxes are now based around PX and not EM making sure there are no unusual circles or rounding issues. Checkboxes also now use a custom font for glyphs instead of CSS tricks.
- Checkbox - Checkbox now have a
fireOnInitsetting for firing callbacks on page load - Checkbox - Checkbox now receive a
checkedclass when checked, making it easier to write css selectors on checked checkboxes, for example when using sibling selectors.ui.checked.checkbox + .content { // style } - Dropdown - New dropdown type, searchable selection for large lists of choices
- Dropdown - Dropdowns can now be initialized directly on a
<select>element without any html - Dropdown - New action combo will change text of adjacent button, select will select element but not change text
- Dropdown - Many new content types now work inside dropdowns, headers, dividers, images, inputs, labels and more
- Form - Form now has a success state which will automatically display success messages
- Dimmer - Dimmer will now automatically determine whether click-to-close is enabled by
settings.on - Dimmer - Multiple dimmers can now be used on the same context with
dimmerName - Dimmer - Dimmer variations can be specified when creating a dimmer from javascript using
variationsetting. - Form - Grouped fields and inline fields can now have labels
- Form - Forms in 'success' state will now show success messages inside
- Form - Inputs now use 1em font size and correctly match selection dropdown height
- Form - Inverted form now properly styles loader
- Form - New field type
requiredformats labels to show filling out field is mandatory - Grid -
ui dividercan now be used inside of row columns as well asvertically divided gridvariation - Grid - Grid rows and columns now support color variations
- Grid - Grid has been rewritten to automatically create row flow without row wrappers
- Grid - Divided and celled grids can now be inverted for dark backgrounds
- Grid - Elements inside a grid that are not rows or columns will now align properly
- Grid - Fixed page grid allows for fixed pixel size containers used with a grid instead of percentage
- Grid - Vertically divided grid now does not include left/right gutters in divider
- Header - Linked headers now receive link colors
- Image - New
bordered imagevariation - Item - Items now have a horizontal list view for content lists
- Label - Added tag label and empty circular label style
- Label - Now has compact form, for fitting into tight spaces
- Label - Now has more sizes available
- List - Child lists can now be formatted to sit inside text content
- List - List images can now specify vertical alignment
- List - List spacing defaults have been adjusted to be more consistent
- Popup - Popup can now allow itself not to be closed when hovered over
- Popup - A popup element can now be specified on initialization.
- Reveal - Reveals now all use css properties with GPU acceleration
- Popup - Positioned popups will now extend in the opposite direction to fit better with floated content
- Rating - Rating now uses an embedded icon font to maximize compatibility
- Rating - Rating can now automatically generate icons without including them
- Rating - Rating can use data attributes to specify individual ratings
- Sidebar - Sidebar now has tall / very tall variations for resizing top/bottom sidebars
- Shape - Shape now is better at calculating sizes when animating
- Shape - You can now disable repeated animations by setting, so animation wont queue if side is currently visible
- Steps - Steps can now have icons, descriptions and titles. Step default theme has been modified significantly to be more flexible.
- Table - Tables now have 'basic' and 'very' basic variations
- Transition - Transition will now keep block position of elements hidden with visibility hidden
- Transition - Transitions now will handle multiple display types more consistently
- Transition - Transition now has a new
startcallback, before animation starts - Transition - Complete callback now does not occur if animation is interrupted before completing
- Transition - You can now specify the final displayType of a transitioning element in metadata or settings (not just automatically detected)
- More untracked changes added as well
** Bug Fixes **
- See Closed GitHub Issues
Bug Fixes
- Grid - Fixes issue where some responsive grid stylings were being overridden by other variations (for example stackable overriding )
Bug Fixes
- Grid - (Backport from 1.0 branch) Fixes issue where some combinations of (tablet/mobile/computer) only does not function correctly
Bug Fixes
- Modal - (Backport from 1.0 branch) Fixes issue where modal sometimes appears too low on second show
Enhancements
- Transition - Adds "fade in left/right" variations to match "fade up/down" Thanks AdamMaras
Fixes
- Accordion - Fixes incompatibilities with
ui listwhen used inside aui accordion, fixes issues with menu accordion display in some circumstances - Menu - Fixes
ui inverted secondary pointing menuto have correct pointer color for all color variations Thanks AdamMaras - Docs - Language clarified for menu/rating definition Thanks jnbt/ewiner
Enhancements
- Modal - Modals now focus on first input if available Thanks Knotix
- RTL - RTL now uses RTLCSS instead of CSSJanus Thanks MohammadYounes
Fixes
- Menu - Fixes bug where pointing menu would sometimes appear below content Thanks Skysplit
- Dropdown - Fixes dropdown 'is animating' with dropdowns when CSS animations were not included Thanks nathankot
- Accordion - Accordion title does not know have to be :first-child to receive proper border Thanks BigBlueHat
- Popup - Fixes javascript animation of popup missing easing dependency
- Label - Fixes border radius on bottom left label
Docs
- Modal - Docs now have HTML examples
- Docs - Fixes issue with overview mode not clearing code examples
- CSS Guide - Fixes typos in css guide
Enhancements
- Dropdown - Dropdowns can now receive focus and be navigated with a keyboard Thanks Musatov
- Popup - Popup now has an
onRemovecallback after removing element from DOM
Fixes
- Modal - Element does not accurately close other modals when initialized at different times Thanks nojhamster
- Modal - Fixes javascript error for browsers that don't support CSS animations if jquery.easing is not included
- Form, Input - Fixes
ui inputto work correctly insideinline field
Fixes
- Transition - Fixes bug where transition could accidentally hide element on show due to error when determining original display type
Enhancements
- Form - Fields can now be aligned to a grid Thanks seralex-vi
Critical Fixes
- Modal - Fixes issue where position sometimes appeared too low on second show
- Reveal - Fixes reveal being broken in Chrome in
0.15.5due to poor fix for reveal selectability
Fixes
- Transition - Fixes issue where transition hidden was sometimes overwritten by UI styles causing the element to stay visible
- Checkbox - Fixes issue where checkboxes with multiple line labels were appearing formatted incorrectly.
Critical Fixes
- Checkbox - Fixes
ui checkboxto obeydisabledproperty of input
Fixes
- Reveal - Hidden content now can be selected on reveal
- Message - Fixes hidden/visible class to work with animations
- Message - Fixes hidden/visible class to set proper display on
ui icon message - Message - Fixes hitbox/position of
close iconinside message
Fixes
- Rating - Fixes issue where rating was behaving erratically in Chrome
Changes
- Transition - CSS Transitions now work in legacy FF (FF > 12)
- All UI - Adds support for legacy FF vendor prefixes (FF > 12)
Docs
- Adds more examples for static checkbox/radio boxes with HTML only
- Fixes a variety of issues with malformed examples (thanks community)
Changes
- All Modules - Debug is now disabled by default
Fixes
- Step - Fixes issue with border radius on vertical steps
- Icon - Orange color is now available for icon
- Menu - Fixes formatting of attached segments with menus
Critical Fixes
- Dropdown - Typo in dropdown css was causing selection dropdowns not to appear
Enhancements
- Step - Vertical Steps now have option to have two line items
- Form - Forms, Dropdowns, and Inputs now have matching padding size, and use 1em font size to appear same size as surrounding text
- Icon - Icons on dark backgrounds should render better in OSX
- Modal - Modals now have an onVisible and onHidden callback for after animation ends
- Form Validation - Form validation now automatically revalidates a selection dropdown on change when invalid
Critical Fixes
- Modal - Browsers without RequestAnimationFrame (Opera) were erroring on modal show
- Dropdown - Element's with numeric
data-textvalues were erroring when selected
Fixes
- Modal - Modal onShow and onHide occurs before transition starts, allowing for class name changes not to be reset
- Dropdown - Default selection text was not appearing when a dropdown had a value that was
falseor0 - Input - Fixes slight error in corner label rounding Thanks MohammadYounes
- Reveal - Reveals will now show on active, for touch devices Thanks Illyism
- Table - Fixes rounding on tables with multiple tfoot elements Thanks webdesserts
- Icon - Hide and unhide icon were accidentally given opposite names
- Checkbox - Checkboxes can now have multiple inputs inside, for use with .NET and other languages that insert their own hidden inputs
Project
- iOS - Active styles, for example pressed in buttons, now appear in docs on touch devices
Enhancements
- Modal - Modal now uses requestAnimationFrame instead of debounced callback
- Dropdown - Dropdown now has error state Thanks Musatov
- Form - Form fields with errors will now properly style dropdown elements Thanks Musatov
- Step - Steps can now appear vertically
Fixes
- List - Bulleted and horizontal lists now appear correctly in IE10-11
Project
- NPM - Docpad is now moved to a dev dependency Thanks kapouer
Fixes
- Modal - Fixes modal positioning appearing slightly below center on second load
- Checkbox - Fixes checkbox appearance inside inverted forms
- Input - Fixes ui input to inherit form sizing
- Accordion - Fixes issues with accordion rules being too specific, causing several common usages of accordions to break
- Form Validation - Fixes form validation regular expression matching Thanks icefox0801
Enhancements
- Label - Corner labels now are coupled to have rounded edges with components with rounded edges like input
- Form - Grouped form fields now have responsive styles for mobile
- Modal - Modal will now work when modal is taller than page's content
- Checkbox - Checkboxes now also trigger DOM
changeevent - Accordion - Accordions now preserve inline styles when animating
- Form Validation - Form validation now rechecks on all form change events, not just input change
Fixes
- Menu - Fixes 2px border on last element in horizontal menus
- Menu - Fixes dropdown formatting when used *inside a menu item
- Menu - Fixes formatting of grouped icon buttons inside menus
- Modal - Fixes z-index of modal close to appear above
relative/absolutemodal content on mobile - Dimmer - Dimmers are less buggy when used with
on: 'hover
Enhancement
- Button - Or buttons can now have text specified using
<div class="or" data-text"text">with alternate text Thanks MohammadYounes
Fixes
- Popup - Fixes issue where popups using
titleattribute to store data were losing title content instead of correctly restoring it - Modal - Fixes an issue where modal may not position correctly in some cases Thanks GianlucaGuarini
- Modal - Fixes modal throwing an error when transition is not included Thanks robertoles
Fixes
- Form - Fixes issue with onSuccess not allowing cancellation of form submit in form validation
- Input - Fixes
ui buttonsto work inside anui action input**Thanks MohammadYounes ** - Items - Fixes
ui horizontal itemsto work correctly, missing comma Thanks mishak87
Project
- RTL - Adds RTL hinting for some files Thanks MohammadYounes
- Specs - Adds additional JSON spec files for future use with generators Thanks brigand
Fixes
- Message - Fixes some issues with margins sometimes not appearing with
attached messagethanks joltmode - Item - Fixes color repeating to be consistent for items thanks skysplit
Enhancement
- Form Validation - Adding custom validation is now simpler, uses syntax
$('.form').form('add prompt', identifier, 'Error message');
Fixes
- Menu - Slightly updates input sizes inside menus
- Grid - Fixes grid
only tablet/mobile/computershowing both devices on exact pixel of breakpoint, i.e. 768px - Icon - Fixes ascending alphabetic inheritance
Fixes
- LESS - Fixes typo breaking less parsing thanks DVSoftware
- Menu - Fixes buttons using
<a>tag from inheriting link styles. thanks joltmode - Menu - Fixes
action inputto work inside menus thanks joltmode - Modal - Fixes possible race conditions in animations of modal thanks dos1
- Message - Prevents close icon from being misformatted in icon message thanks MohammadYounes
Docs
- Icons - Fixes some icon code samples in docs thanks mishak87 Some updates to docs formatting
Major Fixes
- Dropdown - Fixes dropdowns links not working on touch devices
- Input - Fixes input placeholder styles to work (accidental regex replace)
Major Updates
- Transition - Transitions will now, by default, prevent the current animation from being queued while it is actively animating the same animation
- Modal - New setting
allowMultiplelets you specify whether multiple modals can be shown at once - Modal - New setting
detachableallows you to specify whether modal DOM element can be moved (Thanks MohammadYounes)
Updates
- Dropdown - Default value is now stored on init, and can be restored using 'restore defaults' behavior
- Modal - Buttons can now use both
cancel/denyorok/approve, for approve/deny events to fire (Thanks MohammadYounes) - Menu - Fixed menu now adds padding on the next element if it is a grid
- Progress Bar - Adds warning color
Fixes
- Icon - Fixes unnecessary formatting on thumbs up/down
- Dropdown - Fixes touchmove event not clearing on touch devices causing unnecessary overhead
- Input - Action inputs can now be fluid
- Sidebar - Fixes issue where top sidebar was receiving left offset
- Menu - Fixes z-index on fixed menu to exist just below modals
- Dropdown - Fixes issue where last match was returned, not prioritizing value over text
- Form - Fixes all validation input to be trimmed for whitespace
Major Updates
-Transition: Transition has been completely rewritten, performance should be about 10x after first animation due to caching and use of request animation frame
New Features
-Transition: Transitions now work with any display type not just display: block, meaning transitions can be used on buttons and other inline elements without affecting display
Fixes
-Transition: Fixes typo in "horizontal flip out" causing opacity to be fading in
-Popup - Fixes popup sometimes opening and closing when event:click is used and a user double clicks
-Modules: Fixed error in all modules where calling invoke would modify instance outside of scope, making it impossible to access some data (for instance cached positions) from outside of module.
-Modal: Fixes issues with modal in IE, IE11 can now use CSS animations with modals
Critical Fixes
- Dropdown - Fixes issue where dropdown animation does not occur sometimes (Thanks MohammadYounes)
Fixes
- Popup - Native browser popups no longer if using
titleattribute - Grid - Fixes issue where stackable grid was not working correctly when using (x) wide column
- Modal - Fixes element detaching sometimes in case where it is already inside a dimmer
- Input - Removes duplicate sizes
New
- Button - Adds VK button
- Input - Action inputs now support button groups
Fixes
- Rating - Fixes vertical alignment with text
- Dropdown - Fixes missing easing equations for dropdown javascript animations. Would cause an error when no css transitions were included and jquery easing was not available.
Fixes
- Modal - Fixes issue with modal animation regression in 0.10.0
New
- Grid - Adds
doublingresponsive variation which automatically formats content spacing based on device type - Form Validation - Adds two new parameters, to allow for changing of revalidation and delay on input
Updates
- Grid - Row padding is now EM not % based, this might shift layouts slightly
- Grid - Grid columns not inside a row will automatically receive row padding now. This will allow for content to flow correctly when row count is unknown
Fixes
- Grid - Fixes margin on stackable grids
- Dropdown - Value can be retrieved even in instances where forms arent used
Updates
- Rating - Ratings now receive class disabled when read only, instead of receiving
activewhen rateable since active are much more common - Grid - Fixes some instances where grid column width
x widewas being overruled by parent elementx column. - Header, Grid, Segment - Adds justified alignment
- Message - Fixes issues with attached icon message (thanks overra)
New
- Segment - Segments now have a circular variation
Fixes
- LESS files now include vendor prefixes by default instead of only including them in css releases
Fixes
- Dropdown - Fixes issue where falsy value (i.e. 0) could not be selected
- Transition - Fixes transition exists function from not being called
- Form - Adds input type="url" to forms
- Sidebar - Fixes right sidebars to correctly allow for sizing (Thanks DveMac)
- Sidebar - Typo in sidebar header (Thanks slobo)
Docs
- Fixes various typos and missing closing html tags
Fixes
- Dropdown - Fixes "falsy" values (like 0) not being processed correctly
- Segment - Fixes segment text color when nested inside inverted segment
- Button - Fixes improper active/visible state due to :not specificity (most noticeable in mousedown on a dropdown button)
Fixes - Fixes popup not repositioning itself when offstage.
New
- Popup - Adds context option for popup (thanks jefmathiot)
- Accordion - Adds formatting for nested accordions
Updates
- Accordion - Fixes issue with accordion events inside accordions
New
- Button - Basic icons now have inverted style
- Segment - Segments can now be used with
ui gridandui grid column/row - List - Adds animated list variation
Docs
- Release - Fixes issues with minification in grunt
- Examples - Adds new homepage example to release zip
- Code Samples - Updates ACE editor version
Updates
- List - Updated some list styles for greater flexibility
- Dropdown - Dropdown now always receives pointer cursor in all types
- Form - Darkens placeholder text color to be more visible
- Menu - Dropdown position inside secondary menus should be more precise
- Input - Labeled icons now have smaller corner labels
- Menu - Floating dropdown menus now work inside menus
- Button - UI buttons no longer have shadows, this helps match colored buttons in layouts
Fixes
- Header - Fixes alignment of solo icons in headers
- Button - Fixes labeled icon placement in Chrome
- Modal - Fixes use of unsupported comma separated :not selector
- Modal - Fixes left/right ui content receiving modal styles inappropriately
- Menu - Fixes some inverted menu stylings not applying correctly in some instances
- Grid - Fixes comp/tablet/mobile only columns not working if not inside a row
Fixes
- Modal - Fixes issue with scrollable variation on mobile, updates mobile styles
Docs
- Fixes bug in jquery waypoint 2.0.3 causing menus to be lame
Fixes
- Modal - Fixed issue with modals not working in 0.8.4 due to mistake in transition invoke
- Modules - Invoke now gives user's query in error message for method not found
Fixes
- Modules - Fixes bug where invoking a sentence behavior that has a single word match would always invoke single word match. I.e.
show modalwould mistakenly callshowif it existed. - Modules - Adds CSS transition support detection to all modules using css transitions to allow for graceful degradation for IE8
Docs
- Download - Fixes issue where non minified source was being included with minified copy
- IE - Fixed some issue with IE display in docs
Fixes
- Modal - Adds fixes for opening modals when other modals are opened, adds a few new API behaviors
- Form - Fixes issues with form validation not escaping regex characters
- Form - Errored fields now have their icons and corner labels colored appropriately
- Labels - Fixes formatting of links inside labels
Fixes
- Modal - Quick Fix for modal events in IE
- Menu - Fixes arrow direction on vertical menu dropdown
- Button - Fixes button height issue with button groups including icon and normal buttons
Docs
- Fixes some missing closing tags
Fixes
- Button - Fixes colored version sometime losing white text color
- Button - Fixes 1pixel jump on animated fade buttons
Docs
- Prefixer now used for prefixing in grunt
- Spelling fixes
New
- Button - Default button styles have been significantly tweaked
- Button - Evenly divided buttons can use number classes instead of words
class="2 buttons" - Button - New animated button styles, fade, horizontal, and vertical
Fixes
- Button - Fixes "or" sizing to work for all sizes
- Dropdown - Fixes border radius on non-selection dropdowns from changing on activation
- Input - Action buttons now have tactile feedback like normal buttons
Docs
- Added more detailed contributing guide
- Updates info on setting up server
- Added new examples to button and input
Fixes
- Modal - Fixes issue with modal hiding twice onApprove
Fixes
- Dropdown - Fixes issue with dropdown icon position in chrome
- Popup - Fixes issue with popup's using setting inline: true
New
- Table - Added awesome new responsive style to ui tables
- Button - New social buttons for Instagram, LinkedIn, Google Plus, Pinterest
- List - Adds documentation for module format
- List - Adds onTabInit for local tabs on first load
- List - Popups can now have a different target than itself
- Modal - Modal hide can be cancelled from
onApproveandonDenyby returning false from callback - Transition - onShow and onHide callbacks for visibility changing transitions
- Shape - New 'cube' and 'text' shape type
- Shape - Transition duration can now be set programmatically
- Shape - New beforeChange callback
- Sidebar - Sidebar will now default to being exclusive and hiding other sidebars on show
- Sidebar - Sidebar now has onChange, onShow, onHide callbacks
- Sidebar - Sidebar now have several size variations, and a new styled variation that comes preformatted
Docs
- Dimmer - Adds more dimmer examples, fixes settings
- Modules - New examples and docs for all modules
- Adds sortable tables to docs
- New tabbed doc style for modules
- Code samples will now automatically format indention
Fixes
- Button - Fixes vertical fluid buttons not taking up full width
- Shape - Shape now works with no additional stylings
- Shape - Fixes calculation of next side size to work correctly by using offstage element
- Modules - Fixed issue when altering settings using
module('setting')with an object - Dimmer - Dimmer now obeys border radius of parent
- Dropdown - Dropdown cannot display inside item image
- Dropdown - Dropdown links were being prevented by event.preventDefault used for touch devices
- Dropdown - Fixes issue with borders on selection dropdown
- Dropdown - Fixes pointing dropdown to appear correctly in menu
- List - Celled tables now have celled table headers
- Menu - Fixes border radius on tabular menu, fixes one pixel jump on active state
- Menu - Removes vertical label width missing units in menu
- Popup - Popup .toggle() now always hides/shows popup correctly
- Popup - Popup fixed a bug where "top right" placed popup might sometimes be too large
- Popup - Popup will not reshow a visible popup on hover
Updates
- Accordion - Reduces vertical padding on basic accordion content
- Header - Block header now uses RGBA instead of solid color by default
- Label - Ribbon labels now have a shadow color
- List - Horizontal padding on icon list slightly increased, fixes to icon position
- List - Increased padding on attached labels
- List - Leading on bulleted and ordered list slightly increased
- Message - Increase opacity of icons on icon messages
- Modal - Optimizes dimmer init on modal to occur on modal init and not modal show
- Popup - Popup border now uses RGBA to look sexier on dark backgrounds
- Popup - Popup default duration is now 200ms (slighty slower)
- Popup - Popup metadata attribute arrowOffset is now offset for simplicities sake
- Popup - Popup no-longer receives class name 'visible' on show, this allows popups to be used on dropdowns and other elements with a visible state
- Popup - Popups are no longer inline by default
- Table - Table headers are now darker to increase contrast with rainbow striped rows
- Sidebar - Floating sidebar is slightly less heavily shadowed
Fixes
- Fixes issue where browser default action, like link clicking, was prevented on dropdown item click
- Modal keyboard shortcuts now obey settings.closable (credit to luisrudge)
Fixes
- Fixes issue where browser default action, like link clicking, was prevented on dropdown item click
Deprecation
- Dropdown changeText and updateForm have been deprecated and will be removed in 1.0
Updates
- Dropdown hide no longer selects current item as active (useful for menus)
- Simplified possible dropdown actions changeText and updateForm are now consolidated into activate which is the new default
Fixes
- Fixes touch+mouse like touchscreen laptops to work with dropdowns
- Fixes input position inside menus with no other content
- Fixes input sizing on small/large menus
Updates
- Dropdown vastly improved for touch, now can scroll with touch without closing dropdown
- Dropdown active style now slightly more noticable
Updates
- Adds onApprove/onDeny callbacks to modal
- Adds small/large sizing of modal, reformats default modal size to be slightly inset from page grid
- Adds clockwise/counterclockwise rotated icon and default rotate
- Adds orange label/segment
- Adds automatic menu formatting for buttons inside menus
- Dropdowns in vertical menu automatically receive proper triangle pointer direction
Fixes
- Fixes modal spacing on left/right content to match up with grid gutters
- Fixes inheritance issues with rotated icon
- Fixes tests not passing for modal/dimmer
- Fixes overflow on item corner label
- Fixes right menu formatting in secondary menus
- Fixed shadow overlap on dropdown in menus
Updates
- Adds travis CI support with preliminary test coverage for all javascript modules
Fixes
- Minor Fixes caught with testing suite, related to ensuring proper destroy, init,
- Minor fixes to edge cases with setting and retrieving internals/settings as default, init, or during run-time on some modules
Fixes
- Fixes issue with modal sometimes closing/opening multiple times caused by changes in 0.5.0
Updates
- Fixes vertical alignment of checkboxes
Critical Fixes
- Fixes in some UI modules, issue where settings being shared across elements initialized at the same time instead of each instance.
- Fixes regression where popup was overriding variation class name on positioning
Fixes
- Fixes an issue where popup that was set to inline: false was being removed prematurely
- Fixes inheritance issue where grid column may sometimes not appear the correct size
- Fixes modal hide/show dependency issue where dimmer would not always hide modal and vice-versa
Updates
- Adds an example to popup where inline is set to false
- Accordion now comes bundled with proper easing
- Added onCreate to popup module
Fixes
- Updates dropdown to include proper invoke
Fixes
- Fixes issue with event bubbling being cancelled on dropdown item click
Fixes
- Fixes heart rating color
Updates
- Updated some checkbox stylings
- Checkboxes markup now more semantic with default markup including only one label tag that can be inside ui checkbox
Fixes
- Display issues with accordion
Fixes
- Fixes modal show/hide action reversal in Webkit
Updates
- Dimmer can now take different durations for its show and hide
Fixes
- Fixes popup position sometimes appearing off-stage on second appearance
- Fixes popup positions top left, top right, bottom left, bottom right being flipped
Docs
- Updates form and accordion docs
Updates
- Dropdown action default is now automatically determined based on type of dropdown, select dropdowns now will update form fields with default options
- Adds fluid variation to accordion
- Adds more html5 form support for forms (deneuxa)
- Fields can include both field and another level of fields
Fixes
- Fixes radio checkboxes (again)
- Fixes header content display in icon headers
Fixes
- Transitions now work in Safari versions that do not support animation-direction
- Fixes accordion in safari styles getting stuck
- Centering of content in icon header
Fixes
- Fixes modal not working due to destroy teardown in dimmer Issue #153
- Fixes selector for checkbox to fix radio boxes Issue #154
- Fixes issue with popup display in some edge cases Issue #128
Updates
- Headers and lists with icons now do not break with multiline content
- Examples resize with browser width
- Updates ACE editor library
- Code samples now do not change after interacting with examples
Updates
- Dropdown now formats top and right arrow icons automatically with icon coupling with sub menus
- Updates feed example with more feature examples
- Adds more sizes to ratings
- Makes active pagination item style more clear
- Adds attach events method to modal for attaching modal events to other elements
- Adds input focus/blur to modal, see Issue #124
- Adds new methods to rating: 'get rating', 'clear rating', 'disable', 'enable', adds new setting 'clearable'
Fixes
- Fixes position of menu dropdowns in some cases
- Updates modal to refocus elements after close
- Right floated list content now receives left margin
- List items display issues with icons + content
- Fixes rating line height issue
- Fixes rating not being sent as first callback parameter on 'onRate'
- Lists items now auto clear floats
- Fixes icon input inside a menu placement issues
Fixes
- Fixes Page Grid still receiving negative margin
Fixes
- Responsive Grid is now called "Page Grid". Responsive grids are now deprecated. This reduces confusion.
- Negative margins are now automatically removed from grids that are descendents of body tag.
Fixes
- Fixes checkbox selector issue with multiple inputs inside a checkbox
- Modal no longer uses inline css to center when in fixed position mode
- Fixes dropdown to now set active item to whatever hidden input field is when using action updateForm
Updates
- Fixes issue with display on Chromebook Pixel and some devices
- Fixes issues with concatenated version receiving conflicted icon definitions causing icons to not function
Updates
- Fixes issues with modal not swapping to absolutely positioned from fixed when content cannot fit in viewport
Updates
- Fixes invoke returning found function instead of results of found function in dropdown, modal
Updates
- Modals can now have an icon in its left content that will be automatically formatted
- Preserve 3D animations are now on by default for dimmers
Fixes
- Transition now forces browser repaint after animation
- Refactored modal and dimmer components
- Modal will now resize when browser window resizes if vertical height changes
- Fixes issues with dimmer settings sticking between separate modals with the same dimmer.
New
- Adds responsive modal styling, modal always now sits with 5% gutters under page grid responsive styling
- Adds basic modal variation
Fixes
- Issue with modal active state not being removed correctly from modals
- Swaps modal and dropdown to use same variable naming pattern as rest of modules
- Removed selector count from performance logs
New
- Added new font icon set using Font Awesome port
- Adds dropdown icon sexiness to accordions, now with rotating pointing arrows
- Added old icon set as a separate basic icon set
- Added fluid input variation
- Increased size of corner labels
- Adds relaxed grid variation with increased gutters
- Added relaxed and very relaxed list type with increased padding
Fixes
- Rating icon missing font content with icon font update
- Padding on side of rating
- Adds horizontally padded, vertically padded menu item variations to allow menu items to remove padding
- Added fixes to tabular menu especially with attached content
- UI Loaders now positioned automatically in all circumstances, even with long text
- Connected items no longer assume 3 items per row
- Fixes display of left corner icon labels
Updates
- Updated documentation for sidebar, transition, and form validation
- Updated list docs
- Accordion settings documentation
- Rating settings documentation