Input Components

Overview

Centinela provides specialized input components for common use cases including file uploads (InputFile), color pickers with transparency (InputColor), and status chips (ChipCustom). These components extend Material-UI functionality with custom styling and behavior.

InputFile

A file upload component with visual feedback, specifically designed for image uploads.

Import

import InputFile from '../../../components/InputFile/InputFile'

Props

title

string

default:"Subir Archivo"

Button label text for the file upload button.

fnc

function

required

Callback function triggered when a file is selected. Receives the event object.

fnc={(event) => {
  const file = event.target.files[0]
  console.log('Selected file:', file)
}}

fileSelected

File

Currently selected file object to display. Used for controlled component behavior.

fileSelected={currentFile}

Usage Examples

Basic File Upload

import { useState } from 'react'
import InputFile from '../../../components/InputFile/InputFile'

function ImageUploader() {
  const [file, setFile] = useState(null)

  const handleFileChange = (event) => {
    const selectedFile = event.target.files[0]
    setFile(selectedFile)
  }

  return (
    <InputFile 
      title="Subir Imagen" 
      fnc={handleFileChange}
      fileSelected={file}
    />
  )
}

Upload with Validation

function ValidatedImageUpload() {
  const [file, setFile] = useState(null)
  const [error, setError] = useState('')

  const handleFileChange = (event) => {
    const selectedFile = event.target.files[0]
    
    // Validate file size (max 5MB)
    if (selectedFile.size > 5 * 1024 * 1024) {
      setError('File size must be less than 5MB')
      return
    }
    
    // Validate file type
    if (!selectedFile.type.startsWith('image/')) {
      setError('Only image files are allowed')
      return
    }
    
    setError('')
    setFile(selectedFile)
  }

  return (
    <div>
      <InputFile 
        title="Upload Logo" 
        fnc={handleFileChange}
        fileSelected={file}
      />
      {error && <p className="text-red-600 mt-2">{error}</p>}
    </div>
  )
}

Upload with Preview

function ImageUploadWithPreview() {
  const [file, setFile] = useState(null)
  const [preview, setPreview] = useState(null)

  const handleFileChange = (event) => {
    const selectedFile = event.target.files[0]
    setFile(selectedFile)
    
    // Create preview URL
    if (selectedFile) {
      const reader = new FileReader()
      reader.onloadend = () => {
        setPreview(reader.result)
      }
      reader.readAsDataURL(selectedFile)
    }
  }

  return (
    <div className="flex flex-col gap-4">
      <InputFile 
        title="Select Image" 
        fnc={handleFileChange}
        fileSelected={file}
      />
      
      {preview && (
        <div className="border rounded p-2">
          <img 
            src={preview} 
            alt="Preview" 
            className="max-w-xs max-h-64 object-contain"
          />
        </div>
      )}
    </div>
  )
}

Component Source

Location: ~/workspace/source/src/components/InputFile/InputFile.jsx

InputFile accepts only image files by default (accept=‘image/*’). The component displays the selected filename below the upload button.

InputColor

A color picker component with transparency/opacity control, outputting RGBA color values.

Import

import InputColor from '../../../components/InputColor/InputColor'

Props

updateBackground

function

required

Callback function that receives the updated RGBA color string.

updateBackground={(rgbaColor) => {
  console.log('New color:', rgbaColor)
  // Example output: "rgba(255, 0, 0, 0.5)"
}}

backgroundText

string

required

Initial color value in RGBA format.

backgroundText="rgba(0, 0, 0, 1)"

Usage Examples

Basic Color Picker

import { useState } from 'react'
import InputColor from '../../../components/InputColor/InputColor'

function ColorSelector() {
  const [backgroundColor, setBackgroundColor] = useState('rgba(0, 0, 0, 1)')

  return (
    <div>
      <InputColor
        updateBackground={setBackgroundColor}
        backgroundText={backgroundColor}
      />
      
      <div 
        className="mt-4 p-4 rounded"
        style={{ backgroundColor }}
      >
        Preview
      </div>
    </div>
  )
}

Chart Background Configuration

import InputColor from '../../../components/InputColor/InputColor'
import { useForm } from 'react-hook-form'

function ChartConfig() {
  const { setValue, watch } = useForm({
    defaultValues: {
      backgroundColor: 'rgba(255, 255, 255, 0.8)'
    }
  })
  
  const bgColor = watch('backgroundColor')

  return (
    <div className="flex flex-col gap-3">
      <InputColor
        updateBackground={(color) => setValue('backgroundColor', color)}
        backgroundText={bgColor}
      />
      
      <div 
        className="chart-preview p-6 rounded-lg"
        style={{ backgroundColor: bgColor }}
      >
        <h3>Chart Title</h3>
        {/* Chart content */}
      </div>
    </div>
  )
}

