HTML preprocessors can make writing HTML more powerful or convenient. For instance, Markdown is designed to be easier to write and read for text documents and you could write a loop in Pug.
In CodePen, whatever you write in the HTML editor is what goes within the <body>
tags in a basic HTML5 template. So you don't have access to higher-up elements like the <html>
tag. If you want to add classes there that can affect the whole document, this is the place to do it.
In CodePen, whatever you write in the HTML editor is what goes within the <body>
tags in a basic HTML5 template. If you need things in the <head>
of the document, put that code here.
The resource you are linking to is using the 'http' protocol, which may not work when the browser is using https.
CSS preprocessors help make authoring CSS easier. All of them offer things like variables and mixins to provide convenient abstractions.
It's a common practice to apply CSS to a page that styles elements such that they are consistent across all browsers. We offer two of the most popular choices: normalize.css and a reset. Or, choose Neither and nothing will be applied.
To get the best cross-browser support, it is a common practice to apply vendor prefixes to CSS properties and values that require them to work. For instance -webkit-
or -moz-
.
We offer two popular choices: Autoprefixer (which processes your CSS server-side) and -prefix-free (which applies prefixes via a script, client-side).
Any URL's added here will be added as <link>
s in order, and before the CSS in the editor. You can use the CSS from another Pen by using it's URL and the proper URL extention.
You can apply CSS to your Pen from any stylesheet on the web. Just put a URL to it here and we'll apply it, in the order you have them, before the CSS in the Pen itself.
You can also link to another Pen here (use the .css
URL Extension) and we'll pull the CSS from that Pen and include it. If it's using a matching preprocessor, use the appropriate URL Extension and we'll combine the code before preprocessing, so you can use the linked Pen as a true dependency.
JavaScript preprocessors can help make authoring JavaScript easier and more convenient.
Babel includes JSX processing.
Any URL's added here will be added as <script>
s in order, and run before the JavaScript in the editor. You can use the URL of any other Pen and it will include the JavaScript from that Pen.
You can apply a script from anywhere on the web to your Pen. Just put a URL to it here and we'll add it, in the order you have them, before the JavaScript in the Pen itself.
If the script you link to has the file extension of a preprocessor, we'll attempt to process it before applying.
You can also link to another Pen here, and we'll pull the JavaScript from that Pen and include it. If it's using a matching preprocessor, we'll combine the code before preprocessing, so you can use the linked Pen as a true dependency.
Search for and use JavaScript packages from npm here. By selecting a package, an import
statement will be added to the top of the JavaScript editor for this package.
Using packages here is powered by Skypack, which makes packages from npm not only available on a CDN, but prepares them for native JavaScript ES6 import
usage.
All packages are different, so refer to their docs for how they work.
If you're using React / ReactDOM, make sure to turn on Babel for the JSX processing.
If active, Pens will autosave every 30 seconds after being saved once.
If enabled, the preview panel updates automatically as you code. If disabled, use the "Run" button to update.
If enabled, your code will be formatted when you actively save your Pen. Note: your code becomes un-folded during formatting.
Visit your global Editor Settings.
<div id="screen-initial">
<h1 id="msg">Loading...</h1>
<progress id="load-progress" value="0" max="100"></progress>
</div>
<div id="screen-start" class="hidden">
<a href="#" id="start-scan">Start scan</a>
</div>
<div id="screen-scanning" class="hidden">
<video id="camera-feed" playsinline></video>
<!-- Recognition events will be drawn here. -->
<canvas id="camera-feedback"></canvas>
<p id="camera-guides">
Point the camera towards front side of a document.
</p>
</div>
* {
box-sizing: border-box;
}
html,
body {
width: 100%;
height: 100%;
}
html {
margin: 0;
padding: 0;
font-size: 16px;
line-height: 24px;
font-family: sans-serif;
}
body {
display: flex;
min-height: 100%;
margin: 0;
padding: 1.5rem;
justify-content: center;
align-items: center;
}
#loading {
display: block;
}
#view-landing,
#view-scan-from-camera,
#view-scan-from-file,
#view-results {
display: block;
width: 100%;
height: 100%;
}
/* Rules for better readability */
img {
display: block;
width: 100%;
max-width: 320px;
height: auto;
}
video {
width: 100%;
height: 100%;
}
textarea {
display: block;
}
/* Camera feedback */
#screen-scanning {
position: relative;
}
#view-scan-from-camera {
position: relative;
}
#camera-feedback {
position: absolute;
top: 0;
left: 0;
right: 0;
bottom: 0;
width: 100%;
height: 100%;
}
#camera-guides {
position: absolute;
top: 0;
left: 0;
right: 0;
text-align: center;
font-weight: bold;
}
/* Auxiliary classes */
.hidden {
display: none !important;
}
/**
* This example app demonstrates how to use BlinkID In-browser SDK to achieve the following:
*
* - Change default SDK settings
* - Scan front and back side of the identity document with web camera (combined experience)
* - Provide visual feedback to the end-user during the scan
*/
// General UI helpers
const initialMessageEl = document.getElementById("msg");
const progressEl = document.getElementById("load-progress");
// UI elements for scanning feedback
const cameraFeed = document.getElementById("camera-feed");
const cameraFeedback = document.getElementById("camera-feedback");
const drawContext = cameraFeedback.getContext("2d");
const scanFeedback = document.getElementById("camera-guides");
/**
* Check browser support, customize settings and load WASM SDK.
*/
function main() {
// Check if browser has proper support for WebAssembly
if (!BlinkIDSDK.isBrowserSupported()) {
initialMessageEl.innerText = "This browser is not supported!";
return;
}
// 1. It's possible to obtain a free trial license key on microblink.com
const licenseKey = "sRwAAAYHY2Rwbi5pb5ZgjD0UloirGkl5CZLN/5Kx6E92R00Hs2R+VMM6RxDczin4Ip1IuwC7s6oc3R1FvsV1ywzJ4Ew1nt9yl7jnKQ5yK85HFZAxX9rNymC0QQvMWHuzFNqs0mIVGlfjDZfKzXfLDiiRwR7fUaULUA5MZci10KjYLcEz3ixWI2OLcTZs/lnZXMLmBzlmUxPQVA45xWjxEnMfgI9bpaFfXu+lqQctDLtQ51zx9Ua1fANjR5IT/PGTTgubbp4K1Yg5cQRqWcopP+f/U6zKUz8htmLlgusZt4muGHELqlSE+Rg9+TNInxk/5H9iFhHztyDSYItforT6a7CpmRU/Zy36tOEm1ztV";
// 2. Create instance of SDK load settings with your license key
const loadSettings = new BlinkIDSDK.WasmSDKLoadSettings(licenseKey);
// [OPTIONAL] Change default settings
// Show or hide hello message in browser console when WASM is successfully loaded
loadSettings.allowHelloMessage = true;
// In order to provide better UX, display progress bar while loading the SDK
loadSettings.loadProgressCallback = (progress) =>
(progressEl.value = progress);
// Set relative or absolute location of the engine, i.e. WASM and support JS files
loadSettings.engineLocation = "https://unpkg.com/@microblink/blinkid-in-browser-sdk@5.16.0/resources/";
// 3. Load SDK
BlinkIDSDK.loadWasmModule(loadSettings).then(
(sdk) => {
document.getElementById("screen-initial")?.classList.add("hidden");
document.getElementById("screen-start")?.classList.remove("hidden");
document
.getElementById("start-scan")
?.addEventListener("click", (ev) => {
ev.preventDefault();
startScan(sdk);
});
},
(error) => {
initialMessageEl.innerText = "Failed to load SDK!";
console.error("Failed to load SDK!", error);
}
);
}
/**
* Scan single side of identity document with web camera.
*/
async function startScan(sdk) {
document.getElementById("screen-start")?.classList.add("hidden");
document.getElementById("screen-scanning")?.classList.remove("hidden");
// 1. Create a recognizer objects which will be used to recognize single image or stream of images.
//
// GenericCombine ID Recognizer - scan ID documents on both sides
const combinedGenericIDRecognizer = await BlinkIDSDK.createBlinkIdCombinedRecognizer(
sdk
);
// Create a callbacks object that will receive recognition events, such as detected object location etc.
const callbacks = {
onQuadDetection: (quad) => drawQuad(quad),
onDetectionFailed: () => updateScanFeedback("Detection failed", true),
// This callback is required for combined experience.
onFirstSideResult: () => alert("Flip the document"),
};
// 2. Create a RecognizerRunner object which orchestrates the recognition with one or more
// recognizer objects.
const recognizerRunner = await BlinkIDSDK.createRecognizerRunner(
// SDK instance to use
sdk,
// List of recognizer objects that will be associated with created RecognizerRunner object
[combinedGenericIDRecognizer],
// [OPTIONAL] Should recognition pipeline stop as soon as first recognizer in chain finished recognition
false,
// Callbacks object that will receive recognition events
callbacks
);
// 3. Create a VideoRecognizer object and attach it to HTMLVideoElement that will be used for displaying the camera feed
const videoRecognizer = await BlinkIDSDK.VideoRecognizer.createVideoRecognizerFromCameraStream(
cameraFeed,
recognizerRunner
);
// Default scan timeout is 15 seconds
const scanTimeoutSeconds = 15;
// 4. Start the recognition and get results from callback
try {
videoRecognizer.startRecognition(
// 5. Obtain the results
async (recognitionState) => {
if (!videoRecognizer) {
return;
}
// Pause recognition before performing any async operation
videoRecognizer.pauseRecognition();
if (
recognitionState === BlinkIDSDK.RecognizerResultState.Empty
) {
return;
}
const result = await combinedGenericIDRecognizer.getResult();
if (result.state === BlinkIDSDK.RecognizerResultState.Empty) {
return;
}
// Inform the user about results
console.log("BlinkIDCombined results", result);
alert(`Hello, ${result.firstName || result.mrz.secondaryID} ${
result.lastName || result.mrz.primaryID
}!
You were born on ${result.dateOfBirth.year || result.mrz.dateOfBirth.year}-${
result.dateOfBirth.month || result.mrz.dateOfBirth.month
}-${result.dateOfBirth.day || result.mrz.dateOfBirth.day}.`);
// 6. Release all resources allocated on the WebAssembly heap and associated with camera stream
// Release browser resources associated with the camera stream
videoRecognizer?.releaseVideoFeed();
// Release memory on WebAssembly heap used by the RecognizerRunner
recognizerRunner?.delete();
// Release memory on WebAssembly heap used by the recognizer
combinedGenericIDRecognizer?.delete();
// Clear any leftovers drawn to canvas
clearDrawCanvas();
// Hide scanning screen and show scan button again
document
.getElementById("screen-start")
?.classList.remove("hidden");
document
.getElementById("screen-scanning")
?.classList.add("hidden");
}, scanTimeoutSeconds * 1000
);
} catch (error) {
console.error("Error during initialization of VideoRecognizer:", error);
return;
}
}
/**
* Utility functions for drawing detected quadrilateral onto canvas.
*/
function drawQuad(quad) {
clearDrawCanvas();
// Based on detection status, show appropriate color and message
setupColor(quad);
setupMessage(quad);
applyTransform(quad.transformMatrix);
drawContext.beginPath();
drawContext.moveTo(quad.topLeft.x, quad.topLeft.y);
drawContext.lineTo(quad.topRight.x, quad.topRight.y);
drawContext.lineTo(quad.bottomRight.x, quad.bottomRight.y);
drawContext.lineTo(quad.bottomLeft.x, quad.bottomLeft.y);
drawContext.closePath();
drawContext.stroke();
}
/**
* This function will make sure that coordinate system associated with detectionResult
* canvas will match the coordinate system of the image being recognized.
*/
function applyTransform(transformMatrix) {
const canvasAR = cameraFeedback.width / cameraFeedback.height;
const videoAR = cameraFeed.videoWidth / cameraFeed.videoHeight;
let xOffset = 0;
let yOffset = 0;
let scaledVideoHeight = 0;
let scaledVideoWidth = 0;
if (canvasAR > videoAR) {
// pillarboxing: https://en.wikipedia.org/wiki/Pillarbox
scaledVideoHeight = cameraFeedback.height;
scaledVideoWidth = videoAR * scaledVideoHeight;
xOffset = (cameraFeedback.width - scaledVideoWidth) / 2.0;
} else {
// letterboxing: https://en.wikipedia.org/wiki/Letterboxing_(filming)
scaledVideoWidth = cameraFeedback.width;
scaledVideoHeight = scaledVideoWidth / videoAR;
yOffset = (cameraFeedback.height - scaledVideoHeight) / 2.0;
}
// first transform canvas for offset of video preview within the HTML video element (i.e. correct letterboxing or pillarboxing)
drawContext.translate(xOffset, yOffset);
// second, scale the canvas to fit the scaled video
drawContext.scale(
scaledVideoWidth / cameraFeed.videoWidth,
scaledVideoHeight / cameraFeed.videoHeight
);
// finally, apply transformation from image coordinate system to
// https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/setTransform
drawContext.transform(
transformMatrix[0],
transformMatrix[3],
transformMatrix[1],
transformMatrix[4],
transformMatrix[2],
transformMatrix[5]
);
}
function clearDrawCanvas() {
cameraFeedback.width = cameraFeedback.clientWidth;
cameraFeedback.height = cameraFeedback.clientHeight;
drawContext.clearRect(0, 0, cameraFeedback.width, cameraFeedback.height);
}
function setupColor(displayable) {
let color = "#FFFF00FF";
if (displayable.detectionStatus === 0) {
color = "#FF0000FF";
} else if (displayable.detectionStatus === 1) {
color = "#00FF00FF";
}
drawContext.fillStyle = color;
drawContext.strokeStyle = color;
drawContext.lineWidth = 5;
}
function setupMessage(displayable) {
switch (displayable.detectionStatus) {
case BlinkIDSDK.DetectionStatus.Fail:
updateScanFeedback("Scanning...");
break;
case BlinkIDSDK.DetectionStatus.Success:
case BlinkIDSDK.DetectionStatus.FallbackSuccess:
updateScanFeedback("Detection successful");
break;
case BlinkIDSDK.DetectionStatus.CameraAtAngle:
updateScanFeedback("Adjust the angle");
break;
case BlinkIDSDK.DetectionStatus.CameraTooHigh:
updateScanFeedback("Move document closer");
break;
case BlinkIDSDK.DetectionStatus.CameraTooNear:
case BlinkIDSDK.DetectionStatus.DocumentTooCloseToEdge:
case BlinkIDSDK.DetectionStatus.Partial:
updateScanFeedback("Move document farther");
break;
default:
console.warn(
"Unhandled detection status!",
displayable.detectionStatus
);
}
}
let scanFeedbackLock = false;
/**
* The purpose of this function is to ensure that scan feedback message is
* visible for at least 1 second.
*/
function updateScanFeedback(message, force) {
if (scanFeedbackLock && !force) {
return;
}
scanFeedbackLock = true;
scanFeedback.innerText = message;
window.setTimeout(() => (scanFeedbackLock = false), 1000);
}
// Run
main();
Also see: Tab Triggers