Framework7 Release Notes
8.3.0 (2023-08-18)
Bug Fixes
- popup: fix wrong popup push position on top of tablet-full-screen push popup (41def46)
- popup: prevent swiping popup when swiping over enabled sortable (9673b0b)
- router: fix props not passed to
openIn
components (c609439), closes #4215 - sheet: prevent swiping sheet when swiping over enabled sortable (c92ad63)
Features
- sheet: new feature to configure opened breakpoints (3ec8cc1)
- svelte: types reworked for Svelte 4 (#4216) (31b94b0)
- swiper: update swiper to latest 10.2.0 (957fa87)
- update to latest Swiper (b9afba6)
8.2.0 (2023-07-06)
Bug Fixes
- inputs: fixed outline input without label misalignment (81d2757)
- list-view: add "list" slot in Vue component (f4b24bc), closes #4201 #4195
Features
- panel: limit resizable to max 100% width and support resizable floating panels (27ae4e1)
- swiper: update to Swiper v10 (b6cb30a)
8.1.0 (2023-06-12)
Bug Fixes
- calendar: fix range styles if same day selected (84eaf76), closes #4191
- core: hide scrollbar where required in FireFix (f4c4c7e), closes #4189
- core: translucent now applies in iOS theme not depending on iOS device (06b8970)
- messagebar: fix
textareaId
to be passed to textarea element (b3b10b2) - panel: fix panel closed without transition when opened with swipe (be8492c)
- popover: fix ignored
arrow
prop in Popover components (feaa823) - progressbar: fix wrong style applied in Svelte component (4604b1f), closes #4183
- router: fix for correct navigate if used route path format like
/:optionalParam(any+[regexp]+)?
(#4179) (6d40482) - router: fix routable modal destroy if modal route has
async
prop (1234e78) - searchbar: remove unused clear button layer (4e13c36)
Features
- list-index: tweak label colors in MD theme (b797d9b)
- notification: increase notifiaction transition duration and paddings in MD theme (27f211e)
- picker: full width single column picker scrolling (04ca371)
- pull-to-refresh: tweak md colors (b014a34)
8.0.5 (2023-05-08)
Bug Fixes
8.0.4 (2023-05-03)
Bug Fixes
- area-chart: fix tooltip label color in MD theme (5d87626)
- button: fix iOS outline button color (59674be), closes #4169
- chip: fix chip media margin in iOS theme (34f4c28)
8.0.3 (2023-04-17)
Bug Fixes
- core: correct colors inheritance in nested dark mode (e4f0ddc), closes #4165
- core: prevent handling of not trusted touch events (3ea9ac5), closes #4164
- input: fix datetime-local input width (6253c6c)
8.0.2 (2023-04-12)
Features
- app: add
overscroll-behavior: none;
tohtml
(caa3e78), closes #4048 - dialog: tweak placeholder colors (dfadb8d)
- fab: tweak FAB md3 styles and colors (e50a375)
- input: tweak placeholder colors (50d8fb8)
- messagebar: tweak placeholder colors (29849ff)
- searchbar: tweak placeholder colors (f8168a0)
- text-editor: tweak placeholder colors (490c23a)
8.0.1 (2023-04-06)
Bug Fixes
- data-table: detach events on destroy (396fdac)
Features
- core: prevent page scrolling during custom page transitions (6453249)
- icon: add class to Icon also specified in
icon
prop (42b56fa) - touch-ripple: use blurred ripple wave on photo browser toolbar (02b08b6)
- update vue web types (ee8c71d)
8.0.0 (2023-04-03)
Core
- All new Material Theme with Material You design
- All new color theming options and parameters
- Removed Aurora theme
- Removed Elevation, Lazy, Menu, Appbar, Request components and modules
- Removed browser lazy components from package
Photo Browser
- added new swipeable thumbs functionality
Swiper
- updated to all new Swiper v9 with Swiper Element which is now used in Swipeable Tabs
- removed Swiper components from Framework7 React, Vue, Svelte - use Swiper Element instead
Grid
- New simplified grid layout and sizes
- Resizable grid functionality has been removed
Inputs
- Removed inline labels styles
- Removed expandInput functionality in Autocomplete
List
- Removed list item cell & row components and elements
- List styling now has addition
outline
,strong
,dividers
classes / props
Router
- Removed
stackPages
functionality
Tabs
- Swipeable tabs now use
<swiper-container>
Bug Fixes
- photo-browser: fix
touch-action
rules (5850615) - vue: accept
unloadTabContent
param on View (24025a5), closes #4149 - svelte: fix swipeable tabs (9476c6a)
- vue: support for component props defined as array (d5c70e4)
- router: don't try to find route with empty path (4e4ccad)
- smart-select: fix smart select styles (a014cbb)
- fix iOS preloader color (6d3c557)
- smart-select: update lists styles (70bfcd9)
- core: fix issue with custom page transitions (933db6f)
Features
- remove link highlights in MD theme, use only touch ripple (e96f363)
- actions: fix actions position padding in md theme with safe areas (4d34afd)
- core: tweak touch ripple (4419887)
- searchbar: full height expandable with top safe areas (87bcf59)
- touch-ripple: tweak touch ripple appearance (a861e12)
- core: add new router component
$useState
method (677af59) - photo-browser: add new swipeable Thumbs (d3313d6)
- remove
colorTheme
prop in React, Vue, Svelte components (90ecff6) - app: remove
id
,version
,language
app params and properties (1b5ffd6) - app: remove
id
,version
,language
app params and properties (da6e5ae) - popover: rename
angle
toarrow
(fb9867f) - searchbar: rename
hideDividers
->hideGroupTitles
(24e76c1) - tabs: use Swiper Element for swipeable tabs (d3bd0df)
- typography: remove
no-hairline
helper classes (8b10c00) - timeline: new syntax for timeline cols (ce58827)
- checkbox: allow to set checkbox icon position - start or end (db9d799)
- core: remove Core JS lazy modules (25a9c8e)
- smart-select: allow to specify input icon position (68a9fbc)
- svelte: export
style
prop for modals (65ecc23), closes #4100 - swiper: remove support for auto init with "swiper-init" in favor of Swiper custom element (35367f8)
- swiper: remove Swiper components export in React, Svelte & Vue in favor of Swiper Custom Element (344c557)
- actions: Material You styles, rename
bold
->strong
button (d6a4718) - autocomplete: Material You styles, remove
expandInput
functionality (7af373d) - badge: Material You styles (5ca6a50)
- block: Material You styles, new
outline
style (7f7cbe2) - block: support for
-inset-[ios|md]
classes + similar components props (908ca12) - block: support theme-specific
block-strong-[ios|md]
states (75563ce) - breadcrumbs: Material You styles (d854233)
- button: Material You styles (fd4e1f9)
- button: new
tonal
buttons (32daed7) - calendar: Material You styles (2cc67b8)
- calendar: Material You styles (8abf7df)
- card: Material You styles, new
outline
andraised
styles (21a051e) - chip: Material You styles (651406e)
- color-picker: Material You styles (b8a9eee)
- contacts: Material You styles (ab3d5a9)
- contacts-list: Material You styles (6f35c10)
- core: remove Menu components (use Popovers instead) (cf2bb67)
- core:
modal.open
accepts secondforce
argument (99f0267) - core: move
no-hairline
classes to common typography, replace noHairline components prop withoutline
(ca7e2c9) - core: move colors definitions to client side with new
colors
parameter andapp.setColorTheme
method (30c38b8) - core: new Material You colors system.
colorThemeCSSProperties
util now return object withcommon
,light
anddark
vars (9fb8b3a) - core: new page transitions in MD theme (b050a88)
- core: remove
stackedPages
router functionality (6c2e624) - core: remove Appbar module/component (98285ca)
- core: remove bars shadows in MD theme (f14b30f)
- core: remove Elevation module (780783b)
- core: remove Lazy component, use native
loading="lazy"
instead (515a170) - core: remove Request module in favor of native
fetch
(0a9f0a7) - core: rename
autoDarkMode
parameter todarkMode
which accepts false, true or 'auto', addsetDarkMode
app method (8759957) - data-table: Material You styles (ff86338)
- dialog: Material You styles + rename
bold
->strong
button (fa37aee) - fab: Material You styles (6f91229)
- grid: rework Grid module to use actual CSS grid, remove resizable grid (8381a75)
- input: remove inline style inputs (1d06525)
- inputs: Material You styles (3eb25e7)
- list: introduce
list-dividers
classes and props to enable/disable dividers between items (07a9420) - list: Material You colors, unify item-divider -> list-group-title (9ec6aae)
- list: Material You styles + new
outline
andstrong
states + support theme specificinset
props and classes (fae5446) - list: remove ListItemRow and ListItemCell components (c5ed84b)
- list: support
label.item-content
as activable element (e4cb150) - login-screen: Material You styles (accc5e5)
- menu-list: Material You styles (67a7aa2)
- messages+messagebar: Material You styles (1757396)
- navbar: Material You style navbar (c9b7519)
- notification: Material You styles (d68621d)
- panel: Material You styles + remove panels shadows (a67c370)
- panel: new
floating
panel effect (45b6b89) - photo-browser: Material You styles (f065f63)
- photo-browser: update to latest Swiper (b8dbe29)
- picker: Material You styles (2135524)
- popover: Material You styles, new
angle
(corner) parameter (b6ebbe3) - popup: Material You styles (9ece196)
- popup: use
push
effect even if no safe areas detected (da356cb) - range: Material You styles (6bb3df2)
- searchbar: Material You styles (f2d47c6)
- sheet: Material You styles (fd17aed)
- sheet: use
push
effect even if no safe areas detected (5fd5130) - sortable: Material You styles (4012322)
- stepper: Material You styles (e1fe169)
- subnavbar: Material You styles (8b8e152)
- swipeout: Material You styles (d85d591)
- swiper: update to latest Swiper 9 (03fa5d9)
- tabbar: Material You styles + rename
tabbar-labels
->tabbar-icons
(fbd07b0) - tabs: update to latest Swiper (1e82bf4)
- text-editor: Material You styles (357b1d5)
- timeline: Material You styles (a09698d)
- toast: Material You styles (bb09829)
- toggle: Material You styles (82c91d8)
- tooltip: Material You styles (e80fbb2)
- remove Aurora theme (a9de963)
7.1.4 (2023-02-02)
Bug Fixes
- panel: fix panel close routine if it was closed immediately (#4127) (74aa9d8), closes #4108
- popover: disable safe areas in popover (5d5bce6)
- router: keep router props history if page was loaded with passed
props
(5ad3d8a) - svelte: fix custom icon classes (06b406c), closes #4126
7.1.2 (2023-01-18)
Bug Fixes
- dialog: remove margin-left on vertical buttons (2645067), closes #4118
- picker: fixed issue with scrolling on chrome (816898d)
- router: initial url in somecase (#4122) (fe800cf)
- types: add notification
render
method arguments (#4117) (2d17f7a)
Features
- photo-browser: disable Swiper's CSS mode by default (def98a1)
7.1.1 (2022-12-16)
Bug Fixes
- core: reset allowPageChange after duplicated async back navigation (#4111) (#4112) (273c94c)
- panel: fix panel close routine if it was closed immediately (1ceaafc), closes #4108
Features
- photo-browser: add
closeByBackdropClick
parameter (8d34259), closes #4107 - remove postinstall script (92fd6e5)
- router: add
props
support torefreshPage
method (e6fc0c0), closes #4103 - smart-select: add
closeByBackdropClick
parameter (66d899b), closes #4107 - smart-select: support return for HTML in
formatValueText
(90ff029), closes #4094 - svelte: export
style
prop for modals (ddf8b36), closes #4100
- update Swiper to latest (405ea88)
7.0.9 (2022-11-21)
Bug Fixes
Features
- vue: update web types (53b1663)
7.0.8 (2022-09-14)
Bug Fixes
- core: export internal $jsx helper for lazy components (c2a2213), closes #4072
- panel: don't process backdrop if disabled (c01b23c), closes #4069
- swiper: fix if loaded as lazy component (32f3be9), closes #4073
Features
- core: expose
Framework7.parseComponent
(7b0aea0)
7.0.7 (2022-07-15)
Bug Fixes
7.0.6 (2022-07-14)
Bug Fixes
- core: fix core components types file not found in typescript when import (#4059) (1886a76)
- core: fix getWindow/Document getters in lazy components (41a7c50), closes #4052
- panel: fix closeByBackdropClick ignored on instance (48e966f)
Features
- svelte: searchbar: add html attributes auto-complete/correct/capitalize fixes (d5934d6)
7.0.5 (2022-05-31)
Bug Fixes
- core: fix and export framework7-bundle.less (#4041) (7b7ab14)
- react: make children prop explicit for react 18 support (#4040) (3a87831)
- svelte: add export props interface svelte fixes #4023 (#4042) (c27ddbd)
- svelte: fix ListInput as TextEditor value handling (03c3644)
7.0.4 (2022-05-25)
Bug Fixes
- smart-select: use removeDiacrotics in virtual list search (2e2305f)
Features
- popover: new
verticalPosition
parameter to force popover vertical positioning (27774e2)
7.0.3 (2022-05-16)
Features
- add
shared/
exports to vue/react/svelte packages (2bab4a1), closes #4017 - core: expose access to $jsx as Framework7.Component.$jsx (f1b4474)
- react: add export for props interface (#4023) (565ec60)
7.0.2 (2022-04-24)
Bug Fixes
- data-table: fix missing Aurora theme styles (d81eddb)
- router: fix not resetting root url to '/' (1dee4e8), closes #4004
- types: remove reference to
types
folder (197b163)
7.0.1 (2022-04-15)
Bug Fixes
- calendar: fix scrolling on mobiles in calendar pickers (ede596d)
Features
- swiper: update Swiper to latest fixes Photo Browser (65f5085)
[7.0.0] (2022-04-15)
Bug Fixes
- svelte: reuse original Framework7 instance (feda228), closes #3993 #3992
- core: fix component types (249f54c), closes #3997
- preloaded: set initial position to 0 for iOS preloader (#4002) (76e8ef0)
- react: fix Actions and Range types (5c3087c), closes #3997
- use file extensions in all imports (f85d52f)
- vue: fix missing imports extensions (3692e28)
- calendar: don't close sheet calendar on picker popover click (f562972)
- calendar: fix invisible calendar popover on iOS (f10e7e5)
Features
virtual-list: support virtual items auto height (c62d15d)
view: new
initRouterOnTabShow
parameter to load view router only on tab show (0a67569)calendar: month picker as popover (c1cb89f)
calendar: tweak design + time picker as popover (d2cf190)
calendar: year picker as popover (1e90d9a)
core: new breadcrumbs component (acf187c)
modals: support unique backdrop for Popup, Sheet, Actions and Popover (df514dc)
picker: reworked with native CSS Scroll Snap API (b6c4691)
popover: allow popovers to be stacked (3485834), closes #3959
react: new breadcrumbs component (49e8f35)
router:
browserHistoryTabs
parameter to define how to handle routable tabs in history (push or replace) (e957101)svelte: new breadcrumbs component (aa74c25)
vue: new breadcrumbs component (b63676d)
use
.lazy
prefix for browser loaded JS lazy components (d419269)update Swiper to latest v8 (1ae7f90)
update Swiper and Skeleton Elements to latest (947529e)
use new dark classes in Kitchen Sink (f61cace)
core: rename "theme-dark" class for dark mode to "dark" (8144a59)
core: rename dark mode params, props, events and methods (e283e8b)
react: rename components
themeDark
prop todark
(0dd8967)react: support
open-in
functionality with react components router (8894a77)router: move
open-in
functionality to component router (7877e59)svelte: rename components
themeDark
prop todark
(f75b582)svelte: support
open-in
functionality with svelte components router (e03477e)vue: rename App's prop
autoDarkTheme
toautoDarkMode
(0be0730)vue: rename components
themeDark
prop todark
(1b857bf)vue: support
open-in
functionality with vue components route (6610feb)framework7-core: move to pure ES module package (3549b76)
framework7-react: move to pure ES module package (6abf98a)
framework7-svelte: move to pure ES module package and keep only .svelte components (74b8e4d)
framework7-vue: move to pure ES module package (e9adee6)
increase build target to more modern browsers (5efd721)
photo-browser: enables cssMode by default for iOS and Android devices (d6cb8e3)
6.3.17 (2022-04-11)
Bug Fixes
- core: fix component types (249f54c), closes #3997
- preloaded: set initial position to 0 for iOS preloader (#4002) (76e8ef0)
- react: fix Actions and Range types (5c3087c), closes #3997
7.0.0-beta.11 (2022-02-17)
Bug Fixes
- calendar: don't close sheet calendar on picker popover click (f562972)
- calendar: fix invisible calendar popover on iOS (f10e7e5)
Features
- calendar: month picker as popover (c1cb89f)
- calendar: tweak design + time picker as popover (d2cf190)
- calendar: year picker as popover (1e90d9a)
- core: new breadcrumbs component (acf187c)
- modals: support unique backdrop for Popup, Sheet, Actions and Popover (df514dc)
- picker: reworked with native CSS Scroll Snap API (b6c4691)
- popover: allow popovers to be stacked (3485834), closes #3959
- react: new breadcrumbs component (49e8f35)
- router:
browserHistoryTabs
parameter to define how to handle routable tabs in history (push or replace) (e957101) - svelte: new breadcrumbs component (aa74c25)
- vue: new breadcrumbs component (b63676d)
- update Swiper to latest v8 (1ae7f90)
7.0.0-beta.10 (2021-10-28)
Features
- update Swiper and Skeleton Elements to latest (947529e)
7.0.0-beta.8 (2021-10-13)
7.0.0-beta.6 (2021-10-13)
Bug Fixes
- vue: fix missing imports extensions (3692e28)
7.0.0-beta.5 (2021-10-13)
Bug Fixes
- use file extensions in all imports (f85d52f)
7.0.0-beta.4 (2021-10-05)
Features
- use
.lazy
prefix for browser loaded JS lazy components (d419269)
7.0.0-beta.3 (2021-10-05)
Features
- use new dark classes in Kitchen Sink (f61cace)
- core: rename "theme-dark" class for dark mode to "dark" (8144a59)
- core: rename dark mode params, props, events and methods (e283e8b)
- react: rename components
themeDark
prop todark
(0dd8967) - react: support
open-in
functionality with react components router (8894a77) - router: move
open-in
functionality to component router (7877e59) - svelte: rename components
themeDark
prop todark
(f75b582) - svelte: support
open-in
functionality with svelte components router (e03477e) - vue: rename App's prop
autoDarkTheme
toautoDarkMode
(0be0730) - vue: rename components
themeDark
prop todark
(1b857bf) - vue: support
open-in
functionality with vue components route (6610feb)
7.0.0-beta.2 (2021-10-04)
Features
- core: update Skeleton Elements to latest v4 (5ee286d)
- core: update Swiper to latest v7 (6eee6b7)
- core: update Swiper to latest v7 (9bd6f48)
- framework7-core: move to pure ES module package (3549b76)
- framework7-react: move to pure ES module package (6abf98a)
- framework7-svelte: move to pure ES module package and keep only .svelte components (74b8e4d)
- framework7-vue: move to pure ES module package (e9adee6)
- increase build target to more modern browsers (5efd721)
- photo-browser: enables cssMode by default for iOS and Android devices (d6cb8e3)
7.0.0-beta.1 (2021-10-04)
Features
- core: update Skeleton Elements to latest v4 (5ee286d)
- core: update Swiper to latest v7 (6eee6b7)
- core: update Swiper to latest v7 (9bd6f48)
- framework7-core: move to pure ES module package (3549b76)
- framework7-react: move to pure ES module package (6abf98a)
- framework7-svelte: move to pure ES module package and keep only .svelte components (74b8e4d)
- framework7-vue: move to pure ES module package (e9adee6)
- increase build target to more modern browsers (5efd721)
- photo-browser: enables cssMode by default for iOS and Android devices (d6cb8e3)
6.3.16 (2022-02-10)
Bug Fixes
- list-index: fix types for
indexes
param (e94bb2b), closes #3970 - popup: types for
containerEl
prop (a06e3aa) - router: don't call enter/leave for stacked page preload (56765e5)
- router: don't call enter/leave for stacked page preload (d9416ef), closes #3975
- types: add missing params to notification and toast open/close methods (50b1504)
6.3.15 (2022-01-19)
Bug Fixes
- progressbar: tweaked styles for RTL (6f6167c)
6.3.14 (2021-12-30)
Bug Fixes
- vue: fix
sortableMove
event arguments (#3965) (8e716f7) - vue: fix textEditor events arguments (e6a3218)
6.3.12 (2021-12-13)
Bug Fixes
- calendar: remove
ζ₯
char from calendar days for Chinese locale (5f595f2), closes #3960 - popup: add
pointer-events: none
topopup-behind
state (246e737) - range: add missing type definitions (#3961) (d3bc1b4)
Features
- tabbar: allow tabbar to have highlight in iOS theme with extra
tabbar-highlight
class (3a141ad)
6.3.11 (2021-12-08)
Bug Fixes
- sortable: unify
sortableMove
arguments (a17bd83)
6.3.10 (2021-12-08)
Bug Fixes
- vue: fix
web-types
path (6fe117a)
Features
- sortable: new
sortableMove
event to trigger during sortable item drag (ae055b2)
6.3.9 (2021-11-18)
Bug Fixes
6.3.8 (2021-11-08)
Bug Fixes
- react: fix not working correctly change event with swipe (9888e16)
- svelte: method to get Smart Select instance in Link component (558b629), closes #3954
Features
- vue: add web-types for JetBrains editors (f2bd8f9)
6.3.7 (2021-10-28)
Bug Fixes
- gauge: fix update method types (f1b75d5), closes #3950
- searchbar: searchByItem to use current
vl.items
(68e4a09), closes #3948
Features
- vue: reactive
closeByBackdropClick
,closeByOutsideClick
andcloseOnEscape
props in Sheet component (db21896), closes #3949
6.3.6 (2021-10-25)
Bug Fixes
- svelte: fix swipe-to-step behavior in Sheet component (6e0fa74)
6.3.5 (2021-09-30)
Bug Fixes
- list-input: don't ignore sortable=false props in React, Vue, Svelte components
- list-item: don't ignore sortable=false props in React, Vue, Svelte components
Features
- component: new
$ref
function to create reactive variables (108b63b)
6.3.4 (2021-09-16)
Bug Fixes
- actions: bypass
containerEl
parameter when opened in Popover (05ad92c) - smart-select: fix
scrollToSelectedItem
in popover (84b552a)
Features
- router component: add support for fragments
<>...</>
in JSX templates (5c2ac50)
6.3.3 (2021-09-07)
Features
- progressbar: tweak iOS progressbar size to match iOS 15 (88f002a)
6.3.2 (2021-08-31)
Bug Fixes
6.3.1 (2021-08-23)
Bug Fixes
- vue: fix vue typings for Swiper and Skeleton Elements (6c37be6)
6.3.0 (2021-08-16)
Bug Fixes
- picker: prevent closing picker on backdrop drag click (7abae46)
- popover: prevent closing popover on backdrop drag click (fef522e)
- pull-to-refresh: fix ptr-closing class removal (93951d2)
- svelte: fix duplicated export in typings (1ed6d4b)
Features
- pull-to-refresh: new system-like PTR behavior in iOS theme (14a9c14)
6.2.0 (2021-08-02)
Bug Fixes
- navbar: don't scroll page top on navbar title's click when clicked on
<a>
and<button>
(2d78b63) - stepper: allow to enter negative numbers in manualMode (94aec9e), closes #3933
- svelte: fixed not working LoginScreen events (5ae9b47), closes #3934
Features
- checkbox: black checkbox icon in dark theme (fd3c3ff)
- checkbox: update iOS checkbox icon to match iOS 15 look (ac5b5ee)
- panel: new
push
effect (6216d11) - radio: update iOS radio icon to match iOS 15 look (a6c4bb4)
- range: tweak Range Slider styles to match iOS 15 look (cdf7fe5)
- segmented: swipeable segmented strong in iOS theme (29906e4)
- touch: swipeable/activable Dialog and Actions buttons in iOS theme (25a07ef)
6.1.1 (2021-07-26)
Bug Fixes
- router: fixed issue with removing routable modals specified with
asyncComponent
(bbde9c5)
6.1.0 (2021-07-26)
Bug Fixes
- svelte: fix hidden initial breakpoint panel (b9ab2c8), closes #3824
- svelte: ignore some predefined rest props (5c4ea26)
- svelte: use native svelte $$slots for slots detection (fd0ed52)
- gauge: fix typed in
gaugeBeforeDestroy
event (efbe583), closes #3919 - swipeout: check if event is cancelable before preventDefault (c62b7f8), closes #3921
- get-device: allow recognition of Chrome's Android emulator on Windows as android (008bf32)
- react: display error when errorMessageForce is set on Input component (e303b60)
- svelte: display error when errorMessageForce is set on Input component (13ebe86)
- types: fixed default value description for Dialog
closeByBackdropClick
parameter (62ea344), closes #3917 - vue: display error when errorMessageForce is set on Input component (741261e)
- types: fixes for cases when
el
parameter also can be a CSS Selector (1bdf2da)
Features
- core: refactor LESS imports to be compatible with Vite (7e5b81d)
- svelte: TypeScript definition for all Svelte components (3033b3d), closes #3912
- text-editor: new
insertLink
andinsertImage
events to post-process added links and images (a57301b), closes #3903 - vue: TypeScript definition for all Vue components (b6d599a)
- svelte: core component instance is now exposed through slot props (6029fd1), closes #3899
- svelte: add .svelte components to the package (a8f3913)
6.1.0-beta.7 (2021-07-23)
Features
- core: refactor LESS imports to be compatible with Vite (7e5b81d)
6.1.0-beta.6 (2021-07-19)
Bug Fixes
- gauge: fix typed in
gaugeBeforeDestroy
event (efbe583), closes #3919 - swipeout: check if event is cancelable before preventDefault (c62b7f8), closes #3921
6.1.0-beta.5 (2021-07-15)
Features
6.1.0-beta.3 (2021-07-14)
Bug Fixes
- get-device: allow recognition of Chrome's Android emulator on Windows as android (008bf32)
- react: display error when errorMessageForce is set on Input component (e303b60)
- svelte: display error when errorMessageForce is set on Input component (13ebe86)
- types: fixed default value description for Dialog
closeByBackdropClick
parameter (62ea344), closes #3917 - vue: display error when errorMessageForce is set on Input component (741261e)
Features
- text-editor: new
insertLink
andinsertImage
events to post-process added links and images (a57301b), closes #3903 - vue: TypeScript definition for all Vue components (b6d599a)
6.1.0-beta.2 (2021-07-08)
Bug Fixes
- types: fixes for cases when
el
parameter also can be a CSS Selector (1bdf2da)
Features
6.1.0-beta.1 (2021-07-08)
Features
- svelte: add .svelte components to the package (a8f3913)
6.0.22 (2021-06-25)
Bug Fixes
- react messages: consider scrollMessagesOnEdge when scrolling (05dba19), closes #3908
- svelte messages: fix missing
.instance()
component prop (e156acc), closes #3905 - vue: fixes ignored Preloader
size
prop (2cb535c) - vue messages: consider scrollMessagesOnEdge when scrolling (110638e)
6.0.21 (2021-06-09)
Bug Fixes
- router: correctly track DOM changes in React, Vue and Svelte components router (3f96bf1)
- smart select: mark
el
parameter optional for compatibility withsmartSelectParams
(39a0cbf), closes #3902 - store: fixed lost reactivity in core components store (2af3355)
6.0.20 (2021-06-07)
Bug Fixes
- react store: fixed issue with race-conditions in store updates (40f4818)
- react tabs: fix issue when initial tabShow event not catched (b3e1dd0)
- router: correctly bypass
route.tab.options.props
to tab component (f3326e2) - router: routable Tab now inherits parent route
options.props
(a9e32af)
6.0.19 (2021-05-31)
Bug Fixes
- router: fix for routable swipeable tabs (c0c6414)
v6.0.18 (2021-05-28)
Bug Fixes
- navbar: added missing TS events definitions (3bc1eb2), closes #3895
- navbar: fixed issue with large navbar scroll-hide on insufficient page scroll (0b5e4ab)
- panel: added
containerEl
typing to props in React component (da5b38f), closes #3892 - panel: fix not emitting
collapsedBreakpoint
event (03e661f), closes #3887 - router: components router fix when view component updated triggered by something else (df64010)
- router: don't set initial page component if it is master's detail page (9e4e264)
- router: fixed issue for routable swipeable tabs with dynamic params in route path (4a93d90)
- toolbar: added missing TS events definitions (d0afb69)
Features
- smart select: new
sheetBackdrop
parameter to control Sheet backdrop (0d2f60f) - swiper: Swiper updated to latest version (9d30e4b)
v6.0.17 (2021-04-30)
Bug Fixes
- device: fix iPhone detection on FireFox iOS (840503e), closes #3876
- modals: fixed issue when initially opened modal closed without animation (e2cff56)
- svelte: fix value of
textEditorChange
event in ListInput (4e1d26f), closes #3879 - fix missing method definitions for sheet step methods (73167fb)
v6.0.16 (2021-04-16)
Bug Fixes
- core messages: fixed issue with
attrs
in.addMessage
method (da027b9) - react: fix events to be reactive in Range, Stepper and Toggle (53c5be5), closes #3872
- vue: fixed issue with wrong
page-with-subnavbar
class
v.6.0.15 (2021-04-09)
Bug Fixes
- react: fix events to be reactive in Actions, LoginScreen, Panel, Popover, Popup, Sheet (8799b44)
v6.0.14 - March 22, 2021
Bug Fixes
- core: fixed
.less
division widths/heights - react: fixed typing for Progressbar
- text editor: fixed wrong keyboard toolbar dark theme detection
v6.0.12 - March 5, 2021
Bug Fixes
- core: typings for
f7.online
(259c91e), closes #3825 - react: add typings for React components
ref
s (3ecadc2), closes #3827 - react: fix smart select lifecycle hooks (d40b13f)
Features
- calendar: new
calendar.allowTouchMove
boolean property to toggle touchmove interactions (a58ef12)
v6.0.11 - February 24, 2021
Bug Fixes
- components: fixed issue with keepAlive not working correctly for initial page routes (171ca2a)
- store: fixed issue with wrong getter value after state update (11ac753)
v6.0.10 - February 18, 2021
Bug Fixes
- components: fix theme detection for initial page (cf53ba3)
- svelte: proper CJS components in package (63032e3)
v6.0.9 - February 18, 2021
Bug Fixes
- photo browser: fixed issue with not working swipe to close (1e3bcbc)
Features
- swiper: update Swiper to latest 6.4.15 (b2274a1)
v6.0.8 - February 16, 2021
Bug Fixes
- components: better SSR support (0e7b9e8)
- core: allow to init Framework7 more than once if runs on server-side (964af1e)
v6.0.7 - February 5, 2021
Bug Fixes
- frameworks: better check if initial route is a Master route (15c16b4)
- frameworks: fixed issue when passed store instance became different in f7.store (b20b05d)
v6.0.6 - January 26, 2021
- Core
- Text Editor
- Fixed "add link" button functionality
- Text Editor
v6.0.5 - January 26, 2021
- Core
- Router Component
- Added support for HTML contents with
innerHTML
attribute/prop
- Added support for HTML contents with
- Router Component
v6.0.4 - January 19, 2021
- Package
- Fixed
postinstall
script
- Fixed
- Vue
- Removed
vue@2
peer dependency - Card
- Fixed rendering of card footer passed by
footer
prop
- Fixed rendering of card footer passed by
- Removed
v6.0.3 - January 11, 2021
- Core
- Added compatibility with latest
less
v4 - Swiper updated to latest v6.4.5
- Added compatibility with latest
- React
- Fixed issue with broken TypeScript declarations on some components
- Minor fixes
v6.0.1 - December 31, 2020
- React/Svelte/Vue
- Fix for getting initial route component
v6.0.0 - December 31, 2020
- Core
- Package
- Renamed files and imports
- Lite version doesn't contain the following components:
- Gauge
- Area Chart
- Pie Chart
- New types module in
framework7/types
- Modules are now babel transpiled
- App Class
- App
root
parameter to pass app root element renamed toel
app.root
property which contains Dom7 instance of app root element has been renamed toapp.$el
property- Removed app
data
andmethods
global app properties in favor of new Store
- App
- Dom7
- Uses new Dom7 v3
- Template7
- Template7 and its support has been completely removed from Framework7
- Request
- Export renamed to
request
- Now it uses only Promises API
- New
request.abortController()
- Export renamed to
- Utils
- Export renamed to
utils
- Removed
removeDiacritics
util
- Export renamed to
- Device
- Export renamed to
device
- Added
getDevice
export
- Export renamed to
- Support
- Export renamed to
support
- Added
getSupport
export
- Export renamed to
- Components
- Actions
- Actions Button text in MD & Aurora theme now uses theme color
- Area Chart
- All new Area Chart component
- Autocomplete
routableModals
is now disabled by default
- Button
- New loading buttons
- Calendar
routableModals
is now disabled by default- New appearance for Range picker selection
- Time Picker now supports AM/PM period selection based on selected locale or timePickerFormat
- New appearance for Time selector link
- Checkbox
- Removed "extra" margin in checkboxes list in MD theme
- Color Picker
routableModals
is now disabled by default
- Dialog
- Added
containerEl
property to specify where to mount the modal
- Added
- Gauge
- Renamed
$gaugeSvgEl
property to$svgEl
- Renamed
- List
- All new Menu List style for List
- List Button text in MD theme now uses theme color
- Menu
- New appearance for dropdown item hover/pressed states
- Page
- New Page Title element
- Panel
- Improved support for nested panels. Now panel can be created and correctly opened inside of the page (including with breakpoints)
- Photo Browser
routableModals
is now disabled by default
- Picker
- New appearance for selected item/row
routableModals
is now disabled by default
- Pie Chart
- All new Pie Chart component
- Popover
- Now it considers safe-areas on positioning
- Popup
- Fixed issue when Push Popup can incorrectly transform View behind on app/window resize/rotate
- Preloader
- Preloader in MD theme now uses new SVG layout
- Preloader in iOS reworked to match iOS 14 appearance
- Preloader in iOS now also supports "multi" color
- Radio
- Removed "extra" margin in radios list in MD theme
- Skeleton Elements
- Used as dependency
- New React, Svelte and Vue components
- CSS vars renamed without
--f7-
prefix
- Smart Select
routableModals
is now disabled by default
- Swipeout
- New
app.params.swipeout.overswipeRatio
(default to1.2
) allows to configure how more to swipe to enable overswipe - Fixed styles to consider left and right safe-areas
- New
- Swiper
- Updated to all new Swiper v6
- Used as dependency
- Text Editor
- New
.clearValue()
method
- New
- Tooltip
- New
containerEl
parameter - New
delegated
parameter. Enables tooltip for all elements matching totargetEl
selector (e.g. attaches event handler to document).targetEl
parameter must be a CSS Selector (string) - New
trigger: 'manual'
value - New
.setTarget(targetEl)
instance method to change tooltip target after it was created
- New
- Touch Ripple
- Highly reworked Touch Ripple effect (used in MD theme by default)
- New
app.touch.touchRippleInsetElements
parameter to specify elements with inset touch ripple
- Virtual List
itemTemplate
parameter has been removed with removal of Template7
- Actions
- View/Router
pushState...
parameters renamed tobrowserHistory...
- New
browserHistoryInitialMatch
parameter - Now
reloadDetail
will remove all detail pages in master-detail layout between master and new detail page - Route's
master
property that indicates whether it is a master route or not now can be a method that receives(f7, router)
(app and router instances) and should return boolean. - Route's
beforeEnter
,beforeLeave
,redirect
andasync
methods now receive a single object with following propsto
from
resolve
reject
direction
(new in v6 - can beforward
orbackward
)router
(new in v6 - current router instance)app
(new in v6 - f7 app instance)
- Now it is possible to specify how to open page route with
data-open-in
attribute, e.g.<a href="/about/" data-open-in="popup">About</a>
- Route's
options.context
property has been removed - Route's
template
andtemplateUrl
properties have been removed with removal of Template7 - All new Router component
- Uses ES templates instead of Template7 templates
- Removed scoped styles
- Simplified component declaration to be a simple function
- Can be used with JSX syntax
- Store
- All new Store library for application state management
- Capacitor
- Added support for core APIs when app running under Capacitor environment (core Statusbar methods, automatic disabling of service workers and router browser history, etc.)
- Package
- React
App
component now receives all app parameters as props- React components rewritten with hooks
- Removed all prototypes methods (
$$
,$f7
,$f7ready
,$f7route
,$f7router
,$utils
,$device
,$theme
,$request
)- Now they should be imported as
import {f7, f7ready, theme} from 'framework7-react'
.Dom7
,device
,request
can be used asf7.
accessors or imported fromframework7
- Now they should be imported as
- Removed
umd
version
- Vue
- Rewritten to new Vue v3 API (no Vue v2 support anymore)
App
component now receives all app parameters as props- Removed all prototypes methods (
$$
,$f7
,$f7ready
,$f7route
,$f7router
,$utils
,$device
,$theme
,$request
)- Now they should be imported as
import {f7, f7ready, theme} from 'framework7-vue'
.Dom7
,device
,request
can be used asf7.
accessors or imported fromframework7
- Now they should be imported as
- Removed
umd
version - Added
v-model
support- Checkbox, ListItem, Radio, Toggle, MessagebarSheetImage
- Support for
v-model:checked
- Support for
- Actions, LoginScreen, Panel, Popover, Popup, Sheet
- Support for
v-model:opened
- Support for
- Card
- Support for
v-model:expandableOpened
- Support for
- Input, ListInput, Messagebar, Searchbar, Stepper, Range
- Support for
v-model:value
- Support for
- Checkbox, ListItem, Radio, Toggle, MessagebarSheetImage
- Svelte
App
component now receives all app parameters as props- Added
bind:$property
support- Checkbox, ListItem, Radio, Toggle, MessagebarSheetImage
- Support for
bind:checked
- Support for
- Actions, LoginScreen, Panel, Popover, Popup, Sheet
- Support for
bind:opened
- Support for
- Card
- Support for
bind:expandableOpened
- Support for
- Input, ListInput, Messagebar, Searchbar, Stepper, Range
- Support for
bind:value
- Support for
- Checkbox, ListItem, Radio, Toggle, MessagebarSheetImage
- Common for React/Svelte/Vue
- Button, Link, ListButton, ListItem, MenuDropdownItem, MenuItem, TreeviewItem
- New
openIn
prop to specify how to open page route (e.g. open page aspopup
,sheet
,panel
etc)
- New
- Area Chart
- New Area Chart component
- Button
- Support for loading button (button with preloader) with new props:
preloader
- enables button to have preloaderloading
- controls button state to show/hide preloader and hide/show button text (switch button to loading state)preloaderColor
- button's preloader colorpreloaderSize
- button's preloader size
- Support for loading button (button with preloader) with new props:
- Input
- Added
error-message
slot
- Added
- List
- New
menuList
boolean property to enable menu List
- New
- ListItem
- New
selected
boolean property to mark menu list item as selected
- New
- MenuItem
- Added support for tooltip with
tooltip
andtooltipTrigger
props
- Added support for tooltip with
- Messagebar
- Removed component methods
- Messages
- Removed component methods
- Added
typing
prop
- Panel
- Removed component
open
/close
methods
- Removed component
- Pie Chart
- New Pie Chart component
- Popover
target
prop renamed totargetEl
- Popover, Login Screen, Actions, Sheet
- Added
animate
property - Removed component open/close methods
- Added
containerEl
property to specify where to mount the modal
- Added
- Sheet
- Added
fixed
andstatic
slots
- Added
- Toggle
- Added support for tooltip with
tooltip
andtooltipTrigger
props
- Added support for tooltip with
- Button, Link, ListButton, ListItem, MenuDropdownItem, MenuItem, TreeviewItem
v5.7.14 - November 9, 2020
- Core
- Types fixes (#3759, #3758)
- Calendar
- Minor fixes updating selected value (#3761)
- React
- Removed React 16 peer dependency (to be compatible with React 17)
v5.7.13 - October 9, 2020
- Core
- Router
- Fixed swipe-back issues on iOS 14
- Device
- Fixed iOS detection for newest iPads
- Router
- Svelte
- ListInput, Input
- Fixed not working TextEditor events
- LoginScreen
- Fixed not working events
- ListInput, Input
- Lots of docs and Kitchen Sink typos fixes by @DAnn2012
v5.7.12 - September 3, 2020
- Core
- Autocomplete
- Added
searchbarSpellcheck
parameter to enable/disable spell check on searchbar's input. Disabled by default
- Added
- Panel
- Now accepts new
containerEl
parameter to be able be mounted to other element rather than root
- Now accepts new
- Smart Select
- Added
searchbarSpellcheck
parameter to enable/disable spell check on searchbar's input. Disabled by default
- Added
- Autocomplete
- React/Svelte/Vue
- Searchbar
- Added
spellcheck
prop to setspellcheck
attribute on input element
- Added
- ListInput
- Fixed not working
onTextEditorChange
prop in Svelte component
- Fixed not working
- Minor fixes
- Searchbar
v5.7.11 - August 17, 2020
- Core
- Gauge
- Fixed issue when gauge text wasn't appear on update
- Router Component
- Fixed issue when empty
value
attribute was removed on<option>
element
- Fixed issue when empty
- Gauge
- Svelte
- List
- Fixed issue with not working
sortableSort
event
- Fixed issue with not working
- List
v5.7.10 - July 14, 2020
- Core
- Tooltip
- Fixed issue with positioning for SVG elements
- Tooltip
v5.7.9 - July 12, 2020
- Core
- Router Component
- Fixed issue with multiple event handler arguments
- Searchbar
- Not it won't scroll page on expandable open when navbar large collapsed
- Treeview
- Changed style to use/set item
min-height
instead ofheight
- Changed style to use/set item
- View
- Now it will be also auto initialized on dynamically created panel open
- Minor fixes
- Router Component
v5.7.8 - June 13, 2020
- Core
- Card
- Expandable card now has
user-select: none
when it is closed
- Expandable card now has
- Router Component
- Fixed issue with parsing scoped styles that have
"{"
content
- Fixed issue with parsing scoped styles that have
- Card
- React/Svelte/Vue
- Badge
- Added support for Tooltip with
tooltip
andtooltipTrigger
props
- Added support for Tooltip with
- Chip
- Added support for Tooltip with
tooltip
andtooltipTrigger
props
- Added support for Tooltip with
- Badge
- Minor fixes
v5.7.7 - June 5, 2020
- React/Svelte/Vue
- ListInput
- Fixed issue with infinite loop when updating
calendarParams
- Fixed issue with infinite loop when updating
- Stepper
- Auto update stepper internal value on
value
prop update
- Auto update stepper internal value on
- ListInput
- Minor Fixes
v5.7.6 - June 1, 2020
- Core
- Range slider
- Fix for better handling touch events on Windows
- Router
- Fixed issue with parsing route params for Master Detail master page when navigating directly to detail page
- Tabs
- Automatically set initial animated tab position based on
tab-active
class
- Automatically set initial animated tab position based on
- Range slider
- React/Svelte/Vue
- List
- Added
virtualListInstance()
methods to get Virtual List instance in Svelte
- Added
- ListItem
- Added
smartSelectInstance()
method to get Smart Select instance in Svelte
- Added
- ListInput
- Auto update Color Picker and Calendar params on
calendarParams
andcolorPickerParams
props changes
- Auto update Color Picker and Calendar params on
- List
- Minor fixes
v5.7.5 - May 16, 2020
- Core
- Input
- Now
app.input.validate()
andapp.input.validateInputs()
should correctly work with readonly inputs (like in Calendar, Picker, Color Picker, etc.)
- Now
- Range
- Added support for
scaleSteps: 1
- Fixed issue when it didn't update size in parent resizable panel
- Added support for
- Swiper updated to latest 5.4.0
- Hash Navigation
- Added
hashChange
andhashSet
events (#3557)
- Added
- Lazy
- Added support for
<picture>
lazy loading (#3560)
- Added support for
- Mousewheel
- Potentially improved vertical scrolling issues on Windows/Linux
History
andHash Navigation
modules are now included in Framework7 version of Swiper
- Hash Navigation
- Toast
- Added
horizontalPosition
parameter - to set horizontal alignment on wide screen
- Added
- Touch
- Tweaked touch events detection
- Input
- React/Vue/Svelte
- Fab
- Fixed issue when it rendered not correctly without icon
- Chip
- Now it has default slot which goes to text label
- Fab
v5.7.2 - May 9, 2020
- Core
- Autocomplete
- Fixed wrong padding when used as dropdown in searchbar
- Buttons
- Fixed rendering issue with "strong" segmented happened some times in iOS
- Device
- Better iPad detection
- Panel
- Now it auto-hides/restores on push Popup or Sheet modal open
- View
- Fixed
current
view detection when using layout with swipeable tabs
- Fixed
- Autocomplete
- Svelte
- All components now supports
$$restProps
under the hood, it means all extra props passed to components will be set as html attributes on component element
- All components now supports
- Minor fixes and improvements
v5.7.1 - May 1, 2020
- Core
- CSS
body
background color changed to#000
when dark theme enabled
- Panel
- Now it correctly handles disabling backdrop.
- Text Editor
- Popover now calculates position relative to app root element (#3618)
- View
- Fixed
current
view detection when using layout with swipeable tabs
- Fixed
- CSS
- Minor fixes
v5.7.0 - April 25, 2020
- Core
- Card
- Fixed issue when expandable card didn't work when expandable card was opened in another page
- Fixed issue when used with "hide on scroll" Navbar/Toolbar on iOS
- Panel
- New
swipeNoFollow
parameter - fallback option for potentially better performance on old/slow devices. If you enable it, then swipe panel will not follow your finger during touch move, it will be automatically opened/closed on swipe left/right. (default false)
- New
- Popup
- Disabled top/bottom safe areas on "tablet" when opened not as full screen popup
- Now it correctly handles and stack multiple opened "push" popups
- Radio
- Now radio icon can be rendered in the beginning or in the end of the list item, by adding
item-radio-icon-start
oritem-radio-icon-end
class toitem-radio
list element
- Now radio icon can be rendered in the beginning or in the end of the list item, by adding
- Smart Select
- Add support for more data-option-icon properties:
data-option-icon
- if it just a string then will create an icon with this class. If it is in the format off7:icon_name
then it will create a F7-Icons icon. If it is in the format ofmd:icon_name
then it will create a Material Icons icondata-option-icon-ios
- same asdata-option-icon
but will apply only when iOS theme is activedata-option-icon-md
- same asdata-option-icon
but will apply only when MD theme is activedata-option-icon-aurora
- same asdata-option-icon
but will apply only when Aurora theme is active
- Add support for more data-option-icon properties:
- Swiper - updated to latest 5.3.8
- Core
- Fix iOS bug with double bounce on free mode momentum bounce
- A11y
- Fixed focus ring on navigation buttons (#3544)
- Fixed RegExp issue in paginationBulletMessage (#3540, #3541)
- Thumbs
- Added thumbs.autoScrollOffset parameter that allows to set on what thumbs active slide from edge it should automatically move scroll thumbs
- Core
- View
- New
masterDetailResizable
parameter to enable resizable Master Detail layout - New
viewResize
/view:resize
event on Master Detail resize
- New
- Card
- React/Vue/Svelte
- ListItem
- New
radioIcon
string property to define where to display radio icon - in the beginning or in the end of the list item. Can bestart
orend
- New
- Navbar
- Fixed not working
onBackClick
event in Svelte
- Fixed not working
- Panel
- New
swipeNoFollow
boolean property - fallback option for potentially better performance on old/slow devices. If you enable it, then swipe panel will not follow your finger during touch move, it will be automatically opened/closed on swipe left/right. (default false)
- New
- View
- New
materDetailResizable
boolean property to enable resizable Master Detail layout - New
viewResize
/view:resize
event on Master Detail resize
- New
- ListItem
- Minor fixes
v5.6.0 - April 18, 2020
- Core
- App
- Added new app instance boolean property
app.darkTheme
. This property has effect only whenautoDarkTheme
enabled and indicates whether the dark theme active or not - Added new app instance event
darkThemeChange
. It has effect only whenautoDarkTheme
enabled and fires on device preferred color scheme change
- Added new app instance boolean property
- Checkbox
- Fixed styles in RTL mode
- Device
- Added
nwjs
property that is true when app running under NW.js environment
- Added
- Router
- New
pageTabShow
/page:tabshow
andpageTabHide
/page:tabhide
page events. These events fires on page's parent View-Tab show/hide
- New
- Segmented
- Added animation for "strong" segmented active button
- BREAKING CHANGE - now "strong" segmented requires new
<span class="segmented-highlight">
element
- App
- React/Vue/Svelte
- Input
- Added support for
inputmode
input attribute
- Added support for
- ListInput
- Added support for
inputmode
input attribute - Fixed issue with
errorMessage
in Svelte
- Added support for
- ListItem
- Added
tabLink
andtabLinkActive
props to make list item as a tab link
- Added
- Page
- New
pageTabShow
/page:tabshow
andpageTabHide
/page:tabhide
page events. These events fire on page's parent View-Tab show/hide
- New
- Input
- Minor fixes
v5.5.5 - April 10, 2020
- Core
- Modals (Popup, Actions, Popover, Login Screen, etc.)
- Now it is possible to specify all modal parameters via
data-
attributes, e.g.<div class="sheet-modal" data-swipe-to-close="true" data-close-on-escape="true">...</div>
- Now it is possible to specify all modal parameters via
- Swiper - updated to latest 5.3.7
- Core
- Fixed
cssMode
behavior in RTL layout
- Fixed
- Zoom
- Fixed issue with not working double-tap to toggle with virtual slides
- Core
- Modals (Popup, Actions, Popover, Login Screen, etc.)
- Minor fixes
v5.5.4 - April 2, 2020
- Core
- Input
- Don't unset focus on input on input's clear button click/tap
- Input
- Svelte
- Input
- Fixed issue keeping focused state on blur
- Input
- Minor fixes
v5.5.3 - March 28, 2020
- Core
- Modals (Popup, Actions, Popover, Login Screen, etc.)
- Now on modal open/close link click it will close only parent modal or last such modal if there are multiple modals with same selector
- Input
app.input.validate
andapp.input.validateInputs
methods now returntrue
(when input(s) are valid) orfalse
(when input(s) are not valid)
- Modals (Popup, Actions, Popover, Login Screen, etc.)
- Components (React, Vue, Svelte)
- Input/ListInput
- New
onValidate
prop callback that receivestrue
(when input(s) are valid) orfalse
(when input(s) are not valid)
- New
- Input/ListInput
- Minor fixes
v5.5.1 - March 20, 2020
- Core
- Action Sheet
- Fixed issue when it stops to emit events when converted to popover
- Added
cssClass
parameter to add custom css class to generated element
- Login Screen
- Fixed issue with appearance in dark theme
- Popup
- New events when swipeToClose enabled:
swipeStart
,swipeMove
,swipeEnd
,swipeClose
- New events when swipeToClose enabled:
- Searchbar
- Fixed inline-searchbar styles when used with large navbar
- Subnavbar
- Fixed issue with disabled pointer-events in hidden navbar
- Action Sheet
- Minor fixes
v5.5.0 - March 6, 2020
- Core
- Card
- Expandable card backdrop blur now uses opacity instead of blur transition for better performance
- Input
- Added dark/black backround for native select
<option>
- Added dark/black backround for native select
- Navbar
- Added support to make usual (not large) Navbar also transparent. Can be enabled by adding
navbar-transparent
class to navbar - New
snapPageScrollToTransparentNavbar
app.navbar parameter - when enabled it will snap page scroll to transparent title (default true)
- Added support to make usual (not large) Navbar also transparent. Can be enabled by adding
- Router
- New
router.generateUrl({ name, query, params })
to generate route URL
- New
- Router Component
- Fixed issue with
autocomplete
attribute treated asboolean
attribute - Now calling
$update()
on root app component should automatically update all components that depends on$root.
data
- Fixed issue with
- Text Editor
- added
init
andtextEditorInit
events - added
type="button"
attribute for buttons to prevent form from submitting - fixed issue with missing arguments in custom button onClick callback
- added
- Treeview
loadchildren
's eventdone()
callback now supports booleancancel
attribute to cancel/reject loading UI if required by callingdone(true)
- Swiper - updated to latest 5.3.6
- Core
- Fixed wrong auto height calculation with
centeredSlides
enabled
- Fixed wrong auto height calculation with
- Lazy
- Now it will update auto height (if enabled) on lazy image loaded (#3466)
- Zoom
- Fixed issue when previously active slide could be zoomed with
zoom.in()
API (#3451) - Fixed issue when zoom didn't work on
<picture>
element (#3456) - Added support for custom zoom-target element by adding
swiper-zoom-target
class to such elements
- Fixed issue when previously active slide could be zoomed with
- Coverflow Effect
stretch
parameter now can be set in%
(#3468)
- Core
- Card
- React, Svelte, Vue components
- Page
- Added support for
pageBeforeUnmount
event forPage
component
- Added support for
- Navbar
- Added support to make usual (not large) Navbar also transparent. Can be enabled by adding
transparent
property to navbar, e.g.<Navbar transparent>
- Large-transparent navbar now should be enabled by adding two properties
large
andtransparent
instead of onelarge-transparent
. Before:<Navbar large large-transparent>
, now:<Navbar large transparent>
- Added support to make usual (not large) Navbar also transparent. Can be enabled by adding
- Page
- Lots of minor fixes
v5.4.5 - February 21, 2020
- Core
- FAB (Floating Action Button)
- Now it supports backdrop, by adding
<div class="fab-backdrop"></div>
element on same level as FAB element
- Now it supports backdrop, by adding
- Page
- Added custom CSS properties for custom transitions durations:
--f7-page-parallax-transition-duration
,--f7-page-cover-transition-duration
,--f7-page-dive-transition-duration
,--f7-page-fade-transition-duration
,--f7-page-flip-transition-duration
,--f7-page-push-transition-duration
- Added custom CSS properties for custom transitions durations:
- Preloader
- New methods
app.preloader.showIn(el, color)
andapp.preloader.hideIn(el)
to show/hide preloader overlay in specific element
- New methods
- Request
- Now it uses "native" XHR timeout
- FAB (Floating Action Button)
- React, Vue, Svelte
- Added
<FabBackdrop />
component
- Added
- Minor fixes
v5.4.2 - February 16, 2020
- Core
- Card
- Fixed issue with expandable card overflow on iOS devices
- Fixed expandable card transition in RTL
- Text Editor
- Fixed issue when keyboard toolbar stays opened on navigating to another page
- Card
- Minor fixes
v5.4.1 - February 8, 2020
- Core
- Touch
- Fully switch to
pointer
events where supported
- Fully switch to
- Tooltip
- New
trigger
parameter to define how to open Tooltip - onhover
(default) or onclick
- New
- Swiper - updated to latest 5.3.1
- Fixed issue when slider could stuck after last slide (#3414)
- Added
label
to list of form events to keep clicks on it (#3407)
- Request
- Now it won't set headers with
undefined
value
- Now it won't set headers with
- Touch
- Vue/React/Svelte
- Tooltip
- New
tooltipTrigger
prop forButton
,FabButton
,Fab
,Icon
,Link
,ListButton
andListItem
components
- New
- Tooltip
- Minor fixes
v5.4.0 - January 29, 2020
- Framework7 Svelte π
- Core
- Autocomplete
- Now it falls back to not "routable" modal when there is no View passed or it can't be found.
- Calendar
- Now it falls back to not "routable" modal when there is no View passed or it can't be found.
- Card
- New
scrollabelEl
parameter that allows to define child scrollable element (if used) to correctly handle expandable card close with touch move
- New
- Color Picker
- Now it falls back to not "routable" modal when there is no View passed or it can't be found.
- Photo Browser
- Now it falls back to not "routable" modal when there is no View passed or it can't be found.
- Picker
- Now it falls back to not "routable" modal when there is no View passed or it can't be found.
- New
scrollToEl
parameter to specify custom elements to scroll to on open
- Smart Select
- Now it falls back to not "routable" modal when there is no View passed or it can't be found.
- Autocomplete
- React/Vue
- Card
- New
scrollabelEl
prop that allows to define child scrollable element (if used) to correctly handle expandable card close with touch move
- New
- Card
- Lot of minor fixes
v5.4.0-beta.3 - January 25, 2020
- Core
- Autocomplete
- Now it falls back to not "routable" modal when there is no View passed or it can't be found.
- Calendar
- Now it falls back to not "routable" modal when there is no View passed or it can't be found.
- Color Picker
- Now it falls back to not "routable" modal when there is no View passed or it can't be found.
- Photo Browser
- Now it falls back to not "routable" modal when there is no View passed or it can't be found.
- Picker
- Now it falls back to not "routable" modal when there is no View passed or it can't be found.
- Smart Select
- Now it falls back to not "routable" modal when there is no View passed or it can't be found.
- Autocomplete
v5.4.0-beta.2 - January 25, 2020
- Fix missing packages
v5.4.0-beta.1 - January 25, 2020
- Card
- New
scrollabelEl
parameter that allows to define child scrollable element (if used) to correctly handle expandable card close with touch move
- New
- React/Vue
- Card
- New
scrollabelEl
prop that allows to define child scrollable element (if used) to correctly handle expandable card close with touch move
- New
- Card
- Framework7 Svelte π
- Minor fixes
v5.3.2 - January 18, 2020
- Core
- Component
- Now main app component will be created on app init respecting cordova's deviceready event
- Toolbar
- Fixed Tabbar init when it used in main app component
- Picker
- Added
backdrop
parameter support
- Added
- Swiper updated to latest 5.3.0
- Core
- New
slidesPerGroupSkip
behavior (#3361) - New ratio-based breakpoints (#3389)
- Added SCSS interpolation (#3373, #3374)
- New
- Mousehweel
- Fixed issue when it can fail on load (#3383)
- Core
- Touch
- Fixed issue when it could prevent Leaflet map controls on iOS 12.x
- Component
- Vue/React
- Navbar - fixed issue when it could disappear with custom transitions
- Minor fixes
v5.3.0 - January 3, 2020
- Core
- Card
- Increased default
z-index
for expandable card
- Increased default
- Dialog
- Added support for
backdrop
parameter to be able to disable backdrop
- Added support for
- Sheet
- New
sheet.setSwipeStep()
method to update swipe step position if content was modified manually
- New
- Tooltip
- New
offset
parameter to add extra offset to tooltip position
- New
- Touch
- New
touch.activeStateOnMouseMove
boolean app parameter. If enabled it will not remove "active state" from clicked elements on mouse move
- New
- Router Component
- Fixed issue with parsing CSS media queries in scoped styles
- Now it is possible to use whole app layout as a component
- Main app component can be specified in app
component
orcomponentUrl
parameter app.rootComponent
now refers to main app component instance- If main app component is used, then
$root
in components refers to main app component instance
- Main app component can be specified in app
- Minor fixes
- Card
v5.2.0 - December 8, 2019
- Core
- Accordion
- It is now possible to use accordion chevron on opposite side (on left in LTR) by adding
accordion-opposite
class to accordion list
- It is now possible to use accordion chevron on opposite side (on left in LTR) by adding
- Calendar
- Fixed issue when custom
dateFormat
parsed twice (#3434) - Added custom time tokens support to
dateFormat
whentimePicker
is enabled:HH
,H
,hh
,h
,:mm
,:m
,:ss
,:s
,A
,a
(#3439)
- Fixed issue when custom
- Dialog
- New
app.dialog.autoFocus
boolean parameter to auto focus predefined dialog inputs on open (valid for predefined Prompt, Login and Password dialogs). Enabled by default - Added hover and pressed state for dialog buttons in Aurora theme
- New
- Panel
- All panel instance events now have Panel instance as argument (#3404)
- Photo Browser
- Size navbar after updating count text (
1 of 4
) (#3420)
- Size navbar after updating count text (
- Router Component
- Fixed issue when calling
$setState
recursively didn't work as expected (#3421)
- Fixed issue when calling
- Smart Select
- Fixed issue calling scrollToSelectedItem caused error when there were no any items (#3412)
- Sortable
- It is now possible to make sortable handler appear on opposite side (on left in LTR) adding
sortable-opposite
class to sortable list
- It is now possible to make sortable handler appear on opposite side (on left in LTR) adding
- Accordion
- Phenome
- Added lock to not throw and error and ignore further attempts to init Framework7 (for example when App component unmounted and mounted again)
- List
- New boolean
sortableOpposite
prop to render sortable handler on opposite side - New boolean
accordionOpposite
prop to render accordion checron icon on opposite side
- New boolean
- Navbar
- Fixed issue when
no-shadow
andno-hairline
props didn't have expected effect (#3436) - Fixed issue when it was loosing required position classes in Master Detail layout
- Fixed issue when
- Minor fixes
v5.1.3 - November 17, 2019
- Core
- Fixed issue with setting wrong class on page
v5.1.2 - November 17, 2019
- Core
- Fixed issue when
.once
could be called more than once (#3322) - Navbar
- Fixed issue when
scrollTopOnTitleClick
didn't work in iOS theme
- Fixed issue when
- Swiper - updated to latest 5.2.1
- Core
- New loop events
beforeLoopFix
andloopFix
- New parameter
updateOnWindowResize
(by defaulttrue
) that will update/recalc swiper on window resize/orientationchange
- New loop events
- Mousewheel
- Fixed scroll wheel unwanted frozen effect (#3328)
- Thumbs
- New
multipleActiveThumbs
(by defaulttrue
) option to control whether multiple thumbnail slides may get activated or not.
- New
- Core
- Fixed issue when
- Phenome
- Navbar
- Fixed issue when dynamically updating its classes/props could break its layout
- Navbar
- Minor fixes
v5.1.1 - November 3, 2019
- Core
- Calendar
- Fixed
d
,m
,D
,M
tokens parsing in custom date format
- Fixed
- Photo Browser
- Fixed issue when opening PhotoBrowser on not first slide can cause empty text in its Navbar
- Router Component
- New syntax to use custom components in strict HTML layout using
component
attribute, e.g.<tr component="my-table-row"></tr>
instead of<my-table-row></my-table-row>
- New syntax to use custom components in strict HTML layout using
- Calendar
- Minor fixes
v5.1.0 - October 27, 2019
- Core
- Grid
- New resizable grid
- Router Component
- Fixed issue when triggering update could break scoped styles
- Fixed update callbacks queue
- Swiper - updated to latest 5.2.0
- Core
- New
centeredSlidesBounds
parameter that when enabled will keep first and last slides at bounds - Fixed issue when
freeMode
could break position on resize (#2708, #3303) - Fixed transition duration issue with
freeModeSticky
(#3302) - Fixed issue with wrong row/column if not full groups (#3294)
- Fixed issue when
watchOverflow
andslidesOffsetBefore
/slidesOffsetAfter
couldn't work together (#3291)
- New
- Mousewheel
- Faster & smoother mousewheel inertial scrolling (#3304)
- Core
- Grid
- Phenome
- Row/Col
- New
resizable
components properties to enable resizable grid
- New
- Row/Col
v5.0.5 - October 16, 2019
- Core
- Toolbar
- Now it fires
toolbar:show
andtoolbar:hide
events on show/hide
- Now it fires
- Card
- Now it should consider
hideStatusbarOnOpen
when calculating expandable card size
- Now it should consider
- PhotoBrowser
- Fixed issue with double preloader
- Fixed issue when double tap to zoom also toggled exposition
- Router Component
- Fixed issue when
updated
hook had wrong context
- Fixed issue when
- Sheet Modal
- Tweaked Sheet dark theme background color to have more contrast with page
- Input
- Added more events when resizable textarea's size should be recalculated
- Swiper updated to latest v5.1.0
- Core
- Fixed issues with touch on iOS 13
- New
translateTo
method
- Pagination
- Improved dynamic bullets behavior when
loop: true
- Improved dynamic bullets behavior when
- Zoom
- Fixed issue with pinch to zoom on Android
- Core
- Toolbar
- Phenome
- Page
- Fixed issue when pages can stuck on swipe back
- TextEditor
- Fixed issue with not working component events
- Page
v5.0.4 - October 9, 2019
- Core
- Messages
- Fixed iOS dark theme Messages colors
- Text Editor
- Fixed TypeScript definitions error
- Messages
v5.0.3 - October 8, 2019
- Core
- Input
scrollIntoViewOnFocus
functionality now considers the case when input is inside of expandable card
- TextEditor
- Prevent parent form submission on editor button click
- Input
- Phenome
- Page
- Fixed issue when page after can stay "blocked" after expandable card close
- Page
v5.0.2 - October 7, 2019
- Phenome
- ListGroup
- Fixed issue breaking this component
- ListGroup
v5.0.1 - October 7, 2019
- Core
- Tooltip
- Fixed issue when Tooltip stays hidden on desktop
- Tooltip
v5.0.0 - October 7, 2019
CSS & Theming
- iOS Dark theme colors reworked to match iOS 13 dark theme colors
- Most of CSS variables related to colors (especially "gray" colors) reworked to
rgba
colors to appear better on custom designs. It is related to text colors, background colors, icons colors, borders and hairlines colors. - Most of iOS theme
15px
sizes (list/blocks paddings and margins) are changed to16px
instead - New CSS breakpoints. Now there are new names for app sizes instead of
tablet-
anddesktop-
before. Now they are:xsmall
- width more than480px
small
- width more than568px
medium
- width more than768px
large
- width more than1024px
xlarge
- width more than1200px
- Dark Theme can now be excluded from bundle (custom build)
- Light Theme can now also be excluded from bundle (custom build)
Core Package
- Now core package contains new
framework7-lite.js
,framework7-lite.bundle.js
scripts. Difference with usual scripts is that these "lite" versions don't contain Component (Router Component) functionality. This version is recommended to use with F7-Vue/React versions where you anyway use Vue/React components instead.
Core APIs & Modules
- iOS Translucent
- New
iosTranslucentBars
app parameter to enable translucent effect (blur background) on navigation bars (by default enabled) - New
iosTranslucentModals
app parameter to enable translucent effect (blur background) on modals (Dialog, Popover, Actions) (by default enabled)
- New
- Connection API (new)
- New F7 instance's
online
boolean property that istrue
when app online andfalse
otherwise - Now app emits
online
event when app goes online - Now app emits
offline
event when app goes offline - Now app emits
connection
event on app connection change
- New F7 instance's
- Device
.needsStatusbarOverlay()
method has been removed.statusbar
property and detection has been removed.iphoneX
property and detection has been removed.windowsPhone
property and detection has been removed- It doesn't set
device-ios-gt-{version}
classes onhtml
element anymore - It doesn't set
device-{os}-{version}
classes onhtml
element anymore - It doesn't set
retina
class onhtml
element anymore
- Request
- Request "promise" methods now will be resolved with
{ data, status, xhr }
object (rather than with justdata
like before) - Request "promise" methods now will be rejected with
{ message, status, xhr }
object (rather than with juststatus
like before)
- Request "promise" methods now will be resolved with
- Statusbar
- Statusbar overlay element (
<div class="statusbar">
) and related functionality has been removed in favor of using that space by navigation bars and other elements to provide true full-screen experience and customization. Statusbar cordova's API is there as it was before.
- Statusbar overlay element (
- Touch
- Fast clicks functionality has been completely removed. Following
app.touch
' parameters are not supported anymore:fastClicks
,fastClicksDistanceThreshold
,fastClicksDelayBetweenClicks
andfastClicksExclude
- Added support to disable "active state" on specific elements by adding
no-active-state
class to such elements
- Fast clicks functionality has been completely removed. Following
- View/Router
- New
loadInitialPage
(boolean) parameter. When enabled, and there is no children pages inside of the View. It will load initial page that matches to initial URL (default true) - New
componentCache
(boolean) parameter. When enabled, Router will cache components specified viacomponentUrl
(default true) - Removed
.clearPreviousPages()
method. Now there is only.clearPreviousHistory()
that removes both history and pages from DOM - Root (first) detail page (in master-detail layout) will now have extra
page-master-detail-root
- Root (first) detail navbar (in master-detail layout) will now have extra
navbar-master-detail-root
. - Added custom page transitions support and 8 new page transitions:
f7-circle
,f7-cover
,f7-cover-v
,f7-dive
,f7-fade
,f7-flip
,f7-parallax
,f7-push
- Custom transition can now also be specified via
data-transition
attribute on links - Route declaration now supports new
viewName
property. And whatever View such route requested, it will be loaded in View specified inviewName
property. - Route declaration now supports new
options.transition
string property to specify custom transition for this route - Route declaration now supports new
asyncComponent
method that should return Promise resolved with Component or ES module with.default
property containing Component - It is now possible to specify "current" view for link to load the page with
data-view="current"
attribute iosSeparateDynamicNavbar
parameter has been removed and behavior that uses withiosSeparateDynamicNavbar: false
is not supported anymore
- New
Core Components
- Action Sheet
- Now it also appears in dark when dark theme enabled
- Autocomplete
- New
popupPush
parameter - enables Autocomplete popup to push view(s) behind on open - New
popupSwipeToClose
parameter - enables ability to close Autocomplete popup with swipe
- New
- Block
- Now it uses new breakpoint names for
{size}-inset
classes (e.g.tablet-inset
->medium-inset
, etc.) - Block title in iOS theme is now larger and bolder
- Now it uses new breakpoint names for
- Button
- iOS theme buttons are reworked a bit. They now has thicker border and uppercased
- New "strong" segmented style (e.g. iOS 13 segmented). Can be enabled by adding
segmented-strong
class to segmented element (<div class="segmented">
)
- Calendar
- Now calendar value will be cleared on related input's clear (when "clear button" clicked)
- Calendar has been reworked to use
Intl.DateTimeFormat
API.- New
locale
parameter (e.g.en-US
). If not specified, it will use browser locale dateFormat
now can acceptIntl.DateTimeFormatOptions
(e.g.{ month: 'long', day: 'numeric' }
)monthNames
now by default isauto
- it will display month names based on specified locale (or browser locale)monthNamesShort
now by default isauto
- it will display month names based on specified locale (or browser locale)dayNames
now by default isauto
- it will display week day names based on specified locale (or browser locale)dayNamesShort
now by default isauto
- it will display week day names based on specified locale (or browser locale)- Jalali calendar and
IDate
dependency removed in favor of new Intl api
- New
- New month picker functionality (clicking month name in toolbar will open month picker) with new
monthPicker
parameter (by default true) - New year picker functionality (clicking year in toolbar will open year picker) with new
yearPicker
parameter (by default true) - New
yearPickerMin
parameter to specify minimum available year for year picker, by default is today minus 100 years - New
yearPickerMax
parameter to specify maximum available year for year picker, by default is today plus 100 years - New time picker functionality (to select a time in addition to date) with new
timePicker
parameter (by default false) - New
timePickerFormat
parameter to specify time format displayed in time selector. (default{ hour: 'numeric', minute: 'numeric' }
) - New
timePickerPlaceholder
parameter to specify time picker placeholder text (default "Select time") - New
sheetPush
parameter - enables Calendar sheet to push view(s) behind on open - New
sheetSwipeToClose
parameter - to close Calendar sheet with swipe
- Card
- New
hideStatusbarOnOpen
app card parameter - will hide "Statusbar" on expandable card open. (defaulttrue
)
- New
- Color Picker
- New
popupPush
parameter - enables Color Picker popup to push view(s) behind on open - New
popupSwipeToClose
parameter - enables ability to close Color Picker popup with swipe - New
sheetPush
parameter - enables Color Picker sheet to push view(s) behind on open - New
sheetSwipeToClose
parameter - enables ability to close Color Picker sheet with swipe
- New
- Data Table
- Removed support for
tablet-only
anddesktop-only
classes for table columns. Now it uses new breakpoint names and classes accordingly (e.g.medium-only
,xlarge-only
, etc.)
- Removed support for
- Dialog
- Now it also appears in dark when dark theme enabled
- Grid
- Now it uses new breakpoint names for responsive columns classes (e.g.
tablet-50
->medium-50
, etc.)
- Now it uses new breakpoint names for responsive columns classes (e.g.
- List
- Now it uses new breakpoint names for
{size}-inset
classes (e.g.tablet-inset
->medium-inset
, etc.) - Removed declaration for list icon default color (that could make it harder to customize)
- Now it uses new breakpoint names for
- Login Screen
- Now it centers content vertically
- Navbar
- iOS theme dynamic Navbar behavior totally reworked. Now it doesn't take
navbar-inner
from the page's Navbar, but takes whole Navbar element. It makes it easier to customize each navbar (bg color, text color, hairlines, shadows) and brings better transitions between them. - Navbar size now will be increased (when top safe-area is in place) to cover the status bar space. This gives even better full-screen experience and transitions.
- Navbar HTML layout has been reworked, now it has new
navbar-bg
element:<div class="navbar"> <div class="navbar-bg"></div> <div class="navbar-inner">...</div> </div>
- Large Navbar should now have addition
navbar-large
class on navbar itself (instead ofnavbar-large-inner
onnavbar-inner
):<div class="navbar navbar-large"> <div class="navbar-bg"></div> <div class="navbar-inner">...</div> </div>
- New large transparent Navbar (like in iOS 13), can enabled with additional
navbar-large-transparent
class:<div class="navbar navbar-large navbar-large-transparent"> <div class="navbar-bg"></div> <div class="navbar-inner">...</div> </div>
- iOS theme dynamic Navbar behavior totally reworked. Now it doesn't take
- Panel
- Panels functionality has been fully reworked and now behaves more like a modals, which means we now can have as many panels as we want (or need) not limited to only 2 (left and right) panels.
- The following parameter has been removed from
app.panel
parameters:leftBreakpoint
,rightBreakpoint
,swipe
,swipeActiveArea
,swipeCloseActiveAreaSide
,swipeOnlyClose
,swipeThreshold
,closeByBackdropClick
. - Now every panel must be initialized separately and panel parameters must be specified for each panel.
- It is now possible to auto init the panel by adding
panel-init
class and specify such panel parameters withdata-
attributes, e.g.:<div class="panel panel-left panel-cover" data-swipe="true" data-visible-breakpoint="1200"> ... </div>
- Each panel supports new set of parameters:
backdrop
- enables backdropbackdropEl
- specify custom backdrop elementcollapsedBreakpoint
(number) - app width when panel becomes partially visible (collapsed)visibleBreakpoint
(number) - app width when panel becomes fully visibleswipe
(boolean) - makes panel swipeableswipeOnlyClose
(boolean) - makes panel swipeable but only to closeswipeActiveArea
(number) - active area from the edge of the screen where panel swipes enabledswipeThreshold
(number) - panel will not move with swipe if "touch distance" will be less than this value
- Each panel instance has new methods:
enableVisibleBreakpoint()
disableVisibleBreakpoint()
toggleVisibleBreakpoint()
enableCollapsedBreakpoint()
disableCollapsedBreakpoint()
toggleCollapsedBreakpoint()
enableResizable()
disableResizable()
enableSwipe()
disableSwipe()
app.panel.open(panel)/close(panel)
methods now can receive panel element (or CSS selector) of the panel to open/close.left
andright
values are still work but on only if you have only one left or right panel- The following F7 instance props and methods removed and intended to be used on panel instance instead:
app.panel.enableSwipe()
app.panel.disableSwipe()
app.panel.enableResizableSwipe()
app.panel.disableResizableSwipe()
app.panel.left
app.panel.right
panel-active
panel class renamed topanel-in
- PhotoBrowser
backLinkText
parameter renamed topageBackLinkText
- New
popupCloseLinkText
parameter to specify "close" link text when it is opened as Popup or as Standalone - New
navbarShowCount
parameter to define should it display "3 of 5" text in navbar title or not. If not specified (undefined) then it will show this text if there is more than 1 item - New
popupPush
parameter - enables Photo Browser popup to push view(s) behind on open
- Picker
- Font size on picker items became smaller in iOS and MD themes
- New
sheetPush
parameter - enables Picker sheet to push view(s) behind on open - New
sheetSwipeToClose
parameter - enables ability to close Picker sheet with swipe
- Popup
- New boolean
push
parameter. When enabled it will push view behind on open. Works only when top safe area is in place. It can also enabled by addingpopup-push
class to popup element.
- New boolean
- Sheet Modal
- In iOS theme it now has white background color by default
- New boolean
push
parameter. When enabled it will push view behind on open. Works only when top safe area is in place. It can also enabled by addingsheet-push
class to sheet modal element. - Swipeable Sheet Modal now correctly handles scrolling inside of nested
page-content
element
- Sortable
- Sortable
sort
event data now also containel
property with reference to sorted item - Now sorting can be done on tap-hold. It can be enabled by adding additional
sortable-tap-hold
tosortable
container. Alsoapp.touch.tapHold
should be enabled to emittaphold
events.
- Sortable
- Smart Select
- Fixed behavior when it is
multiple
and with Virtual List enabled - New
.unsetValue()
method to unset smart select value - New
popupPush
parameter - enables Smart Select popup to push view(s) behind on open - New
popupSwipeToClose
parameter - enables ability to close Smart Select popup with swipe - New
sheetPush
parameter - enables Smart Select sheet to push view(s) behind on open - New
sheetSwipeToClose
parameter - enables ability to close Smart Select sheet with swipe
- Fixed behavior when it is
- Subnavbar
- Subnavbar's title element (
<div class="title">
) now should be used with classsubnavbar-title
instead (<div class="subnavbar-title">
)
- Subnavbar's title element (
- Swiper updated to latest 5 version:
- Core
- All new CSS Scroll Snap mode (can be enabled with
cssMode: true
). It doesn't support all of Swiper's features, but potentially should bring a much better performance in simple configurations - Fully removed Internet Explorer support
breakpointsInverse
parameter has been removed and nowbreakpoints
behave like withbreakpointsInverse: true
before.touchMoveStopPropagation
parameter now defaults tofalse
click
event won't be fired with 300ms delay anymore. Now it will be fired at the same time astap
event- When
slidesPerColumnFill: 'column'
it now usesflex-direction: column
layout which requires specified height on swiper-container slidesPerColumn
now can be used with breakpoints- Now Swiper styles use CSS Custom Properties (CSS Custom Variables) to specify swiper's color theme (color of navigation buttons/pagination). It is now
--swiper-theme-color: #007aff;
- Improved
es
module "tree-shake-ability" - New
swiper.esm.browser.bundle.js
package that can be used directly in browser (import Swiper from 'swiper.esm.browser.bundle.js'
)
- All new CSS Scroll Snap mode (can be enabled with
- Autoplay
- Now it will be paused when document becomes hidden (in not active tab) and continued again when document becomes visible
- Lazy
- Swiper preloader image replaced with a little bit simpler loader. Now its color can be changed with
--swiper-preloader-color
CSS custom property (which is defaults to--swiper-theme-color
)
- Swiper preloader image replaced with a little bit simpler loader. Now its color can be changed with
- Pagination
- Active pagination bullets and pagination theme colors now use CSS Custom Properties. It can be defined with
--swiper-pagination-color
property (which is defaults to--swiper-theme-color
)
- Active pagination bullets and pagination theme colors now use CSS Custom Properties. It can be defined with
- Navigation
- Navigation icons reworked with built-in (base64) icon font. It allows to apply any color and size without replacing image
- Navigation buttons colors now use CSS Custom Properties. It can be defined with
--swiper-navigation-color
property (which is defaults to--swiper-theme-color
) - With
--swiper-navigation-size
(defaults to44px
) it is now possible to change size of the navigation buttons (and icons)
- Core
- Text Editor
- All new touch-friendly Rich Text Editor component
- Timeline
- Now it uses new breakpoint names for
{size}-sides
classes (e.g.tablet-sides
->medium-sides
, etc.)
- Now it uses new breakpoint names for
- Toolbar
- Tabbar labels text (font) size increased in iOS theme
Framework7 Router Component
Now it supports async
data
method (where it must return Promise)export default { async data() { const user = await fetch('some/path').then((res) => res.json()); return { user, }; }, };
or
export default { data() { return new Promise((resolve) => { fetch('some/path') .then((res) => res.json()) .then((user) => resolve({ user })); }); }, };
Component DOM updates are now async. It means that it is not guaranteed that DOM will be updated right after calling
$setState
. So there is a new$tick
context method that can be safely used to reference DOM and ensure it was updated:this.$setState({ foo: 'bar' }); this.$setState({ john: 'doe' }); this.$tick(() => { // DOM updated });
$setState
now also receives second callback argument that will be fired on DOM update:this.$setState({ foo: 'bar' }, () => { // DOM updated });
Component context has new
$update(callback)
method that can be used instead of$setState
to just trigger DOM update:this.foo = 'bar'; this.$update(() => { // DOM updated });
Added support for mixins that can be re-used in components. Mixin can extend any component lifecycle hook, methods and
data
. Mixins should be passed in component'smixins
property as an array:const mountedMixin = { mounted() { // do something on mounted console.log('mounted'); }, }; const defaultDataMixin = { data() { return { foo: 'bar' }; }, }; // extend component with mixins export default { mixins: [mountedMixin, defaultDataMixin], data() { return { john: 'doe' }; }, // ... };
It is also possible to register global mixins with new method
Framework7.registerComponentMixin(mixinName, mixin)
Framework7.registerComponentMixin('default-data-mixin', { data() { return { foo: 'bar' }; }, });
And use it like:
export default { mixins: ['default-data-mixin'], data() { return { john: 'doe' }; }, // ... };
Now it is possible to create custom reusable components with new method
Framework7.registerComponent(tagName, component)
Framework7.registerComponent('my-list-item', { data() { return { foo: 'bar' }; }, template: ` <li class="list-item" id="{{foo}}">...</li> `, });
And use it in other components like:
<div class="list"> <ul> <my-list-item></my-list-item> </ul> </div>
New
class
based syntax for components for better TypeScript support:import { Component } from 'famework7'; export default class extends Component { data() { return { foo: 'bar' }; } mounted() { console.log('mounted'); this.onMounted(); // call method } onMounted() { // ... } // ... }
Phenome (Vue/React)
Now it is possible to get Framework7 instance,
f7ready
function andtheme
by directly importing them from package. This can be useful for functional components that don't have F7 extensions, e.g.:import { f7, f7ready, theme } from 'framework7-react'; // or import { f7, f7ready, theme } from 'framework7-vue';
Most of internal events reworked to use custom events system instead of DOM events. So all component events don't contain reference to HTML elements anymore.
Phenome (Vue/React) Components
- Block
tabletInset
prop has been removed- New inset props to reflect new breakpoint names:
xsmallInset
,smallInset
,mediumInset
,largeInset
,xlargeInset
- Button
- New
transition
(string) prop to specify custom page transition name for list link
- New
- Grid
Col
component now uses new breakpoint names for responsive size props. So there are new props instead oftabletWidth
anddesktopWidth
:xsmall
,small
,medium
,large
,xlarge
.<Col size="50" medium="33" large="25">...</Col>
- Icon
size
prop will also set elementwidth
andheight
in addition to justfont-size
(like before)- Removed support for Font Awesome and Ionic icons, props
fa
andion
not supported anymore
- Link
- New
transition
(string) prop to specify custom page transition name for list link
- New
- List
- Sortable
sort
event data now also containel
property with reference to sorted item - Sortable
sort
event data now containssortableData
property as first argument - New
sortableTapHold
prop to enable sorting on tap hold. Alsoapp.touch.tapHold
parameter should be enable to emittaphold
events. tabletInset
prop has been removed- New inset props to reflect new breakpoint names:
xsmallInset
,smallInset
,mediumInset
,largeInset
,xlargeInset
- Sortable
- ListItem
accordionBeforeOpen
,accordionBeforeClose
events now containprevent
method as first argumentswipeout
event now contains swipeoutprogress
as first argument- New
transition
(string) prop to specify custom page transition name for list link
- ListInput/Input
- Support for new
type="texteditor"
prop to make it appear as Text Editor - New
textEditorParams
prop to specify text editor parameters
- Support for new
- Navbar
- Removed support for boolean
inner
prop and removed ability to render it without navbar-inner element - New
largeTransparent
prop to make large navbar transparent (should be used in addition tolarge
prop) nav-left
slot renamed toleft
nav-right
slot renamed toright
- New
title-large
slot
- Removed support for boolean
- Panel
- New
collapsedBreakpoint
(number) prop - app width when panel becomes partially visible (collapsed) - New
visibleBreakpoint
(number) prop - app width when panel becomes fully visible - New
swipe
(boolean) prop - makes panel swipeable - New
swipeOnlyClose
(boolean) prop - makes panel swipeable but only to close - New
swipeActiveArea
(number) prop - active area from the edge of the screen where panel swipes enabled - New
swipeThreshold
(number) prop - panel will not move with swipe if "touch distance" will be less than this value
- New
- Page
ptr:refresh
event now containsdone
method as first argument
- PageContent
ptr:refresh
event now containsdone
method as first argument
- PhotoBrowser
backLinkText
prop renamed topageBackLinkText
- New
popupCloseLinkText
prop to specify "close" link text when it is opened as Popup or as Standalone - New
navbarShowCount
prop to define should it display "3 of 5" text in navbar title or not. If not specified (undefined) then it will show this text if there is more than 1 item
- Popup
- New
push
prop to push view(s) behind on open
- New
- Segmented
- New
strong
,strongIos
,strongMd
andstrongAurora
props to enable new "strong" segmented style
- New
- Sheet
- New
push
prop to push view(s) behind on open
- New
- Statusbar
Statusbar
component has been removed
- Tabs
- New
swiperParams
prop to specify swipeable tabs swiper parameters
- New
- TextEditor
- New
TextEditor
component
- New
v4.5.2 - September 27, 2019
- Core
- Router
- Fixed issue in Firefox when going back from routable modal could reload the page in (#3316)
- Card
- Fixed issue with expandable card close, when it is opened in view with sidebar (#3315)
- Swipeout
- Fixed issue when overswipe didn't work with single item (#3279)
- SmartSelect
- Fixed issue when destroying it on close could throw and error
- Autocomplete
- Fixed issue when destroying it on close could throw and error
- Photo Browser
- Fixed issue when destroying it on close could throw and error
- Router
v4.5.1 - September 19, 2019
- Core
- Router Component
- Improved scoped styles parsing algorithm
- Swiper
- Fixed error in swiper lazy module
- Color Picker
- Fixed error with "Current Color" module destroy
- Panel
- Fixed issue with not working
breakpoint
events
- Fixed issue with not working
- Router Component
v4.5.0 - August 21, 2019
- Core
- Router Component
- Fixed issue breaking rendering when root component element is not a
div
- Fixed issue breaking rendering when root component element is not a
- Searchbar
- Fixed issue with scroll for expandable Searchbar in RTL direction
- Sortable
- Now new
no-sorting
ordisallow-sorting
class can be added to specific list item to disable sorting for it
- Now new
- Infinite Scroll
- Fixed issue when it may not work on routable tab if routable tab content is infinite-scroll element
- Pull To Refresh
- Fixed issue when it may not work on routable tab if routable tab content is PTR element
- Dialog
- Fixed issue when calling
.close()
on queued dialog would still open it
- Fixed issue when calling
- Smart Select
- New
formatValueText(values)
parameter to return formatted (custom) text value that appears on list item (initem-after
) - New
setValueText
(by default istrue
) parameter to set formatted text value on list item (initem-after
) - Now it emits
beforeOpen(instance, prevent)
event that allows to prevent its opening by callingprevent()
function
- New
- Preloader
- Fixed issue when it didn't initialize correctly in routable tab
- Progressbar
- Fixed issue when it didn't initialize correctly in routable tab
- Popover
- Fixed issue when during positioning it didn't consider top safe area
- Router Component
- Phenome
- Button, FabButton, Fab, Icon, Link, ListButton, ListItem
- Improved
tooltip
prop reactivity to change, set or unset tooltip correctly
- Improved
- ListItem
- Now settings
sortable: false
prop on it, will prevent this specific item from sorting
- Now settings
- Navbar
nav-left
slot is also available asleft
slotnav-right
slot is also available asright
slot- New
title-large
slot to add custom content/layout to large title text
- List, ListGroup
- New
sortableMoveElements
(boolean) prop that allow to override samesortable.moveElements
global app parameter. That when disabled (false
) won't move DOM elements on sort
- New
- Button, FabButton, Fab, Icon, Link, ListButton, ListItem
- Minor fixes
v4.4.10 - July 29, 2019
- Core
- Device
- Fixed
device-desktop
class
- Fixed
- Device
v4.4.9 - July 29, 2019
- Core
- Infinite Scroll
- Fixed issue when destroying infinite scroll could detach all other
scroll
event listeners
- Fixed issue when destroying infinite scroll could detach all other
- Navbar/Toolbar
- Fixed issue with enabled
hideNavbar/ToolbarOnScroll
could hide toolbar on nested elements scrolling
- Fixed issue with enabled
- Device
- On desktop
device.os
will containmacos
orwindows
if it is running under these OS
- On desktop
- Infinite Scroll
- Phenome
- Card
- Added
backdropEl
property to specify custom card backdrop
- Added
- Card
v4.4.7 - July 19, 2019
- Core
- Card
- Fixed issue when
data-close-by-backdrop-click
was ignored
- Fixed issue when
- Sheet
- New
sheet:stepprogress
andsheetStepPropgress
events firing during swipe step
- New
- Inputs
- New
--f7-input-padding-left
and--f7-input-padding-right
CSS variables - New
--f7-textarea-height
CSS variable
- New
- Device
- Fixed iOS 13 iPad detection when it is in desktop mode
- View/Router
- Fixed issue when
currentView
may not return View in tabs layout - Fixed issue when returning to previous page could block its scroll in iOS
- Fixed issue when
- Tooltip
- Fixed issue when tooltip wasn't initialized if added dynamically with VDOM
- Card
- Minor fixes
v4.4.6 - July 1, 2019
- Core
- Router
- Fixed issue when loading detail page in (Master Detail) with
reloadAll
loaded only detail page
- Fixed issue when loading detail page in (Master Detail) with
- Router
v4.4.5 - June 27, 2019
- Core
- Router
- Improved Master-Detail behavior with
pushState
enabled - Fixed issue when routable modal template contains comments before actual template
- Route
params
now url-decoded
- Improved Master-Detail behavior with
- Router Component
- Fixed issue when Progressbar progress wasn't updated with
$setState
- Fixed issue when Progressbar progress wasn't updated with
- Router
- Phenome
- Page
- Fixed issue with not correctly rendered preloader when infinite or ptr preloader property set dynamically
- Page
- Minor tweaks and fixes
v4.4.3 - June 4, 2019
- Core
- Color Picker
- New Hue-Saturation spectrum module (
hs-spectrum
) - New Brightness slider module (
brightness-slider
)
- New Hue-Saturation spectrum module (
- Router
- Fixed issue when
beforeIn
page callback called beforebeforeOut
of other page
- Fixed issue when
- Virtual List
- Now it is possible to pass custom scrollable parent element with new
scrollableParentEl
parameter
- Now it is possible to pass custom scrollable parent element with new
- Color Picker
- Phenome
- Range
- New
name
prop to specify input's "name" attribute
- New
- Stepper
- New
name
prop to specify input's "name" attribute
- New
- ListButton
- Now also supports
tooltip
property to display tooltip
- Now also supports
- ListItem
- Now also supports
tooltip
property to display tooltip
- Now also supports
- Range
- Minor fixes
v4.4.0 - May 13, 2019
- Core
- All new Treeview component π
- Popup
- Added "swipe-to-close" feature
- New
swipeToClose
parameter that will allow to close Popup with swipe - New
swipeHandler
parameter to specify swipe to close handler element
- Sheet Modal
- Added "swipe-to-close" feature
- Added "swipe-to-step" feature
- New
swipeToClose
parameter that will allow to close Sheet modal with swipe - New
swipeToStep
parameter that will allow to expand Sheet modal with swipe - New
swipeHandler
parameter to specify swipe to close handler element - New
stepOpen()
,stepClose()
andstepToggle()
sheet instance methods to open, close and toggle swipe step. - New
app.sheet.stepOpen()
,app.sheet.stepClose()
andapp.sheet.stepToggle()
app sheet methods to open, close and toggle swipe step. - New
sheet:stepopen
,sheet:stepclose
sheet DOM events - New
stepOpen
,stepClose
sheet instance events - New
sheetStepOpen
,sheetStepClose
app instance events
- Autocomplete
- Now it is possible to select dropdown values with keyboard UP and DOWN keys
- Now it will close dropdown on ESC key
- Checkbox
- Added support for indeterminate checkboxes
- Data Table
- Now it uses indeterminate checkbox in head when some of the rows are selected
- Range Slider
- New
limitKnobPosition
boolean property to limit knob position to size of the bar. By default enabled for iOS theme
- New
- Phenome
- Treeview
- New
Treeview
andTreeviewItem
components
- New
- Popup
- Added "swipe-to-close" feature
- New
swipeToClose
prop that will allow to close Popup with swipe - New
swipeHandler
prop to specify swipe to close handler element
- Sheet Modal
- Added "swipe-to-close" feature
- Added "swipe-to-step" feature
- New
swipeToClose
parameter that will allow to close Sheet modal with swipe - New
swipeToStep
parameter that will allow to expand Sheet modal with swipe - New
swipeHandler
parameter to specify swipe to close handler element - New
sheet:stepopen
(sheetStepOpen
),sheet:stepclose
(sheetStepClose
) sheet events
- Checkbox/ListItem
- New
indeterminate
prop to make checkbox indeterminate
- New
- Range Slider
- New
limitKnobPosition
boolean property to limit knob position to size of the bar. By default enabled for iOS theme
- New
- Treeview
- Minor fixes
v4.3.1 - April 29, 2019
- Core
- Range Slider
- Fixed issue with vertical slider not working correctly with side swipes
- Cards
- Fixed issue with expandable cards glitches in iOS
- Expandable card app parameters can now be set on each card individually with
data-
attributes:data-animate
,data-backdrop
,data-swipe-to-close
,data-close-by-backdrop-click
,data-hide-navbar-on-open
,data-hide-toolbar-on-open
- Router
- Fixed missing reference to
pageFrom
in swipe-back data - Router component has new
$id
property
- Fixed missing reference to
- Touch
- Now touch clicks threshold is configurable with
app.touch.touchClicksDistanceThreshold
parameter
- Now touch clicks threshold is configurable with
- Range Slider
- Phenome
- Card
- Expandable card app parameters can now be set on each card individually with new props:
animate
,hideNavbarOnOpen
,hideToolbarOnOpen
,swipeToClose
,closeByBackdropClick
,backdrop
- Expandable card app parameters can now be set on each card individually with new props:
- Navbar
- Now it should return all children correctly when
inner: false
passed
- Now it should return all children correctly when
- Card
- Minor fixes
v4.3.0 - April 17, 2019
- Core
- Color Picker - all new modular Color Picker component π
- Auto Dark Theme
- Now it can be set automatically based on user system color scheme preference (where supported). To enable
autoDarkTheme: true
must be passed to app init parameters - New
app.enableAutoDarkTheme()
to enable this feature manually (where supported) - New
app.disableAutoDarkTheme()
to disable this feature manually
- Now it can be set automatically based on user system color scheme preference (where supported). To enable
- Panel
- Now side panels can be resizable π. Requires
panel-resizable
class on panel element to enable
- Now side panels can be resizable π. Requires
- Device
- New
prefersColorScheme()
that returnsdark
orlight
where supported, orundefined
where not supported
- New
- Cards
- Fixed issue whith "jumpy" layout when expandable card closes on iOS
- Navbar
- New
navbar:hide
andnavbar:show
events when navbar hidden/shown - New
navbar:collapse
andnavbar:expand
events when navbar collapsed/expanded to large title navbar
- New
- Popover
- New
closeOnEscape
parameter to allow to close it whenESC
keyboard key pressed (disabled by default) - New
backdropEl
parameter to pass custom backdrop element - Now it won't be closed on backdrop click if onscreen keyboard opened (requires cordova keyboard plugin)
- Now it will be repositioned when onscreen keyboard opens and closes (requires cordova keyboard plugin)
- Reworked/tweaked positioning in MD theme
- New
- Popup
- New
closeOnEscape
parameter to allow to close it whenESC
keyboard key pressed (disabled by default) - New
backdropEl
parameter to pass custom backdrop element - Now it won't be closed on backdrop click if onscreen keyboard opened (requires cordova keyboard plugin)
- New
- Actions
- New
closeOnEscape
parameter to allow to close it whenESC
keyboard key pressed (disabled by default) - New
backdropEl
parameter to pass custom backdrop element - Now it won't be closed on backdrop click if onscreen keyboard opened (requires cordova keyboard plugin)
- New
- Sheet
- New
closeOnEscape
parameter to allow to close it whenESC
keyboard key pressed (disabled by default) - New
backdropEl
parameter to pass custom backdrop element - Now it won't be closed on backdrop click if onscreen keyboard opened (requires cordova keyboard plugin)
- Now it can be opened from top (instead of bottom) by adding
sheet-modal-top
class to sheet modal element
- New
- Stepper
- Reworked RTL layout to be in same direction as in LTR
- Request
- Now it automatically set
Accept: 'application/json'
header whendataType: 'json'
parameter passed
- Now it automatically set
- Touch
- Fixed issue with not-removed touch-ripple with very fast clicks or multi-touch
- Utils
- New
utils.colorHsbToHsl(h, s, b)
method to convert HSB(V) color to HSL color - New
utils.colorHslToHsb(h, s, l)
method to convert HSL color to HSB(V) color
- New
- Phenome
- Panel
- New
resizable
prop to enable resizable panel
- New
- Navbar
- New
navbar:hide
/navbarHide
andnavbar:show
/navbarShow
events when navbar hidden/shown - New
navbar:collapse
/navbarCollapse
andnavbar:expand
/navbarExpand
events when navbar collapsed/expanded to large title navbar
- New
- Popover
- Added
backdrop
prop to enable/disable backdrop - New
closeOnEscape
prop to allow to close it whenESC
keyboard key pressed (disabled by default) - New
backdropEl
prop to pass custom backdrop element
- Added
- Popup
- New
closeOnEscape
prop to allow to close it whenESC
keyboard key pressed (disabled by default) - New
backdropEl
prop to pass custom backdrop element
- New
- Actions
- Added
backdrop
prop to enable/disable backdrop - New
closeOnEscape
prop to allow to close it whenESC
keyboard key pressed (disabled by default) - New
backdropEl
prop to pass custom backdrop element
- Added
- Sheet
- New
closeOnEscape
prop to allow to close it whenESC
keyboard key pressed (disabled by default) - New
backdropEl
prop to pass custom backdrop element - New
position
prop, can betop
orbottom
(default) to define how to open Sheet - New
top
prop, alias forposition="top"
- New
bottom
prop, alias forposition="bottom"
- New
- ListInput / Input
- Now it accepts special type
colorpicker
to open color picker on focus - New prop
colorPickerParams
to specify color picker params forcolorpicker
type
- Now it accepts special type
- SwipeoutButton
- New
confirmTitle
prop to set confirm dialog title
- New
- Panel
- Lots of minor fixes and improvements
v4.2.2 - April 4, 2019
- Core
- Smart Select
- New
scrollToSelectedItem
parameter - when enabled it will scroll smart select content to first selected item on open (defaultfalse
) - New
.scrollToSelectedItem()
smart select instance method to scroll smart select content to first selected item (when opened) - Now when opened in Popup, it will render Popup's close button as a plain text link on the right side in Navbar
- New
- Autocomplete
- Now when opened in Popup, it will render Popup's close button as a plain text link on the right side in Navbar
- Router
- Fixed issue with swipe-back when used in Master-Detail layout
- List Index
- Fixed issue with wrong positioning when used with large navbar
- Smart Select
- Phenome
- ListInput / Input
- Now it accepts special type
datepicker
to open calendar on focus - New prop
calendarParams
to specify calendar params fordatepicker
type
- Now it accepts special type
- Button
- New
type
prop. If this prop is one ofsubmit
,button
orreset
then it will be rendered as<button>
tag
- New
- ListInput / Input
- Lots of minor fixes
v4.2.0 - March 20, 2019
- All new Aurora theme! π₯π
- Core
- New Appbar component
- Button
- New
button-round-aurora
,button-raised-aurora
,button-fill-aurora
,button-small-aurora
,button-large-aurora
,button-outline-aurora
modifier classes for Aurora theme
- New
- Cards
- Now it is possible to specify custom expandable card backdrop element with
data-backdrop-el
attribute on card
- Now it is possible to specify custom expandable card backdrop element with
- Device
- New
device.electron
property which istrue
when app runs in Electron environment
- New
- List Index
- New
auroraItemHeight
parameter to specify item height in Aurora theme
- New
- Navbar
- New
auroraCenterTitle
parameter (enabled by default) to position title at the center in Aurora theme.
- New
- Panel
- New
app.panel.toggle(side, animate)
method to toggle (open or close) specified panel - New
panel.toggle(animate)
method to toggle (open or close) current panel - Support for
panel-toggle
class on links to toggle panels
- New
- Picker
- New
mousewheel
parameter (enabled by default) to scroll picker values with mousewheel - New
updateValuesOnMousewheel
parameter (enabled by default) to updates picker and input values during mousewheel scrolling
- New
- Pull To Refresh
- Added mousewheel support with additional
data-ptr-mousewheel="true"
attribute on PTR content element
- Added mousewheel support with additional
- Searchbar
- New Inline Searchbar to fit it better within other components. Can be enabled by adding
searchbar-inline
class to searchbar
- New Inline Searchbar to fit it better within other components. Can be enabled by adding
- Stepper
- New
stepper-round-aurora
,stepper-raised-aurora
,stepper-fill-aurora
,stepper-small-aurora
,stepper-large-aurora
modifier classes for Aurora theme
- New
- Toolbar
- New
toolbar-top-aurora
andtoolbar-bottom-aurora
modifier classes for Aurora theme
- New
- Touch
- Not it is possible to prevent active state bubbling on nested active-state elements with additional
prevent-active-state-propagation
class on nested active-state element - Improved clicks handling with Apple Pencil
- Not it is possible to prevent active state bubbling on nested active-state elements with additional
- Typography
- New half-value margin and padding classes:
margin-half
,margin-left-half
,margin-right-half
,margin-top-half
,margin-bottom-half
,margin-horizontal-half
,margin-vertical-half
,padding-half
,padding-left-half
,padding-right-half
,padding-top-half
,padding-bottom-half
,padding-horizontal-half
,padding-vertical-half
- New half-value margin and padding classes:
- View / Router
- Router component's
$theme
object now contains booleanaurora
property which istrue
for Aurora theme - New Aurora-related parameters:
auroraPageLoadDelay
,auroraSwipeBack
,auroraSwipeBackThreshold
,auroraSwipeBackActiveArea
,auroraSwipeBackAnimateShadow
,auroraSwipeBackAnimateOpacity
- Fixed VDOM rendering with SVG elements
- Router component's
- Phenome
- React and Vue's component prototype
$theme
object now contains booleanaurora
property which istrue
for Aurora theme - New Appbar component
- Button
- New Aurora related modifier props:
raisedAurora
,roundAurora
,largeAurora
,smallAurora
,fillAurora
,outlineAurora
- New Aurora related modifier props:
- Icon
- New
aurora
prop to specify icon for Aurora theme
- New
- Link
- New
iconAurora
prop to specify icon for Aurora theme
- New
- ListIndex
- New
auroraItemHeight
prop to specify item height in Aurora theme
- New
- Navbar
- New boolean
backLinkForce
prop to load and ignore previous page in history - New boolean
backLinkShowText
prop to hide or show back button text. By default disable for MD theme
- New boolean
- Page
- New
ptrMousewheel
prop to make PTR work with mousewheel
- New
- Searchbar
- New
inline
boolean prop to enable inline searchbar
- New
- Stepper
- New Aurora related modifier props:
raisedAurora
,roundAurora
,largeAurora
,smallAurora
,fillAurora
- New
iconAurora
prop to specify icon for Aurora theme
- New Aurora related modifier props:
- Toolbar
- New
topAurora
andbottomAurora
boolean props to set Toolbar position for Aurora theme
- New
- React and Vue's component prototype
- Lots of minor fixed and improvements
v4.1.1 - March 14, 2019
- Core
- Form
- Fix form ajax event arguments (
xhr
anddata
) to be ine.detail
- Fix form ajax event arguments (
- Panel
- Unset breakpoint layout on panel destroy
- Autocomplete
- Fixed issue with autocomplete dropdown click on iOS devices
- Router
- Fixed wrong behavior of navbar back link with swipe back in
ios
theme
- Fixed wrong behavior of navbar back link with swipe back in
- Cards
- Fixed issue when opened expanadble cards wasn't positioned correctly in some layouts
- Form
- Minor fixes
v4.1.0 - March 4, 2019
- Core
- Input
- New "outline" input styles
- List
- Fixed sticky list group titles when used with large navbar
- Cards
- Fixed issue when opened expanadble cards wasn't positioned correctly in some layouts
- Tooltip
- Fixed tooltip auto init under ios theme when it is used in navbar
- Calendar
- Fixed issue when
monthSelector
andyearSelector
params were ignored
- Fixed issue when
- Input
- Phenome
- Support for new outline inputs by adding boolean
outline
prop tof7-list-input
/ListInput
component
- Support for new outline inputs by adding boolean
- Minor fixes
v4.0.6 - February 25, 2019
- Core
- Searchbar
- Tweaked/fixed styles for MD-Dark theme
- Pull To Refresh
- Now it will be ignored on opened expandable cards
- Now it will be ignored on elements with
ptr-ignore
class
- Dialog
- Fixed text alignment in RTL direction
- Swiper update to latest 4.5.0:
- Core
- New
swiper.changeDirection()
method to change direction from horizontal to vertical (and back) dynamically direction
parameter can be used in breakpoints
- New
- Virtual Slides
swiper.virtual.appendSlide
now accepts array of slides to addswiper.virtual.prependSlide
now accepts array of slides to prepend- New
swiper.virtual.removeSlide(indexes)
to remove virtual selected slides - New
swiper.virtual.removeAllSlides()
to remove all virtual slides
- Navigation
- Now it emits
navigationHide
andnavigationShow
events when on nav hide/show
- Now it emits
- Pagination
- Now it emits
paginationHide
andpaginationShow
events when on pagination hide/show
- Now it emits
- Core
- Searchbar
- Phenome
- Fixed broken
textarea:resize
/textareaResize
onInput
andListInput
components
- Fixed broken
- Minor fixes
v4.0.5 - February 14, 2019
- Core
- Fixed d.ts reference path
v4.0.4 - February 13, 2019
- Core
- Fixed lost messages color
v4.0.3 - February 13, 2019
- Core
- Fixed d.ts reference path
v4.0.2 - February 13, 2019
- Core
- Fixed issue when event handlers attached with
.once
may not be detached correctly later - Router
- Fixed issue when routable tab with params
/:param/
in path could produce new page loading instead of switching tab
- Fixed issue when routable tab with params
- Card
- Add
card-prevent-open
class that can be added to element inside of the expandable card. Click on that element won't open expandable card.
- Add
- Searchbar
- Fixed Searchbar position when it is used on page with large navbar
- Fixed issue when event handlers attached with
- Dom7 update to latest 2.1.3:
- Fixed issue when event handlers attached with
.once
may not be detached correctly later
- Fixed issue when event handlers attached with
- Phenome
- Card
- New
cardPreventOpen
prop on Link-like components to prevent expandable card open on this element click.
- New
- Card
- Minor fixes
v4.0.1 - February 8, 2019
- Core
- Fixed issue with Safari crashing on
button-large
rendering - Fixed issue with wrong active button color in bars
- Removed not needed animation prefixes in utils
- Fixed issue with Safari crashing on
v4.0.0 - February 7, 2019 πππ
v3.6.6 - February 5, 2019
- Core
- App
data
andmethods
now available before app initialization. Useful when you delay app initialization (like ondeviceready
event in Cordova app) and need to access data before - Pull To Refresh
- Support for
ptr-watch-scroll
that should be added on scollable elements inside ofptr-content
, so pull to refresh won't trigger during their scrolling
- Support for
- Panel
- Fixed issue when panel backdrop not removed for routable panel
- Template7 update to latest 1.4.1:
- Relaxed
escape
helper to escape only<>&"'
characters - Improved variables parsing in
js
andjs_if
helpers
- Relaxed
- App
- Minor fixes
v3.6.5 - January 4, 2019
- Core
- Router
- Now router methods will throw error if accessed on main app router, e.g.
app.router.navigate()
, it was never allowed, and done to avoid further issues
- Now router methods will throw error if accessed on main app router, e.g.
- Router
- Minor fixes
v3.6.3 - December 27, 2018
- Core
- Range
- New
formatLabel
parameter that allows to pass function and return formatted value for range knob label
- New
- Tabs
- Fixes issue when routable swipeable tabs don't emit
tab:show
events
- Fixes issue when routable swipeable tabs don't emit
- Dialog
- Now it is possible to specify default value for Prompt dialog by adding it as last parameter to
app.dialog.prompt()
method
- Now it is possible to specify default value for Prompt dialog by adding it as last parameter to
- Range
- Phenome
- New
routeProps
prop for Link, Button, ListItem, ListButton components that allows to pass props directly to target route component. For example,<f7-link :props="{foo: 'bar'}">
- New
formatLabel
prop for Range component that allows to pass function and return formatted value for range knob label
- New
- Lost of minor fixes
v3.6.2 - December 11, 2018
- Core
- View
- Fixed wrong type for
name
parameter in typescript definitions
- Fixed wrong type for
- View
- Phenome
- Message - fixed wrong click handler target
v3.6.1 - December 10, 2018
- Phenome (React / Vue)
- Tabs - fixed issue with broken Animated/Swipeable tabs
v3.6.0 - December 7, 2018
- Core
- Router
- New
keepAlive
routes. When route's page is specified withkeepAlive: true
, then it, instead of removing and destroying component, it will be detached from DOM and attached back when required. - New
router.clearPreviousPages()
method that removes all previous (stacked) pages from DOM
- New
- Accordion
- New
accordion:beforeopen
event that is triggered right before accordion will be opened.event.detail.prevent
contains function that will prevent it from opening if called; - New
accordion:beforeclose
event that is triggered right before accordion will be closed.event.detail.prevent
contains function that will prevent it from closing if called;
- New
- Router
- Phenome (React / Vue)
- AccordionItem and ListItem have new
accordion:beforeopen
/accordionBeforeOpen
events, second argument passed to handler contains function that will prevent it from closing if called; - AccordionItem and ListItem have new
accordion:beforeclose
/accordionBeforeClose
events, second argument passed to handler contains function that will prevent it from closing if called; - View component now accepts MD-theme related swipeback props:
mdSwipeBack
,mdSwipeBackAnimateShadow
,mdSwipeBackAnimateOpacity
,mdSwipeBackActiveArea
,mdSwipeBackThreshold
- ListItem has new
virtualListIndex: Number
property to specify item index when rendered inside of Virtual List - Searchbar has new
value
property to specify Searchbar input's value. Can be usefule when used withcustomSearch
enabled
- AccordionItem and ListItem have new
- Lots of minor fixes and improvements
v3.5.2 - November 12, 2018
- Core
- List
- Fixed issue with hairlines in last swipeout-list item
- Panel
- Fixed issue when routable Panel can appear without backdrop
- Searchbar
- New
inputEvents
parameter that allow to specify which input events should be tracked for search
- New
- List
- Phenome
- ListInput - add
tag
property to allow to change defaultli
tag to anything else - Searchbar - new
inputEvents
prop that allow to specify which input events should be tracked for search - Fixed issue with router page classes
- ListInput - add
- Minor fixes
v3.5.1 - November 2, 2018
- Core
- Swiper update to latest 4.4.2:
- New
touchStartForcePreventDefault
parameter to force touch start event prevent default - Breakpoints fix when breakpoint keys are strings
- Fixed issue when draggable scrollbar may not work on desktop Safari
- Fixed issue with wrong sort of Virtual Slides
- New
- Swipeout
- Added new
swipeout:overswipeenter
andswipeout:overswipeexit
events fired when overswipe enabled/disabled
- Added new
- Panel
- Fixed issue when Swipe Panel could cause kind of screen flickering on open
- Swiper update to latest 4.4.2:
- Phenome
- Messagebar - new
textareaId
property to set ID attribute on its textarea - ListItem - new
swipeoutOverswipeEnter
andswipeoutOverswipeExit
events
- Messagebar - new
- Minor fixes
v3.5.0 - October 26, 2018
- Phenome
- Fix issues with handling "stacked" pages
- New ListInput component to be used instead of ListItem+Label+Input
- Minor fixes
v3.4.3 - October 19, 2018
- Phenome
- Input - better handling of
with-value
andfocused
states - Messagebar - make
resizePage
enabled by default like in docs
- Input - better handling of
- Minor fixes
v3.4.2 - October 12, 2018
- Core
- Device
- Added correct detection for
webView
prop when app installed to home screen
- Added correct detection for
- Accordion
- Fixes issue when
accordionOpened
event fired without passing opened element as argument
- Fixes issue when
- Request
- If
contentType: 'application/json'
andprocessData: false
it will automatically send POST data as JSON
- If
- Picker
- Fixed issue when double click outside of opened Picker could cause router navigating to previous page
- Pull To Refresh
- Now it will ignore PTR when scrolling in page's nested container
- Panel
- Now it respects
swipeThreshold
parameter whenswipeNoFollow
is enabled
- Now it respects
- Searchbar
- New
searchGroup
parameter to handle custom item groups to hide on search - New
searchGroupTitle
parameter to handle custom item groups titles to hide on search
- New
- Device
- Phenome (React / Vue)
- Input - better handling of
with-value
andfocused
states when used in list item - Searchbar - new
searchGroup
andsearchGroupTitle
props - Page - improved router-related page classes handling that could cause issue with navigation
- Input - better handling of
- Minor fixes
v3.4.0 - September 28, 2018
- Core
- Lazy modules support π
- Added support to load F7 modules during runtime with new app methods:
- New
app.loadModule(module)
method to load F7 module - New
app.loadModules([module])
method to load array of F7 modules
- New
- New
lazyModulesPath
app parameter to specify lazy modules location - New lazy component files in
lazy-components/
package folder - New
js/framework7-lazy.js
script containing core version of Framework7 - New
css/framework7-lazy.css
styles containing core version of Framework7
- Added support to load F7 modules during runtime with new app methods:
- Router
- New Route's
modules
parameter to load F7 modules before entering the route
- New Route's
- Statusbar
- Added new
statusbar
app parameters:androidOverlaysWebView
(by defaultfalse
)androidTextColor
(by defaultblack
)androidBackgroundColor
(by defaultnull
)
- Added new
app.statusbar
app methods:app.statusbar.overlaysWebView(overlays)
app.statusbar.setTextColor(color)
- Added new
- Lazy modules support π
- Phenome
- Lots of TypeScript definitions fixes and tweaks
- Minor fixes
v3.3.2 - September 20, 2018
- Core
- Support for new iPhone XR / XS / XS Max
- View
- Now it emits
view:init
DOM event andviewInit
app event
- Now it emits
- Router
- Now it is possible to pass React/Vue component
props
in routeoptions
or when navigating likerouter.navigate('/somepage/', { props: { foo: 'bar' } })
- Now it is possible to pass React/Vue component
- Phenome
- View Component - added support
viewInit
event - Improved TypeScript declaration for React components events
- View Component - added support
- Minor fixes
v3.3.1 - September 14, 2018
- Core
- Router
- TypeScript defs tweaks #2668 #2666
- Panel
- TypeScript defs tweaks #2667
- Smart Select
- Fixed issue when it could throw error on init trying to get select
name
attribute
- Fixed issue when it could throw error on init trying to get select
- Router
- Phenome
- ListItem
- Fixed issue when Smart Select could be opened twice that caused router issue on navigating back
- ListItem
v3.3.0 - September 14, 2018
- Core
- Added TypeScript definitions for whole core framework APIs (with huge help of @JasonKleban)! π
- Swiper update to latest 4.4.1:
- Core
- New
centerInsufficientSlides
parameter to center slides if the amount of slides less thanslidesPerView
- New
breakpointsInverse
parameter (boolean), if enabled then it will count breakpoints in reversed direction, e.g. will override parameters if window width is more than specified breakpoint
- New
- Virtual Slides
- New
addSlidesBefore
andaddSlidesAfter
parameters to increase amount of pre-rendered slides
- New
- Thumbs
- All new "Thumbs" module/component designed to control slider thumbnails, in more logical and correct way than with Controller module.
- Core
- Virtual DOM Router Components
- Added snabbdom's "style" module that allows to make fancy and smooth custom animations
- Input
- Now input placeholder will be visible on item with floating label when it receives focus
- Phenome
- Added TypeScript definitions for all React components π
- Added TypeScript definitions for F7-Vue and F7-React components extensions (e.g.
this.$f7
,this.$f7router
, etc.) π - List Component
- new
noChevron
prop to disable "chevron" icon on all nested list items with link - new
chevronCenter
prop to set "chevron" icon in the middle of all nested media list items with link
- new
- ListItem Component
disabled
prop will now set "disabled" class on list item if it is not a checkbox or radio- new
noChevron
prop to disable "chevron" icon on list item with link - new
chevronCenter
prop to set "chevron" icon in the middle of media list item with link
- Improved Framework7 initialization routine
- Fixed issue when
f7ready
callback fired beforedeviceready
event in Cordova environment
- Lots of fixes
v3.2.1 - August 31, 2018
- Template7 - updated to latest 1.4.0
- Added TypeScript Definitions
- Dom7 - updated to latest 2.1.0
- Added TypeScript Definitions
- Phenome
- Navbar - added
innerClass
andinnerClassName
(alias) props to set additional class onnavbar-inner
element - Popup - fixed issue when its
animate
andbackdrop
props became disabled by default
- Navbar - added
- Minor fixes
v3.2.0 - August 28, 2018
- Core
- Router
- Added support for routable Panels! Thanks to @bencompton π
- Added support to navigate to route by its name using
router.navigate({ name: 'someroute' })
- Optimized Router Component ES template parsing
- Now it caches XHR-loaded Router Components (from
componentUrl
)
- Calendar
- New
backdrop
andcloseByBackdropClick
parameters
- New
- Smart Select
- New
cssClass
parameter that will add additional class to Smart Select element searchbar
parameter now can be a full object with Searchbar parameters- New
appendSearchbarNotFound
parameter that adds additional element to Smart Select container that will be visible when there are no searchbar results
- New
- Popup
- Fixed issue on backdrop click when multiple popups opened same time
- Device
- It now adds
device-macos
anddevice-windows
html classes when relevant device is used
- It now adds
- Utils - 2 new methods added:
app.utils.uniqueNumber()
- returns unique counter numberapp.utils.id(mask, map)
- returns randomly generated string by mask, e.g.app.utils.id('xxxx-xxxx-xxxx-xxxx')
will return string liked692-c811-e032-6028
- Router
- Phenome (Vue/React)
- View component - added new
routesBeforeEnter
androutesBeforeLeave
properties - List component - now emits
submit
event if it is used as form - List Item component - fixed issue with
onChange
event in React - Actions, Popover, Sheet - added new
closeByBackdropClick
andcloseByOutsideClick
properties - Popup - added new
closeByBackdropClick
,backdrop
,animate
properties
- View component - added new
- Lots of minor fixes
v3.1.1 - August 3, 2018
- Core
- Virtual DOM Router Components
- Improved boolean attributes handling (
readonly
,checked
, etc.) - Fixed issue when comment inside of template can break the rendering
- Better auto-init components cleanup
- Improved boolean attributes handling (
- Virtual DOM Router Components
- Minor fixes
v3.1.0 - July 31, 2018
- Core
- Router
- New
updateCurrentUrl(url)
method to update url of the currently active route (and current browser state ifpushState
is enabled) - Will emit new
routeUrlUpdate
event ifupdateCurrentUrl()
was called - Fixed issue when going back with enabled
pushState
could produce double pages back in Firefox - Fixed issue when changing routable swipeable tabs wasn't trigger
routeChanged
event - Single-file Router Components:
- It can now treat component template as ES template literal. Additional
es
attribute is required on template to enable, e.g.<template es>
- It is now rendered with Virtual DOM (Snabbdom library) for layout auto updating π
- It has new
$setState(mergeState)
method to set new component state and force component to update its layout
- It can now treat component template as ES template literal. Additional
- New
- Searchbar
- Fixed issue when in some situations it didn't trigger
search
event when used with Virtual List
- Fixed issue when in some situations it didn't trigger
- Calendar
- Day "events" dots layout is reworked and now each day can have few dots (of different color) at a time
- Input
- Fixed wrong resizable textarea calculation in Firefox
- Stepper
- Has new "manual input mode". When enabled it allows to type value from keyboar and check fractional part with defined accurancy. Also, when enabled, then
step
parameter is ignored during typing. It has 3 new parameters:manualInputMode: false
- enables manual input modedecimalPoint: 4
- number of digits after dotbuttonsEndInputMode: true
- disables manual input mode on Stepper's button click
- Has new "manual input mode". When enabled it allows to type value from keyboar and check fractional part with defined accurancy. Also, when enabled, then
- Swiper - updated to latest 4.3.5
- Core
iOSEdgeSwipeThreshold
parameter renamed to justedgeSwipeThreshold
. OldiOSEdgeSwipeThreshold
name is still supported- Improved observer performance if there are many mutations at a time.
- Controller
- Fixed issue with wrong auto height resizing
- Scrollbar
- Fixed issue when it was using active event listeners instead of passive.
- Core
- Dom7 - updated to latest 2.0.7
- Fixed issue with undefined elements in classList access (#13)
- Template7 - updated to latest 1.3.8
- Fixed issue with parsing parents in
js
andjs_if
helpers when properties contain$
character
- Fixed issue with parsing parents in
- Router
- Phenome
- Stepper component has new properties:
manualInputMode: false
- enables manual input modedecimalPoint: 4
- number of digits after dotbuttonsEndInputMode: true
- disables manual input mode on Stepper's button click
- Fixed Messagebar send-link reference issue
- Stepper component has new properties:
- Lots of minor fixes
v3.0.7 - July 20, 2018
- Phenome
- Fixed build error
v3.0.6 - July 20, 2018
- Core
- Fixed missing
idate
dependency
- Fixed missing
v3.0.5 - July 20, 2018
- Core
- Calendar
- Added support for Jalali calendar, can be enabled with
calendarType: 'jalali'
- New
rangePickerMinDays
andrangePickerMaxDays
to require min/max days when range picker enabled
- Added support for Jalali calendar, can be enabled with
- Tooltip
- Fixed issue when tooltip wasn't fully hidden on touch devices
- Router
routeChanged
event will also work for routable tabs now
- Calendar
- Phenome
- Fixed not working
readonly
prop inf7-input
Vue component
- Fixed not working
- Minor fixes
v3.0.1 - July 10, 2018
- Phenome
- Fixed
TypeError
error inActionsGroup
component
- Fixed
v3.0.0 - July 5, 2018 π
v3.0.0-beta.19 - July 3, 2018
- Core
- Router
- View/Router parameter
beforeLeave
renamed toroutesBeforeLeave
- View/Router parameter
beforeEnter
renamed toroutesBeforeEnter
- View/Router parameter
- Router
v3.0.0-beta.18 - July 3, 2018
- Core
- Router
- Fixed error with
beforeLeave
middleware when loading initial route
- Fixed error with
- Router
v3.0.0-beta.17 - July 2, 2018
- Core
- Router
preRoute
middleware renamed tobeforeEnter
that will be executed before route load/enter.- Added
beforeLeave
route middleware that will be executed before route unload/leave.
- Progressbar
- Fixed positioning of progressbar inside of the Page with statusbar enabled
- Router
v3.0.0-beta.16 - July 1, 2018
- Core
- Searchbar - fixed issue with wrong
previousQuery
insearch
event
- Searchbar - fixed issue with wrong
- Phenome
- ListItem has new
defaultChecked
prop to support React uncontrolled components
- ListItem has new
- Minor fixes
v3.0.0-beta.15 - June 27, 2018
- Phenome Components
- Fixes issue when React components could be rendered wrong in production build
v3.0.0-beta.14 - June 24, 2018
- Core
- Elevation
- Elevation moved to separate component
- Added support for
elevation-hover-$n
class to add elevation on hover - Added support for
elevation-pressed-$n
class to add elevation on press - Added support for
elevation-transiton
class to add transition between elevation states
- Elevation
- Phenome
- Icon
- Added support for tooltip with
tooltip
prop
- Added support for tooltip with
- Icon
v3.0.0-beta.12 - June 22, 2018
- Core
- Tooltip
el
parameter has been renamed totargetEl
- Accordion
- Now it toggles
aria-hidden
attribute on accordion content toggle
- Now it toggles
- Tooltip
v3.0.0-beta.11 - June 19, 2018
- Core
- Fix touch ripple issues that happen from time to time in Edge
- Fix minor push state issues in Edge
- Device util now has additional detections props:
windowsPhone
,windows
,macos
,ie
,edge
v3.0.0-beta.10 - June 15, 2018
- Core
- All new Gauge component with responsive SVG gauges
- Router
- Added
preRoute
support (middleware) that can be configured per route or globally on View/Router init for all routes
- Added
- Smart Select
- New
change
/smartSelectChange
events
- New
- Autocomplete
- Fixed error with undefined value replacement
- Tooltip
- New
setText
method to dynamically change Tooltip's text/content
- New
- Phenome
- Better validation logic for
Input
component Toggle
- fixed issue whentoggleChange
event not being fired on desktopListItemContent
- fixed issue with callingsetState
in render function- Support for
target
prop/attribute forLink
,Button
,Fab
,FabButton
components - Tooltip support (with
tooltip
prop) forFab
andFabButton
components - New
Gauge
(React) /f7-gauge
(Vue) component to produce responsive SVG gauges - Added Smart Select for
Link
component withsmartSelect
andsmartSelectParams
props
- Better validation logic for
v3.0.0-beta.9 - June 12, 2018
- Core
- All new Tooltip component
- Template7 update to latest 1.3.6
- Better
@global
parsing injs
andjs_if
helpers
- Better
- Phenome
- Now
f7route
andf7router
are passed as props for components loaded by router (Page, Routable Tabs, Routable Modals). $f7route
and$f7router
are now also available only on components loaded by router (Page, Routable Tabs, Routable Modals) and may not be available in custom children components. For children components they must be passed done using props- Added
tooltip
support forLink
andButton
components
- Now
v3.0.0-beta.8 - June 11, 2018
- Phenome
- Transform object rest spread syntax to Object.assign in Vue/React components
v3.0.0-beta.7 - June 9, 2018
- Core
- Lots of MD styles updated to new Material Design specification
- Cards
- New outline cards style
- Chips
- New outline style + tweaked iOS chips styles
- FAB
- New FAB-Extended style with additional text label support inside of FAB
- Support for FAB actions label
- Typography
- New Elevation styles, can be configured with
elevation-1
,elevation-2
, ...,elevation-24
classes
- New Elevation styles, can be configured with
- Dialog
- Preloader dialog now supports preloader color as second argument:
app.dialog.preloader(title, color)
- Preloader dialog now supports preloader color as second argument:
- Smart Select
- Will not error anymore about required View if it is actually not required (e.g. for SS opened in Popup, Popover or Sheet)
- Picker - fixed issues with touch/swipe areas in RTL layout
- Calendar
- Fixed issue when not possible to switch calendar to previous month when min date is the last date of previous month
- Fixed issue when double click behind calendar could cause router to go to the previous page
- Swiper - updated to latest
- Fixed issue when slidePrev goes to wrong slide #2650
- Fixed issue when roundLength was not considered for grids calculation #2656
- Phenome
- Card
- New
outline
prop to make card outline
- New
- Chip
- New
outline
prop to make chip outline
- New
- Fab
- New
text
prop to add text to FAB and make it as Extended FAB - New
label
prop forFabButton
to add label for fab button
- New
- Simplified conditional icon props for Icon, Link and Button components:
if-ios
->ios
,if-md
->md
,icon-if-ios
->icon-ios
,icon-if-md
->icon-md
- Input
- New
error-message-force
prop to force error message to show. Works in case ofvalidate
is omitted
- New
- Messagebar
- New
resizePage
prop that will resize messages page with messagebar - New
resizePage()
method renamed toresize()
- New
- Card
v3.0.0-beta.6 - June 5, 2018
- Phenome
- ListItem - fixed
subtitle
slot being ignored
- ListItem - fixed
v3.0.0-beta.5 - June 4, 2018
- Phenome - fix issue when passing
undefined
child to the component
v3.0.0-beta.4 - June 4, 2018
- Core
- App methods (specified in
methods
params) are now bound to app context (initialized F7 instance) - Swiper - updated to latest 4.3.2
- Core
- Added
addSlide(index, slide)
method to add slide at required position. Thanks to @kochizufan - Fixed issue with loop #2647. Thanks to @kochizufan
- Added
- Pagination
- New
formatFractionCurrent(number)
parameter to format current number in Fraction pagination - New
formatFractionTotal(number)
parameter to format total number in Fraction pagination
- New
- Core
- App methods (specified in
- Phenome
- Use
domProps
for Vue input components - ListItem
- New
swipeoutOpened
prop to control (open/close) swipeout item by prop
- New
- Use
v2.3.1 - June 1, 2018
- Searchbar
- Fixed issue with not hiding/showing backdrop when
customSearch
is enabled
- Fixed issue with not hiding/showing backdrop when
- Sortable
- New app parameter
sortable.moveElements
by default istrue
. Useful to disable when you use for DOM manipulation other library like Vue or React
- New app parameter
- Swiper update to latest v4.3.2:
- Core
- Added
addSlide(index, slide)
method to add slide at required position. Thanks to @kochizufan - Fixed issue with loop #2647. Thanks to @kochizufan
- Added
- Pagination
- New
formatFractionCurrent(number)
parameter to format current number in Fraction pagination - New
formatFractionTotal(number)
parameter to format total number in Fraction pagination
- New
- Core
- Minor fixes
v2.3.0 - May 27, 2018
- View/Router
- Fixed missing
pushStateOnLoad
parameter - Added support for routable Action Sheet
- Fixed missing
- Searchbar
- Fixed issue with exapandable Searchbar missplace in MD theme when used with Subnavbar
- Input
- New
scrollIntoViewDuration
app.input parameter to set duration for scrolling input into view - New
scrollIntoViewAlways
app.input parameter to scroll input into view no matter is it outside of view or not app.input.scrollIntoView
now has additionalforce
argument to scroll input into view no matter is it outside of view or not:app.input.scrollIntoView(inputEl, duration, centered, force)
- Clicking input's clear button now also triggers
input
event in addition tochange
event
- New
- Statusbar
- Improved statusbar overlay detection for iOS devices
- Autocomplete
- New
dropdownContainerEl
parameter to define place where dropdown need to be inserted - Improved dropdown positioning
- New
- Dom7 update to latest v2.0.6:
- Fixed issue with remove event listeners when they was not added
- Swiper update to latest v4.3.0:
- Core
- Fixed issue when
swipeBack
sometimes slides to wrong slide - Fixed issue when window resizing can break Coverflow effect layout
- Fixed issue with wrong detection of iOSEdgeSwipeDetection
- Fixed issue when
- Dom7 update to latest v2.0.6:
- Fixed issue with remove event listeners when they was not added
- Core
- Lots of minor fixes
v2.2.5 - April 29, 2018
- Router
- Fixed issue with not loaded routable tabs content after swipe-back to page with these routable tabs
- Page data will have additional
swipeback: true
prop when the page event was triggered by swipe back
- Range
- New
range:changed
(rangeChanged
,changed
) event that will be triggered on slide knob release after value change
- New
- Messagebar
- Fixed textarea text color for MD-Dark theme
- Form Storage
- Added support for skip inputs from storing by adding
no-store-data
orignore-store-data
class to input element
- Added support for skip inputs from storing by adding
- Dom7 updated to latest v2.0.5
- Support for setting array value on multiple select
- Improved internal events proxies logic for better memory management
- Swiper update to latest v4.2.5
- Core
- Prevent apply grab cursor when swiper is locked
- Fixed breakpoint with loop getting wrong realIndex when on init
- Fixed "transformed" slides sizes calculation that could cause issues in with Coverflow effect
- Autoplay
- Fixed issue that can cause memory leak
- Core
- Minor fixes
v2.2.1 - April 7, 2018
- List Index
- Improved page scroll logic when scrolling upward
- Router
- Fixed issue when Swipe Back may not work for views other than main
- Fixed issue with undefined initial browser history state when
pushState
enabled
- Minor fixes
v1.7.1 - April 7, 2018
- Fix for touch events when app can be unresponsive iOS 11.3
v2.2.0 - April 1, 2018
- List Index
- Meet all new List Index component π
- Full iPhone X safe areas support and required tweaks for MD theme π. Same as for iOS theme: automatic support for top and bottom safe areas (for portrait orientation). For landscape orientation the following classes must be added to elements:
ios-edges
- for full-width elements (like main View)ios-edge-left
- for elements that stick to the left edge of the screen (like left Panel)ios-edge-right
- for elements that stick to the right edge of the screen (like right Panel)
- Stepper
- New
autorepeat
parameter that will repeatedly increase/decrease values while you tap and hold plus/minus buttons - New
autorepeatDynamic
parameter that will increase autorepeat ratio based on how long you hold the button - New
wraps
parameter. When enabled, incrementing beyond maximum value sets value to minimum value; likewise, decrementing below minimum value sets value to maximum value
- New
- Sortable
- Fixed styling when sortable list is using with
no-chevron
class
- Fixed styling when sortable list is using with
- Range Slider
- New
draggableBar
parameter (defaults totrue
) that allows to disable value change on range bar click and drag - Added auto sizes recalculation on parent modals/panel/tabs open
- New
- Router
- Will now replace state (if
pushState
enabled) on initial load when initial route hasredirect
- Fixed issue with
tab:beforeremove
event was not fired for routeable tabs - Improved
restoreScrollTopOnBack
logic to save and restore scrolling on activepage-content
element - Swipe Back support for MD theme with new Router parameters:
mdSwipeBack: false
- enables swipe back for MD thememdSwipeBackAnimateShadow: true
- enable/disable box-shadow animation during swipe back actionmdSwipeBackAnimateOpacity: false
- enable/disable opacity animation during swipe back action. You can disable it to improve performancemdSwipeBackActiveArea: 30
- width of invisible left edge of the screen that triggers swipe back actionmdSwipeBackThreshold: 0
- swipe back will start if "touch distance" will be more than this value
- Will now replace state (if
- Request
- Now if you
return false
inbeforeOpen
orbeforeSend
callbacks it will cancel the XHR request
- Now if you
- Autocomplete
- New
inputEvents
parameter (by default isinput
) allows to configure input events used to handle Autocomplete actions and source request
- New
- Smart Select
- Fixed issue when Searchbar didn't work when Smart Select opened in
page
with Searchbar in iOS theme
- Fixed issue when Searchbar didn't work when Smart Select opened in
- Dialog
- New
app.dialog.keyboardActions
parameter (enabled by default) that enables keyboard shortcuts (Enter and Esc) keys for predefined dialogs (Alert, Confirm, Prompt, Login, Password)
- New
- Fixed iOS 11.3 bug that can break Fast clicks and make Cordova/PhoneGap app unresponsive on app resume from background π₯
- Swiper updated to latest 4.2.2 version
- Core
- Respect and update breakpoints when calling Swiper's
.update()
method
- Respect and update breakpoints when calling Swiper's
- Pagination
- New
progressbarOpposite
parameter to make pagination progressbar opposite todirection
parameter, means vertical progressbar for horizontal swiper direction and horizontal progressbar for vertical swiper direction
- New
- Core
- Lots of minor fixes
v1.7.0 - March 21, 2018
- Full iPhone X support and required tweaks. Automatic support for top and bottom safe areas (for portrait orientation). For landscape orientation the following classes must be added to elements:
ios-edges
- for full-width elements (like main View)ios-edge-left
- for elements that stick to the left edge of the screen (like left Panel)ios-edge-right
- for elements that stick to the right edge of the screen (like right Panel)
- Dom7
- Added
beforeCreate
callback for.ajax
method
- Added
- Minor fixes
v2.1.3 - March 19, 2018
- Searchbar
- Fixed issue with position of input clear button
- Router
- Fixed issue with wrong component context when
component
passed to route
- Fixed issue with wrong component context when
v2.1.2 - March 18, 2018
- Stepper
- Fixed theme-specific modifier classes, e.g.
stepper-fill-ios
,.stepper-round-md
etc.
- Fixed theme-specific modifier classes, e.g.
v2.1.1 - March 17, 2018
- Stepper
- Meet all new Stepper component π
- Data Table
- Added data table footer UI for pagination
- Added UI support for having inputs in table head
- Input
- Now it is possible to use fancy input elements outside of List View, by just wrapping it with
<div class="input">
- Now it is possible to use fancy input elements outside of List View, by just wrapping it with
- Router
- Fixed issue when route context wasn't available in
async
route - Fixed issue when modal HTML element was duplicated in modal routes
- Fixed issue when route context wasn't available in
- Form
- Fixed issue when
enctype
attribute was ignored on ajax form
- Fixed issue when
- VI (video intelligence)
- Now serves vi api over
https
- Now serves vi api over
- Actions
- Fixed issue with error when pass already rendered HTML element to the
actions.create
constructor - Fixed issue with not setting actions button bg color
- Added support for
closeByOutsideClick
logic
- Fixed issue with error when pass already rendered HTML element to the
- Searchbar
- Now hides elements (when required) by setting/unsetting classes instead of directly modifying element
display
property
- Now hides elements (when required) by setting/unsetting classes instead of directly modifying element
- Toast
- Added
destroyOnClose
parameter to automatically destroy toast instance on close - New
app.toast.show
method to automatically create and open Toast - Improved iPhone X support for bottom toast
- Added
- List
- New
no-chevron
class on list and list item link to disable chevron icon - New
chevron-center
class on media list or media list item to set chevron icon position on center
- New
- Swiper updated to latest 4.2.0 version
- Core
swiper.updateAutoHeight(speed)
now supportsspeed
parameter to resize swiper wrapper with duration- Fixed issues in free mode with
freeModeSticky
not being able to snap to closest snap point - New
swiper.slideToClosest()
method to slide to closest snap point when it is somewhere in between
- A11y (Accessibility)
- It is now enabled by default (if installed)
- Controller
- Fixed RTL issue when vertical swiper controls horizontal one
- Lazy
- Fixed issue when lazy loading not always triggered on window resize
- Core
- Improved server-side rendering by using
ssr-window
package - Lots of minor fixes
v2.0.10 - February 19, 2018
- Router
- New
router.clearPreviousHistory()
method to clear all previous pages history and remove all previous pages from DOM - New
clearPreviousHistory
option forrouter.navigate
that will clear history after reloading/navigating to specified page - Fixed issue with not correctly working
reloadPrevious
parameter
- New
- Smart Select
- Now accepts
view
as a parameter on initialization
- Now accepts
- Accordion
- Fixed iOS rendering issue when opening accordiong enables page scroll
- Panel
- Swipe panel won't be opened on quick swipe if the swipe distance doesn't exceed
swipeThreshold
parameter
- Swipe panel won't be opened on quick swipe if the swipe distance doesn't exceed
- Range Slider
- Fixed issue with broken events when passing event listeners in
on
parameter on init
- Fixed issue with broken events when passing event listeners in
- Minor fixes
v2.0.8 - February 11, 2018
- Swipeout
- Fixed issue in Safari when it flashes on open
- Router
- Now
route
(currentRoute) object has additionalcontext
property if it was passed in route options
- Now
- Range Slider
- Now it triggers input's
change
event on when user releases slider
- Now it triggers input's
- Sortable
- Fixed issue when sortable list used with list groups
- Swiper updated to latest 4.1.6:
- Improved touch events support on desktop Windows devices with touch screen
- Improved "loop fix" when slider is in the free mode
- New
noSwipingSelector
parameter that can be used instead ofnoSwipingClass
- New
preventIntercationOnTransition
parameter to prevent interaction during slice change transition - New
.slideToLoop
method to be used in loop mode - Improved IE 10 support. But it is recommended to use proto polyfill
- Improved touch support for Edge
- Fixed issue with
slideChange
events being fired when slide wasn't actually changed - Scrollbar
- Now doesn't require to enable
simulateTouch
for desktops when it isdraggable
- Now doesn't require to enable
- Pagination
- Added new multiple main bullets support for dynamic bullets pagination
- Zoom
- Now supports Virtual Slides
- New
watchOverflow
(disabled by default). When enabled Swiper will be disabled and hide navigation buttons on case there are not enough slides for sliding - Autoplay
- New
reverseDirection
to enable autoplay in reverse direction - New
waitForTransition
parameter when autoplay will wait for wrapper transition to continue (enabled by default). Can be disabled in case of using Virtual Translate when your slider may not have transition
- New
- Minor fixes
v2.0.7 - January 27, 2018
- Picker
- Fixed issue with
change
event not being fired
- Fixed issue with
- Panel
- Fixed issue with closing swipe panel with
swipeActiveArea
parameter
- Fixed issue with closing swipe panel with
- Router
async
route support for routable tabsasync
route support for routable modals
- Virtual List
- New
ul
andcreateUl
parameters. When disabled then VL can be used with any elements not expecting the list only
- New
- Dialog
- New
app.destroyPredefinedDialogs
parameter to automatically destroy predefined dialogs like Alert, Confirm, Prompt, etc.
- New
- Package
- Now ES-next modules have named export in addition to default, it exports
{ Template7, Dom7, Utils, Request, Device, Support }
- Now ES-next modules have named export in addition to default, it exports
- Minor fixes
v2.0.6 - January 9, 2018
- Photo Browser
- Fixed isse with wrong navbar color when color theme applied
- Range Slider
- Fixed wrong knob position in RTL layout
- Tabs
- Fixed issue with routable tabs links in navbar not switching correctly active class
- Request
- New
request.postJSON(url, data, success, error, dataType)
method to send pure JSON data with POST
- New
- Router
- Router ajax events now receives second argument with navigating options
- New
router.refreshPage()
method to reload current page - New
passRouteQueryToRequest
parameter (true
by default) will pass route url query to request url query (for routeurl
,templateUrl
andcomponentUrl
options). If you have the following route{ path: '/somepage/', url: 'http://myserver/page/' }
and you will click link with/somepage/?foo=bar
url then it will load page fromhttp://myserver/page/?foo=bar
url. - New
passRouteParamsToRequest
parameter (false
by default) will pass current route parameters to request url query (for routeurl
,templateUrl
andcomponentUrl
options). If you have the following route{ path: '/user/:userId/posts/:postId/', url: 'http://myserver/userpost/' }
and you will click link with/user/11/posts/12/
url then it will load page fromhttp://myserver/userpost/?userId=11&postId=12
url. - It is now also possible to use router parameters delimiters in route
url
,templateUrl
andcomponentUrl
options that will be replaced on request. E.g.{ path: '/user/:userId/posts/:postId/', url: 'http://myserver/{{userId}}/{{postId}}' }
- Toolbar / Tabbar
- Common app tabbar in multiple views app structure can be also hidden with "toolbar-hide-on-scroll"
- Minor fixes
v2.0.5 - January 2, 2018
* Lots of minor fixes
v2.0.2 - December 5, 2017
- Router
- Fix to make Routable tabs work on home page
- Few CSS tweaks for iPhone X safe areas
v2.0.1 - December 4, 2017
- Fixed iOS 11.2 iPhone X support with new CSS
env
safe areas
v2.0.0 - December 3, 2017 π
v2.0.0-beta.21 - December 3, 2017
- Router
- Fixed issue with multiple "destroy" hooks called when using modals/tabs as router components
- vi
- Added
placementType
ad parameter
- Added
v2.0.0-beta.20 - December 2, 2017
- Range Slider
- Recalculate range slider size when parent tab becomes visible
- CSS
!important
rule for hidingios-only
andmd-only
elements
v2.0.0-beta.19 - December 1, 2017
- Fixed issue with View router initialization when it was created after app init. Fixes also issue in cordova when app initialized later within
deviceready
event
v2.0.0-beta.18 - November 30, 2017
- New vi (video intelligence) component. vi is a mobile video SSP (Supply / Sell Side Platform). It provides self-serve tools for publishers to captivate and monetize audiences
- Popover
- Now may accept target elements coordinates with
targetX
,targetY
parameters instead oftargetEl
target element itself
- Now may accept target elements coordinates with
- Actions
- New
forceToPopover
parameter to always convert it to Popover toPopover
parameter renamed toconvertToPopover
- New
backdrop
(true/false) parameter to enable/disable Actions backdrop
- New
- Router
- New
currentPageEl
router property that points to current page HTMLElement. - Improved routable tabs support for different routes but with same tab IDs
- Improved dynamic navbar transition using CSS page transitions
- New
- Form Storage
- Renamed methods:
app.form.data.get()
->app.form.getFormData()
app.form.data.remove()
->app.form.removeFormData()
app.form.data.store()
->app.form.storeFormData()
app.form.toData()
->app.form.convertToData()
app.form.fromData()
->app.form.fillFromData()
- Renamed methods:
- CSS & Theming
- New "Dark Color Theme" for both "iOS" and "MD" themes. Can be added with
theme-dark
CSS class. - Full iPhone X support and required tweaks. Automatic support for top and bottom safe areas (for portrait orientation). For landscape orientation the following classes must be added to elements:
ios-edges
- for full-width elements (like main View)ios-edge-left
- for elements that stick to the left edge of the screen (like left Panel)ios-edge-right
- for elements that stick to the right edge of the screen (like right Panel)
- Common
disabled
class to make any elements disabled
- New "Dark Color Theme" for both "iOS" and "MD" themes. Can be added with
- Swiper updated to latest 4.0.7:
- Fixed issue with not working correctly
touchReleaseOnEdges
on iOS - Fixed issue with not working allowSlideNext/Prev change on Breakpoints
- Fixed wrong scrollbar dragging when using custom
dragSize
- Fixed issue with not working correctly
- Build/Package - new files structure to improve tree-shaking as much as possible:
- Now the
framework7.esm.js
andframework7.esm.bundle.js
are in the root of/dist/
folder. framework7.esm.js
now exports only Framework7 core library with single default export- All additional components must be included from separate
/dist/components/
folder. For exampleimport Searchbar from 'framework7/dist/components/searchbar/searchbar.js';
- Custom CSS build is now also possible with LESS.
framework7.less
is now in the root of/dist/
and contains only Framework7 core library styles. Additional components must be included from separate/dist/components/
folder. For exampleimport "framework7/dist/components/searchbar/searchbar.less";
- Now the
- Lost of minor fixes
v2.0.0-beta.17 - November 14, 2017
- Preloader
- Fixed preloader backdrop styles to cover the screen behind it
- Router
- Cancels swipe back page in case of swipe left
- Input
- Added
scrollIntoViewOnFocus
parameter, that is by default enabled for Android - Added
scrollIntoViewCentered
parameter to scroll input into center of view
- Added
- Minor fixes
v2.0.0-beta.16 - November 8, 2017
- Swiper updated to latest version
- Fixed issue with not working
noSwiping
parameter - Parallax now considers
slidesPerGroup
parameter - Zoom: improved gestures handling
- Pagination: fixed issues with wrong positioned dynamic-bullets when there are not enough slides
- Fixed issues with some effects being broken with enabled
breakpoints
- Fixed issue with not working
- Panels
- Fixed issue with wrong styles when panels become visible by breakpoints
- PhotoBrowser
- Improved zoom behavior on Androids (due to Swiper update)
- Router
- Added routes alias support
routes = [ { path: '/foo/', url: 'somepage.html', alias: '/bar/', } ]
- Added routes redirect support
routes = [ { path: '/foo/', url: 'somepage.html', }, { path: '/bar/', redirect: '/foo/', } ]
- Added routes alias support
- Build
- Along with config file path now it is also possible to specify build output path like
npm run build:prod -- --config path/to/config.js --output path/to/build
- Along with config file path now it is also possible to specify build output path like
- Minor fixes
v2.0.0-beta.15 - October 27, 2017
- Fixed issue with extented context in router components
v2.0.0-beta.14 - October 26, 2017
- Fix router page events issue when no
route
passed to page callback
v2.0.0-beta.12 - October 26, 2017
- Router
- Added path-to-regexp for better route matching with support of RegExp in route path
- Route
name
renamed topageName
parameter to specify page's name to load. Routename
now means name of the route - Added additional routes arguments to
async
method. Now it isasync(routeTo, routeFrom, resolve, reject)
pushState
now supports for multiple Views at a time- Router component's context now can be extended with
options.context
route parameter - Router component now supports inline nested
<template>
that won't be parsed by Template7 - Added support for dynamic routes
- Route events, now it is possible to specify
on
object with page events on route object
- PhotoBrowser
- Now uses Virtual Slides by default
- Input
- Now automatically scrolls into view on Androids when keyboard becomes opened
- Colors
- Number of built-in colors reduced to red, green, blue, pink, yellow, orange, white, black, gray
- Build
- Now it is possible to specify path to config file like
npm run build:dev -- --config path/to/config.js
- Now it is possible to specify path to config file like
- Lost of minor fixes
v2.0.0-beta.11 - October 13, 2017
- Messagebar
- Added
top
parameter to consider it as top messagebar - Added
resizePage
parameter to define whether it should resize the page - Added
maxHeight
parameter to specify messagebar max-height on resize
- Added
- Minor fixes
v2.0.0-beta.10 - October 11, 2017
- Swiper update to latest 4.0.1:
- Fixed issue with pagination being broken with loop mode
- Reworked
realIndex
calculation ordering
- Router
- Now it creates dynamically navbar (for isDynamicNavbar) only when the page with navbar appears
- Statusbar
- Fixed broken
statusbar.show
method
- Fixed broken
- Package
- Now it exports by default modular
framework7.esm.js
version instead of bundle
- Now it exports by default modular
v2.0.0-beta.9 - October 8, 2017
- New Picker component
- New Calendar component
- New Custom Modal component
- Router
- Added support for swipeable routable tabs
- Swiper
- Update to latest version with Virtual Slides support
- ES-next modules renamed
framework7.module.js
->framework7.esm.bundle.js
(exported by default)framework7.modular.js
->framework7.esm.js
- Numerous fixes and improvements
v2.0.0-beta.8 - September 21, 2017
- Toolbar
- Class
toolbar-bottom
to display it on the bottom for MD theme has been renamed totoolbar-bottom-md
.
- Class
- Sortable
- Renamed events
sortable:open
->sortable:enable
,sortable:close
->sortable:disable
.
- Renamed events
- Grid
no-gutter
class renamed tono-gap
.
- Card
card-content-inner
element has been removed. Now to have the same effect it is required additionalcard-content-padding
class tocard-content
element.
- Modal is now a part of a core components.
- Toast
- Added icon support for center-positioned Toast.
- Router
- Reloaded page (called with
reloadAll
orreloadCurrent
parameters) now also firespageBeforeIn
andpageAfterIn
events. - Improved routable Tabs. Now it also works with Animated Tabs.
- Reloaded page (called with
- Notification
- All new Notification component arrived, with better unified look and swipe-to-close support.
- Buttons
small
buttons now can be round and not round.
- Lots of minor fixes.
v2.0.0-beta.7 - September 13, 2017
- Fixed issue with Routable Tabs not working correctly on home page
- Fixed issue with touch ripple effect being broken after bundler optimization
v2.0.0-beta.6 - September 13, 2017
- Template7 updated to latest v1.3.0
v2.0.0-beta.5 - September 13, 2017
- Small core refactorings to work better in tree-shaking bundlers
v2.0.0-beta.4 - September 11, 2017
- Added full RTL layout support (with new
.rtl
stylesheets). - Removed XHR (Ajax) functionality from Dom7, including
$.ajax
,$.get
,$.post
,$.getJSON
. These are replaced with new Framework7request
module. - Removed
$.
utilities from Dom7, including$.parseUrlQuery
,$.isArray
,$.each
,$.unique
,$.serializeObject
,$.dataset
,$.extend
, they are available viaFramework7.utils
orapp.utils
. - Utils'
.promise
now returns native Promise if it is supported by browser and fallback to Promise-like polyfill if it is not supported.
v2.0.0-beta.3 - September 7, 2017
- Add new Autocomplete component
- Add new Toast component
- New modular package
framework7.modular.js
- New view
restoreScrollTopOnBack
parameter to restore previous page scroll position when navigating back - Lots of minor fixes and improvements
v2.0.0-beta.2 - September 2, 2017
- Add new Swiper component
- Add new Photo Browser component
- Ported Notifications component
- Improved custom build
- Lots of minor fixes
v2.0.0-beta.1 - August 21, 2017
- Initial v2 release