Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

History

18 Commits

Repository files navigation

CSSTextLib

Atomic CSS文本工具库 - 600+单一用途类,让您在几秒内完成文本样式设计。

一个Sass文件 → 编译后**< 4 kB压缩版**
导入即可,无需再为文本样式编写新代码。


⚡ 快速开始

  1. 下载 csstextlib.min.css
  2. 放入 <head>
<linkrel="stylesheet" href="https://raw.githubusercontent.com/EndlessPixel/CSSTextLib/refs/heads/main/version/3.0/csstextlib.min.css">
  1. 在您的标记中使用类:
<pclass="text-color-blue text-bold text-size-large">
蓝色、粗体、大号文本 - 搞定。
</p>

🎨 功能概览

版本 3.0 (完整功能版)

类别示例类数量
颜色.text-color-blue, .text-color-light-green22
高亮背景.text-highlight-yellow, .text-highlight-black22
字体大小.text-size-small.text-size-xxxlarge10
透明度.text-opacity-0.text-opacity-100 (5%间隔)21
字重.text-weight-thin.text-weight-black (9档)9
文本阴影.text-shadow-small, .text-shadow-glow-white5
对齐.text-align-center, .text-align-justify4
装饰线.text-underline, .text-line-through6
字体族.text-font-monospace, .text-font-ui-rounded11
间距.text-letter-spacing-large, .text-word-spacing-small4
行高.text-line-height-small, .text-line-height-large3
文本溢出.text-overflow-ellipsis, .text-overflow-ellipsis-24
光标样式.text-cursor-pointer, .text-cursor-not-allowed4
文本选择.text-select-none, .text-select-all3
换行控制.text-nowrap, .text-pre-wrap4
垂直对齐.text-align-baseline, .text-align-super5
装饰线样式.text-underline-dashed, .text-underline-wavy4
交互效果.text-hover-bold, .text-hover-color-black4
特殊排版.text-writing-mode-vertical, .text-orientation-upright4
暗色模式通过 @media (prefers-color-scheme: dark) 自动切换
响应式.text-hide-sm, .text-show-lg8
动画.text-animate-fade, .text-animate-scale, .text-animate-blink3
打印优化自动优化打印样式

总计 ≈ 600+ 类 - 全部从一个Sass文件生成。


🔄 版本对比

版本 1.0 (基础版)

  • 文件: text.css
  • 大小: ~2kB (压缩后)
  • 功能: 基础文本样式、颜色、大小、对齐、装饰
  • 适合: 简单项目,只需要基础文本样式

版本 2.0 (增强版)

  • 文件: csstextlib.scss / csstextlib.min.css
  • 大小: ~3kB (压缩后)
  • 新增: SCSS变量、暗色模式、响应式类、基础动画
  • 适合: 现代Web应用,需要响应式和暗色模式支持

版本 3.0 (完整版) 推荐

  • 文件: csstextlib.scss / csstextlib.min.css
  • 大小: ~4kB (压缩后)
  • 新增: 多档位字重、文本阴影预设、多行省略、交互效果、光标样式、特殊排版等
  • 适合: 专业项目,需要完整文本样式控制和高级功能

🛠 自行构建

方法一:使用Sass编译

# 安装dart-sass(只需一次)
npm install -g sass
# 生成扩展版和压缩版
sass csstextlib.scss csstextlib.css --style=expanded
sass csstextlib.scss csstextlib.min.css --style=compressed

方法二:使用构建脚本

仓库包含构建脚本,只需运行:

  • Windows: 双击 build.bat
  • macOS/Linux: 运行 ./build.sh

🧩 自定义配置

编辑 csstextlib.scss 文件中的 变量映射

// 添加自定义颜色$color-map: (
'brand': #ff4757, // 添加品牌色'accent': #00d1b2, // 添加强调色'gray': #6c757d,
);
// 添加自定义字体大小$font-sizes: (
'tiny': 10px,
'huge': 48px,
// 原有大小保持不变
);
// 添加自定义字重$font-weights: (
'extrablack': 950, // 超黑体'ultralight': 50, // 超细体
);

重新编译后,新类如 .text-color-brand.text-size-huge.text-weight-extrablack 将自动生成。


🚀 高级用法示例

多行文本省略

<p class="text-overflow-ellipsis-2" style="width: 300px;">
这是两行文本省略示例,当文本超过两行时显示省略号...
</p>

交互效果

<p class="text-color-blue text-hover-bold text-cursor-pointer">
悬停时变粗体(尝试悬停)
</p>

特殊排版

<p class="text-writing-mode-vertical text-color-purple">
垂直排版的文本
</p>

动画文本

<p class="text-animate-fade text-color-orange">
淡入动画文本
</p>
<p class="text-animate-blink text-color-red">
闪烁动画文本
</p>

📄 许可证

Eclipse Public License 2.0
(详见 LICENSE 文件)


🤝 贡献指南

欢迎提交PR!请在提交前运行构建脚本,确保 .css.min.css 文件保持同步。

贡献步骤:

  1. Fork 本仓库
  2. 创建功能分支 (git checkout -b feature/新功能)
  3. 运行构建脚本 (./build.shbuild.bat)
  4. 提交更改 (git commit -m '添加新功能')
  5. 推送到分支 (git push origin feature/新功能)
  6. 创建Pull Request

注意事项:

  • 保持向后兼容性
  • 添加新功能时同时更新文档
  • 确保所有测试通过

📚 详细文档

查看完整文档和示例:
CSSTextLib 详细文档

About

一个由system_mini研发的CSS文本工具库 - 600+单一用途类,多种效果与响应式设计。单文件Sass源码与CSS压缩版。导入即用,瞬间完成文本样式设计。

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Contributors

Languages