Function getLabelForElement

util/dom_utils.js:139–191

(element)

 *           > aria-describedby > hybrid question text (for radio/checkbox) > nearby text fallback
 */
export function getLabelForElement(element) {
    if (!element) return '';

    // Strategy 1: Explicit <label for="id">
    if (element.id) {
        const label = document.querySelector(`label[for="${CSS.escape(element.id)}"]`);
        if (label) return cleanLabelText(label, element);
    }

    // Strategy 2: aria-labelledby (references another element)
    const labelledBy = element.getAttribute('aria-labelledby');
    if (labelledBy) {
        const labelEl = document.getElementById(labelledBy);
        if (labelEl) return cleanLabelText(labelEl, element);
    }

    // Strategy 3: aria-label attribute
    const ariaLabel = element.getAttribute('aria-label');
    if (ariaLabel) return ariaLabel.trim();

    // Strategy 4: Implicit label (element wrapped in <label>)
    const parentLabel = element.closest('label');
    if (parentLabel) return cleanLabelText(parentLabel, element);

    // Strategy 5: Placeholder (fallback for inputs)
    if (element.placeholder) return element.placeholder.trim();

    // Strategy 6: Legend in fieldset
    const fieldset = element.closest('fieldset');
    if (fieldset) {
        const legend = fieldset.querySelector('legend');
        if (legend) return cleanLabelText(legend, element);
    }

    // Strategy 7: aria-describedby (common for questions)
    const describedBy = element.getAttribute('aria-describedby');
    if (describedBy) {
        const descEl = document.getElementById(describedBy);
        if (descEl) return cleanLabelText(descEl, element);
    }

    // Strategy 8: For radio/checkbox - find question using hybrid approach
    if (element.type === 'radio' || element.type === 'checkbox') {
        const questionText = findQuestionText(element);
        if (questionText) return questionText;
    }

    // Strategy 9: General fallback - DOM traversal for nearby text
    const nearbyText = findNearbyLabelText(element);
    if (nearbyText) return nearbyText;

    return '';
}

/**
 * Clean label text - remove element's own value and extra whitespace