ใ“ใฎใƒšใƒผใ‚ธใฏใ‚ณใƒŸใƒฅใƒ‹ใƒ†ใ‚ฃใƒผใฎๅฐฝๅŠ›ใง่‹ฑ่ชžใ‹ใ‚‰็ฟป่จณใ•ใ‚Œใพใ—ใŸใ€‚MDN Web Docs ใ‚ณใƒŸใƒฅใƒ‹ใƒ†ใ‚ฃใƒผใซใคใ„ใฆใ‚‚ใฃใจ็Ÿฅใ‚Šใ€ไปฒ้–“ใซใชใ‚‹ใซใฏใ“ใกใ‚‰ใ‹ใ‚‰ใ€‚

View in English Always switch to English

HTMLInputElement: stepUp() ใƒกใ‚ฝใƒƒใƒ‰

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

HTMLInputElement.stepUp() ใƒกใ‚ฝใƒƒใƒ‰ใฏใ€ๆ•ฐๅ€คๅž‹ใฎ <input> ่ฆ็ด ใฎๅ€คใ‚’ step ๅฑžๆ€งใฎๅ€คใ€ใพใŸใฏ step ๅฑžๆ€งใŒๆ˜Ž็คบ็š„ใซ่จญๅฎšใ•ใ‚Œใฆใ„ใชใ„ๅ ดๅˆใฏๆ—ขๅฎšใฎ step ใฎๅ€คใ ใ‘ๅข—ๅŠ ใ•ใ›ใ‚‹ใ‚‚ใฎใงใ™ใ€‚ใ“ใฎใƒกใ‚ฝใƒƒใƒ‰ใ‚’ๅ‘ผใณๅ‡บใ™ใจใ€ value ใฏ (step * n) ใ ใ‘ๆธ›ๅฐ‘ใ—ใพใ™ใ€‚ใ“ใ“ใงใ€n ใฏๆŒ‡ๅฎšใ•ใ‚Œใชใ‹ใฃใŸๅ ดๅˆใ€ๆ—ขๅฎšใง 1 ใจใชใ‚Šใ€step ใŒๆŒ‡ๅฎšใ•ใ‚Œใชใ‹ใฃใŸๅ ดๅˆใ€ step ใฎๆ—ขๅฎšๅ€คใจใชใ‚Šใพใ™ใ€‚

ๅ…ฅๅŠ›ๅž‹ ๆ—ขๅฎšใฎ step ใฎๅ€ค step ใฎๅฎฃ่จ€ใฎไพ‹
date 1 ๏ผˆๆ—ฅ๏ผ‰ 7 ๆ—ฅ๏ผˆ1 ้€ฑ้–“๏ผ‰ๅ˜ไฝใฎๅข—ๅŠ :
<input type="date" min="2019-12-25" step="7">
month 1 ๏ผˆใƒถๆœˆ๏ผ‰ 12 ใƒถๆœˆ๏ผˆ1 ๅนด๏ผ‰ๅ˜ไฝใฎๅข—ๅŠ :
<input type="month" min="2019-12" step="12">
week 1 ๏ผˆ้€ฑ้–“๏ผ‰ 2 ้€ฑ้–“ๅ˜ไฝใฎๅข—ๅŠ :
<input type="week" min="2019-W23" step="2">
time 60 ๏ผˆ็ง’๏ผ‰ 900 ็ง’๏ผˆ15 ๅˆ†๏ผ‰ๅ˜ไฝใฎๅข—ๅŠ :
<input type="time" min="09:00" step="900">
datetime-local 1 ๏ผˆๆ—ฅ๏ผ‰ ๅŒใ˜ๆ›œๆ—ฅ:
<input type="datetime-local" min="019-12-25T19:30" step="7">
number 1 0.1 ๅˆปใฟ
<input type="number" min="0" step="0.1" max="10">
range 1 2 ใšใคๅข—ๅŠ :
<input type="range" min="0" step="2" max="10">

