The visual color appearance of the component
Code
Code is a component used to display inline code. It is composed from the Box component with a font family of `mono` for displaying code.
The Code
component is a single part component. All of the styling is applied
directly to the code
element.
To learn more about styling single part components, visit the Component Style page.
Theming properties#
The properties that affect the theming of the Code
component are:
variant
: The visual variant of the code. Defaults tosubtle
.colorScheme
: The color scheme of the code. Defaults togray
.
Theming utilities#
defineStyle
: a function used to create style objects.defineStyleConfig
: a function used to define the style configuration for a single part component.
import { defineStyle, defineStyleConfig } from '@chakra-ui/react'
Customizing the default theme#
import { defineStyle, defineStyleConfig } from '@chakra-ui/react'const outline = defineStyle({border: '2px dashed', // change the appearance of the borderborderRadius: 0, // remove the border radiusfontSize: 'md', // change the font sizefontWeight: 'semibold', // change the font weight})export const codeTheme = defineStyleConfig({variants: { outline },})
After customizing the code theme, we can import it in our theme file and add it
in the components
property:
import { extendTheme } from '@chakra-ui/react'import { codeTheme } from './components/code'export const theme = extendTheme({components: { Code: codeTheme },})
This is a crucial step to make sure that any changes that we make to the Code theme are applied.
Adding a custom variant#
Let's assume we want to include a custom branded variant. Here's how we can do that:
import { defineStyle, defineStyleConfig } from '@chakra-ui/react'const brandPrimary = defineStyle({background: 'orange.500',color: 'white',fontFamily: 'mono',fontWeight: 'normal',// let's also provide dark mode alternatives_dark: {background: 'orange.300',color: 'orange.800',}})export const codeTheme = defineStyleConfig({variants: { brandPrimary },})// Now we can use the new `brandPrimary` variant<Code variant="brandPrimary">...</Code>
Using a custom color scheme#
Let's assume we want to use our own custom color scale based on our brand. We'd need to define the color scale first in the main theme file:
import { extendTheme } from '@chakra-ui/react'export const theme = extendTheme({colors: {brand: {50: '#f7fafc',...500: '#718096',...900: '#171923',}}})
Then, we can use the custom color scale as the color scheme for the Code:
<Code colorScheme='brand'>...</Code>
Changing the default properties#
Let's assume we want to change the default size, variant or color scheme of every code in our app. Here's how we can do that:
import { defineStyleConfig } from '@chakra-ui/react'export const codeTheme = defineStyleConfig({defaultProps: {variant: 'outline',colorScheme: 'brand',},})// This saves you time, instead of manually setting the size,// variant and color scheme every time you use a Code:<Code variant="outline" colorScheme="brand">...</Code>
Showcase#
import { Box, Flex, IconButton, Code, useColorMode } from "@chakra-ui/react"; import { FaMoon, FaSun } from "react-icons/fa"; export default function App() { const { toggleColorMode, colorMode } = useColorMode(); return ( <Box position="relative" h="100vh"> <Flex wrap="wrap" gap={12} p={12}> <Code colorScheme="green">console.log('Themed Green Code')</Code> <Code variant="custom">console.log('Themed Custom Variant Code')</Code> <Code variant="solid">console.log('Themed Solid Variant Code')</Code> <Code variant="outline"> console.log('Themed Outline Variant Code') </Code> </Flex> <IconButton aria-label="toggle theme" rounded="full" size="xs" position="absolute" bottom={4} left={4} onClick={toggleColorMode} icon={colorMode === "dark" ? <FaSun /> : <FaMoon />} /> </Box> ); }
Props#
colorScheme
colorScheme
"whiteAlpha" | "blackAlpha" | "gray" | "red" | "orange" | "yellow" | "green" | "teal" | "blue" | "cyan" | "purple" | "pink" | "linkedin" | "facebook" | "messenger" | "whatsapp" | "twitter" | "telegram"
gray
size
size
The size of the Code
string
variant
variant
The variant of the Code
"solid" | "subtle" | "outline"
subtle
The Code
component is a single part component. All of the styling is applied
directly to the code
element.
To learn more about styling single part components, visit the Component Style page.
Theming properties#
The properties that affect the theming of the Code
component are:
variant
: The visual variant of the code. Defaults tosubtle
.colorScheme
: The color scheme of the code. Defaults togray
.
Theming utilities#
defineStyle
: a function used to create style objects.defineStyleConfig
: a function used to define the style configuration for a single part component.
import { defineStyle, defineStyleConfig } from '@chakra-ui/react'
Customizing the default theme#
import { defineStyle, defineStyleConfig } from '@chakra-ui/react'const outline = defineStyle({border: '2px dashed', // change the appearance of the borderborderRadius: 0, // remove the border radiusfontSize: 'md', // change the font sizefontWeight: 'semibold', // change the font weight})export const codeTheme = defineStyleConfig({variants: { outline },})
After customizing the code theme, we can import it in our theme file and add it
in the components
property:
import { extendTheme } from '@chakra-ui/react'import { codeTheme } from './components/code'export const theme = extendTheme({components: { Code: codeTheme },})
This is a crucial step to make sure that any changes that we make to the Code theme are applied.
Adding a custom variant#
Let's assume we want to include a custom branded variant. Here's how we can do that:
import { defineStyle, defineStyleConfig } from '@chakra-ui/react'const brandPrimary = defineStyle({background: 'orange.500',color: 'white',fontFamily: 'mono',fontWeight: 'normal',// let's also provide dark mode alternatives_dark: {background: 'orange.300',color: 'orange.800',}})export const codeTheme = defineStyleConfig({variants: { brandPrimary },})// Now we can use the new `brandPrimary` variant<Code variant="brandPrimary">...</Code>
Using a custom color scheme#
Let's assume we want to use our own custom color scale based on our brand. We'd need to define the color scale first in the main theme file:
import { extendTheme } from '@chakra-ui/react'export const theme = extendTheme({colors: {brand: {50: '#f7fafc',...500: '#718096',...900: '#171923',}}})
Then, we can use the custom color scale as the color scheme for the Code:
<Code colorScheme='brand'>...</Code>
Changing the default properties#
Let's assume we want to change the default size, variant or color scheme of every code in our app. Here's how we can do that:
import { defineStyleConfig } from '@chakra-ui/react'export const codeTheme = defineStyleConfig({defaultProps: {variant: 'outline',colorScheme: 'brand',},})// This saves you time, instead of manually setting the size,// variant and color scheme every time you use a Code:<Code variant="outline" colorScheme="brand">...</Code>
Showcase#
import { Box, Flex, IconButton, Code, useColorMode } from "@chakra-ui/react"; import { FaMoon, FaSun } from "react-icons/fa"; export default function App() { const { toggleColorMode, colorMode } = useColorMode(); return ( <Box position="relative" h="100vh"> <Flex wrap="wrap" gap={12} p={12}> <Code colorScheme="green">console.log('Themed Green Code')</Code> <Code variant="custom">console.log('Themed Custom Variant Code')</Code> <Code variant="solid">console.log('Themed Solid Variant Code')</Code> <Code variant="outline"> console.log('Themed Outline Variant Code') </Code> </Flex> <IconButton aria-label="toggle theme" rounded="full" size="xs" position="absolute" bottom={4} left={4} onClick={toggleColorMode} icon={colorMode === "dark" ? <FaSun /> : <FaMoon />} /> </Box> ); }