offset-path ray函数演示（二）

马黑黑

在 offset-path ray函数演示（一） 中，大家可能已经对 ray() 函数有了些许印象，本演示则需要了解更多：ray 函数的所有参数以及其它相关知识。

💡ray() 函数语法：

ray(<angle> && <size>? && contain? && [at <position>]?)
对应参数含义：射线角度、射线长度、块内包含、射线起点位置。参数顺序没有硬性规定。

💡ray()函数参数

序号	参数	说明
1	angle	必须参数，规范射线方向，角度值，0deg 向上，顺时针增加
2	size	可选参数，路径长度，即 offset-distance 0% 和 100% 之间的距离，相对于包含块。可选值有 closest-side（最近边，默认）、 farthest-side（最远边）、closest-corner（最近角）、farthest-corner（最远角）、sides（沿角度到容器边界）
3	contain	可选参数，元素全程不超出包含块缩短线段的长度（设计本意，算法或浏览器支持度待改进）
4	at position	可选参数，指定射线的起点以及元素在其包含块中的放置位置，缺省默认 at 50% 50%

💡主要配套CSS属性

offset-distance - 沿路径的位置（0% ~ 100%）
offset-position - 射线起点（默认 50% 50%）
offset-rotate - 元素朝向（auto：随路径转向，角度值：朝向固定）
offset-anchor - 元素锚点（默认元素中心点）

💡演示代码（支持预览）：

以下示例设计为综合性演示，ray() 的四个参数一起用上。演示代码不理解没有关系，关键在于演示体验：不同的参数组合生成的射线路径各异，体验时慢慢领会。体验中通过调节不同参数的值、查看 movebox 元素的运动状态应该有助于理解射线路径形态。演示加入了 offset-distance 相抵路径动画效果，在调整射线角度后触发。体验当中注意观察动态生成的 offset-path 路径代码。

<style>
    @import 'https://638183.freep.cn/638183/web/css/hl.css';
    h2 { text-align: center; }
    .pa {
        width: 800px;
        height: 400px;
        border: 1px solid gray;
        position: relative;
        margin: 30px auto 0;
    }
    .pa:nth-of-type(1)::before {
        position: absolute;
        content: attr(data-code);
        width: 100%;
        bottom: 10px;
        text-align: center;
    }
    .pa:nth-of-type(2) {
        border-width: 0;
    }
    .movebox {
        padding: 0px;
        font-size: 36px;
        border: 1px solid gray;
        position: absolute;
    }
    @keyframes move {
        from { offset-distance: 0%; }
        to { offset-distance: 100%; }
    }
</style>

<h2>ray()函数综合演示</h2>
<div id="pa" class="pa hlCode" data-code="offset-path尚未生成">
    <div class="movebox">➡️</div>
</div>
<div class="pa">
    <p>
        <label for="rangeSet">调整角度 ：</label>
        <input id="rangeSet" type="range" value="0" max="360" min="-360" step="5" />
        <output id="outRes">0</output>
    </p>
    <p>
        <label>路径长度：</label>
        <input id="r1" type="radio" name="size" value="closest-side" checked />
        <label for="r1">closest-side</label>
        <input id="r2" type="radio" name="size" value="farthest-side" />
        <label for="r2">farthest-side</label>
        <input id="r3" type="radio" name="size" value="closest-corner" />
        <label for="r3">closest-corner</label>
        <input id="r4" type="radio" name="size" value="farthest-corner" />
        <label for="r4">farthest-corner</label>
        <input id="r5" type="radio" name="size" value="sides" />
        <label for="r5">sides</label>
    </p>
    <p>
        <label for="chkContain">contain ：</label>
        <input id="chkContain" type="checkbox" value="contain" checked />
    </p>
    <p>
        <label for="atX">射线起点(x坐标)：</label>
        <input id="atX" type="range" max="100" min="0" value="50"/>
        <output id="outX">50%</output>
    </p>
    <p>
        <label for="atY">射线起点(y坐标)：</label>
        <input id="atY" type="range" max="100" min="0" value="50"/>
        <output id="outY">50%</output>
    </p>
    <p><button onclick="location.reload()">全部重置</button></p>
</div>
<script>
    const movebox = document.querySelector('.movebox');
    
    movebox.onanimationend = () => rangeSet.disabled = false;
    
    movebox.onanimationstart = () => rangeSet.disabled = true;
    
    rangeSet.oninput = () => {
        outRes.value = rangeSet.value + 'deg';
        movebox.style.setProperty('offset-path', createRayPath());
    }
    
    rangeSet.onchange = () => {
        const path = createRayPath();

        movebox.style.animation = '';
        pa.dataset.code = `offset-path: ${path};`;
        
        setTimeout( () => {
            movebox.style.setProperty('offset-path', `${path}`);
            movebox.style.setProperty('animation', 'move linear 2s forwards');
        }, 500);
    };
    
    atX.oninput = () => {
        movebox.style.setProperty('offset-path', createRayPath());
        outX.value = `${atX.value}%`;
    };
    atY.oninput = () => {
        movebox.style.setProperty('offset-path', createRayPath());
        outY.value = `${atY.value}%`;
    };
    
    function createRayPath() {
        const contain = chkContain.checked ? 'contain' : '';
        const size = document.querySelector('input[name="size"]:checked').value;
        const pos = `${atX.value}% ${atY.value}%`;
        let ray = `${rangeSet.value}deg ${contain} ${size} at ${pos}`.replaceAll('  ', ' ');
        ray = `ray(${ray})`;
        return ray;
    }
</script>
    

霜染枫丹

马老师中午好！

这个我运行了一下，特别赞佩！喜欢这形式，我先抱走了。很感谢您的分享，辛苦了，祝您吉祥快乐！

红影

去运行了一下，看着小方块按照指令滑行着，closest-side（最近边，默认）还有最远边等等的那几个设置没弄明白是什么意思呢

小辣椒

小辣椒欣赏加学习

马黑黑

小辣椒 发表于 2026-8-1 13:06
小辣椒欣赏加学习

马黑黑

红影 发表于 2026-8-1 12:56
去运行了一下，看着小方块按照指令滑行着，closest-side（最近边，默认）还有最远边等等的那几个设置没弄 ...

表格里关于 ray() 参数都有简要说明。

size 参数用来设置射线的长度，共有五个可选值，都是基于包含块（容器）的边界、从起点到指定边的距离：

① 最近边，射线长度按从起点到最近边的距离计算（缺省默认）；
② 最远边，射线长度按从起点到最远边的距离计算；
③ 最近角，射线长度按从起点到最近角的距离计算；
④ 最远角，射线长度按从起点到最远角的距离计算；
⑤ sides（边界），射线长度按从起点到射线延长线与容器相交的边的距离计算。

杨帆

谢谢马老师精彩讲解 ray函数四个参数的直观效果。另：contain作为可选参数，默认值是什么？