ใ“ใฎใƒกใ‚ฝใƒƒใƒ‰ใ‚’ๅ‘ผใณๅ‡บใ™ใจใ€ใƒ•ใ‚ฉใƒผใƒ ใ‚ณใƒณใƒˆใƒญใƒผใƒซๅ†…ใง่จญๅฎšใ•ใ‚ŒใŸๅˆถ็ด„ใฎ็ฏ„ๅ›ฒๅ†…ใงใ€ step ๅฑžๆ€งใงๆŒ‡ๅฎšใ•ใ‚ŒใŸๅ€คใซๅผ•ๆ•ฐใ‚’ๆŽ›ใ‘ใŸๅ€คใ ใ‘ใ€ใƒ•ใ‚ฉใƒผใƒ ใ‚ณใƒณใƒˆใƒญใƒผใƒซใฎๅ€คใ‚’ๅค‰ๆ›ดใ—ใพใ™ใ€‚ๅผ•ๆ•ฐใŒๆธกใ•ใ‚Œใชใ‹ใฃใŸๅ ดๅˆใฎๆ—ขๅฎšๅ€คใฏ 1 ใงใ™ใ€‚ใ“ใฎใƒกใ‚ฝใƒƒใƒ‰ใฏใ€ๅ€คใŒ max ใ‚’ไธŠๅ›žใฃใŸใ‚Šใ€ step ๅฑžๆ€งใŒ่จญๅฎšใ™ใ‚‹ๅˆถ็ด„ใซ้•ๅใ•ใ›ใ‚‹ใ‚ˆใ†ใชใ“ใจใฏใ—ใพใ›ใ‚“ใ€‚

stepUp() ใƒกใ‚ฝใƒƒใƒ‰ใ‚’ๅ‘ผใณๅ‡บใ™ๅ‰ใฎๅ€คใŒ็„กๅŠนใงใ‚ใฃใŸๅ ดๅˆใ€ไพ‹ใˆใฐ step ๅฑžๆ€งใง่จญๅฎšใ—ใŸๅˆถ็ด„ใซ้ฉๅˆใ—ใชใ„ๅ ดๅˆใ€ stepUp() ใƒกใ‚ฝใƒƒใƒ‰ใ‚’ๅ‘ผใณๅ‡บใ™ใจใ€ใƒ•ใ‚ฉใƒผใƒ ใ‚ณใƒณใƒˆใƒญใƒผใƒซใฎๅˆถ็ด„ใซ้ฉๅˆใ™ใ‚‹ๅ€คใŒ่ฟ”ใ•ใ‚Œใพใ™ใ€‚

ใƒ•ใ‚ฉใƒผใƒ ใ‚ณใƒณใƒˆใƒญใƒผใƒซใŒๆ™‚ๅˆปใ€ๆ—ฅไป˜ใ€ๆ•ฐๅ€คไปฅๅค–ใฎใ‚‚ใฎใงใ€ step ๅฑžๆ€งใซๅฏพๅฟœใ—ใฆใ„ใชใ„ๅ ดๅˆ๏ผˆๅ‰่ฟฐใฎ่กจใซๅฏพๅฟœใ™ใ‚‹ๅ…ฅๅŠ›ๅž‹ใฎใƒชใ‚นใƒˆใ‚’ๅ‚็…ง๏ผ‰ใ€ใพใŸใฏ step ๅ€คใŒ any ใซ่จญๅฎšใ•ใ‚Œใฆใ„ใ‚‹ๅ ดๅˆใ€ InvalidStateError ไพ‹ๅค–ใŒ็™บ็”Ÿใ—ใพใ™ใ€‚

ๆง‹ๆ–‡

js
stepUp()
stepUp(stepIncrement)

ๅผ•ๆ•ฐ

stepIncrement ็œ็•ฅๅฏ

ๆ•ฐๅ€คใงใ™ใ€‚ๅผ•ๆ•ฐใŒๆธกใ•ใ‚Œใชใ‹ใฃใŸๅ ดๅˆใ€ stepIncrement ใฏๆ—ขๅฎšใง 1 ใซใชใ‚Šใพใ™ใ€‚

่ฟ”ๅ€ค

ใชใ— (undefined)ใ€‚

ไพ‹

ใ“ใฎไพ‹ใฎใƒœใ‚ฟใƒณใ‚’ใ‚ฏใƒชใƒƒใ‚ฏใ™ใ‚‹ใจใ€ number ๅ…ฅๅŠ›ๅž‹ใฎๅ€คใŒๅข—ๅŠ ใ—ใพใ™ใ€‚

HTML

html
<p>
  <label for="theNumber">
    0 ใ‹ใ‚‰ 400 ใพใงใฎ 5 ใงๅ‰ฒใ‚Šๅˆ‡ใ‚Œใ‚‹ๆ•ฐใ‚’ๅ…ฅๅŠ›ใ—ใฆใใ ใ•ใ„ใ€‚
  </label>
  <input type="number" step="5" id="theNumber" min="0" max="400" />
