Security News
The Unpaid Backbone of Open Source: Solo Maintainers Face Increasing Security Demands
Solo open source maintainers face burnout and security challenges, with 60% unpaid and 60% considering quitting.
@financial-times/o-normalise
Advanced tools
Provides base styles and resets for stylesheets. Includes standardised utilities, such as visually hiding components or adding a consistent focus state.
Foundation styles and standardised utilities
Check out how to include Origami components in your project to get started with o-normalise
.
To output all default o-normalise
styles call the mixin oNormalise
:
@include oNormalise();
To include features of o-normalise
granularly, pass an $opts
map. E.g. to output all styles except for the css helper classes o-normalise-visually-hidden
and o-normalise-clearfix
:
@include oNormalise($opts: (
'elements': ('forms', 'images', 'text', 'links'),
'body': ('font-smoothing', 'focus', 'reduce-motion')
));
Options include:
Feature | Description | Values |
---|---|---|
elements | Element types to apply normalising styles to. | 'forms', 'images', 'text', 'links' |
body | Features which apply to html , body , main elements and all elements with a :focus state. | 'font-smoothing', 'focus' |
helpers | Classes which may be applied to elements manually. | 'clearfix', 'visually-hidden' |
oNormaliseVisuallyHidden
- provides styles to visually hide an element while remaining accessible to screen reader.oNormaliseClearfix
- adds clearfix styles to the element. See this Sitepoint article for more on clearfixes - we use a variation on method 3.oNormaliseBoxSizing
- adds box-sizing: border-box
to the current and all descending elements, see this article by Paul Irish for a full explanation.o-normalise
provides default focus states using the :focus-visible
pseudo-class. This applies while an element matches the :focus
pseudo-class and the user-agent determines that the focus should be specially indicated.
Browser support is now good so we no longer recommend the focus-visible polyfill, this should be removed from your project. :focus
is used as a fallback where needed in older browsers.
If you think there is something that could be added to o-normalise
, either raise an issue to discuss or create a Pull Request with the changes to be reviewed by the Origami team.
If you think of any JavaScript functions or utilities that would be useful to have in a module like this, please raise an issue on o-utils.
State | Major Version | Last Minor Release | Migration guide |
---|---|---|---|
✨ active | 3 | N/A | migrate to v3 |
⚠ maintained | 2 | 2.0 | migrate to v2 |
╳ deprecated | 1 | 1.7 | N/A |
If you have any questions or comments about this component, or need help using it, please either raise an issue, visit #origami-support or email Origami Support.
This software is published by the Financial Times under the MIT licence.
FAQs
Provides base styles and resets for stylesheets. Includes standardised utilities, such as visually hiding components or adding a consistent focus state.
The npm package @financial-times/o-normalise receives a total of 2,765 weekly downloads. As such, @financial-times/o-normalise popularity was classified as popular.
We found that @financial-times/o-normalise demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 10 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Solo open source maintainers face burnout and security challenges, with 60% unpaid and 60% considering quitting.
Security News
License exceptions modify the terms of open source licenses, impacting how software can be used, modified, and distributed. Developers should be aware of the legal implications of these exceptions.
Security News
A developer is accusing Tencent of violating the GPL by modifying a Python utility and changing its license to BSD, highlighting the importance of copyleft compliance.