Multiple Color Inputs

function ThemeEditor() {
  const [primaryColor, setPrimaryColor] = useState('rgba(59, 130, 246, 1)')
  const [secondaryColor, setSecondaryColor] = useState('rgba(168, 85, 247, 1)')
  const [bgColor, setBgColor] = useState('rgba(255, 255, 255, 0.95)')

  return (
    <div className="flex flex-col gap-4">
      <div>
        <label className="block mb-2 font-semibold">Primary Color</label>
        <InputColor
          updateBackground={setPrimaryColor}
          backgroundText={primaryColor}
        />
      </div>
      
      <div>
        <label className="block mb-2 font-semibold">Secondary Color</label>
        <InputColor
          updateBackground={setSecondaryColor}
          backgroundText={secondaryColor}
        />
      </div>
      
      <div>
        <label className="block mb-2 font-semibold">Background Color</label>
        <InputColor
          updateBackground={setBgColor}
          backgroundText={bgColor}
        />
      </div>
    </div>
  )
}

Component Source

Location: ~/workspace/source/src/components/InputColor/InputColor.jsx

InputColor outputs colors in RGBA format, allowing for transparency control through the opacity slider. The color is converted from HEX to RGB internally.

ChipCustom

A customizable chip/badge component with color variants and action icons.

Import

import ChipCustom from '../../../components/ChipCustom/ChipCustom'

Props

label

string

default:""

Text content to display in the chip.

color

string

default:"default"

Color variant for the chip. Options:

default - Gray background
success - Green background
error - Red background

onClick

function

Click handler for the chip label. Makes the chip clickable.

onClick={() => console.log('Chip clicked')}

onDelete

function

Shows a delete icon and calls this function when clicked.

onDelete={() => handleRemove(id)}

onInfo

function

Shows an info icon and calls this function when clicked.

onInfo={() => showDetails(id)}

Usage Examples

Basic Chips

import ChipCustom from '../../../components/ChipCustom/ChipCustom'

function StatusDisplay() {
  return (
    <div className="flex gap-2">
      <ChipCustom label="Pending" color="default" />
      <ChipCustom label="Active" color="success" />
      <ChipCustom label="Error" color="error" />
    </div>
  )
}

Clickable Chips

function FilterChips() {
  const [selectedFilter, setSelectedFilter] = useState('all')

  return (
    <div className="flex gap-2">
      <ChipCustom 
        label="All" 
        color={selectedFilter === 'all' ? 'success' : 'default'}
        onClick={() => setSelectedFilter('all')}
      />
      <ChipCustom 
        label="Active" 
        color={selectedFilter === 'active' ? 'success' : 'default'}
        onClick={() => setSelectedFilter('active')}
      />
      <ChipCustom 
        label="Inactive" 
        color={selectedFilter === 'inactive' ? 'success' : 'default'}
        onClick={() => setSelectedFilter('inactive')}
      />
    </div>
  )
}

Deletable Tags

