- Big update!Announcing Socket for GitHub 1.0. Learn more →
wide-align
Advanced tools
wide-align
A wide-character aware text alignment function for use on the console or with fixed width fonts.
- 1.1.5latest
- Version published
- Maintainers
- 1
- Weekly downloads
- 16,996,724
- decreased by-3.62%
Weekly downloads
Readme
wide-align
A wide-character aware text alignment function for use in terminals / on the console.
Usage
var align = require('wide-align')
// Note that if you view this on a unicode console, all of the slashes are
// aligned. This is because on a console, all narrow characters are
// an en wide and all wide characters are an em. In browsers, this isn't
// held to and wide characters like "古" can be less than two narrow
// characters even with a fixed width font.
console.log(align.center('abc', 10)) // ' abc '
console.log(align.center('古古古', 10)) // ' 古古古 '
console.log(align.left('abc', 10)) // 'abc '
console.log(align.left('古古古', 10)) // '古古古 '
console.log(align.right('abc', 10)) // ' abc'
console.log(align.right('古古古', 10)) // ' 古古古'
Functions
align.center(str, length) → str
Returns str with spaces added to both sides such that that it is length chars long and centered in the spaces.
align.left(str, length) → str
Returns str with spaces to the right such that it is length chars long.
align.right(str, length) → str
Returns str with spaces to the left such that it is length chars long.
Origins
These functions were originally taken from cliui. Changes include switching to the MUCH faster pad generation function from lodash, making center alignment pad both sides and adding left alignment.
FAQs
What is wide-align?
A wide-character aware text alignment function for use on the console or with fixed width fonts.
Is wide-align popular?
The npm package wide-align receives a total of 14,259,328 weekly downloads. As such, wide-align popularity was classified as popular.
Is wide-align well maintained?
We found that wide-align demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago.It has 1 open source maintainer collaborating on the project.