docusaurus-theme-openapi-docs
Version:
OpenAPI theme for Docusaurus.
256 lines (255 loc) • 7.93 kB
JavaScript
;
/* ============================================================================
* Copyright (c) Palo Alto Networks
*
* This source code is licensed under the MIT license found in the
* LICENSE file in the root directory of this source tree.
* ========================================================================== */
var __createBinding =
(this && this.__createBinding) ||
(Object.create
? function (o, m, k, k2) {
if (k2 === undefined) k2 = k;
var desc = Object.getOwnPropertyDescriptor(m, k);
if (
!desc ||
("get" in desc ? !m.__esModule : desc.writable || desc.configurable)
) {
desc = {
enumerable: true,
get: function () {
return m[k];
},
};
}
Object.defineProperty(o, k2, desc);
}
: function (o, m, k, k2) {
if (k2 === undefined) k2 = k;
o[k2] = m[k];
});
var __setModuleDefault =
(this && this.__setModuleDefault) ||
(Object.create
? function (o, v) {
Object.defineProperty(o, "default", { enumerable: true, value: v });
}
: function (o, v) {
o["default"] = v;
});
var __importStar =
(this && this.__importStar) ||
(function () {
var ownKeys = function (o) {
ownKeys =
Object.getOwnPropertyNames ||
function (o) {
var ar = [];
for (var k in o)
if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
return ar;
};
return ownKeys(o);
};
return function (mod) {
if (mod && mod.__esModule) return mod;
var result = {};
if (mod != null)
for (var k = ownKeys(mod), i = 0; i < k.length; i++)
if (k[i] !== "default") __createBinding(result, mod, k[i]);
__setModuleDefault(result, mod);
return result;
};
})();
var __importDefault =
(this && this.__importDefault) ||
function (mod) {
return mod && mod.__esModule ? mod : { default: mod };
};
Object.defineProperty(exports, "__esModule", { value: true });
exports.default = SchemaTabs;
const react_1 = __importStar(require("react"));
const internal_1 = require("@docusaurus/theme-common/internal");
const useIsBrowser_1 = __importDefault(require("@docusaurus/useIsBrowser"));
const clsx_1 = __importDefault(require("clsx"));
const flatten_1 = __importDefault(require("lodash/flatten"));
function TabList({ className, block, selectedValue, selectValue, tabValues }) {
const tabRefs = [];
const { blockElementScrollPositionUntilNextRender } = (0,
internal_1.useScrollPositionBlocker)();
const handleTabChange = (event) => {
const newTab = event.currentTarget;
const newTabIndex = tabRefs.indexOf(newTab);
const newTabValue = tabValues[newTabIndex].value;
if (newTabValue !== selectedValue) {
blockElementScrollPositionUntilNextRender(newTab);
selectValue(newTabValue);
}
};
const handleKeydown = (event) => {
let focusElement = null;
switch (event.key) {
case "Enter": {
handleTabChange(event);
break;
}
case "ArrowRight": {
const nextTab = tabRefs.indexOf(event.currentTarget) + 1;
focusElement = tabRefs[nextTab] ?? tabRefs[0];
break;
}
case "ArrowLeft": {
const prevTab = tabRefs.indexOf(event.currentTarget) - 1;
focusElement = tabRefs[prevTab] ?? tabRefs[tabRefs.length - 1];
break;
}
default:
break;
}
focusElement?.focus();
};
const tabItemListContainerRef = (0, react_1.useRef)(null);
const [showTabArrows, setShowTabArrows] = (0, react_1.useState)(false);
(0, react_1.useEffect)(() => {
const resizeObserver = new ResizeObserver((entries) => {
for (let entry of entries) {
requestAnimationFrame(() => {
if (entry.target.clientWidth < entry.target.scrollWidth) {
setShowTabArrows(true);
} else {
setShowTabArrows(false);
}
});
}
});
resizeObserver.observe(tabItemListContainerRef.current);
return () => {
resizeObserver.disconnect();
};
}, []);
const handleRightClick = (e) => {
e.preventDefault();
if (tabItemListContainerRef.current) {
tabItemListContainerRef.current.scrollLeft += 90;
}
};
const handleLeftClick = (e) => {
e.preventDefault();
if (tabItemListContainerRef.current) {
tabItemListContainerRef.current.scrollLeft -= 90;
}
};
return react_1.default.createElement(
"div",
{ className: "openapi-tabs__schema-tabs-container" },
showTabArrows &&
react_1.default.createElement("button", {
className: "openapi-tabs__arrow left",
onClick: handleLeftClick,
}),
react_1.default.createElement(
"ul",
{
ref: tabItemListContainerRef,
role: "tablist",
"aria-orientation": "horizontal",
className: (0, clsx_1.default)(
"openapi-tabs__schema-list-container",
"tabs",
{
"tabs--block": block,
},
className
),
},
tabValues.map(({ value, label, attributes }) =>
react_1.default.createElement(
"li",
{
// TODO extract TabListItem
role: "tab",
tabIndex: selectedValue === value ? 0 : -1,
"aria-selected": selectedValue === value,
key: value,
ref: (tabControl) => {
tabRefs.push(tabControl);
},
onKeyDown: handleKeydown,
onClick: handleTabChange,
...attributes,
className: (0, clsx_1.default)(
"tabs__item",
"openapi-tabs__schema-item",
attributes?.className,
{
active: selectedValue === value,
}
),
},
react_1.default.createElement(
"span",
{ className: "openapi-tabs__schema-label" },
label ?? value
)
)
)
),
showTabArrows &&
react_1.default.createElement("button", {
className: "openapi-tabs__arrow right",
onClick: handleRightClick,
})
);
}
function TabContent({ lazy, children, selectedValue }) {
const childTabs = (Array.isArray(children) ? children : [children]).filter(
Boolean
);
const flattenedChildTabs = (0, flatten_1.default)(childTabs);
if (lazy) {
const selectedTabItem = flattenedChildTabs.find(
(tabItem) => tabItem.props.value === selectedValue
);
if (!selectedTabItem) {
// fail-safe or fail-fast? not sure what's best here
return null;
}
return (0, react_1.cloneElement)(selectedTabItem, {
className: "margin-top--md",
});
}
return react_1.default.createElement(
"div",
{ className: "margin-top--md" },
childTabs.map((tabItem, i) =>
(0, react_1.cloneElement)(tabItem, {
key: i,
hidden: tabItem.props.value !== selectedValue,
})
)
);
}
function TabsComponent(props) {
const tabs = (0, internal_1.useTabs)(props);
return react_1.default.createElement(
"div",
{ className: "openapi-tabs__schema-container" },
react_1.default.createElement(TabList, { ...props, ...tabs }),
react_1.default.createElement(TabContent, { ...props, ...tabs })
);
}
function SchemaTabs(props) {
const isBrowser = (0, useIsBrowser_1.default)();
return react_1.default.createElement(
TabsComponent,
// Remount tabs after hydration
// Temporary fix for https://github.com/facebook/docusaurus/issues/5653
{
// Remount tabs after hydration
// Temporary fix for https://github.com/facebook/docusaurus/issues/5653
key: String(isBrowser),
...props,
},
(0, internal_1.sanitizeTabsChildren)(props.children)
);
}