word-wrap

中文文档
1.2.5发布于 2023/07/22MITTypeScriptCommonJS零依赖近 30 天下载 5.4亿

将单词换行到指定的长度。

中文使用文档
文档目录14 节
  1. 安装
  2. 用法
  3. 选项
  4. options.width
  5. options.indent
  6. options.newline
  7. options.escape
  8. options.trim
  9. options.cut
  10. 关于
  11. 相关项目
  12. 贡献者
  13. 作者
  14. 许可证

自动换行 NPM version NPM monthly downloads NPM total downloads Linux Build Status

将单词换行到指定的长度。

请考虑跟随这个项目的作者, Jon Schlinkert,并考虑主演该项目,以展示您的: 心: 和支持。

安装

安装与 npm:

$ npm install --save word-wrap

用法

var wrap = require('word-wrap');

wrap('Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.');

结果:

  Lorem ipsum dolor sit amet, consectetur adipiscing
  elit, sed do eiusmod tempor incididunt ut labore
  et dolore magna aliqua. Ut enim ad minim veniam,
  quis nostrud exercitation ullamco laboris nisi ut
  aliquip ex ea commodo consequat.

选项

image

options.width

类型: Number

默认值: 50

在换行到新行之前的文本宽度。

例子:

wrap(str, {width: 60});

options.indent

类型: String

默认值:‘ ’(两个空格)

在每行开头使用的字符串。

例子:

wrap(str, {indent: '      '});

options.newline

类型: String

默认值: \n

在每行末尾使用的字符串。

例子:

wrap(str, {newline: '\n\n'});

options.escape

类型: function

默认值: function(str){return str;}

一个转义函数,在分隔行之后在每行上运行。

例子:

var xmlescape = require('xml-escape');
wrap(str, {
  escape: function(string){
    return xmlescape(string);
  }
});

options.trim

类型: Boolean

默认值: false

从返回的字符串中删除尾随空格。这个选项是自 .trim() 还将从第一行去掉前导缩进。

例子:

wrap(str, {trim: true});

options.cut

类型: Boolean

默认值: false

当单词长度超过指定宽度时,将单词分隔为任意两个字母。

例子:

wrap(str, {cut: true});

关于

贡献

拉请求和明星总是受欢迎的。对于bug和特性请求, 请创建一个问题。

运行测试

运行和审查单元测试是熟悉库及其API的好方法。可以使用以下命令安装依赖项并运行测试:

$ npm install && npm test
建立文档

(这个项目的自述。Md由 动词请不要直接编辑自述文件。对自述文件的任何更改都必须在 .verb.md 自述文件模板)。

使用实例生成自述文件。

$ npm install -g verbose/verb#dev verb-generate-readme && verb

你也可能对这些项目感兴趣:

贡献者

| 提交 | 贡献者 |
| --- | --- |
| 47 | jonschlinkert |
| 7 | OlafConijn |
| 3 | doowb |
| 2 | aashutoshrathi |
| 2 | lordvlad |
| 2 | hildjj |
| 1 | danilosampaio |
| 1 | 2 fd |
| 1 | leonard-thieu |
| 1 | mohd-akram |
| 1 | toddself |
| 1 | wolfgang42 |
| 1 | zachhale |

作者

Jon Schlinkert

许可证

版权所有©2023 Jon Schlinkert。 根据 麻省理工学院的许可。


该文件由 动词-生成-自述文件2023年7月22日,v0.8.0。

版本与发布记录

word-wrap 共发布 17 个版本,首次发布于 2014/03/30;过去 12 个月发布了 0 个版本。

版本发布日期距今
1.2.5latest2023/07/223 年前
1.2.42023/07/193 年前
1.2.32017/06/039 年前
1.2.22017/05/029 年前
1.2.12017/01/319 年前
1.2.02016/12/299 年前

关于 word-wrap 的常见问题

word-wrap 是什么?

将单词换行到指定的长度。

如何安装 word-wrap?

在项目目录运行 npm install word-wrap,或使用 pnpm add / yarn add / bun add。

word-wrap 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

word-wrap 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

word-wrap 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=0.10.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

word-wrap 可以商用吗?

word-wrap 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

word-wrap 的下载量有多少?

根据 npm 官方下载统计,word-wrap 在 2026/10/05 – 2026/11/03 这 30 天内被下载 542,540,686 次,日均约 18,084,690 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

word-wrap 还在维护吗?

最新版本 1.2.5 发布于 2023/07/22(3 年前);至今共发布 17 个版本,其中过去 12 个月发布了 0 个;首次发布于 2014/03/30。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。