Button - 图1

Button Vue Component

Button Vue component represents Framework7’s Button elements.

Button Components

There are following components included:

  • **f7-button** - single button
  • **f7-segmented** - segmented wrapper for buttons

Button Properties

Button component has almost the same properties as the Link component but with few additional button-specific properties:

PropTypeDefaultDescription
<f7-segmented> properties
raisedbooleanfalseMakes segmented raised. Affects MD theme only
roundbooleanfalseMakes segmented round
tagstringdivTag used to render Segmented element
<f7-button> properties
tab-linkstring
boolean		Enables tab link and specify CSS selector of the target tab (if specified as a string)
tab-link-activebooleanfalseMakes this tab link active
activebooleanfalseMakes this button active state when used in Segmented. Must be used instead of tab-link-active
textstringButton text label
no-fast-clickbooleanDisables fast click
tooltipstringButton tooltip text to show on button hover/press
roundbooleanfalseMakes button round
round-iosbooleanfalseMakes button round for iOS theme only
round-mdbooleanfalseMakes button round for MD theme only
bigbooleanfalseMakes big button
big-iosbooleanfalseMakes big button for iOS theme only
big-mdbooleanfalseMakes big button for MD theme only
smallbooleanfalseMakes small button
small-iosbooleanfalseMakes small button for iOS theme only
small-mdbooleanfalseMakes small button for MD theme only
fillbooleanfalseMakes button filled color
fill-iosbooleanfalseMakes button filled color for iOS theme only
fill-mdbooleanfalseMakes button filled color for MD theme only
raisedbooleanfalseMakes button raised. Affects MD theme only
outlinebooleanfalseMakes button outline. Affects MD theme only
<f7-button> icon related properties
icon-sizestring
number		Icon size in px
icon-colorstringIcon color. One of the default colors
iconstringCustom icon class
icon-f7stringName of F7 Icons font icon
icon-materialstringName of Material Icons font icon
icon-fastringName of Font Awesome font icon
icon-ionstringName of Ionicons font icon
icon-iosstringIcon 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
icon-mdstringIcon 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
<f7-button> navigation/router related properties
hrefstring
boolean		#URL of the page to load. In case of boolean href=”false” it won’t add href tag
targetstringValue of link target attribute, e.g. _blank, _self, etc.
viewstringCSS selector of the View to load the page
externalbooleanEnable to bypass Framework7’s link click handler
backbooleanEnables back navigation link
forcebooleanForce page to load and ignore previous page in history (use together with back prop)
reload-currentbooleanReloads new page instead of the currently active one
reload-previousbooleanReplace the previous page in history with the new one from route
reload-allbooleanLoad new page and remove all previous pages from history and DOM
animatebooleanDisables pages animation
ignore-cachebooleanIgnores caching
route-tab-idstringRoutable Tab id
route-propsobjectObject with additional props that will be passed to target route component
<f7-button> action related properties
panel-openstring
boolean		Defines panel to open. Can be left or right
panel-closebooleanCloses panel on click
actions-openstring
boolean		CSS selector of the action sheet to open on click
actions-closestring
boolean		CSS selector of the action sheet to close on click. Or boolean property to close currently opened action sheet
popup-openstring
boolean		CSS selector of the popup to open on click
popup-closestring
boolean		CSS selector of the popup to close on click. Or boolean property to close currently opened popup
popover-openstring
boolean		CSS selector of the popover to open on click
popover-closestring
boolean		CSS selector of the popover to close on click. Or boolean property to close currently opened popover
sheet-openstring
boolean		CSS selector of the sheet modal to open on click
sheet-closestring
boolean		CSS selector of the sheet modal to close on click. Or boolean property to close currently opened sheet modal
login-screen-openstring
boolean		CSS selector of the login screen to open on click
login-screen-closestring
boolean		CSS selector of the login screen to close on click. Or boolean property to close currently opened login screen
sortable-enablestring
boolean		CSS selector of the Sortable list to open on click
sortable-disablestring
boolean		CSS selector of the Sortable list to close on click. Or boolean property to close currently opened Sortable list
sortable-togglestring
boolean		CSS selector of the Sortable list to toggle on click. Or boolean property to toggle currently opened/closed Sortable list
searchbar-enablestring
boolean		CSS selector of the Expandable Searchbar to be enabled on click. Or boolean property to enable the first found Searchbar
searchbar-disablestring
boolean		CSS selector of the Expandable Searchbar to be disabled on click. Or boolean property to disable the first found Searchbar
searchbar-togglestring
boolean		CSS selector of the Expandable Searchbar to toggle on click. Or boolean property to toggle the first found Searchbar
searchbar-clearstring
boolean		CSS selector of the Expandable Searchbar to clear on click. Or boolean property to clear the first found Searchbar

Button Events

EventDescription
<f7-button> events
clickEvent will be triggered after click on a button

