useClasses

Technically, this is not a hooks, it just uses the nomenclature of hooks as well. useClasses is used to mix strings, objects, expressions, etc. into class-names, and remove the extra space characters. It is actually similar in function to classnames, but much more compact and lower of size.

The original purpose of creating an additional hooks instead of using a package from the community was to reduce the size of the package, there are not a lot of complex class-names expressions to deal with in Geist, just for regular space sign removal.

Basic usage

Remove spaces from multiple characters:

import { useClasses } from 'himalaya'

export default ({ className }) => {
  const myClass = 'button'

  // output -> "button "
  return <div className={`${myClass} ${className}`} />

  // output -> "button"
  return <div className={useClasses(myClass, className)} />
}

Add an expression based on class-names:

export default ({ className }) => {
  const classes = useClasses('button', isHover ? 'hover' : 'base', className)

  // output -> "button hover"
  // output -> "button base"
  return <div className={classes} />
}

Parse Object

For more complex scenarios, we can use hooks to parse an object and output a string:

export default ({ active, disabled }) => {
  const classes = useClasses('button', {
    active,
    'button-disabled': disabled,
  })

  // output -> "button active"
  // output -> "button active button-disabled"
  return <div className={classes} />
}

Boundary Scenes

Any value that can be implicitly typed to false will be ignored:

useClasses('') // output -> ""
useClasses(null) // output -> ""
useClasses('btn', undefined) // output -> "btn"
useClasses({ active: null }) // output -> ""
useClasses(0) // output -> ""
useClasses(false, 'btn', '') // output -> "btn"

APIs

useClasses

type useClasses = (input: string | Object | null | undefined | boolean | number) => string