Link React Component

Link is main component to create links for navigation, custom actions, switching tabs, open/close panels, etc.

There are following components included:

  • **Link** / **F7Link**
Prop Type Default Description
<Link> properties
--- --- --- ---
noLinkClass boolean Removes “link” class
tabLink string boolean Enables tab link and specify CSS selector of the target tab (if specified as a string)
tabLinkActive boolean Makes this tab link active
text string Link text
noFastClick boolean Disables fast click
badge string number Badge count
badgeColor string Badge color. One of the default colors
iconOnly boolean Enable when used in navbar/toolbar with icon only inside
tooltip string Link tooltip text to show on link hover/press
<Link> Smart Select related properties
smartSelect boolean false Enables Smart Select behavior
smartSelectParams object Object with Smart Select Parameters
<Link> icon related properties
iconSize string number Icon size in px
iconColor string Icon color. One of the default colors
icon string Custom icon class
iconF7 string Name of F7 Icons font icon
iconMaterial string Name of Material Icons font icon
iconFa string Name of Font Awesome font icon
iconIon string Name of Ionicons font icon
iconIos string Icon to be used in case of iOS theme is used. Consists of icon family and icon name divided by colon, e.g. f7:home or ion:home
iconMd string Icon to be used in case of MD theme is used. Consists of icon family and icon name divided by colon, e.g. material:home or fa:home
iconAurora string Icon to be used in case of Aurora theme is used. Consists of icon family and icon name divided by colon, e.g. f7:home or fa:home
iconBadge string number Adds badge to the icon (intended to be used in Tabbar’s icons)
<Link> navigation/router related properties
href string boolean # URL of the page to load. In case of boolean href=”false” it won’t add href tag
target string Value of link target attribute, e.g. _blank, _self, etc.
view string CSS selector of the View to load the page
external boolean Enable to bypass Framework7’s link click handler
back boolean Enables back navigation link
force boolean Force page to load and ignore previous page in history (use together with back prop)
reloadCurrent boolean Reloads new page instead of the currently active one
reloadPrevious boolean Replace the previous page in history with the new one from route
reloadAll boolean Load new page and remove all previous pages from history and DOM
reloadDetail boolean Reload Detail page in Master Detail view
animate boolean Disables pages animation
ignoreCache boolean Ignores caching
routeTabId string Routable Tab id
routeProps object Object with additional props that will be passed to target route component
preventRouter boolean false If set, then it won’t be processed by Framework7 router
<Link> action related properties
panelOpen string boolean Defines panel to open. Can be left or right
panelClose boolean Closes panel on click
panelToggle boolean Toggle (open/close) panel on click
actionsOpen string boolean CSS selector of the action sheet to open on click
actionsClose string boolean CSS selector of the action sheet to close on click. Or boolean property to close currently opened action sheet
popupOpen string boolean CSS selector of the popup to open on click
popupClose string boolean CSS selector of the popup to close on click. Or boolean property to close currently opened popup
popoverOpen string boolean CSS selector of the popover to open on click
popoverClose string boolean CSS selector of the popover to close on click. Or boolean property to close currently opened popover
sheetOpen string boolean CSS selector of the sheet modal to open on click
sheetClose string boolean CSS selector of the sheet modal to close on click. Or boolean property to close currently opened sheet modal
loginScreenOpen string boolean CSS selector of the login screen to open on click
loginScreenClose string boolean CSS selector of the login screen to close on click. Or boolean property to close currently opened login screen
sortableEnable string boolean CSS selector of the Sortable list to open on click
sortableDisable string boolean CSS selector of the Sortable list to close on click. Or boolean property to close currently opened Sortable list
sortableToggle string boolean CSS selector of the Sortable list to toggle on click. Or boolean property to toggle currently opened/closed Sortable list
searchbarEnable string boolean CSS selector of the Expandable Searchbar to be enabled on click. Or boolean property to enable the first found Searchbar
searchbarDisable string boolean CSS selector of the Expandable Searchbar to be disabled on click. Or boolean property to disable the first found Searchbar
searchbarToggle string boolean CSS selector of the Expandable Searchbar to toggle on click. Or boolean property to toggle the first found Searchbar
searchbarClear string boolean CSS selector of the Expandable Searchbar to clear on click. Or boolean property to clear the first found Searchbar
cardOpen string boolean CSS selector of the expandable card to open on click. Or boolean to open first found expandable card
cardClose string boolean CSS selector of the expandable card to close on click. Or boolean property to close currently opened expandable card
cardPreventOpen boolean Click on element with this prop won’t open its parent expandable card
menuClose boolean Closes Menu dropdown on click
Event Description
<Link> events
--- ---
click Event will be triggered after click on a link

Examples

1. <Link href="/about/">About</Link>

1. <Link back>Back</Link>

With Router Parameters

1. <Link href="/about/" animate={false} ignoreCache={true}>About</Link>

1. <Link href="http://google.com" external>Google</Link>

1. {/* Tabs  */}
2. <Tabs>
3. <Tab id="tab-1" tabActive>Tab 1</Tab>
4. <Tab id="tab-1">Tab 2</Tab>
5. </Tabs>
6. {/* Switch Between Tabs  */}
7. <Link tabLink="#tab-1" tabLinkActive>Show Tab 1</Link>
8. <Link tabLink="#tab-2">Show Tab 2</Link>

Routable Tabs

1. {/* Tabs  */}
2. <Tabs>
3. <Tab id="tab-1"></Tab>
4. <Tab id="tab-2"></Tab>
5. </Tabs>
6. {/* Switch Between Tabs  */}
7. <Link tabLink routeTabId="tab-1" href="/tabs/">Show Tab 1</Link>
8. <Link tabLink routeTabId="tab-2" href="/tabs/tab-2/">Show Tab 2</Link>

Open And Close Panel

1. <Link panelOpen="left">Open Left Panel</Link>
2. <Link panelClose>Close Panel</Link>

Open and Close Popup

1. <Link popupOpen="#my-popup">Open Popup</Link>
2. <Link popupClose="#my-popup">Close Popup</Link>

With Icon & Color

1. <Link iconF7="home" text="Home" color="red"></Link>