CKTIS / JavaScript
HTMLProgressElement: напредък на задача с max и value
HTMLProgressElement предоставя свойствата max и value на елемент progress. Те описват общото количество работа и завършената част и позволяват да се различи известен нулев напредък от състояние, при което степента на завършеност е неизвестна.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
progress.max = total;
progress.value = completed;
progress.position;
progress.removeAttribute("value");HTMLProgressElement е DOM интерфейсът за елемента progress, който показва напредъка на задача. Progress max/value обхваща две числови свойства: max описва общото количество работа, а value — завършената част. Това е уеб API на браузъра, а не функционалност на конкретно издание на ECMAScript; самото наличие на Node 24 не доказва, че API е налично.
max трябва да е по-голямо от 0, а стойността му по подразбиране е 1. value представя напредъка от 0 до max, така че не е задължително да е процент. При max = 8 и value = 3 са завършени три от осем единици. Минималната стойност винаги е 0; елементът progress не поддържа атрибут min.
Когато атрибутът value е налице, напредъкът е определен. Свойството position, което е само за четене, тогава връща value / max. Ако атрибутът value липсва, напредъкът е неопределен: прочитането на value връща 0, но position връща -1. Задаването на value = 0 означава известен нулев напредък, а не неопределено състояние. Използвайте removeAttribute("value"), за да се върнете към това състояние.
Осигурете достъпно име чрез свързан елемент label, aria-label или aria-labelledby; текстът вътре в елемента не замества етикет. MDN класифицира интерфейса като широко достъпен в браузърите от юли 2015 г. Примерът създава неприсъединен елемент и показва разликата между известен нулев и неизвестен напредък, без анимация или зависимост от времето.
Примери
(() => {
const progress = document.createElement("progress");
progress.setAttribute("aria-label", "Task progress");
progress.max = 8;
progress.value = 3;
console.log(`max=${progress.max}, value=${progress.value}, position=${progress.position}`);
progress.value = 0;
console.log(`zero: value=${progress.value}, position=${progress.position}`);
progress.removeAttribute("value");
console.log(`unknown: value=${progress.value}, position=${progress.position}`);
})();Резултат
max=8, value=3, position=0.375 zero: value=0, position=0 unknown: value=0, position=-1
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.