1
1
mirror of https://github.com/primer/css.git synced 2024-12-24 14:42:26 +03:00
css/modules/primer-truncate
2017-05-11 15:07:16 -04:00
..
.github move modules into modules folder 2017-05-11 15:07:16 -04:00
lib move modules into modules folder 2017-05-11 15:07:16 -04:00
.gitignore move modules into modules folder 2017-05-11 15:07:16 -04:00
.npmignore move modules into modules folder 2017-05-11 15:07:16 -04:00
.postcss.json move modules into modules folder 2017-05-11 15:07:16 -04:00
.stylelintrc.json move modules into modules folder 2017-05-11 15:07:16 -04:00
.travis.yml move modules into modules folder 2017-05-11 15:07:16 -04:00
CHANGELOG.md move modules into modules folder 2017-05-11 15:07:16 -04:00
index.scss move modules into modules folder 2017-05-11 15:07:16 -04:00
LICENSE move modules into modules folder 2017-05-11 15:07:16 -04:00
package.json move modules into modules folder 2017-05-11 15:07:16 -04:00
README.md move modules into modules folder 2017-05-11 15:07:16 -04:00

Primer CSS Truncate

NPM version Build Status

.css-truncate will shorten text with an ellipsis. The maximum width of the truncated text can be changed by overriding the max-width of the .css-truncate-target.

This repository is a module of the full primer-css repository.

Install

This repository is distributed with npm. After installing npm, you can install primer-truncate with this command.

$ npm install --save primer-truncate

Usage

The source files included are written in Sass (scss) You can simply point your sass include-path at your node_modules directory and import it like this.

@import "primer-truncate/index.scss";

You can also import specific portions of the module by importing those partials from the /lib/ folder. Make sure you import any requirements along with the modules.

Build

For a compiled css version of this module, a npm script is included that will output a css version to build/build.css The built css file is also included in the npm package.

$ npm run build

Documentation

.css-truncate will shorten text with an ellipsis. The maximum width of the truncated text can be changed by overriding the max-width of .css-truncate-target. Unless the full text is so long that it affects performace, always add title to the truncated element so the full text can still be seen.

<span class="branch-ref css-truncate css-truncate-target" title="really-long-branch-name">
  really-long-branch-name
</span>

You can reveal the entire string on hover with the addition of .expandable.

<span class="css-truncate expandable">
  <span class="branch-ref css-truncate-target">this-is-a-really-long-branch-name</span>
</span>

License

MIT © GitHub