function TagManager() {
  const [tags, setTags] = useState(['sensor-a', 'high-priority', 'monitored'])

  const removeTag = (tagToRemove) => {
    setTags(tags.filter(tag => tag !== tagToRemove))
  }

  return (
    <div className="flex flex-wrap gap-2">
      {tags.map(tag => (
        <ChipCustom
          key={tag}
          label={tag}
          color="success"
          onDelete={() => removeTag(tag)}
        />
      ))}
    </div>
  )
}

Chips with Info Action

function AlarmChips() {
  const alarms = [
    { id: 1, name: 'Temperature High', severity: 'error' },
    { id: 2, name: 'Pressure Normal', severity: 'success' },
  ]

  const showAlarmDetails = (alarmId) => {
    console.log('Show details for alarm:', alarmId)
  }

  return (
    <div className="flex flex-wrap gap-2">
      {alarms.map(alarm => (
        <ChipCustom
          key={alarm.id}
          label={alarm.name}
          color={alarm.severity}
          onInfo={() => showAlarmDetails(alarm.id)}
        />
      ))}
    </div>
  )
}

Multi-Action Chips

function SensorTags() {
  const [sensors, setSensors] = useState([
    { id: 1, name: 'Temp Sensor A', status: 'success' },
    { id: 2, name: 'Flow Sensor B', status: 'error' },
  ])

  const viewSensor = (id) => {
    console.log('View sensor:', id)
  }

  const removeSensor = (id) => {
    setSensors(sensors.filter(s => s.id !== id))
  }

  const showSensorInfo = (id) => {
    console.log('Show info for sensor:', id)
  }

  return (
    <div className="flex flex-wrap gap-2">
      {sensors.map(sensor => (
        <ChipCustom
          key={sensor.id}
          label={sensor.name}
          color={sensor.status}
          onClick={() => viewSensor(sensor.id)}
          onDelete={() => removeSensor(sensor.id)}
          onInfo={() => showSensorInfo(sensor.id)}
        />
      ))}
    </div>
  )
}

Component Source

Location: ~/workspace/source/src/components/ChipCustom/ChipCustom.jsx

Color Variants

<ChipCustom label="Default" color="default" />
// Gray background (bg-gray-500)

Common Use Cases

Form with File Upload
Tag Filter System
Status Badges

import { useState } from 'react'
import { TextField, Button } from '@mui/material'
import InputFile from '../../../components/InputFile/InputFile'
import InputColor from '../../../components/InputColor/InputColor'

function ChartForm() {
  const [chartName, setChartName] = useState('')
  const [logoFile, setLogoFile] = useState(null)
  const [bgColor, setBgColor] = useState('rgba(255, 255, 255, 1)')

  const handleSubmit = (e) => {
    e.preventDefault()
    
    const formData = new FormData()
    formData.append('name', chartName)
    formData.append('logo', logoFile)
    formData.append('backgroundColor', bgColor)
    
    // Submit form data
  }

  return (
    <form onSubmit={handleSubmit} className="flex flex-col gap-4">
      <TextField
        label="Chart Name"
        value={chartName}
        onChange={(e) => setChartName(e.target.value)}
        fullWidth
      />
      
      <InputFile
        title="Upload Chart Logo"
        fnc={(e) => setLogoFile(e.target.files[0])}
        fileSelected={logoFile}
      />
      
      <InputColor
        updateBackground={setBgColor}
        backgroundText={bgColor}
      />
      
      <Button type="submit" variant="contained">
        Create Chart
      </Button>
    </form>
  )
}

import { useState } from 'react'
import ChipCustom from '../../../components/ChipCustom/ChipCustom'

