@html-eslint/eslint-plugin
Version:
ESLint plugin for HTML
93 lines (81 loc) • 2.14 kB
JavaScript
/**
* @import {
* AnyNode,
* Tag
* } from "@html-eslint/types"
* @import {RuleModule} from "../types"
*/
const { RULE_CATEGORY } = require("../constants");
const { find } = require("./utils/array");
const { findAttr, isTag } = require("./utils/node");
const { getRuleUrl } = require("./utils/rule");
const MESSAGE_IDS = {
MISSING: "missing",
EMPTY: "empty",
};
/**
* @param {AnyNode} node
* @returns {node is Tag}
*/
function isMetaViewport(node) {
if (isTag(node) && node.name === "meta") {
const nameAttribute = findAttr(node, "name");
return !!(
nameAttribute &&
nameAttribute.value &&
nameAttribute.value.value.toLowerCase() === "viewport"
);
}
return false;
}
/** @type {RuleModule<[]>} */
module.exports = {
meta: {
type: "code",
docs: {
description: 'Enforce use of `<meta name="viewport">` in `<head>`',
category: RULE_CATEGORY.ACCESSIBILITY,
recommended: false,
url: getRuleUrl("require-meta-viewport"),
},
fixable: null,
schema: [],
messages: {
[MESSAGE_IDS.MISSING]: 'Missing `<meta name="viewport">`.',
[MESSAGE_IDS.EMPTY]:
'Unexpected empty `content` attribute in `<meta name="viewport">`.',
},
},
create(context) {
return {
Tag(node) {
if (node.name !== "head") {
return;
}
const metaViewport = find(node.children, isMetaViewport);
if (!metaViewport) {
context.report({
node,
messageId: MESSAGE_IDS.MISSING,
});
return;
}
const contentAttribute = findAttr(metaViewport, "content");
const isAttributeEmpty =
!contentAttribute ||
!contentAttribute.value ||
!contentAttribute.value.value.length;
if (isAttributeEmpty) {
const reportTarget =
!contentAttribute || !contentAttribute.value
? metaViewport
: contentAttribute;
context.report({
node: reportTarget,
messageId: MESSAGE_IDS.EMPTY,
});
}
},
};
},
};