1.1.3 • Published 2 years ago

custom-selection v1.1.3

Weekly downloads
-
License
ISC
Repository
github
Last release
2 years ago

Verified on Openbase

Add custom ::selection css pseudo-element to website using data attributes all so you can improve your websites look and feel

Installation

⚠️ Custom CSS Selection is a controversial practice that can cause usability, accessibility, and performance issues. Don't override selected text styles for purely aesthetic reasons — users can customize them to suit their needs. For people experiencing cognitive concerns or who are less technologically literate, unexpected changes to selection styles may hurt their understanding of the functionality. If overridden, it is important to ensure that the contrast ratio between the text and background colors of the selection is high enough that people experiencing low vision conditions can read it.

CDN

Inside <body> closing tag

<!-- Custom Selection -->
<script src="https://cdn.jsdelivr.net/npm/custom-selection@1.1.2/dist/custom-selection.core.min.js"></script>

Usage

Basic

With simple detection.

HTML

<body data-selection data-selection-color="1a1a1a" data-selection-text-color="#fffff"></body>

Element Attributes

AttributeValuesDescription
data-selectionInitialises JavaScript
data-selection-colorhex codehttps://img.shields.io/badge/hex-value-blue Changes text selection background color
data-selection-text-colorhex codehttps://img.shields.io/badge/hex-value-blue Changes text selection text color
data-selection-text-strokebooleanhttps://img.shields.io/badge/-coming%20soon-inactive Initialises text stroke CSS value
data-selection-text-stroke-colorhex codehttps://img.shields.io/badge/-coming%20soon-inactive https://img.shields.io/badge/hex-value-blue Changes text selection stroke color
data-selection-text-stroke-widthstringhttps://img.shields.io/badge/-coming%20soon-inactive Changes selection stroke width
data-selection-text-stroke-fill-colorhex codehttps://img.shields.io/badge/-coming%20soon-inactive https://img.shields.io/badge/hex-value-blue Changes text selection stroke fill color
data-selection-text-decorationbooleanhttps://img.shields.io/badge/-coming%20soon-inactive Initialises text decoration CSS value
data-selection-text-decoration-colorhex codehttps://img.shields.io/badge/-coming%20soon-inactive https://img.shields.io/badge/hex-value-blue Changes text decoration color
data-selection-text-decoration-linestringhttps://img.shields.io/badge/-coming%20soon-inactive Add line decorations using underline , overline & line-through
data-selection-text-decoration-stylestringhttps://img.shields.io/badge/-coming%20soon-inactive Add line styles using solid, double, dotted, dashed & wavy
data-selection-text-decoration-thicknessstringhttps://img.shields.io/badge/-coming%20soon-inactive

Demo

demo

Values Used

attributevalue
data-selection-
data-selection-color#f7f33a
data-selection-text-color#cba6d6
Final Element
<body data-selection data-selection-color="#f7f33a" data-selection-text-color="#cba6d6"></body>

Browser support

source : mdn web docs supportFull = https://img.shields.io/badge/-Full%20Support-success

supportRequires a vendor prefix or different name for use = https://img.shields.io/badge/-Some%20Support-important

supportNo = https://img.shields.io/badge/-No%20Support-critical

ChromeEdgeFirefoxOperaSafariChrome AndroidFirefox for AndroidOpera AndroidSafari on iOSSamsung InternetWebView Android
::selectionhttps://img.shields.io/badge/-%20Version%201-successhttps://img.shields.io/badge/-%20Version%2012-successhttps://img.shields.io/badge/-%20Version%2062-successhttps://img.shields.io/badge/-%20Version%209.5-successhttps://img.shields.io/badge/-%20Version%201.1-successhttps://img.shields.io/badge/-%20Version%2018-successhttps://img.shields.io/badge/-%20Version%2062-successhttps://img.shields.io/badge/-%20Version%2014-successhttps://img.shields.io/badge/-No%20Support-criticalhttps://img.shields.io/badge/-%20Version%201.0-successhttps://img.shields.io/badge/-%20Version%2037-success
datasethttps://img.shields.io/badge/-%20Version%208-successhttps://img.shields.io/badge/-%20Version%2012-successhttps://img.shields.io/badge/-%20Version%206-successhttps://img.shields.io/badge/-%20Version%2011-successhttps://img.shields.io/badge/-%20Version%205.1-successhttps://img.shields.io/badge/-%20Version%2018-successhttps://img.shields.io/badge/-%20Version%206-successhttps://img.shields.io/badge/-%20Version%2011-successhttps://img.shields.io/badge/-%20Version%205-successhttps://img.shields.io/badge/-%20Version%201.1-successhttps://img.shields.io/badge/-%20Version%203-success
custom-selection.core.jshttps://img.shields.io/badge/-%20Version%201-successhttps://img.shields.io/badge/-%20Version%2012-successhttps://img.shields.io/badge/-%20Version%2062-successhttps://img.shields.io/badge/-%20Version%209.5-successhttps://img.shields.io/badge/-%20Version%201.1-successhttps://img.shields.io/badge/-%20Version%2018-successhttps://img.shields.io/badge/-%20Version%2062-successhttps://img.shields.io/badge/-%20Version%2014-successhttps://img.shields.io/badge/-No%20Support-criticalhttps://img.shields.io/badge/-%20Version%201.0-successhttps://img.shields.io/badge/-%20Version%2037-success

Useful Links

mdn web docs