Examples

  1. <f7-block-title>Usual Buttons</f7-block-title>
  2. <f7-block>
  3.   <f7-row>
  4.     <f7-col>
  5.       <f7-button>Button</f7-button>
  6.     </f7-col>
  7.     <f7-col>
  8.       <f7-button>Button</f7-button>
  9.     </f7-col>
  10.     <f7-col>
  11.       <f7-button round>Round</f7-button>
  12.     </f7-col>
  13.   </f7-row>
  14. </f7-block>
  16. <f7-block-title>Fill Buttons</f7-block-title>
  17. <f7-block>
  18.   <f7-row>
  19.     <f7-col>
  20.       <f7-button fill>Button</f7-button>
  21.     </f7-col>
  22.     <f7-col>
  23.       <f7-button fill>Button</f7-button>
  24.     </f7-col>
  25.     <f7-col>
  26.       <f7-button fill round>Round</f7-button>
  27.     </f7-col>
  28.   </f7-row>
  29. </f7-block>
  31. <f7-block-title>Outline Buttons (MD-theme only)</f7-block-title>
  32. <f7-block>
  33.   <f7-row>
  34.     <f7-col>
  35.       <f7-button outline>Button</f7-button>
  36.     </f7-col>
  37.     <f7-col>
  38.       <f7-button outline>Button</f7-button>
  39.     </f7-col>
  40.     <f7-col>
  41.       <f7-button outline round>Round</f7-button>
  42.     </f7-col>
  43.   </f7-row>
  44. </f7-block>
  46. <f7-block-title>Raised Buttons (MD-theme only)</f7-block-title>
  47. <f7-block>
  48.   <f7-row tag="p">
  49.     <f7-col tag="span">
  50.       <f7-button raised>Button</f7-button>
  51.     </f7-col>
  52.     <f7-col tag="span">
  53.       <f7-button raised fill>Fill</f7-button>
  54.     </f7-col>
  55.     <f7-col tag="span">
  56.       <f7-button raised outline>Outline</f7-button>
  57.     </f7-col>
  58.   </f7-row>
  59.   <f7-row tag="p">
  60.     <f7-col tag="span">
  61.       <f7-button raised round>Round</f7-button>
  62.     </f7-col>
  63.     <f7-col tag="span">
  64.       <f7-button raised fill round>Fill</f7-button>
  65.     </f7-col>
  66.     <f7-col tag="span">
  67.       <f7-button raised outline round>Outline</f7-button>
  68.     </f7-col>
  69.   </f7-row>
  70. </f7-block>
  72. <f7-block-title>Segmented</f7-block-title>
  73. <f7-block>
  74.   <f7-segmented raised tag="p">
  75.     <f7-button>Button</f7-button>
  76.     <f7-button>Button</f7-button>
  77.     <f7-button active>Active</f7-button>
  78.   </f7-segmented>
  79.   <f7-segmented raised tag="p">
  80.     <f7-button outline>Outline</f7-button>
  81.     <f7-button outline>Outline</f7-button>
  82.     <f7-button outline active>Active</f7-button>
  83.   </f7-segmented>
  84.   <f7-segmented raised round tag="p">
  85.     <f7-button round>Button</f7-button>
  86.     <f7-button round>Button</f7-button>
  87.     <f7-button round active>Active</f7-button>
  88.   </f7-segmented>
  89.   <f7-segmented round round tag="p">
  90.     <f7-button round outline>Outline</f7-button>
  91.     <f7-button round outline>Outline</f7-button>
  92.     <f7-button round outline active>Active</f7-button>
  93.   </f7-segmented>
  94. </f7-block>
  96. <f7-block-title>Big Buttons</f7-block-title>
  97. <f7-block>
  98.   <f7-row tag="p">
  99.     <f7-col tag="span">
  100.       <f7-button big>Button</f7-button>
  101.     </f7-col>
  102.     <f7-col tag="span">
  103.       <f7-button big fill>Fill</f7-button>
  104.     </f7-col>
  105.   </f7-row>
  106.   <f7-row tag="p">
  107.     <f7-col tag="span">
  108.       <f7-button big raised>Raised</f7-button>
  109.     </f7-col>
  110.     <f7-col tag="span">
  111.       <f7-button big raised fill>Raised Fill</f7-button>
  112.     </f7-col>
  113.   </f7-row>
  114. </f7-block>
  116. <f7-block-title>Small Buttons</f7-block-title>
  117. <f7-block>
  118.   <f7-row tag="p">
  119.     <f7-col tag="span">
  120.       <f7-button big small>Button</f7-button>
  121.     </f7-col>
  122.     <f7-col tag="span">
  123.       <f7-button big small outline>Outline</f7-button>
  124.     </f7-col>
  125.     <f7-col tag="span">
  126.       <f7-button big small fill>Fill</f7-button>
  127.     </f7-col>
  128.   </f7-row>
  129.   <f7-row tag="p">
  130.     <f7-col tag="span">
  131.       <f7-button big small round>Button</f7-button>
  132.     </f7-col>
  133.     <f7-col tag="span">
  134.       <f7-button big small outline round>Outline</f7-button>
  135.     </f7-col>
  136.     <f7-col tag="span">
  137.       <f7-button big small fill round>Fill</f7-button>
  138.     </f7-col>
  139.   </f7-row>
  140. </f7-block>
  142. <f7-block-title>Color Buttons</f7-block-title>
  143. <f7-block>
  144.   <f7-row>
  145.     <f7-col>
  146.       <f7-button color="red">Red</f7-button>
  147.     </f7-col>
  148.     <f7-col>
  149.       <f7-button color="green">Green</f7-button>
  150.     </f7-col>
  151.     <f7-col>
  152.       <f7-button color="blue">Blue</f7-button>
  153.     </f7-col>
  154.   </f7-row>
  155. </f7-block>
  157. <f7-block-title>Color Fill Buttons</f7-block-title>
  158. <f7-block>
  159.   <f7-row>
  160.     <f7-col>
  161.       <f7-button fill color="red">Red</f7-button>
  162.     </f7-col>
  163.     <f7-col>
  164.       <f7-button fill color="green">Green</f7-button>
  165.     </f7-col>
  166.     <f7-col>
  167.       <f7-button fill color="blue">Blue</f7-button>
  168.     </f7-col>
  169.   </f7-row>
  170. </f7-block>