</p>
<p>
  <label>ๅข—ๅŠ ใ•ใ›ใŸใ„ๆฎต้šŽใฎๆ•ฐใ‚’ๅ…ฅๅŠ›ใ™ใ‚‹ใ‹ใ€็ฉบๆฌ„ใฎใพใพใซใ—ใฆใใ ใ•ใ„ใ€‚</label>
  <input type="number" step="1" id="incrementInput" min="0" max="25" />
</p>
<input type="button" value="Increment" id="theButton" />

Java10Script

js
/* ้–ขๆ•ฐใ‚’ๅ‘ผใณๅ‡บใ™ใƒœใ‚ฟใƒณใ‚’็”Ÿๆˆ */
const button = document.getElementById("theButton");
button.addEventListener("click", () => {
  stepOnUp();
});

function stepOnUp() {
  let input = document.getElementById("theNumber");
  let val = document.getElementById("incrementInput").value;

  if (val) {
    /* ๅผ•ๆ•ฐไป˜ใใงๅŠ ็ฎ— */
    input.stepUp(val);
  } else {
    /* ๅผ•ๆ•ฐใชใ—ใงๅŠ ็ฎ—ใ€‚ 0 ใ‚’่ฉฆใ—ใฆใใ ใ•ใ„ใ€‚ */
    input.stepUp();
  }
}

CSS

css
input:invalid {
  border: red solid 3px;
}

็ตๆžœ

stepUp ใƒกใ‚ฝใƒƒใƒ‰ใซๅผ•ๆ•ฐใ‚’ๆธกใ•ใชใ‹ใฃใŸๅ ดๅˆใ€ๆ—ขๅฎšๅ€คใฏ 1 ใซใชใ‚Šใพใ™ใ€‚ไป–ใฎๅ€คใฏ step ๅฑžๆ€งใฎๅ€คใซไน—็ฎ—ใ•ใ‚Œใ‚‹ใฎใงใ€ใ“ใฎๅ ดๅˆใฏ 5 ใจใชใ‚Šใพใ™ใ€‚ stepIncrement ใซ 4 ใ‚’ๆธกใ—ใŸๅ ดๅˆใ€ stepUp ใฏ 4 * 5 ใ™ใชใ‚ใก 20 ใ ใ‘่กŒใ‚ใ‚Œใพใ™ใ€‚ใ“ใฎๅผ•ๆ•ฐใŒ 0 ใงใ‚ใฃใŸๅ ดๅˆใ€ๆ•ฐๅ€คใฏๅŠ ็ฎ—ใ•ใ‚Œใพใ›ใ‚“ใ€‚ stepUp ใƒกใ‚ฝใƒƒใƒ‰ใฏๅ…ฅๅŠ›ใŒ็ฏ„ๅ›ฒๅค–ใซใชใ‚‰ใชใ„ใ‚ˆใ†ใซใ€ใ“ใฎๅ ดๅˆใฏ 400 ใซใชใฃใŸๆ™‚็‚นใงๅœๆญขใ—ใ€ๅผ•ๆ•ฐใจใ—ใฆๆธกใ•ใ‚ŒใŸๅ€คใฎๅฐๆ•ฐ็‚นไปฅไธ‹ใ‚’ๅˆ‡ใ‚Šๆจใฆใพใ™ใ€‚

ๆฎต้šŽใฎๅŠ ็ฎ—ไฟ‚ๆ•ฐใ‚’ 1.2 ใซ่จญๅฎšใ—ใฆใฟใฆใใ ใ•ใ„ใ€‚ใƒกใ‚ฝใƒƒใƒ‰ใ‚’ๅ‘ผใณๅ‡บใ™ใจใฉใ†ใชใ‚‹ใงใ—ใ‚‡ใ†ใ‹๏ผŸ

ๅ€คใ‚’ไธๆญฃใชๆ•ฐๅ€คใงใ‚ใ‚‹ 4 ใซ่จญๅฎšใ—ใฆใฟใฆใใ ใ•ใ„ใ€‚ใƒกใ‚ฝใƒƒใƒ‰ใ‚’ๅ‘ผใณๅ‡บใ™ใจใฉใ†ใชใ‚‹ใงใ—ใ‚‡ใ†ใ‹๏ผŸ

ไป•ๆง˜ๆ›ธ

Specification
HTML
# dom-input-stepup-dev

ใƒ–ใƒฉใ‚ฆใ‚ถใƒผใฎไบ’ๆ›ๆ€ง

้–ข้€ฃๆƒ…ๅ ฑ