Color Properties
All Framework7-Vue components supports same set of color properties that allow to set separate element colors and color themes:
| Prop | Type | Default | Description |
|---|---|---|---|
| color | string | Single element color. One of the default colors. | |
| color-theme | string | Applies color theme to the element. It should be some parent element as this will have visual effect on all supported children elements, e.g. view, page, navbar, toolbar, list, etc. One of the default colors. | |
| text-color | string | Sets element's text color. One of the default colors. | |
| bg-color | string | Sets element's background color. One of the default colors. | |
| border-theme | string | Sets element's borders color. One of the default colors. | |
| ripple-color | string | Sets element ripple wave color. One of the default colors. | |
| dark | boolean | false | Enables dark layout theme on element. It should be some parent element as this will have visual effect on all supported children elements, e.g. view, page, navbar, toolbar, list, etc. |
For example:
<!-- Button color -->
<f7-button color="red">Red Button</f7-button>
<!-- Link color -->
<f7-link color="green">Green Link</f7-link>
<!-- Page color theme -->
<f7-page color-theme="orange">
...
</f7-page>
<!-- Panel with dark theme -->
<f7-panel dark>
...
</f7-panel>
color-themes.vue
<template>
<f7-page>
<f7-navbar large title="Color Themes" back-link>
<template #right>
<f7-link>Link</f7-link>
</template>
</f7-navbar>
<f7-toolbar tabbar icons bottom>
<f7-toolbar-pane>
<f7-link
tab-link="#tab-1"
tab-link-active
text="Tab 1"
icon-ios="f7:envelope_fill"
icon-md="material:email"
/>
<f7-link
tab-link="#tab-2"
text="Tab 2"
icon-ios="f7:calendar_fill"
icon-md="material:today"
/>
<f7-link
tab-link="#tab-3"
text="Tab 3"
icon-ios="f7:cloud_upload_fill"
icon-md="material:file_upload"
/>
</f7-toolbar-pane>
</f7-toolbar>
<f7-block-title medium>Layout Themes</f7-block-title>
<f7-block strong inset>
<p>Framework7 comes with 2 main layout themes: Light (default) and Dark:</p>
<div class="grid grid-cols-2 grid-gap">
<div class="bg-color-white demo-theme-picker" @click="setLayoutTheme('light')">
<f7-checkbox v-if="theme === 'light'" checked disabled />
</div>
<div class="bg-color-black demo-theme-picker" @click="setLayoutTheme('dark')">
<f7-checkbox v-if="theme === 'dark'" checked disabled />
</div>
</div>
</f7-block>
<f7-block-title medium>Default Color Themes</f7-block-title>
<f7-block strong inset>
<p>Framework7 comes with {{ colors.length }} color themes set.</p>
<div class="grid grid-cols-3 medium-grid-cols-4 large-grid-cols-5 grid-gap">
<div v-for="(color, index) in colors" :key="index">
<f7-button
fill
round
small
class="demo-color-picker-button"
:color="color"
@click="setColorTheme(color)"
>{{ color }}</f7-button
>
</div>
</div>
</f7-block>
<f7-block-title medium>Material Color Scheme</f7-block-title>
<f7-list strong inset dividers-ios>
<f7-list-item title="Monochrome">
<template #after>
<f7-toggle
:checked="monochrome"
@toggle:change="() => setMdColorSchemeMonochrome(!monochrome)"
/>
</template>
</f7-list-item>
<f7-list-item title="Vibrant">
<template #after>
<f7-toggle :checked="vibrant" @toggle:change="() => setMdColorSchemeVibrant(!vibrant)" />
</template>
</f7-list-item>
</f7-list>
<f7-block-title medium>Custom Color Theme</f7-block-title>
<f7-list strong inset>
<f7-list-input
type="colorpicker"
label="HEX Color"
placeholder="e.g. #ff0000"
readonly
:value="{ hex: themeColor }"
:color-picker-params="{ targetEl: '#color-theme-picker-color' }"
@colorpicker:change="(value) => setCustomColor(value.hex)"
>
<template #media>
<div
id="color-theme-picker-color"
style="
width: 28px;
height: 28px;
border-radius: 4px;
background: var(--f7-color-primary);
"
></div>
</template>
</f7-list-input>
</f7-list>
</f7-page>
</template>
<script>
import {
f7Navbar,
f7Page,
f7BlockTitle,
f7Button,
f7Block,
f7List,
f7ListInput,
f7ListItem,
f7Checkbox,
f7Link,
f7Toolbar,
f7ToolbarPane,
f7Toggle,
f7,
} from 'framework7-vue';
import $ from 'dom7';
import { ref } from 'vue';
let globalTheme = 'light';
let globalThemeColor = $('html').css('--f7-color-primary').trim();
export default {
components: {
f7Navbar,
f7Page,
f7BlockTitle,
f7Button,
f7Block,
f7List,
f7ListInput,
f7ListItem,
f7Checkbox,
f7Link,
f7Toolbar,
f7ToolbarPane,
f7Toggle,
},
setup() {
if (!globalThemeColor) {
globalThemeColor = $('html').css('--f7-color-primary').trim();
}
const monochrome = ref(false);
const vibrant = ref(false);
const theme = ref(globalTheme);
const themeColor = ref(globalThemeColor);
const colors = Object.keys(f7.colors).filter(
(c) => c !== 'primary' && c !== 'white' && c !== 'black',
);
const setLayoutTheme = (newTheme) => {
f7.setDarkMode(newTheme === 'dark');
globalTheme = newTheme;
theme.value = newTheme;
};
const setColorTheme = (newColor) => {
globalThemeColor = f7.colors[newColor];
themeColor.value = globalThemeColor;
f7.setColorTheme(globalThemeColor);
};
const setCustomColor = (newColor) => {
globalThemeColor = newColor;
themeColor.value = globalThemeColor;
f7.setColorTheme(globalThemeColor);
};
const setMdColorScheme = () => {
if (!vibrant.value && !monochrome.value) {
f7.setMdColorScheme('default');
} else if (vibrant.value && !monochrome.value) {
f7.setMdColorScheme('vibrant');
} else if (!vibrant.value && monochrome.value) {
f7.setMdColorScheme('monochrome');
} else if (vibrant.value && monochrome.value) {
f7.setMdColorScheme('monochrome-vibrant');
}
};
const setMdColorSchemeMonochrome = (value) => {
monochrome.value = value;
setMdColorScheme();
};
const setMdColorSchemeVibrant = (value) => {
vibrant.value = value;
setMdColorScheme();
};
return {
monochrome,
vibrant,
theme,
themeColor,
colors,
setLayoutTheme,
setColorTheme,
setCustomColor,
setMdColorScheme,
setMdColorSchemeMonochrome,
setMdColorSchemeVibrant,
};
},
};
</script>







