Span
Overview
The Span component renders a styled inline <span> element with Bulma helper class integration. Use it for highlighting text, applying inline styles, or wrapping content that needs Bulma's typography and color utilities without affecting the document flow.
The Span component is a thin wrapper around the HTML <span> element, providing consistent Bulma styling and helper class support for inline content.
Import
import { Span } from '@allxsmith/bestax-bulma';
Props
| Prop | Type | Default | Description |
|---|---|---|---|
className | string | — | Additional CSS classes. |
textColor | 'primary' | 'link' | 'info' | 'success' | 'warning' | 'danger' | 'black' | 'black-bis' | 'black-ter' | 'grey-darker' | 'grey-dark' | 'grey' | 'grey-light' | 'grey-lighter' | 'white' | 'light' | 'dark' | 'inherit' | 'current' | — | Text color helper. |
bgColor | 'primary' | 'link' | 'info' | 'success' | 'warning' | 'danger' | 'black' | 'black-bis' | 'black-ter' | 'grey-darker' | 'grey-dark' | 'grey' | 'grey-light' | 'grey-lighter' | 'white' | 'light' | 'dark' | 'inherit' | 'current' | — | Background color helper. |
children | React.ReactNode | — | Content to render inside the span. |
| ... | All standard <span> and Bulma helper props | (See Helper Props) |
Usage
Default Span
The default usage of the Span component renders plain inline content.
<Span>Default Span</Span>
Primary Color Span
Set the text color using the textColor prop to highlight inline text.
<Span textColor="primary">Primary Text</Span>
Success Color Span
Use semantic colors to convey meaning.
<Span textColor="success">Success Text</Span>
Span with Background
Add a background color and padding to create a highlight effect.
<Span bgColor="warning" p="2"> Highlighted Text </Span>
Large Text Span
Use the textSize prop to increase the font size of inline content.
<Span textSize="3">Large Span</Span>
Bold Span
Apply bold text weight for emphasis.
<Span textWeight="bold">Bold Span</Span>
All Colors
Display spans in all Bulma theme colors.
<div style={{ display: 'flex', flexDirection: 'column', gap: '0.5rem' }}> <Span textColor="primary">Primary Span</Span> <Span textColor="link">Link Span</Span> <Span textColor="info">Info Span</Span> <Span textColor="success">Success Span</Span> <Span textColor="warning">Warning Span</Span> <Span textColor="danger">Danger Span</Span> </div>
Inline with Text
Spans work seamlessly inline within paragraphs.
<Paragraph> This paragraph contains a <Span textColor="primary">colored span</Span> and a{' '} <Span textWeight="bold">bold span</Span> for emphasis. </Paragraph>
Highlighted Text
Combine background and text colors for a marker-like highlight effect.
<Paragraph> This sentence has{' '} <Span bgColor="warning" textColor="dark" p="1"> highlighted text </Span>{' '} to draw attention. </Paragraph>
Accessibility
- Semantic Meaning: The
<span>element has no semantic meaning. Use it only for styling purposes. - Color Contrast: Ensure sufficient contrast between text and background colors for readability.
- Screen Readers: Content inside spans is read normally by screen readers.
For text that has semantic importance, consider using <strong> (Strong) or <em> (Emphasis) components instead.
Related Components
Strong: For semantically important bold text.Emphasis: For semantically emphasized italic text.Paragraph: For text paragraphs.- Helper Props: Bulma helper props for spacing, color, etc.