robert
/
xjs


			
				
					
						
						
							123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183
							<!DOCTYPE html>
<html lang="zh-CN">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>Tween parameters - Overview</title>
  <link rel="stylesheet" href="../demo.css">
  <style>
    .track {
      position: relative;
      height: 1px;
      background: #262626;
      margin: 18px 0 8px;
    }
    .lane {
      display: flex;
      align-items: center;
      justify-content: space-between;
      gap: 14px;
      padding: 14px 0;
      border-bottom: 1px solid #202020;
    }
    .lane:last-child { border-bottom: none; }
    .dot {
      width: 16px;
      height: 16px;
      border-radius: 4px;
      background: var(--highlight-color);
      will-change: transform;
    }
    .dot.orange { background: var(--accent-color); }
    .dot.gray { background: #666; }
    .meta {
      width: 240px;
      min-width: 240px;
      color: #bdbdbd;
      font-size: 13px;
      line-height: 1.35;
    }
    .meta strong { color: #fff; font-weight: 700; }
    .meta code { font-size: 12px; }
  </style>
</head>
<body>
  <div class="container">
    <div class="page-top">
      <div class="crumb">ANIMATION › TWEEN PARAMETERS</div>
      <div class="since">SINCE 1.0.0</div>
    </div>

    <h1>Tween parameters</h1>
    <p class="description">
      这组参数决定动画<strong>怎么播放</strong>：多久开始、跑多快、怎么缓动、循环几次、结束时停在哪…<br>
      在 <code class="inline">xjs(target).animate({...})</code> 里，它们跟“要动的属性”写在同一个对象里。
    </p>

    <h2>核心参数一览</h2>
    <p>
      支持的常用项：<code class="inline">duration</code>、<code class="inline">delay</code>、<code class="inline">endDelay</code>、
      <code class="inline">easing</code>、<code class="inline">direction</code>、<code class="inline">loop</code>、
      <code class="inline">autoplay</code>、<code class="inline">fill</code>。
      其中 <code class="inline">easing</code> 还支持 <strong>spring</strong>（对象形式）。
    </p>

    <div class="box-container">
      <div class="box-header">
        <div class="box-title">Quick overview</div>
        <div class="box-right">
          <button class="icon-btn" type="button" title="Copy" onclick="DocPage.copyActiveCode()" aria-label="Copy code">
            <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">
              <rect x="9" y="9" width="13" height="13" rx="2"></rect>
              <path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"></path>
            </svg>
          </button>
          <div class="tabs" role="tablist" aria-label="Code tabs">
            <div class="tab active" role="tab" aria-selected="true" tabindex="0" onclick="DocPage.switchTab('js')">JavaScript</div>
            <div class="tab" role="tab" aria-selected="false" tabindex="-1" onclick="DocPage.switchTab('html')">HTML</div>
            <div class="tab" role="tab" aria-selected="false" tabindex="-1" onclick="DocPage.switchTab('css')">CSS</div>
          </div>
        </div>
      </div>

      <div id="js-code" class="code-view active">
<span class="fun">xjs</span><span class="punc">(</span><span class="str">'.dot'</span><span class="punc">)</span>.<span class="fun">animate</span><span class="punc">({</span>
  x<span class="punc">:</span> <span class="str">'18rem'</span><span class="punc">,</span>
  duration<span class="punc">:</span> <span class="num">900</span><span class="punc">,</span>
  delay<span class="punc">:</span> <span class="num">120</span><span class="punc">,</span>
  easing<span class="punc">:</span> <span class="str">'ease-out'</span><span class="punc">,</span>
  direction<span class="punc">:</span> <span class="str">'alternate'</span><span class="punc">,</span>
  loop<span class="punc">:</span> <span class="num">2</span><span class="punc">,</span>
  endDelay<span class="punc">:</span> <span class="num">200</span><span class="punc">,</span>
  fill<span class="punc">:</span> <span class="str">'forwards'</span>
<span class="punc">}</span><span class="punc">)</span><span class="punc">;</span>
      </div>

      <div id="html-code" class="html-view">
<span class="tag">&lt;div</span> <span class="attr">class</span>=<span class="val">"lane"</span><span class="tag">&gt;</span>
  <span class="tag">&lt;div</span> <span class="attr">class</span>=<span class="val">"meta"</span><span class="tag">&gt;</span>...<span class="tag">&lt;/div&gt;</span>
  <span class="tag">&lt;div</span> <span class="attr">class</span>=<span class="val">"dot"</span><span class="tag">&gt;&lt;/div&gt;</span>
<span class="tag">&lt;/div&gt;</span>
      </div>

      <pre id="css-code" class="css-view">.dot { width: 16px; height: 16px; border-radius: 4px; background: var(--highlight-color); }
.dot.orange { background: var(--accent-color); }
.dot.gray { background: #666; }</pre>

      <div class="feature-desc">
        <strong>这组最想让你记住的点：</strong>
        <br>1) 参数和属性写在同一个对象里（上面代码里 <code class="inline">x</code> 是属性，其余是播放参数）。
        <br>2) 不会写也没关系：先只写 <code class="inline">duration</code> + <code class="inline">easing</code>，就已经很好玩了。
        <br>3) 想要“弹簧手感”？把 <code class="inline">easing</code> 写成对象即可（后面有 spring 专门页面）。
      </div>

      <div class="demo-visual">
        <div class="lane">
          <div class="meta"><strong>默认</strong><br><code class="inline">duration: 900</code> <code class="inline">ease-out</code></div>
          <div class="dot"></div>
        </div>
        <div class="lane">
          <div class="meta"><strong>更慢</strong><br><code class="inline">duration: 1600</code> <code class="inline">ease-in-out</code></div>
          <div class="dot orange"></div>
        </div>
        <div class="lane">
          <div class="meta"><strong>更“复读机”</strong><br><code class="inline">loop: 3</code> <code class="inline">alternate</code></div>
          <div class="dot gray"></div>
        </div>
        <div class="track" aria-hidden="true"></div>
      </div>

      <div class="action-bar">
        <button class="play-btn" onclick="runDemo()">REPLAY</button>
      </div>
    </div>

    <div class="doc-nav" aria-label="Previous and next navigation">
      <a href="#" onclick="goPrev(); return false;">
        <span>
          <span class="nav-label">Previous</span><br>
          <span id="prev-title" class="nav-title">—</span>
        </span>
        <span aria-hidden="true">←</span>
      </a>
      <div id="nav-center" class="nav-center">Tween parameters</div>
      <a href="#" onclick="goNext(); return false;">
        <span>
          <span class="nav-label">Next</span><br>
          <span id="next-title" class="nav-title">—</span>
        </span>
        <span aria-hidden="true">→</span>
      </a>
    </div>
  </div>

  <div id="toast" class="toast" role="status" aria-live="polite"></div>

  <script src="../page_utils.js"></script>
  <script src="../../xjs.js"></script>
  <script>
    const CURRENT = 'tween_parameters/overview.html';

    function resetDots() {
      document.querySelectorAll('.dot').forEach(el => el.style.transform = 'none');
    }

    function runDemo() {
      resetDots();
      const dots = document.querySelectorAll('.dot');
      xjs(dots[0]).animate({ x: '18rem', duration: 900, easing: 'ease-out' });
      xjs(dots[1]).animate({ x: '18rem', duration: 1600, easing: 'ease-in-out' });
      xjs(dots[2]).animate({ x: '18rem', duration: 700, easing: 'linear', loop: 3, direction: 'alternate' });
    }

    function goPrev() { window.parent?.docNavigatePrev?.(CURRENT); }
    function goNext() { window.parent?.docNavigateNext?.(CURRENT); }

    DocPage.enableTabKeyboardNav();
    DocPage.syncMiddleActive(CURRENT);
    DocPage.syncPrevNext(CURRENT);
    setTimeout(runDemo, 300);
  </script>
</body>
</html>