function DataFilter() {
  const [activeTags, setActiveTags] = useState(['all'])
  const availableTags = ['all', 'sensors', 'alarms', 'reports']

  const toggleTag = (tag) => {
    if (tag === 'all') {
      setActiveTags(['all'])
    } else {
      const newTags = activeTags.filter(t => t !== 'all')
      
      if (activeTags.includes(tag)) {
        const filtered = newTags.filter(t => t !== tag)
        setActiveTags(filtered.length ? filtered : ['all'])
      } else {
        setActiveTags([...newTags, tag])
      }
    }
  }

  return (
    <div className="flex gap-2 flex-wrap">
      {availableTags.map(tag => (
        <ChipCustom
          key={tag}
          label={tag}
          color={activeTags.includes(tag) ? 'success' : 'default'}
          onClick={() => toggleTag(tag)}
        />
      ))}
    </div>
  )
}

import ChipCustom from '../../../components/ChipCustom/ChipCustom'

function SensorStatusList({ sensors }) {
  const getStatusColor = (status) => {
    switch(status) {
      case 'online': return 'success'
      case 'offline': return 'error'
      default: return 'default'
    }
  }

  const handleViewDetails = (sensorId) => {
    // Navigate to sensor details
  }

  return (
    <div className="space-y-2">
      {sensors.map(sensor => (
        <div key={sensor.id} className="flex items-center gap-3 p-2">
          <span className="font-medium">{sensor.name}</span>
          <ChipCustom
            label={sensor.status}
            color={getStatusColor(sensor.status)}
            onInfo={() => handleViewDetails(sensor.id)}
          />
        </div>
      ))}
    </div>
  )
}

Best Practices

InputFile

Validation: Always validate file size and type before processing
User Feedback: Show preview or filename to confirm selection
Error Handling: Provide clear error messages for invalid files
Accessibility: Ensure the label is descriptive and meaningful

InputColor

Initial Values: Always provide a valid RGBA string as initial value
Preview: Show a live preview of the selected color
Contrast: Consider text contrast when using backgrounds
Transparency: Remember that transparency affects overlapping elements

ChipCustom

Color Semantics: Use colors consistently (success=positive, error=negative)
Interactive States: Only make chips clickable when there’s an action
Icon Usage: Don’t combine too many actions on a single chip
Spacing: Use flex gap for proper chip spacing in groups

Chart Types

UI Components

Overview

InputFile

Import

Props

Usage Examples

Basic File Upload

Upload with Validation

Upload with Preview

Component Source

InputColor

Import

Props

Usage Examples

Basic Color Picker

Chart Background Configuration

Multiple Color Inputs

Component Source

ChipCustom

Import

Props

Usage Examples

Basic Chips

Clickable Chips

Deletable Tags

Chips with Info Action

Multi-Action Chips

Component Source

Color Variants

Common Use Cases

Best Practices

InputFile

InputColor

ChipCustom

Build docs developers (and LLMs) love

Chart Types

UI Components

Documentation Index

​Overview

​InputFile

​Import

​Props

​Usage Examples

​Basic File Upload

​Upload with Validation

​Upload with Preview

​Component Source

​InputColor

​Import

​Props

​Usage Examples

​Basic Color Picker

​Chart Background Configuration

​Multiple Color Inputs

​Component Source

​ChipCustom

​Import

​Props

​Usage Examples

​Basic Chips

​Clickable Chips

​Deletable Tags

​Chips with Info Action

​Multi-Action Chips

​Component Source

​Color Variants

​Common Use Cases

​Best Practices

​InputFile

​InputColor

​ChipCustom

Build docs developers (and LLMs) love

Overview

InputFile

Import

Props

Usage Examples

Basic File Upload

Upload with Validation

Upload with Preview

Component Source

InputColor

Import

Props

Usage Examples

Basic Color Picker

Chart Background Configuration

Multiple Color Inputs

Component Source

ChipCustom

Import

Props

Usage Examples

Basic Chips

Clickable Chips

Deletable Tags

Chips with Info Action

Multi-Action Chips

Component Source

Color Variants

Common Use Cases

Best Practices

InputFile

InputColor

ChipCustom