classnames
一个简单的 JavaScript 实用程序,用于有条件地将类名连接在一起。
可以通过 npm
包管理器从 npm
注册表上下载:
npm install classnames
classNames
函数接受任意数量的参数,可以是字符串或对象。参数 'foo'
是 { foo: true } 的缩写。如果与给定键关联的值是假的,则该键将不会包含在输出中。
classNames('foo', 'bar'); // => 'foo bar'
classNames('foo', { bar: true }); // => 'foo bar'
classNames({ 'foo-bar': true }); // => 'foo-bar'
classNames({ 'foo-bar': false }); // => ''
classNames({ foo: true }, { bar: true }); // => 'foo bar'
classNames({ foo: true, bar: true }); // => 'foo bar'
// 支持不同类型的参数同时传入
classNames('foo', { bar: true, duck: false }, 'baz', { quux: true }); // => 'foo bar baz quux'
classNames(null, false, 'bar', undefined, 0, 1, { baz: null }, ''); // => 'bar 1'
// 数组将按照上述规则递归展平
const arr = ['b', { c: true, d: false }];
classNames('a', arr); // => 'a b c'
// 相当于
classNames('a', 'b', { c: true, d: false }); // => 'a b c'
let buttonType = 'primary';
classNames({ [`btn-${buttonType}`]: true });
在 React 中使用:
下面这段代码实现了一个具有交互功能的按钮组件。按钮的样式类名将根据按钮的状态动态改变,从而实现按钮按下和鼠标悬停的反馈效果。
import React, { useState } from 'react';
export default function Button (props) {
const [isPressed, setIsPressed] = useState(false);
const [isHovered, setIsHovered] = useState(false);
let btnClass = 'btn';
if (isPressed) btnClass += ' btn-pressed';
else if (isHovered) btnClass += ' btn-over';
return (
<button
className={btnClass}
onMouseDown={() => setIsPressed(true)}
onMouseUp={() => setIsPressed(false)}
onMouseEnter={() => setIsHovered(true)}
onMouseLeave={() => setIsHovered(false)}
>
{props.label}
</button>
);
}
而使用classnames
库来动态生成按钮的类名:
import React, { useState } from 'react';
import classNames from 'classnames';
export default function Button (props) {
const [isPressed, setIsPressed] = useState(false);
const [isHovered, setIsHovered] = useState(false);
const btnClass = classNames({
btn: true,
'btn-pressed': isPressed,
'btn-over': !isPressed && isHovered,
});
return (
<button
className={btnClass}
onMouseDown={() => setIsPressed(true)}
onMouseUp={() => setIsPressed(false)}
onMouseEnter={() => setIsHovered(true)}
onMouseLeave={() => setIsHovered(false)}
>
{props.label}
</button>
);
}
'btn: true'
:键为btn,表示按钮应该包含类名 btn
。'btn-pressed': isPressed
:键为btn-pressed
,表示当isPressed
为true
时,按钮应该包含类名btn-pressed
。'btn-over': !isPressed && isHovered
:键为btn-over
,表示当isPressed
为false
且isHovered
为true
时,按钮应该包含类名btn-over
。因为可以将对象、数组和字符串参数混合在一起,所以支持可选的 className
prop
属性也更简单,因为结果中只包含真实参数:
const btnClass = classNames('btn', this.props.className, {
'btn-pressed': isPressed,
'btn-over': !isPressed && isHovered,
});
此外,作者还提供了另外两个版本:dedupe
版本和 bind
版本。
其中dedupe
版本可以正确地删除类的重复数据,并确保从结果集中排除后面参数中指定的虚假类。但是此版本速度较慢(大约 5 倍),因此它作为一个可选的版本。
const classNames = require('classnames/dedupe');
classNames('foo', 'foo', 'bar'); // => 'foo bar'
classNames('foo', { foo: false, bar: true }); // => 'bar'
而另一个bind
版本可以让你结合 css-modules
,以便在组件中动态地添加或删除 CSS 类名,同时保证 css-modules
的作用域。
css-modules
是一种在项目中使用局部作用域的 CSS 的方法。它通过给每个类名添加一个唯一的哈希值,确保类名在整个应用程序中是唯一的,避免了全局作用域的类名冲突。
const classNames = require('classnames/bind');
const styles = {
foo: 'abc',
bar: 'def',
baz: 'xyz',
};
const cx = classNames.bind(styles);
const className = cx('foo', ['bar'], { baz: true }); // => 'abc def xyz'
下面是一个使用classnames
的bind
版本结合css-modules
的示例:
import { useState } from 'react';
import classNames from 'classnames/bind';
import styles from './submit-button.css';
const cx = classNames.bind(styles);
export default function SubmitButton ({ store, form }) {
const [submissionInProgress, setSubmissionInProgress] = useState(store.submissionInProgress);
const [errorOccurred, setErrorOccurred] = useState(store.errorOccurred);
const [valid, setValid] = useState(form.valid);
const text = submissionInProgress ? 'Processing...' : 'Submit';
const className = cx({
base: true,
inProgress: submissionInProgress,
error: errorOccurred,
disabled: valid,
});
return <button className={className}>{text}</button>;
}
由于代码比较短,这里便直接放源码,并在其中加上了注释,读者可自行阅读:
/*!
Copyright (c) 2018 Jed Watson.
Licensed under the MIT License (MIT), see
http://jedwatson.github.io/classnames
*/
/* global define */
(function () {
'use strict';
var hasOwn = {}.hasOwnProperty;
function classNames() {
// 用于存储生成的类名数组
var classes = [];
for (var i = 0; i < arguments.length; i++) {
// 获取当前参数
var arg = arguments[i];
// 如果参数为空或为false,则跳过
if (!arg) continue;
// 获取参数的类型
var argType = typeof arg;
// 如果参数是字符串或数字,则直接添加到类名数组中
if (argType === 'string' || argType === 'number') {
classes.push(arg);
} else if (Array.isArray(arg)) {
if (arg.length) {
// 如果参数是数组,则递归调用classnames函数,并将数组作为参数传入
var inner = classNames.apply(null, arg);
if (inner) {
// 如果递归调用的结果不为空,则将结果添加到类名数组中
classes.push(inner);
}
}
} else if (argType === 'object') {
// 判断 object 是否是一个自定义对象
// 因为原生的 JavaScript 对象(例如 Array、Object 等)的 toString 方法包含 [native code]
if (arg.toString !== Object.prototype.toString && !arg.toString.toString().includes('[native code]')) {
classes.push(arg.toString());
continue;
}
for (var key in arg) {
if (hasOwn.call(arg, key) && arg[key]) {
// 如果参数是对象,并且对象的属性值为真,则将属性名添加到类名数组中
classes.push(key);
}
}
}
}
// 将类名数组通过空格连接成字符串,并返回
return classes.join(' ');
}
// 判断是否在CommonJS环境下,如果是,则将classNames赋值给module.exports
if (typeof module !== 'undefined' && module.exports) {
classNames.default = classNames;
module.exports = classNames;
} else if (typeof define === 'function' && typeof define.amd === 'object' && define.amd) {
// 如果在AMD环境下,则将classnames函数注册为模块,并将其命名为'classnames'
define('classnames', [], function () {
return classNames;
});
} else {
// 在浏览器环境下,将classnames函数挂载到全局的window对象上
window.classNames = classNames;
}
}());
/*!
Copyright (c) 2018 Jed Watson.
Licensed under the MIT License (MIT), see
http://jedwatson.github.io/classnames
*/
/* global define */
(function () {
'use strict';
var classNames = (function () {
// 创建一个不继承自Object的空对象,以便后面可以跳过hasOwnProperty的检查
function StorageObject() {}
StorageObject.prototype = Object.create(null);
// 解析数组,将数组中的每个元素解析为classNames
function _parseArray (resultSet, array) {
var length = array.length;
for (var i = 0; i < length; ++i) {
_parse(resultSet, array[i]);
}
}
var hasOwn = {}.hasOwnProperty;
// 解析数字,将数字作为classNames的属性
function _parseNumber (resultSet, num) {
resultSet[num] = true;
}
// 解析对象,将对象的属性作为classNames的属性
function _parseObject (resultSet, object) {
// 判断 object 是否是一个自定义对象
// 因为原生的 JavaScript 对象(例如 Array、Object 等)的 toString 方法包含 [native code]
if (object.toString !== Object.prototype.toString && !object.toString.toString().includes('[native code]')) {
resultSet[object.toString()] = true;
return;
}
for (var k in object) {
if (hasOwn.call(object, k)) {
// set value to false instead of deleting it to avoid changing object structure
// https://www.smashingmagazine.com/2012/11/writing-fast-memory-efficient-javascript/#de-referencing-misconceptions
resultSet[k] = !!object[k];
}
}
}
var SPACE = /\s+/;
// 解析字符串,将字符串按照空格分割为数组,并将数组中的每个元素作为classNames的属性
function _parseString (resultSet, str) {
var array = str.split(SPACE);
var length = array.length;
for (var i = 0; i < length; ++i) {
resultSet[array[i]] = true;
}
}
// 解析参数,根据参数的类型调用相应的解析函数
function _parse (resultSet, arg) {
if (!arg) return;
var argType = typeof arg;
// 处理字符串类型的参数
// 'foo bar'
if (argType === 'string') {
_parseString(resultSet, arg);
// 处理数组类型的参数
// ['foo', 'bar', ...]
} else if (Array.isArray(arg)) {
_parseArray(resultSet, arg);
// 处理对象类型的参数
// { 'foo': true, ... }
} else if (argType === 'object') {
_parseObject(resultSet, arg);
// 处理数字类型的参数
// '130'
} else if (argType === 'number') {
_parseNumber(resultSet, arg);
}
}
// 主函数
function _classNames () {
// 避免arguments泄漏
var len = arguments.length;
var args = Array(len);
for (var i = 0; i < len; i++) {
args[i] = arguments[i];
}
// 创建一个存储classNames的对象
var classSet = new StorageObject();
// 解析参数并将结果存储在classSet对象中
_parseArray(classSet, args);
var list = [];
// 将classSet中值为true的属性加入到list数组中
for (var k in classSet) {
if (classSet[k]) {
list.push(k)
}
}
return list.join(' ');
}
return _classNames;
})();
// 判断是否在CommonJS环境下,如果是,则将classNames赋值给module.exports
if (typeof module !== 'undefined' && module.exports) {
classNames.default = classNames;
module.exports = classNames;
} else if (typeof define === 'function' && typeof define.amd === 'object' && define.amd) {
// 如果在AMD环境下,则将classnames函数注册为模块,并将其命名为'classnames'
define('classnames', [], function () {
return classNames;
});
} else {
// 在浏览器环境下,将classnames函数挂载到全局的window对象上
window.classNames = classNames;
}
}());
/*!
Copyright (c) 2018 Jed Watson.
Licensed under the MIT License (MIT), see
http://jedwatson.github.io/classnames
*/
/* global define */
(function () {
'use strict';
var hasOwn = {}.hasOwnProperty;
function classNames () {
// 用于存储生成的类名数组
var classes = [];
for (var i = 0; i < arguments.length; i++) {
// 获取当前参数
var arg = arguments[i];
// 如果参数为空或为false,则跳过
if (!arg) continue;
var argType = typeof arg;
// 如果参数是字符串或数字,则直接添加到类名数组中
if (argType === 'string' || argType === 'number') {
classes.push(this && this[arg] || arg);
} else if (Array.isArray(arg)) {
// 如果参数是数组,则递归调用classnames函数,并将数组作为参数传入
classes.push(classNames.apply(this, arg));
} else if (argType === 'object') {
// 判断 object 是否是一个自定义对象
// 因为原生的 JavaScript 对象(例如 Array、Object 等)的 toString 方法包含 [native code]
if (arg.toString !== Object.prototype.toString && !arg.toString.toString().includes('[native code]')) {
classes.push(arg.toString());
continue;
}
for (var key in arg) {
if (hasOwn.call(arg, key) && arg[key]) {
// 如果参数是对象,并且对象的属性值为真,则将属性名添加到类名数组中
classes.push(this && this[key] || key);
}
}
}
}
return classes.join(' ');
}
// 判断是否在CommonJS环境下,如果是,则将classNames赋值给module.exports
if (typeof module !== 'undefined' && module.exports) {
classNames.default = classNames;
module.exports = classNames;
} else if (typeof define === 'function' && typeof define.amd === 'object' && define.amd) {
// 如果在AMD环境下,则将classnames函数注册为模块,并将其命名为'classnames'
define('classnames', [], function () {
return classNames;
});
} else {
// 在浏览器环境下,将classnames函数挂载到全局的window对象上
window.classNames = classNames;
}
}());
与 index.js
相比,这个版本增加了对this
上下文的处理。
// 以下类型声明主要用于定义一个名为 "classNames" 的命名空间和相关的类型。
// 在这个声明中,"classNames" 命名空间中定义了一些类型和接口
declare namespace classNames {
// "Value" 是一个联合类型,表示可以接受的值的类型,包括字符串、数字、布尔值、未定义和空值
type Value = string | number | boolean | undefined | null;
// "Mapping" 是一个类型别名,表示一个键值对的集合,其中键是字符串,值可以是任何类型
type Mapping = Record<string, unknown>;
// "ArgumentArray" 是一个接口,继承自数组类型 "Array",表示一个参数数组,其中每个元素都是 "Argument" 类型
interface ArgumentArray extends Array<Argument> {}
// "ReadonlyArgumentArray" 是一个接口,继承自只读数组类型 "ReadonlyArray",表示一个只读的参数数组
interface ReadonlyArgumentArray extends ReadonlyArray<Argument> {}
// "Argument" 是一个联合类型,表示可以作为参数的类型,可以是 "Value"、"Mapping"、"ArgumentArray" 或 "ReadonlyArgumentArray"
type Argument = Value | Mapping | ArgumentArray | ReadonlyArgumentArray;
}
// 定义了一个名为 "ClassNames" 的接口,它是一个函数类型,可以接受 "classNames.ArgumentArray" 类型的参数,并返回一个字符串
interface ClassNames {
(...args: classNames.ArgumentArray): string;
default: ClassNames;
}
declare const classNames: ClassNames;
// 通过 "export as namespace" 来将 "classNames" 声明为全局命名空间
export as namespace classNames;
// 使用 "export =" 来导出 "classNames",使其可以在其他模块中使用
export = classNames;
在源码开头使用严格模式的主要原因是为了确保代码的质量和可靠性。严格模式可以帮助开发者避免一些常见的错误和不规范的语法,同时也提供了更严格的错误检查和更清晰的错误提示。使用严格模式可以减少一些隐患,提高代码的可维护性和可读性。
此外,严格模式还可以禁止一些潜在的危险行为,例如禁止使用未声明的变量、禁止对只读属性赋值、禁止删除变量等。这可以提高代码的安全性,减少一些潜在的漏洞和安全风险。
因此,为了确保代码的质量、可靠性和安全性,许多开发者选择在源码开头使用严格模式。这样可以强制要求代码符合更严格的规范,减少错误和潜在的问题,并提高代码的可维护性和可读性。
Object.create(null)
是一个创建一个新对象的方法,该对象没有原型链,也就是没有继承任何属性和方法。这意味着该对象没有内置的属性和方法,只能通过直接赋值来添加属性和方法。使用 Object.create(null)
创建的对象被称为“纯净对象”或“字典对象”,它适用于需要一个纯粹的键值对集合而不需要继承的场景。在这种对象中,键和值可以是任何类型的数据,而不仅限于字符串。
在代码中使用了 StorageObject.prototype = Object.create(null);
创建了一个不继承自 Object
的空对象 StorageObject
。这样可以跳过 hasOwnProperty
的检查,提高代码的性能。
解析不同类型的参数,包括字符串、数组、对象和数字
设计模式
单例模式是一种创建型设计模式,用于确保某个类只有一个实例,并提供一个全局访问点来访问该实例。
classNames
对象,并将其赋值给全局变量window.classNames
。这样就保证了只有一个classNames
对象存在,其他地方无法再创建新的classNames
对象。工厂模式是一种创建型设计模式,它提供了一种创建对象的接口,但具体创建的对象类型可以在运行时确定。工厂模式可以分为简单工厂模式、工厂方法模式和抽象工厂模式。
- 简单工厂模式:也称为静态工厂模式,它直接使用一个静态方法来创建对象。
- 工厂方法模式:也称为虚拟工厂模式,它定义了一个工厂接口,并由不同的具体工厂实现来创建不同的对象。
_classNames()
创建classNames
对象,该对象可以根据不同的参数类型调用不同的解析函数来解析参数,并将结果存储在classSet
对象中。classNames
根据不同的运行环境,判断是否在 CommonJS
环境下、AMD
环境下或浏览器环境下。如果在 CommonJS
环境下,将 classNames
赋值给 module.exports
;如果在 AMD
环境下,将 classNames
注册为模块,并命名为 'classnames'
;如果在浏览器环境下,将 classNames
挂载到全局的 window
对象上。
declare namespace
可以定义一个命名空间,将相关的类型和接口组织在一起,防止命名冲突并提供模块化的结构。type
关键字可以定义类型别名,方便重复使用复杂的类型。联合类型可以用于表示一个值可以是多个不同类型之一。interface
关键字可以定义接口,表示一种对象的结构。接口可以继承自其他接口,通过继承可以复用已有的接口定义。export
关键字可以将类型或值导出,使其可以在其他模块中使用。使用 import
关键字可以在其他模块中导入已导出的类型或值。