Stepper Vue Component

    Stepper Vue component represents Stepper component.

    Stepper Components

    There are following components included:

    • f7-stepper

    Stepper Properties

    Prop Type Default Description
    <f7-stepper> properties
    init boolean true Initializes Stepper
    value number 0 Stepper value
    min number 0 Minimum value
    max number 100 Maximum value
    step number 1 Maximum value
    wraps boolean false When enabled, incrementing beyond maximum value sets value to minimum value; likewise, decrementing below minimum value sets value to maximum value
    autorepeat boolean false When enabled it will repeatedly increase/decrease values while you tap and hold plus/minus buttons
    autorepeat-dynamic boolean false When enabled it will increase autorepeat ratio based on how long you hold the button
    input boolean true Defines should it render <input> element or not
    input-readonly boolean false Makes inner input element readonly
    buttons-only boolean false Disables inner value container between stepper buttons
    format-value function(value) Custom function to format value for value element between buttons. It must return new formatted value
    manual-input-mode boolean false Enables manual input mode. This mode allows to type value from keyboar and check fractional part with defined accurancy. Also, step parameter is ignored when typing in this mode.
    decimal-point number 4 Number of digits after dot, when in manual input mode.
    buttons-end-input-mode boolean true Disables manual input mode on Stepper's minus or plus button click.
    disabled boolean false Defines whether the stepper is disabled or not
    round boolean false Makes stepper round
    round-ios boolean false Makes stepper round for iOS theme only
    round-md boolean false Makes stepper round for MD theme only
    big boolean false Makes big stepper
    big-ios boolean false Makes big stepper for iOS theme only
    big-md boolean false Makes big stepper for MD theme only
    small boolean false Makes small stepper
    small-ios boolean false Makes small stepper for iOS theme only
    small-md boolean false Makes small stepper for MD theme only
    fill boolean false Makes stepper filled color
    fill-ios boolean false Makes stepper filled color for iOS theme only
    fill-md boolean false Makes stepper filled color for MD theme only
    raised boolean false Makes stepper raised. Affects MD theme only

    Stepper Events

    Event Description
    <f7-stepper> events
    stepper:change Event will be triggered when Stepper value has been changed
    stepper:minusclick Event will be triggered on "minus" button click
    stepper:plusclick Event will be triggered on "plus" button click
    input Event will be triggered on input's input event

    Stepper Methods

    Event Description
    <f7-stepper> methods
    .increment() Increment stepper value, similar to clicking on its "plus" button
    .decremenet() Decrement stepper value, similar to clicking on its "minus" button
    .setValue(newValue) Set new stepper value
    .getValue() Returns stepper value

    Examples

    <template>
      <f7-page>
        <f7-navbar title="Stepper"></f7-navbar>
        <f7-block-title>Shape and size</f7-block-title>
        <f7-block strong class="text-align-center">
          <f7-row>
            <f7-col>
              <small class="display-block">Default</small>
              <f7-stepper></f7-stepper>
            </f7-col>
            <f7-col>
              <small class="display-block">Round</small>
              <f7-stepper round></f7-stepper>
            </f7-col>
          </f7-row>
    
          <f7-row class="margin-top">
            <f7-col>
              <small class="display-block">Fill</small>
              <f7-stepper fill></f7-stepper>
            </f7-col>
            <f7-col>
              <small class="display-block">Round Fill</small>
              <f7-stepper fill round></f7-stepper>
            </f7-col>
          </f7-row>
    
          <f7-row class="margin-top">
            <f7-col>
              <small class="display-block">Small</small>
              <f7-stepper small></f7-stepper>
            </f7-col>
            <f7-col>
              <small class="display-block">Small Round</small>
              <f7-stepper small round></f7-stepper>
            </f7-col>
          </f7-row>
    
          <f7-row class="margin-top">
            <f7-col>
              <small class="display-block">Small Fill</small>
              <f7-stepper small fill></f7-stepper>
            </f7-col>
            <f7-col>
              <small class="display-block">Small Round Fill</small>
              <f7-stepper small round fill></f7-stepper>
            </f7-col>
          </f7-row>
    
          <f7-row class="margin-top">
            <f7-col>
              <small class="display-block">Big</small>
              <f7-stepper big></f7-stepper>
            </f7-col>
            <f7-col>
              <small class="display-block">Big Round</small>
              <f7-stepper big round></f7-stepper>
            </f7-col>
          </f7-row>
    
          <f7-row class="margin-top">
            <f7-col>
              <small class="display-block">Big Fill</small>
              <f7-stepper big fill></f7-stepper>
            </f7-col>
            <f7-col>
              <small class="display-block">Big Round Fill</small>
              <f7-stepper big round fill></f7-stepper>
            </f7-col>
          </f7-row>
        </f7-block>
    
        <f7-block-title>Raised (MD-theme only)</f7-block-title>
        <f7-block strong class="text-align-center">
          <f7-row>
            <f7-col>
              <small class="display-block">Default</small>
              <f7-stepper raised></f7-stepper>
            </f7-col>
            <f7-col>
              <small class="display-block">Round</small>
              <f7-stepper raised round></f7-stepper>
            </f7-col>
          </f7-row>
    
          <f7-row class="margin-top">
            <f7-col>
              <small class="display-block">Fill</small>
              <f7-stepper raised fill></f7-stepper>
            </f7-col>
            <f7-col>
              <small class="display-block">Round Fill</small>
              <f7-stepper raised fill round></f7-stepper>
            </f7-col>
          </f7-row>
    
          <f7-row class="margin-top">
            <f7-col>
              <small class="display-block">Small</small>
              <f7-stepper raised small></f7-stepper>
            </f7-col>
            <f7-col>
              <small class="display-block">Small Round</small>
              <f7-stepper raised small round></f7-stepper>
            </f7-col>
          </f7-row>
    
          <f7-row class="margin-top">
            <f7-col>
              <small class="display-block">Small Fill</small>
              <f7-stepper raised small fill></f7-stepper>
            </f7-col>
            <f7-col>
              <small class="display-block">Small Round Fill</small>
              <f7-stepper raised small round fill></f7-stepper>
            </f7-col>
          </f7-row>
    
          <f7-row class="margin-top">
            <f7-col>
              <small class="display-block">Big</small>
              <f7-stepper raised big></f7-stepper>
            </f7-col>
            <f7-col>
              <small class="display-block">Big Round</small>
              <f7-stepper raised big round></f7-stepper>
            </f7-col>
          </f7-row>
    
          <f7-row class="margin-top">
            <f7-col>
              <small class="display-block">Big Fill</small>
              <f7-stepper raised big fill></f7-stepper>
            </f7-col>
            <f7-col>
              <small class="display-block">Big Round Fill</small>
              <f7-stepper raised big round fill></f7-stepper>
            </f7-col>
          </f7-row>
        </f7-block>
        <f7-block-title>Colors</f7-block-title>
        <f7-block strong class="text-align-center">
          <f7-row>
            <f7-col>
              <f7-stepper fill color="red"></f7-stepper>
            </f7-col>
            <f7-col>
              <f7-stepper fill round color="green"></f7-stepper>
            </f7-col>
          </f7-row>
    
          <f7-row class="margin-top">
            <f7-col>
              <f7-stepper fill color="blue"></f7-stepper>
            </f7-col>
            <f7-col>
              <f7-stepper fill round color="pink"></f7-stepper>
            </f7-col>
          </f7-row>
    
          <f7-row class="margin-top">
            <f7-col>
              <f7-stepper fill small color="yellow"></f7-stepper>
            </f7-col>
            <f7-col>
              <f7-stepper fill small round color="orange"></f7-stepper>
            </f7-col>
          </f7-row>
    
          <f7-row class="margin-top">
            <f7-col>
              <f7-stepper fill small color="gray"></f7-stepper>
            </f7-col>
            <f7-col>
              <f7-stepper fill small round color="black"></f7-stepper>
            </f7-col>
          </f7-row>
        </f7-block>
        <f7-block-title>Without input element</f7-block-title>
        <f7-block strong class="text-align-center">
          <f7-row>
            <f7-col>
              <f7-stepper :input="false"></f7-stepper>
            </f7-col>
            <f7-col>
              <f7-stepper :input="false" round></f7-stepper>
            </f7-col>
          </f7-row>
        </f7-block>
        <f7-block-title>Min, max, step</f7-block-title>
        <f7-block strong class="text-align-center">
          <f7-row>
            <f7-col>
              <f7-stepper :value="100" :min="0" :max="1000" :step="100"></f7-stepper>
            </f7-col>
            <f7-col>
              <f7-stepper :input="false" :value="5" :min="0" :max="10" :step="0.5"></f7-stepper>
            </f7-col>
          </f7-row>
        </f7-block>
    
        <f7-block-title>Autorepeat (Tap & hold)</f7-block-title>
        <f7-block-header>Pressing and holding one of its buttons increments or decrements the stepper’s value repeatedly. With dynamic autorepeat, the rate of change depends on how long the user continues pressing the control.</f7-block-header>
        <f7-block strong class="text-align-center">
          <f7-row>
            <f7-col>
              <small class="display-block">Default</small>
              <f7-stepper :value="0" :min="0" :max="100" :step="1" :autorepeat="true"></f7-stepper>
            </f7-col>
            <f7-col>
              <small class="display-block">Dynamic</small>
              <f7-stepper :value="0" :min="0" :max="100" :step="1" :autorepeat="true" :autorepeat-dynamic="true"></f7-stepper>
            </f7-col>
          </f7-row>
        </f7-block>
    
        <f7-block-title>Wraps</f7-block-title>
        <f7-block-header>In wraps mode incrementing beyond maximum value sets value to minimum value, likewise, decrementing below minimum value sets value to maximum value</f7-block-header>
        <f7-block strong class="text-align-center">
          <f7-row>
            <f7-col>
              <f7-stepper :value="0" :min="0" :max="10" :step="1" :autorepeat="true" :wraps="true"></f7-stepper>
            </f7-col>
          </f7-row>
        </f7-block>
    
        <f7-block-title>Custom value element</f7-block-title>
        <f7-list>
          <f7-list-item :title="`Apples ${applesCount}`">
            <f7-stepper :buttons-only="true" small raised slot="after" @stepper:change="setApples"></f7-stepper>
          </f7-list-item>
          <f7-list-item :title="`Oranges ${orangesCount}`">
            <f7-stepper :buttons-only="true" small raised slot="after" @stepper:change="setOranges"></f7-stepper>
          </f7-list-item>
        </f7-list>
    
        <f7-block-title>Custom value format</f7-block-title>
        <f7-list>
          <f7-list-item header="Meeting starts in" :title="meetingTimeComputed">
            <f7-stepper
              :min="15"
              :max="240"
              :step="15"
              :value="meetingTime"
              :buttons-only="true"
              small
              slot="after"
              @stepper:change="setMeetingTime"
            ></f7-stepper>
          </f7-list-item>
        </f7-list>
    
        <f7-block-title>Manual input</f7-block-title>
        <f7-block-header>It is possible to enter value manually from keyboard or mobile keypad. When click on input field, stepper enter into manual input mode, which allow type value from keyboar and check fractional part with defined accurancy. Click outside or enter Return key, ending manual mode.</f7-block-header>
        <f7-block strong class="text-align-center">
          <f7-row>
            <f7-col>
              <f7-stepper fill :value="0" :min="0" :max="1000" :step="1" :autorepeat="true" :wraps="true" :manual-input-mode="true" :decimal-point="2"></f7-stepper>
            </f7-col>
          </f7-row>
        </f7-block>
      </f7-page>
    </template>
    
    <script>
      export default {
        data() {
          return {
            applesCount: 0,
            orangesCount: 0,
            meetingTime: 15,
          };
        },
        computed: {
          meetingTimeComputed() {
            const self = this;
            const value = self.meetingTime;
    
            const hours = Math.floor(value / 60);
            const minutes = value - (hours * 60);
            const formatted = [];
            if (hours > 0) {
              formatted.push(hours + ' ' + (hours > 1 ? 'hours' : 'hour'));
            }
            if (minutes > 0) {
              formatted.push(minutes + ' minutes');
            }
            return formatted.join(' ');
          },
        },
        methods: {
          setApples(value) {
            this.applesCount = value;
          },
          setOranges(value) {
            this.orangesCount = value;
          },
          setMeetingTime(value) {
            this.meetingTime = value;
          },
        },
      };
    </script>