|
|
|
async function drawGraph(
|
|
|
|
url,
|
|
|
|
baseUrl,
|
|
|
|
pathColors,
|
|
|
|
depth,
|
|
|
|
enableDrag,
|
|
|
|
enableLegend,
|
|
|
|
enableZoom
|
|
|
|
) {
|
|
|
|
const container = document.getElementById('graph-container');
|
|
|
|
|
|
|
|
const { index, links, content } = await fetchData;
|
|
|
|
const curPage = url.replace(baseUrl, '');
|
|
|
|
|
|
|
|
const parseIdsFromLinks = (links) => [
|
|
|
|
...new Set(links.flatMap((link) => [link.source, link.target])),
|
|
|
|
];
|
|
|
|
|
|
|
|
// Links is mutated by d3. We want to use links later on, so we make a copy and pass that one to d3
|
|
|
|
// Note: shallow cloning does not work because it copies over references from the original array
|
|
|
|
const copyLinks = JSON.parse(JSON.stringify(links));
|
|
|
|
|
|
|
|
const neighbours = new Set();
|
|
|
|
const wl = [curPage || '/', '__SENTINEL'];
|
|
|
|
if (depth >= 0) {
|
|
|
|
while (depth >= 0 && wl.length > 0) {
|
|
|
|
// compute neighbours
|
|
|
|
const cur = wl.shift();
|
|
|
|
if (cur === '__SENTINEL') {
|
|
|
|
depth--;
|
|
|
|
wl.push('__SENTINEL');
|
|
|
|
} else {
|
|
|
|
neighbours.add(cur);
|
|
|
|
const outgoing = index.links[cur] || [];
|
|
|
|
const incoming = index.backlinks[cur] || [];
|
|
|
|
wl.push(
|
|
|
|
...outgoing.map((l) => l.target),
|
|
|
|
...incoming.map((l) => l.source)
|
|
|
|
);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
} else {
|
|
|
|
parseIdsFromLinks(copyLinks).forEach((id) => neighbours.add(id));
|
|
|
|
}
|
|
|
|
|
|
|
|
const data = {
|
|
|
|
nodes: [...neighbours].map((id) => ({ id })),
|
|
|
|
links: copyLinks.filter(
|
|
|
|
(l) => neighbours.has(l.source) && neighbours.has(l.target)
|
|
|
|
),
|
|
|
|
};
|
|
|
|
|
|
|
|
const color = (d) => {
|
|
|
|
if (d.id === curPage || (d.id === '/' && curPage === '')) {
|
|
|
|
return 'var(--g-node-active)';
|
|
|
|
}
|
|
|
|
|
|
|
|
for (const pathColor of pathColors) {
|
|
|
|
const path = Object.keys(pathColor)[0];
|
|
|
|
const colour = pathColor[path];
|
|
|
|
if (d.id.startsWith(path)) {
|
|
|
|
return colour;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
return 'var(--g-node)';
|
|
|
|
};
|
|
|
|
|
|
|
|
const drag = (simulation) => {
|
|
|
|
function dragstarted(event, d) {
|
|
|
|
if (!event.active) simulation.alphaTarget(1).restart();
|
|
|
|
d.fx = d.x;
|
|
|
|
d.fy = d.y;
|
|
|
|
}
|
|
|
|
|
|
|
|
function dragged(event, d) {
|
|
|
|
d.fx = event.x;
|
|
|
|
d.fy = event.y;
|
|
|
|
}
|
|
|
|
|
|
|
|
function dragended(event, d) {
|
|
|
|
if (!event.active) simulation.alphaTarget(0);
|
|
|
|
d.fx = null;
|
|
|
|
d.fy = null;
|
|
|
|
}
|
|
|
|
|
|
|
|
const noop = () => {};
|
|
|
|
return d3
|
|
|
|
.drag()
|
|
|
|
.on('start', enableDrag ? dragstarted : noop)
|
|
|
|
.on('drag', enableDrag ? dragged : noop)
|
|
|
|
.on('end', enableDrag ? dragended : noop);
|
|
|
|
};
|
|
|
|
|
|
|
|
const height = Math.max(container.offsetHeight, 250);
|
|
|
|
const width = container.offsetWidth;
|
|
|
|
|
|
|
|
const simulation = d3
|
|
|
|
.forceSimulation(data.nodes)
|
|
|
|
.force('charge', d3.forceManyBody().strength(-30))
|
|
|
|
.force(
|
|
|
|
'link',
|
|
|
|
d3
|
|
|
|
.forceLink(data.links)
|
|
|
|
.id((d) => d.id)
|
|
|
|
.distance(40)
|
|
|
|
)
|
|
|
|
.force('center', d3.forceCenter());
|
|
|
|
|
|
|
|
const svg = d3
|
|
|
|
.select('#graph-container')
|
|
|
|
.append('svg')
|
|
|
|
.attr('width', width)
|
|
|
|
.attr('height', height)
|
|
|
|
.attr('viewBox', [-width / 2, -height / 2, width, height]);
|
|
|
|
|
|
|
|
if (enableLegend) {
|
|
|
|
const legend = [
|
|
|
|
{ Current: 'var(--g-node-active)' },
|
|
|
|
{ Note: 'var(--g-node)' },
|
|
|
|
...pathColors,
|
|
|
|
];
|
|
|
|
legend.forEach((legendEntry, i) => {
|
|
|
|
const key = Object.keys(legendEntry)[0];
|
|
|
|
const colour = legendEntry[key];
|
|
|
|
svg
|
|
|
|
.append('circle')
|
|
|
|
.attr('cx', -width / 2 + 20)
|
|
|
|
.attr('cy', height / 2 - 30 * (i + 1))
|
|
|
|
.attr('r', 6)
|
|
|
|
.style('fill', colour);
|
|
|
|
svg
|
|
|
|
.append('text')
|
|
|
|
.attr('x', -width / 2 + 40)
|
|
|
|
.attr('y', height / 2 - 30 * (i + 1))
|
|
|
|
.text(key)
|
|
|
|
.style('font-size', '15px')
|
|
|
|
.attr('alignment-baseline', 'middle');
|
|
|
|
});
|
|
|
|
}
|
|
|
|
|
|
|
|
// draw links between nodes
|
|
|
|
const link = svg
|
|
|
|
.append('g')
|
|
|
|
.selectAll('line')
|
|
|
|
.data(data.links)
|
|
|
|
.join('line')
|
|
|
|
.attr('class', 'link')
|
|
|
|
.attr('stroke', 'var(--g-link)')
|
|
|
|
.attr('stroke-width', 2)
|
|
|
|
.attr('data-source', (d) => d.source.id)
|
|
|
|
.attr('data-target', (d) => d.target.id);
|
|
|
|
|
|
|
|
// svg groups
|
|
|
|
const graphNode = svg
|
|
|
|
.append('g')
|
|
|
|
.selectAll('g')
|
|
|
|
.data(data.nodes)
|
|
|
|
.enter()
|
|
|
|
.append('g');
|
|
|
|
|
|
|
|
// calculate radius
|
|
|
|
const nodeRadius = (d) => {
|
|
|
|
const numOut = index.links[d.id]?.length || 0;
|
|
|
|
const numIn = index.backlinks[d.id]?.length || 0;
|
|
|
|
return 3 + (numOut + numIn) / 4;
|
|
|
|
};
|
|
|
|
|
|
|
|
// draw individual nodes
|
|
|
|
const node = graphNode
|
|
|
|
.append('circle')
|
|
|
|
.attr('class', 'node')
|
|
|
|
.attr('id', (d) => d.id)
|
|
|
|
.attr('r', nodeRadius)
|
|
|
|
.attr('fill', color)
|
|
|
|
.style('cursor', 'pointer')
|
|
|
|
.on('click', (_, d) => {
|
|
|
|
// SPA navigation
|
|
|
|
window.navigate(
|
|
|
|
new URL(`${baseUrl}${decodeURI(d.id).replace(/\s+/g, '-')}/`),
|
|
|
|
'.singlePage'
|
|
|
|
);
|
|
|
|
})
|
|
|
|
.on('mouseover', function (_, d) {
|
|
|
|
d3.selectAll('.node')
|
|
|
|
.transition()
|
|
|
|
.duration(100)
|
|
|
|
.attr('fill', 'var(--g-node-inactive)');
|
|
|
|
|
|
|
|
const neighbours = parseIdsFromLinks([
|
|
|
|
...(index.links[d.id] || []),
|
|
|
|
...(index.backlinks[d.id] || []),
|
|
|
|
]);
|
|
|
|
const neighbourNodes = d3
|
|
|
|
.selectAll('.node')
|
|
|
|
.filter((d) => neighbours.includes(d.id));
|
|
|
|
const currentId = d.id;
|
|
|
|
const linkNodes = d3
|
|
|
|
.selectAll('.link')
|
|
|
|
.filter((d) => d.source.id === currentId || d.target.id === currentId);
|
|
|
|
|
|
|
|
// highlight neighbour nodes
|
|
|
|
neighbourNodes.transition().duration(200).attr('fill', color);
|
|
|
|
|
|
|
|
// highlight links
|
|
|
|
linkNodes
|
|
|
|
.transition()
|
|
|
|
.duration(200)
|
|
|
|
.attr('stroke', 'var(--g-link-active)');
|
|
|
|
|
|
|
|
// show text for self
|
|
|
|
d3.select(this.parentNode)
|
|
|
|
.raise()
|
|
|
|
.select('text')
|
|
|
|
.transition()
|
|
|
|
.duration(200)
|
|
|
|
.style('opacity', 1);
|
|
|
|
})
|
|
|
|
.on('mouseleave', function (_, d) {
|
|
|
|
d3.selectAll('.node').transition().duration(200).attr('fill', color);
|
|
|
|
|
|
|
|
const currentId = d.id;
|
|
|
|
const linkNodes = d3
|
|
|
|
.selectAll('.link')
|
|
|
|
.filter((d) => d.source.id === currentId || d.target.id === currentId);
|
|
|
|
|
|
|
|
linkNodes.transition().duration(200).attr('stroke', 'var(--g-link)');
|
|
|
|
|
|
|
|
d3.select(this.parentNode)
|
|
|
|
.select('text')
|
|
|
|
.transition()
|
|
|
|
.duration(200)
|
|
|
|
.style('opacity', 0);
|
|
|
|
})
|
|
|
|
.call(drag(simulation));
|
|
|
|
|
|
|
|
// draw labels
|
|
|
|
const labels = graphNode
|
|
|
|
.append('text')
|
|
|
|
.attr('dx', 0)
|
|
|
|
.attr('dy', (d) => nodeRadius(d) + 8 + 'px')
|
|
|
|
.attr('text-anchor', 'middle')
|
|
|
|
.text((d) => content[d.id]?.title || d.id.replace('-', ' '))
|
|
|
|
.style('opacity', 0)
|
|
|
|
.style('pointer-events', 'none')
|
|
|
|
.style('font-size', '0.4em')
|
|
|
|
.raise()
|
|
|
|
.call(drag(simulation));
|
|
|
|
|
|
|
|
// set panning
|
|
|
|
|
|
|
|
if (enableZoom) {
|
|
|
|
svg.call(
|
|
|
|
d3
|
|
|
|
.zoom()
|
|
|
|
.extent([
|
|
|
|
[0, 0],
|
|
|
|
[width, height],
|
|
|
|
])
|
|
|
|
.scaleExtent([0.25, 4])
|
|
|
|
.on('zoom', ({ transform }) => {
|
|
|
|
link.attr('transform', transform);
|
|
|
|
node.attr('transform', transform);
|
|
|
|
const scale = transform.k;
|
|
|
|
const scaledOpacity = Math.max((scale - 1) / 3.75, 0);
|
|
|
|
labels.attr('transform', transform).style('opacity', scaledOpacity);
|
|
|
|
})
|
|
|
|
);
|
|
|
|
}
|
|
|
|
|
|
|
|
// progress the simulation
|
|
|
|
simulation.on('tick', () => {
|
|
|
|
link
|
|
|
|
.attr('x1', (d) => d.source.x)
|
|
|
|
.attr('y1', (d) => d.source.y)
|
|
|
|
.attr('x2', (d) => d.target.x)
|
|
|
|
.attr('y2', (d) => d.target.y);
|
|
|
|
node.attr('cx', (d) => d.x).attr('cy', (d) => d.y);
|
|
|
|
labels.attr('x', (d) => d.x).attr('y', (d) => d.y);
|
|
|
|
});
|
|
|
|
}
|